frankenphp在macos上设worker数需分清两种模式：http线程池模式用php_server的num_threads（如设6），独立worker进程模式则需为每个worker创建launchd plist文件并指定不同端口，二者互斥且不可混用。
在 macOS 上为 FrankenPHP v1.3 设置 worker 进程数量，必须明确区分两种完全不同的运行模式：一种是 HTTP 请求处理线程数（由 php_server 或全局 frankenphp 指令控制），另一种是 后台常驻 worker 进程数（由 frankenphp-worker 命令启动的独立进程）。二者不能混用，配置位置、生效方式和验证手段均不相同。
确认当前使用的是哪种模式
打开你的 Caddyfile，检查是否存在以下任一结构：
—— 若有 php_server 或 php 指令（例如 php_server { num_threads 4 }），你走的是 HTTP 线程池模式，此时“worker 数量”实为 PHP 执行线程数，由 num_threads 控制；
—— 若 Caddyfile 中无 php_server，但你通过终端手动执行了类似 frankenphp-worker --script /path/to/worker.php --addr :8081 的命令，则你启用的是 独立 worker 进程模式，此时 worker 数量 = 你手动启动的进程个数。
两者互斥。macOS 上无法用单条命令启动多个 worker 进程，【--script 只接受一个绝对路径，传多个会报 unknown flag: --script】。
HTTP 线程池模式：设置 php_server 的 num_threads
这是最常用、也最符合 macOS 开发习惯的方式。适用于 Web 请求处理（如 Laravel、CodeIgniter 的 HTTP 入口）。
第一步：编辑 Caddyfile，在匹配 PHP 路径的 server 块内添加 php_server 指令，并显式指定 num_threads：
localhost:8000 {<br> root * ./public<br> php_server {<br> num_threads 6<br> }<br> try_files {path} /index.php?<br>}
第二步：保存后重启 Caddy：sudo brew services restart caddy（若用 Homebrew 安装）或 pkill caddy && caddy run（若前台运行）。
注意：不要写 workers.count —— 这是旧版或 Go API 层参数，Caddyfile 中无效；macOS 上 num_threads 是唯一合法字段。设为 6 是针对 4 核 M1/M2 Mac 的推荐起步值，兼顾响应与内存（假设 memory_limit=128M，6×128M ≈ 768MB，远低于 macOS 默认可用内存）。
独立 worker 进程模式：用 systemd 或 launchd 启动多个 frankenphp-worker
仅当你需要长期运行后台任务（如队列监听、定时推送）时才用此模式。macOS 原生不支持 systemd，必须改用 launchd。
方法一：为每个 worker 创建独立的 .plist 文件
在 ~/Library/LaunchAgents/ 下新建文件 dev.frankenphp.queue.plist：
<?xml version="1.0" encoding="UTF-8"?><br><br><plist version="1.0"><br><dict><br> <key>Label</key><br> <string>dev.frankenphp.queue</string><br> <key>ProgramArguments</key><br> <array><br> <string>/opt/homebrew/bin/frankenphp-worker</string><br> <string>--script</string><br> <string>/var/www/myapp/queue-worker.php</string><br> <string>--addr</string><br> <string>:8081</string><br> </array><br> <key>RunAtLoad</key><br> <true></true><br> <key>KeepAlive</key><br> <true></true><br></dict><br></plist>
方法二：加载并启动
执行：launchctl load ~/Library/LaunchAgents/dev.frankenphp.queue.plist → launchctl start dev.frankenphp.queue。
要启第二个 worker（如邮件推送），复制该 plist，改 Label、--script 绝对路径、--addr 端口（如 :8082），再 load + start。每个 plist 对应一个独立 worker 进程，总数即为你创建的 plist 文件数。
【--script 必须是绝对路径，相对路径会导致 failed to open stream】。macOS 上没有全局工作目录概念，frankenphp-worker 不会自动切换到项目根目录。
验证当前 worker/线程数量是否生效
运行：ps aux | grep frankenphp，观察输出行数：
—— 若只看到 1 行含 caddy run 或 caddy start，且无 frankenphp-worker，说明你处于 HTTP 线程池模式，此时线程数不体现为独立进程，需查指标；
—— 若看到多行 frankenphp-worker --script ...，行数即为你启动的 worker 进程数；
HTTP 模式下查真实线程负载：先确认 Caddyfile 启用了 { prometheus :9100 }，再执行：curl http://localhost:9100/metrics 2>/dev/null | grep -E "(frankenphp_busy_threads|frankenphp_total_threads)"。输出中 frankenphp_total_threads 的值应等于你在 php_server 中设置的 num_threads。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
