You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
77 lines
2.0 KiB
77 lines
2.0 KiB
13 years ago
|
<?php
|
||
|
|
/**
|
||
|
|
* CHelpCommand class file.
|
||
|
|
*
|
||
|
|
* @author Qiang Xue <qiang.xue@gmail.com>
|
||
|
|
* @link http://www.yiiframework.com/
|
||
|
|
* @copyright Copyright © 2008-2011 Yii Software LLC
|
||
|
|
* @license http://www.yiiframework.com/license/
|
||
|
|
*/
|
||
|
|
|
||
|
|
namespace yii\console;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* CHelpCommand represents a console help command.
|
||
|
|
*
|
||
|
|
* CHelpCommand displays the available command list or the help instructions
|
||
|
|
* about a specific command.
|
||
|
|
*
|
||
|
|
* To use this command, enter the following on the command line:
|
||
|
|
* <pre>
|
||
|
|
* php path/to/entry_script.php help [command name]
|
||
|
|
* </pre>
|
||
|
|
* In the above, if the command name is not provided, it will display all
|
||
|
|
* available commands.
|
||
|
|
*
|
||
|
|
* @property string $help The command description.
|
||
|
|
*
|
||
|
|
* @author Qiang Xue <qiang.xue@gmail.com>
|
||
|
|
* @since 2.0
|
||
|
|
*/
|
||
|
|
class HelpCommand extends Command
|
||
|
|
{
|
||
|
|
/**
|
||
|
|
* Execute the action.
|
||
|
|
* @param array $args command line parameters specific for this command
|
||
|
|
*/
|
||
|
|
public function run($args)
|
||
|
|
{
|
||
|
|
$runner=$this->getCommandRunner();
|
||
|
|
$commands=$runner->commands;
|
||
|
|
if(isset($args[0]))
|
||
|
|
{
|
||
|
|
$name=strtolower($args[0]);
|
||
|
|
}
|
||
|
|
if(!isset($args[0]) || !isset($commands[$name]))
|
||
|
|
{
|
||
|
|
if(!empty($commands))
|
||
|
|
{
|
||
|
|
echo "Yii command runner (based on Yii v".\Yii::getVersion().")\n";
|
||
|
|
echo "Usage: ".$runner->getScriptName()." <command-name> [parameters...]\n";
|
||
|
|
echo "\nThe following commands are available:\n";
|
||
|
|
$commandNames=array_keys($commands);
|
||
|
|
sort($commandNames);
|
||
|
|
echo ' - '.implode("\n - ",$commandNames);
|
||
|
|
echo "\n\nTo see individual command help, use the following:\n";
|
||
|
|
echo " ".$runner->getScriptName()." help <command-name>\n";
|
||
|
|
}
|
||
|
|
else
|
||
|
|
{
|
||
|
|
echo "No available commands.\n";
|
||
|
|
echo "Please define them under the following directory:\n";
|
||
|
|
echo "\t".\Yii::$app->getCommandPath()."\n";
|
||
|
|
}
|
||
|
|
}
|
||
|
|
else
|
||
|
|
echo $runner->createCommand($name)->getHelp();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Provides the command description.
|
||
|
|
* @return string the command description.
|
||
|
|
*/
|
||
|
|
public function getHelp()
|
||
|
|
{
|
||
|
|
return parent::getHelp().' [command-name]';
|
||
|
|
}
|
||
|
|
}
|