在 ThinkPHP 5 中,命令行工具使用 addOption
和 addArgument
方法来定义命令的选项和参数。这两个方法的主要区别在于它们的作用和使用方式。
addOption
addOption
用于定义命令行中的选项(options)。选项通常以短横线(-
)或双短横线(--
)开头,并且可以有默认值、描述和是否必需等属性。选项通常用于修改命令的行为,而不是传递主要的数据。
示例
protected function configure()
{
$this->setName('mycommand')
->setDescription('This is a sample command')
->addOption('verbose', 'v', InputOption::VALUE_NONE, 'Enable verbose mode')
->addOption('output', null, InputOption::VALUE_REQUIRED, 'Set the output file');
}
在这个例子中:
verbose
选项可以通过-v
或--verbose
来指定。output
选项需要一个值,可以通过--output=filename
或--output filename
来指定。
addArgument
addArgument
用于定义命令行中的参数(arguments)。参数是命令的主要输入数据,通常没有前缀,按顺序传递。参数可以有名称、是否必需以及是否可以接受多个值等属性。
示例
protected function configure()
{
$this->setName('mycommand')
->setDescription('This is a sample command')
->addArgument('name', InputArgument::REQUIRED, 'The name of the user')
->addArgument('email', InputArgument::OPTIONAL, 'The email of the user');
}
在这个例子中:
name
参数是必需的,用户必须提供。email
参数是可选的,用户可以选择提供。
主要区别
-
语法:
- 选项通常以短横线(
-
)或双短横线(--
)开头,例如--verbose
或-v
。 - 参数直接按顺序传递,不带前缀,例如
user_name
。
- 选项通常以短横线(
-
用途:
- 选项用于修改命令的行为,例如启用调试模式、设置输出文件等。
- 参数用于传递主要的数据,例如用户名、文件名等。
-
必填性:
- 选项可以是可选的,也可以有默认值。
- 参数可以是必需的或可选的,但通常用于传递主要的数据。
-
使用方式:
- 选项可以在命令的任何位置出现,通常在参数之前。
- 参数按顺序传递,不能随意改变顺序。
示例代码
假设你有一个自定义命令 greet
,它需要一个名字作为参数,并且可以接受一个可选的问候语选项:
namespace app\command;
use think\console\Command;
use think\console\Input;
use think\console\input\Argument;
use think\console\input\Option;
use think\console\Output;
class Greet extends Command
{
protected function configure()
{
$this->setName('greet')
->setDescription('Greet someone')
->addArgument('name', Argument::REQUIRED, 'The name of the person to greet')
->addOption('greeting', 'g', Option::VALUE_OPTIONAL, 'The greeting message', 'Hello');
}
protected function execute(Input $input, Output $output)
{
$name = $input->getArgument('name');
$greeting = $input->getOption('greeting');
$output->writeln($greeting . ', ' . $name . '!');
}
}
在这个例子中:
name
是必需的参数。greeting
是可选的选项,默认值为Hello
。
你可以这样调用这个命令:
php think greet John --greeting=Hi
这将输出 Hi, John!
。