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.
		
		
		
		
		
			
		
			
				
					
					
						
							75 lines
						
					
					
						
							2.0 KiB
						
					
					
				
			
		
		
	
	
							75 lines
						
					
					
						
							2.0 KiB
						
					
					
				<?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]'; | 
						|
	} | 
						|
} |