PHPCLI模式运行方法及环境要求

想让PHP脚本在命令行下顺利运行？关键在于满足三个硬性条件：系统必须安装独立的php-cli包（而非仅Web模块），CLI专用的php.ini需启用脚本所需扩展（如pdo_mysql），且脚本首行必须写对Shebang（#!/usr/bin/env php）；许多用户踩坑正是因为误以为装了PHP就能跑CLI——实际上Ubuntu等系统默认不带CLI、CLI与Web配置完全隔离、扩展需单独开启，三者缺一不可。

PHP CLI 模式能运行的前提是二进制文件本身可用

不是所有 PHP 安装都自带可执行的 php 命令。很多 Linux 发行版（比如 Ubuntu）把 CLI 和 Apache/FPM 模块拆成不同包，只装 php-fpm 或 libapache2-mod-php 是不够的。
必须确认系统 PATH 中存在且可执行：

which php
php -v

如果报 command not found，说明 CLI 版本根本没装。Ubuntu/Debian 下要装 php-cli 包；CentOS/RHEL 8+ 需装 php-common + php-cli（或直接 dnf install php）。

CLI 模式默认禁用某些扩展和配置项

PHP CLI 和 Web SAPI（如 Apache）使用不同的 php.ini 文件，路径通常不一致：

php --ini

常见差异包括：

• display_errors = On（CLI 默认开，Web 默认关）
• extension=opcache.so（CLI 默认不加载，避免干扰脚本调试）
• max_execution_time = 0（CLI 默认不限时，Web 默认 30 秒）

如果你的脚本依赖 pdo_mysql 却报 Class 'PDO' not found，先检查 CLI 的 php.ini 是否启用了对应 extension，而不是复用 Web 的配置。

脚本开头必须有正确的 Shebang（Linux/macOS）

想直接 ./script.php 运行，第一行必须是 Shebang，且指向真实 PHP CLI 可执行路径：

#!/usr/bin/env php
<?php echo "Hello CLI\n";

注意：

• 不能写成 #!/usr/bin/php —— 路径可能因系统而异；/usr/bin/env php 更可靠
• 文件需加执行权限：chmod +x script.php
• Windows 不认 Shebang，直接用 php script.php
• Shebang 行末不能有多余空格或 BOM，否则报 bad interpreter

CLI 模式下 $_SERVER 和输出行为与 Web 不同

很多框架或老代码依赖 $_SERVER['DOCUMENT_ROOT'] 或 $_SERVER['REQUEST_URI']，这些在 CLI 下是空或未定义的，直接访问会触发 Notice。另外：

• echo / var_dump() 输出直接到终端，不会被 Web 服务器缓冲或截断
• CLI 没有输出缓冲自动刷新，大日志写入建议显式 flush() 或用 file_put_contents(..., FILE_APPEND)
• readline()、fgets(STDIN) 才是标准输入方式，$_GET/$_POST 全为空

一个典型坑：用 header("Location: ...") 重定向 —— CLI 下会直接报 Warning，因为无 HTTP 上下文。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。