PHP CLI传参用$argv/$argc,位置参数需判空;推荐getopt()解析选项,注意冒号规则;shell转义和php.ini配置(-d/-c)影响参数与环境。

php命令行运行时怎么传参数
PHP脚本在命令行(CLI)中执行时,参数不是通过 $_GET 或 $_POST 获取的,而是通过 $argv 数组和 $argc 变量。其中 $argv[0] 是脚本路径,后续元素才是你传入的参数。
比如运行:
php script.php hello world --verbose那么
$argv 就是 ['script.php', 'hello', 'world', '--verbose'],$argc === 4。
- 直接用
$argv[1]、$argv[2]拿位置参数,但要先判断$argc > 1,否则会触发Undefined offset - 带短横线的参数(如
-f、--file)需自行解析,PHP 不自动处理成键值对 - 如果需要类 Unix 风格的参数解析(支持
-h、--help、-o file.txt),推荐用getopt()函数
getopt() 怎么用才不踩坑
getopt() 是 PHP 内置函数,专为 CLI 参数解析设计,但它的语法容易写错,尤其在长选项和参数绑定上。
示例:想支持 -f filename 和 --output=dir,可以这样写:
立即学习“PHP免费学习笔记(深入)”;
$options = getopt('f:', ['output:']);
注意点:
- 短选项后跟冒号(
'f:')表示它必须带参数;不加冒号('v')就是布尔开关 - 长选项数组里写
'output:'表示必须带值;写'help'(无冒号)就是纯标志位 - 如果传了
-f但没给值,getopt()直接返回false,不会抛异常——得自己检查 - 混合使用短/长选项时,顺序无关,但
getopt()不处理空格分隔的长选项值(--output dir不行,必须--output=dir)
为什么 $argv 有时为空或不全
这不是 PHP 的 bug,而是 shell 层面的转义或分词问题。常见原因有:
- 参数含空格但没加引号,比如
php test.php a b c→ 三个参数;但php test.php "hello world"→ 第二个参数才是完整字符串 - 特殊字符如
*、$、( )被 shell 展开,还没到 PHP 就被替换了,例如php test.php *.log会把当前目录所有 log 文件名作为参数传入 - Windows CMD 对引号处理更严格,双引号内不能嵌套双引号;PowerShell 则默认做更多解析,建议 CLI 脚本开头加
var_dump($argv);确认实际收到什么
想改默认 php.ini 配置怎么办
命令行模式默认加载的是 CLI 专用的 php.ini(路径可通过 php --ini 查看),和 Web 用的不是同一个。要临时覆盖配置项,不用改文件:
- 用
-d参数直接设 ini 值:php -d memory_limit=512M script.php - 指定不同配置文件:
php -c /path/to/cli.ini script.php - 禁用所有扩展(调试用):
php -n script.php - 注意:
-d设置的值优先级高于php.ini,但某些只读指令(如zend_extension)无法用-d修改
真正麻烦的是当脚本依赖某个扩展(比如 pdo_sqlite)却在 CLI 下没启用——这时光改参数没用,得去对应 php.ini 里确认 extension= 行是否取消注释,且 CLI 和 Web 的 php.ini 是两份独立配置。











