本文详解如何在 macOS 上通过 launchd（配合 .plist 配置文件）替代传统 cron，实现每分钟自动运行 PHP 脚本，涵盖 plist 编写、权限设置、加载调试及关键避坑提示。
本文详解如何在 macos 上通过 `launchd`（配合 `.plist` 配置文件）替代传统 cron，实现每分钟自动运行 php 脚本，涵盖 plist 编写、权限设置、加载调试及关键避坑提示。
在 macOS 系统中，launchd 是官方推荐的守护进程管理机制，比传统 cron 更可靠、更集成，尤其适合用户级定时任务（如每分钟执行一个 PHP 脚本）。与 Linux 的 crontab 不同，launchd 通过 XML 格式的 .plist 文件定义任务行为，支持精确的时间间隔、环境隔离和自动重启等高级特性。
✅ 正确创建 LaunchAgent plist 文件
将以下内容保存为 ~/Library/LaunchAgents/com.yourname.php-minutely.plist（请将 yourname 替换为实际用户名，并确保命名符合反向域名规范）：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.yourname.php-minutely</string>
<key>ProgramArguments</key>
<array>
<string>/usr/bin/php</string>
<string>/Users/yourname/projects/myapp/script.php</string>
</array>
<key>WorkingDirectory</key>
<string>/Users/yourname/projects/myapp</string>
<key>StartInterval</key>
<integer>60</integer>
<key>RunAtLoad</key>
<true/>
<!-- ⚠️ 生产环境默认注释掉；仅调试时启用 -->
<!--
<key>StandardOutPath</key>
<string>/tmp/php-minutely.log</string>
<key>StandardErrorPath</key>
<string>/tmp/php-minutely.err</string>
-->
</dict>
</plist>? 关键字段说明：
- Label：唯一标识符，必须与文件名一致（不含 .plist 后缀）；
- ProgramArguments：不可用 shell -c 包裹，需显式指定 PHP 解释器路径（建议用 which php 确认）及脚本绝对路径；
- WorkingDirectory：确保脚本内相对路径（如 include 'config.php';）能正确解析；
- StartInterval 60：严格按秒计时，每 60 秒触发一次（非“每分钟整点”）；
- RunAtLoad：系统登录后立即启动，避免首次延迟。
? 设置权限并加载任务
# 设置标准权限（644 是 launchd 强制要求） chmod 644 ~/Library/LaunchAgents/com.yourname.php-minutely.plist # 验证权限（应显示 -rw-r--r--） ls -l ~/Library/LaunchAgents/com.yourname.php-minutely.plist # 加载配置（无需 sudo，因属用户级 LaunchAgent） launchctl load ~/Library/LaunchAgents/com.yourname.php-minutely.plist # ✅ 可选：立即手动触发一次测试 launchctl start com.yourname.php-minutely
? 提示：若加载失败，运行 launchctl list | grep yourname 查看是否已注册；错误日志可通过 console.app 搜索 com.yourname.php-minutely 实时追踪。
立即学习“PHP免费学习笔记（深入）”；
⚠️ 必须注意的实践要点
- 路径必须为绝对路径：ProgramArguments 和 WorkingDirectory 均不支持 ~ 或 $HOME，务必使用 /Users/username/... 形式；
- PHP 可执行路径需准确：macOS 自带 PHP 已弃用，若使用 Homebrew 安装（如 php@8.2），路径通常为 /opt/homebrew/bin/php（Apple Silicon）或 /usr/local/bin/php（Intel），请先执行 which php 确认；
-
日志策略至关重要：
- 调试阶段可临时启用 StandardOutPath/StandardErrorPath 输出到 /tmp/；
- 上线前必须注释掉这两行——否则每分钟追加日志将快速填满磁盘，甚至导致系统卡顿（尤其在无日志轮转机制时）；
- 脚本健壮性检查：确保 PHP 脚本本身具备错误处理（如 set_error_handler()）、超时控制（set_time_limit(30)）及幂等逻辑，避免重复执行引发数据异常；
-
环境变量差异：launchd 默认不加载 shell profile（如 .zshrc），若脚本依赖自定义 PATH 或环境变量，需在 plist 中显式声明：
<key>EnvironmentVariables</key> <dict> <key>PATH</key> <string>/opt/homebrew/bin:/usr/bin:/bin</string> </dict>
✅ 验证与维护
- 查看任务状态：launchctl list | grep php-minutely（PID 非 0 表示正在运行）；
- 查看最近执行日志（通过 Console.app 过滤 com.yourname.php-minutely）；
- 修改 plist 后，需先 unload 再 load 才生效：
launchctl unload ~/Library/LaunchAgents/com.yourname.php-minutely.plist launchctl load ~/Library/LaunchAgents/com.yourname.php-minutely.plist
通过以上步骤，你已构建了一个稳定、可维护、符合 macOS 最佳实践的分钟级 PHP 定时任务系统。相比 cron，launchd 具备更好的资源感知能力、会话生命周期绑定及统一诊断接口，是现代 macOS 自动化任务的首选方案。
