macos上frankenphp v1.4开机自启必须用launchd：在~/library/launchagents/下创建com.frankenphp.server.plist，正确配置label、programarguments（含--config路径）、workingdirectory、runatload、keepalive及path环境变量，执行launchctl load/start/enable后重启验证。
macOS上FrankenPHPv1.4怎么实现开机自启动
macOS不支持systemd，也无法像Linux那样用service文件注册系统级服务，FrankenPHP v1.4在macOS上要实现开机自启动，必须借助launchd机制——这是苹果官方推荐且唯一可靠的用户/系统级守护进程管理方案，手动写shell脚本或放登录项都不可靠、不持久、不安全。
创建plist配置文件
在~/Library/LaunchAgents/目录下新建文件com.frankenphp.server.plist（注意路径必须是当前用户目录下的LaunchAgents，不能放在/Library/LaunchDaemons/除非你明确要用root权限运行）。
内容如下（请严格复制，路径、参数、标签大小写均不可错）：
【yourusername必须替换成你真实的macOS用户名】；【Caddyfile路径和WorkingDirectory必须指向你实际的项目根目录，且该目录下必须存在合法Caddyfile】；否则launchd加载后会静默失败，连日志都不写。
加载并启用服务
执行命令加载配置：launchctl load ~/Library/LaunchAgents/com.frankenphp.server.plist
立即启动服务：launchctl start com.frankenphp.server
检查是否运行中：launchctl list | grep frankenphp → 若输出含该label且PID非“-”，说明已成功运行。
若返回空或报错，不要反复重试，先查日志：tail -n 20 /Users/yourusername/myapp/logs/frankenphp.stderr.log。常见错误是Caddyfile语法错、端口被占、或frankenphp二进制仍被Gatekeeper拦截——此时需先用右键“打开”方式运行一次再试。
验证开机自启是否生效
第一步：执行launchctl enable gui/$(id -u)/com.frankenphp.server。这步必不可少，否则即使RunAtLoad设为true，重启后也不会自动拉起。
第二步：重启Mac，等待约30秒后，在终端运行launchctl list | grep frankenphp，确认PID为正整数。
第三步：访问http://localhost:8000（或你Caddyfile里定义的地址），页面能正常响应即表示成功。
注意：launchd默认不会继承GUI环境变量（比如Homebrew路径），所以plist里必须显式声明PATH，否则可能报frankenphp: command not found。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
