php脚本在命令行终端下如何运行-php教程-PHP中文网

php脚本执行失败主因是环境配置问题而非语法错误，需依次验证cli可用性、php路径、权限、路径格式及编码，并正确处理参数。

php脚本在命令行终端下如何运行

php 命令能直接运行脚本，但失败往往不是因为语法错，而是环境没配好、权限没给足、路径写错了——先确认 CLI 可用，再谈执行。

检查 `php --version` 是否可用

终端里敲 php --version 没输出？说明系统根本没装 CLI 版 PHP，或者它不在 PATH 里。
常见现象：command not found 或 bash: php: command not found。
解决办法：
• Linux/macOS：用 which php 查路径；空返回就装 php-cli（Ubuntu/Debian 用 sudo apt install php-cli，CentOS/RHEL 用 sudo dnf install php-cli）
• Windows：确认 php.exe 所在目录已加进系统 PATH，且 PATHEXT 包含 .PHP

用 `php` 显式调用脚本（最稳的方式）

不依赖 Shebang，也不怕容器或共享主机里 PATH 不一致。
必须用绝对路径，避免相对路径在 crontab 或不同工作目录下失效：
• 先查 PHP 位置：which php（比如返回 /usr/bin/php）
• 再跑脚本：/usr/bin/php /var/www/scripts/backup.php
• 加日志重定向：/usr/bin/php /var/www/scripts/backup.php > /var/log/backup.log 2>&1
注意：2>&1 要写在最后，否则 stderr 不会进日志；> 是覆盖写，要用追加就写 >>

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

加 Shebang 并 `chmod +x` 后直接运行

想写成 ./backup.php 这样跑？可以，但有硬性条件：
• 第一行必须是 #!/usr/bin/env php，且不能有任何空格、BOM、空行
• 文件保存为 UTF-8 无 BOM 格式（VS Code 默认可能带 BOM，需手动改）
• 执行 chmod +x backup.php，否则 Permission denied
• 运行前确保当前目录正确：cd /path/to/script && ./backup.php
坑点：Docker 容器里 /usr/bin/env 可能不存在，这时得硬写 #!/usr/bin/php，并确认该路径真实存在

传参和读参：别漏掉 `$argv[0]` 是脚本名

php script.php arg1 arg2 之后，$argv 是数组：
• $argv[0] = "script.php"（不是第一个参数）
• $argv[1] = "arg1"，$argv[2] = "arg2"
• $argc = 3（总长度，含脚本名）
常见误操作：
• 把 $argv[1] 当作脚本名，导致逻辑错
• 参数含空格时没加引号，被 shell 拆开成多个参数
• 用 -f 选项（php -f script.php）其实是冗余的，默认就走 -f，不用显写