PHP命令行执行方式讲解_PHP CLI模式基础使用教程

PHP CLI模式专用于命令行脚本，需确认php -v显示(cli)，通过which php和php -r "echo PHP_SAPI;"验证；支持php script.php、php -r、php -a三种执行方式，与Web环境在输出缓冲、$_SERVER、ini配置及超时限制上存在关键差异。

PHP 不仅能跑在 Web 服务器上，还能直接通过命令行（CLI）运行脚本，适合写定时任务、数据处理、本地开发工具等。关键在于用对 PHP 的 CLI SAPI（Server API），而不是误用 CGI 或 Web 服务器环境。

确认你用的是 CLI 版本

执行 php -v 查看版本时，末尾应显示 (cli)，例如：
PHP 8.2.12 (cli) (built: Sep 26 2025 14:12:33)
如果显示 (cgi-fcgi) 或没标 cli，说明可能调用了错误的二进制文件（比如系统 PATH 混淆了多个 PHP 安装）。可用 which php 和 php -r "echo PHP_SAPI;" 双重验证。

三种常用 CLI 执行方式

• 运行 PHP 文件：直接传入 .php 脚本路径，如 php script.php。脚本内无需 shebang（但加了也不影响），PHP CLI 会自动忽略第一行 #! 开头的内容。
• 执行单行代码：用 -r 参数，例如 php -r "echo date('Y-m-d');"。注意双引号内变量会被 shell 展开，建议用单引号包裹 PHP 代码。
• 交互式模式：运行 php -a 进入 REPL，可逐行输入 PHP 代码并即时执行（PHP 7.4+ 支持更完善的语法高亮和历史记录）。

CLI 模式与 Web 模式的几个关键差异

• 默认关闭输出缓冲：echo 会立即打印，不需 ob_flush()；但若需控制输出节奏，仍可手动启用。
• $_SERVER 变量不同：没有 REQUEST_METHOD、HTTP_HOST 等 Web 相关键，但有 argv（参数数组）、argc（参数个数）、SCRIPT_FILENAME 等 CLI 专属项。
• ini 设置可能不同：CLI 使用独立的 php.ini（常为 php.ini-development 或 php-cli.ini），可通过 php --ini 查看加载路径，php -i | grep memory_limit 查具体配置。
• 自动终止无超时限制：CLI 默认 max_execution_time = 0（不限时），适合长时间运行脚本，但也要注意内存泄漏风险。

实用小技巧

• 用 php -l script.php 快速语法检查，不执行只报错。
• 用 php -f script.php arg1 arg2 显式指定文件，并向 $argv 传参（$argv[0] 是脚本名，$argv[1] 起才是自定义参数）。
• 脚本开头加 #!/usr/bin/env php 并 chmod +x script.php 后，可直接 ./script.php 运行（依赖系统正确识别 shebang）。
• 重定向输出很自然：php task.php > log.txt 2>&1 把标准输出和错误都存入文件。

基本上就这些。CLI 模式不复杂但容易忽略环境差异，确认 sapi 类型、善用参数、留意配置隔离，就能稳定写出靠谱的命令行脚本。