第1节：Mac 环境准备与验证
确认系统自带 PHP 与版本状态
要在 Mac 的终端运行 PHP 脚本，首先需要确认系统自带的 PHP 版本以及可执行路径是否可用。执行命令 php -v 可以看到版本信息、版权和编译信息，帮助判断是否具备 CLI 支持。若显示“command not found”或版本信息异常，则说明 PATH 配置或系统自带的 PHP 组件需要调整。通过 which php 可以定位当前系统选择的 PHP 可执行文件位置，如 /usr/bin/php。
此外，运行 php -i | head -n 5 可以快速查看 PHP 的核心配置项，确保 CLI 模式可用。同时记录下当前 PATH 的状态，以便后续添加第三方版本。
使用 Homebrew 安装或升级 PHP 的要点
如果需要较新版本的 PHP 或更灵活的版本管理，通过 Homebrew 安装 PHP 是常见做法。先确保系统已经安装了 Homebrew，然后执行以下步骤来安装指定版本的 PHP，并将其设为默认执行版本。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update
brew install php@8.2
brew link --overwrite --force php@8.2
安装完成后，请确保 PATH 中包含了对应版本的二进制目录，例如 /usr/local/opt/php@8.2/bin，并在你的 shell 配置文件（如 .zshrc 或 .bash_profile）中添加如下条目：export PATH="/usr/local/opt/php@8.2/bin:$PATH"，然后重新打开终端以生效。
第2节：在 Terminal 运行 PHP 脚本的基本流程
编写一个简单的 CLI PHP 脚本
为了快速验证环境与运行能力，可以编写一个最简单的 CLI 脚本并直接在终端执行。将下面的内容保存为 hello.php，脚本使用 包裹代码。该脚本用于输出提示信息，帮助确认 PHP CLI 的基本执行能力。
在实际运行时，你可以为该脚本添加可执行权限并直接执行，第一行的 shebang（如 #!/usr/bin/env php）可让脚本直接以可执行文件方式运行，提升使用便利性。
要把它作为普通命令运行，你需要为脚本赋予执行权限并指定完整路径，例如：chmod +x hello.php，然后使用 ./hello.php 来执行。
通过命令行解释运行单独的 PHP 代码
如果只是临时执行少量 PHP 代码，不需要保存成文件，可以使用 CLI 的 -r 选项，直接在命令行中运行。-r 选项允许直接执行 PHP 片段，适合快速测试一段逻辑。
php -r 'echo "Current time: " . date("Y-m-d H:i:s") . PHP_EOL;'请注意 引号与分号的正确闭合，以避免语法错误；该方法适合进行短小片段的验证和快速迭代。
第3节：实操要点：路径、参数与错误处理
脚本路径与工作目录的注意
在 CLI 模式下，脚本运行时的工作目录会直接影响相对路径的解析。__DIR__ 常量 可以返回当前脚本所在的目录，帮助你编写对路径独立的代码。通过在脚本内记录启动时的工作目录，可以快速定位文件读写位置。
如果需要对工作目录进行动态切换，请使用 chdir()，但应在切换失败时做适当回退，并最好将路径改为绝对路径以提升可移植性。
传参与环境变量
通过命令行传参是日常需求之一，$argv 数组用于接收参数，其中 $argv[0] 是脚本名。你可以利用 foreach、list() 等方式来解析参数，提升脚本的通用性。
除了命令行参数，环境变量在 CLI 模式下也很常用，$_ENV 或 getenv() 能访问到配置项，例如数据库连接字符串、API 令牌等。
日志与错误输出
良好的日志与错误处理策略是稳定运行的关键。error_reporting(E_ALL) 和 ini_set('display_errors', 1) 可以在开发阶段开启完整错误输出，生产环境则倾向于输出到日志文件。
执行时还可以把输出重定向到文件以便后续分析，例如 php script.php > output.log 2>&1，其中 2>&1 将错误输出重定向到同一日志文件，方便排错与追溯。
