在 PHP 中,当我们在获取命令行参数时,可以通过遍历$argv
来获取,其实呢是有规范可循的,也就是 GNU C-style parser for command line options 。
比如使用命令wget
下载文件时,使用下面的一些方式来指定option
都可以
wget http://mengkang.net/a.jpg -O b.jpg
wget http://mengkang.net/a.jpg -Ob.jpg --tries=3 -b
wget http://mengkang.net/a.jpg -Ob.jpg --tries=3 -bvd
我们整理下command line options
的规则,首先参数分为短参数名和完整参数名,而且一些还有映射关系。比如我们使用wget
时,-O
对应--output-document
。
char
字符,只能1字节,不能超过1字节,比如上面的第四个命令的最后一个参数就不知道是一个选项还是三个选项了。-
)开始-
后面跟多个选项名--
)开始getopt ( string $options [, array $longopts [, int &$optind ]] ) : array
https://www.php.net/manual/zh/function.getopt.php
$options
短参数字符列表,参数字符后面用:
标识必须传值;参数字符后面用::
标识可选传值;只有参数字符表示该参数(或者说选项)不接受传值$longopts
长参数由于是多字节,所以必须是数组,否则没法分隔。长参数同样遵循上面::
、:
规则
php
里面缺少结构体的支撑,相比c
的长选项的配置更加简洁,但也缺少了长短选项的映射关系配置。
$shortOpts = "O:Vv::dh";
$longOpts = ["output-document:","version","verbose::", "debug", "help"];
$options = getopt($shortOpts, $longOpts);
var_export($options);
php getopt.php -Oa.jpg
array (
'O' => 'a.jpg',
)
php getopt.php -O=a.jpg
array (
'O' => 'a.jpg',
)
php getopt.php -O a.jpg
array (
'O' => 'a.jpg',
)
php getopt.php -O=a.jpg -dhV
array (
'O' => 'a.jpg',
'd' => false,
'h' => false,
'V' => false,
)
php getopt.php -O=a.jpg -dhV -vvv
array (
'O' => 'a.jpg',
'd' => false,
'h' => false,
'V' => false,
'v' => 'vv',
)
上面例子中我的短参数和长参数是对应的,但是没有数据结构来表示他们的对应关系(在C里面有option
结构体来做这个对应关系的管理),所以我们两个都传的话,程序两个值会收到,然后我们自己判断短参数和长参数使用哪个。
php getopt.php -O=a.jpg -dhV -vvv --output-document b.jpg --debug
array (
'O' => 'a.jpg',
'd' => false,
'h' => false,
'V' => false,
'v' => 'vv',
'output-document' => 'b.jpg',
'debug' => false,
)
这样写是不规范的,尽量避免这样的写法。
php getopt.php -O=a.jpg -dhVvvv
array (
'O' => 'a.jpg',
'd' => false,
'h' => false,
'V' => false,
'v' => 'vv',
)
php getopt.php -O=a.jpg -dhvvvV
array (
'O' => 'a.jpg',
'd' => false,
'h' => false,
'v' => 'vvV',
)
总结了这个GNU C command line options 使用的套路,命令使用起来就更溜了,不会懵逼为什么linux
下各种工具使用的案例写法“千奇百怪”了。
(en)在C里面并不支持
短选项
和值
用等号连接,在PHP里却是可以的,需要注意。