FrankenPHP开发模式默认监听localhost:8000，生产环境则由Caddy接管并强制使用80/443端口，支持HTTPS与HTTP/3。
开发环境用 php-server 默认监听 :8000
FrankenPHP 的 php-server 子命令专为本地开发设计，启动后默认绑定 http://localhost:8000，不依赖外部代理或 TLS。你只需确保项目里有 index.php（比如放在 public/ 下），然后运行：
frankenphp php-server --document-root public
常见问题包括：
-
listen tcp :8000: bind: address already in use：说明端口被占，加--addr :8001换一个即可 - 返回 404：大概率是
--document-root指错了路径，Laravel/Symfony 必须指向public/，不是项目根目录 - curl 测试时没看到
Server: FrankenPHP响应头：说明请求没走到 FrankenPHP，可能本地还开着 Apache/Nginx 占了 80 端口
生产环境靠 Caddy 自动管理端口，80 和 443 是刚需
FrankenPHP 生产部署不直接暴露 php-server，而是通过内置的 Caddy 作为前置服务器——它自动处理 HTTPS、HTTP/3、ACME 证书申请等。此时端口由 Caddy 控制，不是 FrankenPHP 自己选的。
必须开放的端口只有两个（阿里云安全组/防火墙里要放行）：
立即学习“PHP免费学习笔记（深入）”；
-
80（TCP）：用于 Let's Encrypt 的 HTTP-01 验证，即使你只跑 HTTPS 也得开着 -
443（TCP + UDP）：HTTPS 和 HTTP/3 流量入口；UDP 是 HTTP/3 必需的
如果你在 Caddyfile 里写了 example.com:8080 这种自定义端口，Caddy 仍会尝试从 80/443 接入再反向代理过去，但对外服务端口仍是 80/443 ——除非你主动关掉自动 HTTPS 并改用 SERVER_NAME=:8080 强制降级，那就不走 Caddy 的 TLS 逻辑了。
worker 模式下每个实例得手动指定 --addr，别撞端口
当你用 frankenphp-worker 启多个后台任务（比如一个跑队列、一个跑通知），每个 worker 实例是独立进程，必须各自绑定不同端口，否则第二个会因地址冲突退出。
正确做法是显式传参：
frankenphp-worker --script /var/www/queue.php --addr :8081
frankenphp-worker --script /var/www/notify.php --addr :8082
注意点：
-
--addr值必须带冒号前缀，如:8081，写成8081会报错 - 这些端口只供内部调用或调试用，**不要开放到公网**；真正对外的服务仍走 Caddy 的 80/443
- 如果用 systemd 或 supervisor 管理，记得在 service 文件里写死
--addr，避免重启后随机分配
Docker 部署时端口映射别写反：宿主机 80 → 容器内 80，不是 8000
Docker 官方镜像 dunglas/frankenphp 内置 Caddy，默认监听容器内的 :80 和 :443，不是开发模式的 :8000。所以 docker run 或 compose.yaml 里必须这样映射：
- "80:80"
- "443:443"
写成 - "8000:80" 就会导致外部无法访问，因为 Caddy 根本没在容器里监听 8000。另外，HTTP/3 要求 UDP 映射也得加上：
- "443:443/udp"
容易忽略的是：Caddy 的证书存储路径（/data）和配置（/config）必须挂载为 volume，否则每次重启都得重申请证书，而且跨容器无法复用。
端口这事表面是数字配置，实际牵扯到 FrankenPHP 的运行模式切换、Caddy 的生命周期、以及网络层暴露策略。开发时图省事用 :8000 没问题，一旦进生产，就得按 Caddy 的规则来——它不接受“我只想开 8080”，除非你主动放弃自动 HTTPS 和 HTTP/3。
