515 lines
13 KiB
PHP
515 lines
13 KiB
PHP
<?php
|
|
/**
|
|
* CakePHP(tm) : Rapid Development Framework (https://cakephp.org)
|
|
* Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
|
|
*
|
|
* Licensed under The MIT License
|
|
* For full copyright and license information, please see the LICENSE.txt
|
|
* Redistributions of files must retain the above copyright notice.
|
|
*
|
|
* @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
|
|
* @link https://cakephp.org CakePHP(tm) Project
|
|
* @since CakePHP(tm) v 1.2.0.5012
|
|
* @license https://opensource.org/licenses/mit-license.php MIT License
|
|
*/
|
|
|
|
App::uses('AppShell', 'Console/Command');
|
|
|
|
/**
|
|
* Provides a very basic 'interactive' console for CakePHP apps.
|
|
*
|
|
* @package Cake.Console.Command
|
|
* @deprecated 3.0.0 Deprecated since version 2.4, will be removed in 3.0
|
|
*/
|
|
class ConsoleShell extends AppShell {
|
|
|
|
/**
|
|
* Available binding types
|
|
*
|
|
* @var array
|
|
*/
|
|
public $associations = array('hasOne', 'hasMany', 'belongsTo', 'hasAndBelongsToMany');
|
|
|
|
/**
|
|
* Chars that describe invalid commands
|
|
*
|
|
* @var array
|
|
*/
|
|
public $badCommandChars = array('$', ';');
|
|
|
|
/**
|
|
* Available models
|
|
*
|
|
* @var array
|
|
*/
|
|
public $models = array();
|
|
|
|
/**
|
|
* _finished
|
|
*
|
|
* This shell is perpetual, setting this property to true exits the process
|
|
*
|
|
* @var mixed
|
|
*/
|
|
protected $_finished = false;
|
|
|
|
/**
|
|
* _methodPatterns
|
|
*
|
|
* @var array
|
|
*/
|
|
protected $_methodPatterns = array(
|
|
'help' => '/^(help|\?)/',
|
|
'_exit' => '/^(quit|exit)/',
|
|
'_models' => '/^models/i',
|
|
'_bind' => '/^(\w+) bind (\w+) (\w+)/',
|
|
'_unbind' => '/^(\w+) unbind (\w+) (\w+)/',
|
|
'_find' => '/.+->find/',
|
|
'_save' => '/.+->save/',
|
|
'_columns' => '/^(\w+) columns/',
|
|
'_routesReload' => '/^routes\s+reload/i',
|
|
'_routesShow' => '/^routes\s+show/i',
|
|
'_routeToString' => '/^route\s+(\(.*\))$/i',
|
|
'_routeToArray' => '/^route\s+(.*)$/i',
|
|
);
|
|
|
|
/**
|
|
* Override startup of the Shell
|
|
*
|
|
* @return void
|
|
*/
|
|
public function startup() {
|
|
App::uses('Dispatcher', 'Routing');
|
|
$this->Dispatcher = new Dispatcher();
|
|
$this->models = App::objects('Model');
|
|
|
|
foreach ($this->models as $model) {
|
|
$class = $model;
|
|
App::uses($class, 'Model');
|
|
$this->{$class} = new $class();
|
|
}
|
|
$this->out(__d('cake_console', 'Model classes:'));
|
|
$this->hr();
|
|
|
|
foreach ($this->models as $model) {
|
|
$this->out(" - {$model}");
|
|
}
|
|
|
|
if (!$this->_loadRoutes()) {
|
|
$message = __d(
|
|
'cake_console',
|
|
'There was an error loading the routes config. Please check that the file exists and contains no errors.'
|
|
);
|
|
$this->err($message);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Gets the option parser instance and configures it.
|
|
*
|
|
* @return ConsoleOptionParser
|
|
*/
|
|
public function getOptionParser() {
|
|
$parser = parent::getOptionParser();
|
|
|
|
$parser->description(array(
|
|
'The interactive console is a tool for testing parts of your',
|
|
'app before you write code.',
|
|
'',
|
|
'See below for a list of supported commands.'
|
|
))->epilog(array(
|
|
'<info>Model testing</info>',
|
|
'',
|
|
'To test model results, use the name of your model without a leading $',
|
|
'e.g. Foo->find("all")',
|
|
"",
|
|
'To dynamically set associations, you can do the following:',
|
|
'',
|
|
"\tModelA bind <association> ModelB",
|
|
'',
|
|
"where the supported associations are hasOne, hasMany, belongsTo, hasAndBelongsToMany",
|
|
"",
|
|
'To dynamically remove associations, you can do the following:',
|
|
'',
|
|
"\t ModelA unbind <association> ModelB",
|
|
'',
|
|
"where the supported associations are the same as above",
|
|
"",
|
|
"To save a new field in a model, you can do the following:",
|
|
'',
|
|
"\tModelA->save(array('foo' => 'bar', 'baz' => 0))",
|
|
'',
|
|
"where you are passing a hash of data to be saved in the format",
|
|
"of field => value pairs",
|
|
"",
|
|
"To get column information for a model, use the following:",
|
|
'',
|
|
"\tModelA columns",
|
|
'',
|
|
"which returns a list of columns and their type",
|
|
"",
|
|
'<info>Route testing</info>',
|
|
"",
|
|
'To test URLs against your app\'s route configuration, type:',
|
|
"",
|
|
"\tRoute <url>",
|
|
"",
|
|
"where url is the path to your your action plus any query parameters,",
|
|
"minus the application's base path. For example:",
|
|
"",
|
|
"\tRoute /posts/view/1",
|
|
"",
|
|
"will return something like the following:",
|
|
"",
|
|
"\tarray(",
|
|
"\t [...]",
|
|
"\t 'controller' => 'posts',",
|
|
"\t 'action' => 'view',",
|
|
"\t [...]",
|
|
"\t)",
|
|
"",
|
|
'Alternatively, you can use simple array syntax to test reverse',
|
|
'To reload your routes config (Config/routes.php), do the following:',
|
|
"",
|
|
"\tRoutes reload",
|
|
"",
|
|
'To show all connected routes, do the following:',
|
|
'',
|
|
"\tRoutes show",
|
|
));
|
|
|
|
return $parser;
|
|
}
|
|
/**
|
|
* Prints the help message
|
|
*
|
|
* @return void
|
|
*/
|
|
public function help() {
|
|
$optionParser = $this->getOptionParser();
|
|
$this->out($optionParser->epilog());
|
|
}
|
|
|
|
/**
|
|
* Override main() to handle action
|
|
*
|
|
* @param string $command The command to run.
|
|
* @return void
|
|
*/
|
|
public function main($command = null) {
|
|
$this->_finished = false;
|
|
while (!$this->_finished) {
|
|
if (empty($command)) {
|
|
$command = trim($this->in(''));
|
|
}
|
|
|
|
$method = $this->_method($command);
|
|
|
|
if ($method) {
|
|
$this->$method($command);
|
|
} else {
|
|
$this->out(__d('cake_console', "Invalid command"));
|
|
$this->out();
|
|
}
|
|
$command = '';
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Determine the method to process the current command
|
|
*
|
|
* @param string $command The command to run.
|
|
* @return string or false
|
|
*/
|
|
protected function _method($command) {
|
|
foreach ($this->_methodPatterns as $method => $pattern) {
|
|
if (preg_match($pattern, $command)) {
|
|
return $method;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Set the finiished property so that the loop in main method ends
|
|
*
|
|
* @return void
|
|
*/
|
|
protected function _exit() {
|
|
$this->_finished = true;
|
|
}
|
|
|
|
/**
|
|
* List all models
|
|
*
|
|
* @return void
|
|
*/
|
|
protected function _models() {
|
|
$this->out(__d('cake_console', 'Model classes:'));
|
|
$this->hr();
|
|
foreach ($this->models as $model) {
|
|
$this->out(" - {$model}");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Bind an association
|
|
*
|
|
* @param mixed $command The command to run.
|
|
* @return void
|
|
*/
|
|
protected function _bind($command) {
|
|
preg_match($this->_methodPatterns[__FUNCTION__], $command, $tmp);
|
|
|
|
foreach ($tmp as $data) {
|
|
$data = strip_tags($data);
|
|
$data = str_replace($this->badCommandChars, "", $data);
|
|
}
|
|
|
|
$modelA = $tmp[1];
|
|
$association = $tmp[2];
|
|
$modelB = $tmp[3];
|
|
|
|
if ($this->_isValidModel($modelA) && $this->_isValidModel($modelB) && in_array($association, $this->associations)) {
|
|
$this->{$modelA}->bindModel(array($association => array($modelB => array('className' => $modelB))), false);
|
|
$this->out(__d('cake_console', "Created %s association between %s and %s",
|
|
$association, $modelA, $modelB));
|
|
} else {
|
|
$this->out(__d('cake_console', "Please verify you are using valid models and association types"));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Unbind an association
|
|
*
|
|
* @param mixed $command The command to run.
|
|
* @return void
|
|
*/
|
|
protected function _unbind($command) {
|
|
preg_match($this->_methodPatterns[__FUNCTION__], $command, $tmp);
|
|
|
|
foreach ($tmp as $data) {
|
|
$data = strip_tags($data);
|
|
$data = str_replace($this->badCommandChars, "", $data);
|
|
}
|
|
|
|
$modelA = $tmp[1];
|
|
$association = $tmp[2];
|
|
$modelB = $tmp[3];
|
|
|
|
// Verify that there is actually an association to unbind
|
|
$currentAssociations = $this->{$modelA}->getAssociated();
|
|
$validCurrentAssociation = false;
|
|
|
|
foreach ($currentAssociations as $model => $currentAssociation) {
|
|
if ($model === $modelB && $association === $currentAssociation) {
|
|
$validCurrentAssociation = true;
|
|
}
|
|
}
|
|
|
|
if ($this->_isValidModel($modelA) && $this->_isValidModel($modelB) && in_array($association, $this->associations) && $validCurrentAssociation) {
|
|
$this->{$modelA}->unbindModel(array($association => array($modelB)));
|
|
$this->out(__d('cake_console', "Removed %s association between %s and %s",
|
|
$association, $modelA, $modelB));
|
|
} else {
|
|
$this->out(__d('cake_console', "Please verify you are using valid models, valid current association, and valid association types"));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Perform a find
|
|
*
|
|
* @param mixed $command The command to run.
|
|
* @return void
|
|
*/
|
|
protected function _find($command) {
|
|
$command = strip_tags($command);
|
|
$command = str_replace($this->badCommandChars, "", $command);
|
|
|
|
// Do we have a valid model?
|
|
list($modelToCheck) = explode('->', $command);
|
|
|
|
if ($this->_isValidModel($modelToCheck)) {
|
|
$findCommand = "\$data = \$this->$command;";
|
|
//@codingStandardsIgnoreStart
|
|
@eval($findCommand);
|
|
//@codingStandardsIgnoreEnd
|
|
|
|
if (is_array($data)) {
|
|
foreach ($data as $idx => $results) {
|
|
if (is_numeric($idx)) { // findAll() output
|
|
foreach ($results as $modelName => $result) {
|
|
$this->out("$modelName");
|
|
|
|
foreach ($result as $field => $value) {
|
|
if (is_array($value)) {
|
|
foreach ($value as $field2 => $value2) {
|
|
$this->out("\t$field2: $value2");
|
|
}
|
|
|
|
$this->out();
|
|
} else {
|
|
$this->out("\t$field: $value");
|
|
}
|
|
}
|
|
}
|
|
} else { // find() output
|
|
$this->out($idx);
|
|
|
|
foreach ($results as $field => $value) {
|
|
if (is_array($value)) {
|
|
foreach ($value as $field2 => $value2) {
|
|
$this->out("\t$field2: $value2");
|
|
}
|
|
|
|
$this->out();
|
|
} else {
|
|
$this->out("\t$field: $value");
|
|
}
|
|
}
|
|
}
|
|
}
|
|
} else {
|
|
$this->out();
|
|
$this->out(__d('cake_console', "No result set found"));
|
|
}
|
|
} else {
|
|
$this->out(__d('cake_console', "%s is not a valid model", $modelToCheck));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Save a record
|
|
*
|
|
* @param mixed $command The command to run.
|
|
* @return void
|
|
*/
|
|
protected function _save($command) {
|
|
// Validate the model we're trying to save here
|
|
$command = strip_tags($command);
|
|
$command = str_replace($this->badCommandChars, "", $command);
|
|
list($modelToSave) = explode("->", $command);
|
|
|
|
if ($this->_isValidModel($modelToSave)) {
|
|
// Extract the array of data we are trying to build
|
|
list(, $data) = explode("->save", $command);
|
|
$data = preg_replace('/^\(*(array)?\(*(.+?)\)*$/i', '\\2', $data);
|
|
$saveCommand = "\$this->{$modelToSave}->save(array('{$modelToSave}' => array({$data})));";
|
|
//@codingStandardsIgnoreStart
|
|
@eval($saveCommand);
|
|
//@codingStandardsIgnoreEnd
|
|
$this->out(__d('cake_console', 'Saved record for %s', $modelToSave));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Show the columns for a model
|
|
*
|
|
* @param mixed $command The command to run.
|
|
* @return void
|
|
*/
|
|
protected function _columns($command) {
|
|
preg_match($this->_methodPatterns[__FUNCTION__], $command, $tmp);
|
|
|
|
$modelToCheck = strip_tags(str_replace($this->badCommandChars, "", $tmp[1]));
|
|
|
|
if ($this->_isValidModel($modelToCheck)) {
|
|
// Get the column info for this model
|
|
$fieldsCommand = "\$data = \$this->{$modelToCheck}->getColumnTypes();";
|
|
//@codingStandardsIgnoreStart
|
|
@eval($fieldsCommand);
|
|
//@codingStandardsIgnoreEnd
|
|
|
|
if (is_array($data)) {
|
|
foreach ($data as $field => $type) {
|
|
$this->out("\t{$field}: {$type}");
|
|
}
|
|
}
|
|
} else {
|
|
$this->out(__d('cake_console', "Please verify that you selected a valid model"));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Reload route definitions
|
|
*
|
|
* @return void
|
|
*/
|
|
protected function _routesReload() {
|
|
if (!$this->_loadRoutes()) {
|
|
return $this->err(__d('cake_console', "There was an error loading the routes config. Please check that the file exists and is free of parse errors."));
|
|
}
|
|
$this->out(__d('cake_console', "Routes configuration reloaded, %d routes connected", count(Router::$routes)));
|
|
}
|
|
|
|
/**
|
|
* Show all routes
|
|
*
|
|
* @return void
|
|
*/
|
|
protected function _routesShow() {
|
|
$this->out(print_r(Hash::combine(Router::$routes, '{n}.template', '{n}.defaults'), true));
|
|
}
|
|
|
|
/**
|
|
* Parse an array URL and show the equivalent URL as a string
|
|
*
|
|
* @param mixed $command The command to run.
|
|
* @return void
|
|
*/
|
|
protected function _routeToString($command) {
|
|
preg_match($this->_methodPatterns[__FUNCTION__], $command, $tmp);
|
|
|
|
//@codingStandardsIgnoreStart
|
|
if ($url = eval('return array' . $tmp[1] . ';')) {
|
|
//@codingStandardsIgnoreEnd
|
|
$this->out(Router::url($url));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Parse a string URL and show as an array
|
|
*
|
|
* @param mixed $command The command to run.
|
|
* @return void
|
|
*/
|
|
protected function _routeToArray($command) {
|
|
preg_match($this->_methodPatterns[__FUNCTION__], $command, $tmp);
|
|
|
|
$this->out(var_export(Router::parse($tmp[1]), true));
|
|
}
|
|
|
|
/**
|
|
* Tells if the specified model is included in the list of available models
|
|
*
|
|
* @param string $modelToCheck The model to check.
|
|
* @return bool true if is an available model, false otherwise
|
|
*/
|
|
protected function _isValidModel($modelToCheck) {
|
|
return in_array($modelToCheck, $this->models);
|
|
}
|
|
|
|
/**
|
|
* Reloads the routes configuration from app/Config/routes.php, and compiles
|
|
* all routes found
|
|
*
|
|
* @return bool True if config reload was a success, otherwise false
|
|
*/
|
|
protected function _loadRoutes() {
|
|
Router::reload();
|
|
extract(Router::getNamedExpressions());
|
|
|
|
//@codingStandardsIgnoreStart
|
|
if (!@include CONFIG . 'routes.php') {
|
|
//@codingStandardsIgnoreEnd
|
|
return false;
|
|
}
|
|
CakePlugin::routes();
|
|
|
|
Router::parse('/');
|
|
return true;
|
|
}
|
|
|
|
}
|