1: <?php
 2: /**
 3:  * CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
 4:  * Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
 5:  *
 6:  * Licensed under The MIT License
 7:  * For full copyright and license information, please see the LICENSE.txt
 8:  * Redistributions of files must retain the above copyright notice.
 9:  *
10:  * @copyright     Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
11:  * @link          https://cakephp.org CakePHP(tm) Project
12:  * @since         2.0.0
13:  * @license       https://opensource.org/licenses/mit-license.php MIT License
14:  */
15: namespace Cake\Console;
16: 
17: use Cake\Console\Exception\MissingTaskException;
18: use Cake\Core\App;
19: use Cake\Core\ObjectRegistry;
20: 
21: /**
22:  * Registry for Tasks. Provides features
23:  * for lazily loading tasks.
24:  */
25: class TaskRegistry extends ObjectRegistry
26: {
27:     /**
28:      * Shell to use to set params to tasks.
29:      *
30:      * @var \Cake\Console\Shell
31:      */
32:     protected $_Shell;
33: 
34:     /**
35:      * Constructor
36:      *
37:      * @param \Cake\Console\Shell $Shell Shell instance
38:      */
39:     public function __construct(Shell $Shell)
40:     {
41:         $this->_Shell = $Shell;
42:     }
43: 
44:     /**
45:      * Resolve a task classname.
46:      *
47:      * Part of the template method for Cake\Core\ObjectRegistry::load()
48:      *
49:      * @param string $class Partial classname to resolve.
50:      * @return string|false Either the correct classname or false.
51:      */
52:     protected function _resolveClassName($class)
53:     {
54:         return App::className($class, 'Shell/Task', 'Task');
55:     }
56: 
57:     /**
58:      * Throws an exception when a task is missing.
59:      *
60:      * Part of the template method for Cake\Core\ObjectRegistry::load()
61:      * and Cake\Core\ObjectRegistry::unload()
62:      *
63:      * @param string $class The classname that is missing.
64:      * @param string $plugin The plugin the task is missing in.
65:      * @return void
66:      * @throws \Cake\Console\Exception\MissingTaskException
67:      */
68:     protected function _throwMissingClassError($class, $plugin)
69:     {
70:         throw new MissingTaskException([
71:             'class' => $class,
72:             'plugin' => $plugin
73:         ]);
74:     }
75: 
76:     /**
77:      * Create the task instance.
78:      *
79:      * Part of the template method for Cake\Core\ObjectRegistry::load()
80:      *
81:      * @param string $class The classname to create.
82:      * @param string $alias The alias of the task.
83:      * @param array $settings An array of settings to use for the task.
84:      * @return \Cake\Console\Shell The constructed task class.
85:      */
86:     protected function _create($class, $alias, $settings)
87:     {
88:         return new $class($this->_Shell->getIo());
89:     }
90: }
91: