1. 入门概览与核心概念
1.1 为什么选择命令行执行 PHP
PHP 命令行接口（CLI） 提供与网页服务器分离的执行环境，适用于自动化、脚本化、数据处理等场景。相比传统 Web SAPI，CLI 运行模型更轻量，启动快，易于重复执行。
核心优势 包括可预测的输出、无浏览器依赖，和对系统资源的更好控制。学习 CLI 的第一步是理解 php 命令 的基本形式以及常用选项。
示例命令用于快速确认环境与版本：
php -v
php --ini
php -m1.2 快速启动的典型工作流
在日常工作中，CLI 脚本可用于数据处理、自动化任务和构建流程。你可以把重复的逻辑写成可执行脚本，在计划任务或钩子中调用。
常见场景包括：文件处理、数据转换、定时任务、持续集成等。理解这些场景有助于你设计更高效的 CLI 程序。
下面给出一个最小化的快速演示，展示无界面输出的基本能力。
php -r 'echo "Hello from CLI\n";'2. 安装与环境配置
2.1 系统与依赖
在不同操作系统上，PHP CLI 的安装路径和包名稍有差异，但核心概念保持一致。系统包管理器负责提供预编译的 php-cli 二进制文件。
常见做法包括通过 apt/yum/homebrew 安装，确保 CLI 二进制可用，并留意依赖的 PHP 模块是否需要单独安装。
# Debian/Ubuntu
sudo apt-get update
sudo apt-get install -y php-cli# CentOS/RHEL
sudo yum install -y php-cli# macOS 使用 Homebrew
brew install php2.2 确认路径与版本
安装完成后，确认可执行文件的位置和版本信息是常见的排错步骤。确保 PATH 正确，以便全局访问 php 命令。
你可以通过这些命令快速定位与核对：
command -v php
php -v
php --ini3. 常用命令与帮助查询
3.1 基本运行模式：执行脚本、单行代码、交互式
PHP CLI 提供多种执行方式，按需选择 -f、-r、-a，以实现不同的编程场景。
常用模式包括：把脚本文件交给 CLI、执行单行代码、进入交互式模式以测试片段。
# 运行脚本文件
php -f /path/to/script.php# 直接执行一段 PHP 代码
php -r '$name = "CLI"; echo "Hello from $name\n";'# 进入交互式解释器
php -a3.2 帮助与信息查询
遇到未知选项或需要快速了解某个特性时，查询帮助信息是第一步。常用命令能够返回版本、配置以及可用模块信息。
下面是标准的帮助与信息查询组合：
php --help
php --ini
php -i | head -n 20
php -m3.3 常用选项与实例
通过覆盖配置参数来解决特定问题，临时覆盖 ini 设置是 CLI 的强大能力之一。
示例演示内存限制控制和简单的代码片段执行：
# 临时提升内存上限
php -d memory_limit=512M -r 'echo ini_get("memory_limit"), PHP_EOL;'# 运行一个脚本文件
php -f /path/to/script.php4. 排错与调试技巧
4.1 常见错误类型与定位要点
CLI 环境中的错误多样，解析错误、致命错误、未定义函数与未加载的扩展是最常见的几类。定位要点包括查看错误信息、检查脚本路径与权限、核对依赖加载顺序。
通过开启错误输出与记录日志，可以迅速定位问题。使用合适的 error_reporting 设置是基础。
第一步往往是快速校验脚本语法或依赖状态。
php -l /path/to/script.php # 语法检查
php -d display_errors=1 -r 'echo "check\n";' # 显示运行时错误4.2 调试工具与日志机制
善用日志输出与调试功能，将错误输出落地到日志文件，有助于长期排错与审计。
常用做法包括临时更改 error_log 路径、使用 trace 信息以及在关键处输出变量内容。
php -d display_errors=1 -d error_log=/tmp/php-error.log -r 'trigger_error("Test notice", E_USER_NOTICE);'4.3 配置、扩展与环境差异
CLI 与 FPM、Web 服务器之间可能存在配置差异，Loaded Configuration File 与模块加载情况直接影响行为。
通过检查配置文件和已加载扩展，可以快速发现缺少模块或错误的配置。
php --ini
php -i | grep -e 'Loaded Configuration File' -e 'extension'5. 进阶用法与性能优化
5.1 调整 CLI 的性能参数
对于需要长时间运行的 CLI 脚本，语言层面的性能参数需要谨慎设置。memory_limit 与 Opcode 缓存都可能影响性能与稳定性。
在某些场景下，使用 -d 启用特定特性，或在启动时采用合适的进程管理方式，可以获得更稳定的运行表现。
# 指定更高的内存上限
php -d memory_limit=1024M /path/to/script.php# 检查当前 Opcode 缓存状态（若开启）
php -i | grep -i opcode5.2 自动化与任务调度实战
将 CLI 脚本接入计划任务或持续集成流，可以实现高效的自动化工作流。Cron 作业、队列工作者、以及 CI 流水线是常见组合。
通过简单的调度设置，你可以在固定时间执行特定的 PHP CLI 脚本，从而实现定期数据处理与报告生成。
# Cron 示例：每小时执行一次
0 * * * * /usr/bin/php /path/to/script.php# 使用队列工作者的常见模式（示意）
php /path/to/worker.php --daemonize