macOS Ventura已移除系统自带PHP，php -v报command not found属正常；需用Homebrew安装并正确配置PATH，运行脚本须用绝对路径，CLI与Web使用不同php.ini，定时任务推荐launchd而非cron。
macOS Ventura（2022年发布）已彻底移除系统自带的 PHP，php -v 报 command not found 是正常现象，不是你漏装了什么——它本来就没有。
确认 PHP 是否真的可用
很多人输完 php /path/to/script.php 报错，第一反应是脚本写错了，其实卡在第一步：终端根本没找到 php。
- 先运行
php -v；如果返回版本号（如PHP 8.3.12），说明已就绪 - 如果提示
command not found，别急着重装，先查路径：which php - Homebrew 安装的 PHP 在 Apple Silicon Mac 上路径通常是
/opt/homebrew/bin/php，Intel 是/usr/local/bin/php - 检查
~/.zshrc是否含export PATH="/opt/homebrew/bin:$PATH"（Ventura 默认 shell 是 zsh） - 改完必须执行
source ~/.zshrc，否则新开终端才生效
直接运行单个 PHP 文件的命令格式
只要 php 命令能识别，运行脚本就是最直白的一行：
php /Users/yourname/project/test.php
- 务必用绝对路径，比如
/Users/yourname/project/test.php，不能只写test.php（除非当前目录就是脚本所在目录） - 脚本开头不需要
#!/usr/bin/env php—— 这行只对可执行文件 +chmod +x有效，CLI 下手动调用时完全无关 - 如果脚本依赖扩展（如
curl、mbstring），运行时报Call to undefined function，说明 CLI 模式下该扩展未启用；执行php -m | grep curl确认，再查php --ini对应的php.ini路径，打开后取消对应extension=行的注释
定时运行 PHP 脚本：优先用 launchd，别碰 cron
macOS Ventura 对 cron 的支持已弱化，且环境变量不一致（尤其 Homebrew PHP 的路径在 cron 里常失效），官方推荐方案是 launchd。
立即学习“PHP免费学习笔记（深入）”；
- 创建
~/Library/LaunchAgents/com.yourname.sync.plist -
ProgramArguments里必须写明完整 PHP 路径，例如/opt/homebrew/bin/php，不能只写php -
WorkingDirectory设为脚本所在目录，避免require相对路径出错 - 用
launchctl load ~/Library/LaunchAgents/com.yourname.sync.plist加载，再用launchctl start com.yourname.sync手动触发一次验证 - 日志输出要显式配置：在 plist 中加
StandardOutPath和StandardErrorPath，否则失败时无声无息
常见错误和绕不开的坑
很多问题表面是 PHP 报错，实际是 macOS Ventura 的权限或路径机制在作祟。
-
Permission denied运行脚本？不是文件没chmod +x，而是脚本里用了shell_exec('ls')类函数——Ventura 默认禁用完全访问磁盘权限，需到「系统设置 → 隐私与安全性 → 完全磁盘访问」里给「终端」打勾 -
file_get_contents(): failed to open stream读本地文件？确认路径是绝对路径，且 PHP 进程有权限读取该目录（尤其~/Downloads或~/Desktop受沙盒限制） - Web 服务器（如 MAMP）能跑通的脚本，CLI 下报错？因为 Web 和 CLI 使用不同
php.ini，执行php --ini查清楚到底加载了哪个配置文件 - 脚本里用了
$_SERVER['DOCUMENT_ROOT']？CLI 模式下这个变量不存在，会 Notice，别依赖它
Ventura 下 PHP 运行的核心矛盾从来不是语法或逻辑，而是“谁在哪个上下文里、用哪套环境、以什么权限调用它”。把 php --ini、which php、launchctl list 这三招记牢，90% 的“跑不起来”都能当场定位。
