frankenphp不支持单实例多站点虚拟主机配置，必须区分两类场景：web站点共用一个进程（靠caddy多server块按域名路由），后台任务需多个独立worker实例（各绑定唯一端口和绝对路径脚本）。
FrankenPHP 本身不支持“单实例多站点”的传统虚拟主机式配置，它没有内置的域名路由或多租户 worker 管理能力。所谓“多站点”，实际分两类场景：一类是多个 Web 应用（如 Laravel、Symfony、静态前端）共存于同一 FrankenPHP 进程，靠 Caddy 的 多 server 块 实现；另一类是多个长期运行的后台任务（如队列消费者、定时推送），必须通过 多个独立 worker 实例 隔离部署。两者技术路径完全不同，不能混用。
一、多个 Web 站点共用一个 FrankenPHP 进程（推荐用于 HTTP 服务）
这是最常见也最轻量的方式。所有站点共享同一个 PHP 线程池和 Caddy 服务器，由 Caddy 根据 Host 头匹配不同 server 块，再各自指向对应项目的 public/ 目录。
- 在项目根目录创建 Caddyfile，每个站点一个 server 块，例如：
{
frankenphp
}
<p>site-a.com {
root * /var/www/site-a/public
php_server
encode zstd br gzip
}</p><p>site-b.com {
root * /var/www/site-b/public
php_server
encode zstd br gzip
}</p><h1>可选：本地开发用 localhost 支持多域名</h1><p>localhost {
respond "Use site-a.com or site-b.com in your hosts file"
}</p>
- 确保每个站点的 public/ 目录可读，且 index.php 能正常响应 200
- 如果站点是前后端分离结构（如 Vue + Symfony API），可在同一域名下用路径区分：
your-domain.com {
# 前端静态资源
handle { try_files {path} /index.html }
<pre class="brush:php;toolbar:false;"># 后端 API 接口
handle /api/* /login /logout {
root * /var/www/backend/public
php_server
}}
二、多个后台 Worker 任务隔离部署（仅用于常驻进程）
如果你需要为不同站点运行各自的队列监听器、定时任务或长连接服务，FrankenPHP 不允许在一个命令里启动多个 --script。必须为每个任务单独启动一个 worker 进程，并用 systemd 或 supervisor 管理。
- 每个 worker 实例需满足三个硬性条件：
– 绑定唯一端口（--addr :8081、:8082）
– 指向绝对路径脚本（--script /var/www/site-a/worker.php）
– 输出独立日志（避免混杂） - 以 systemd 为例，新建 /etc/systemd/system/frankenphp-site-a.service：
[Unit] Description=FrankenPHP Worker for Site A After=network.target <p>[Service] Type=simple User=www-data WorkingDirectory=/var/www/site-a ExecStart=/usr/local/bin/frankenphp worker --addr :8081 --script /var/www/site-a/worker.php Restart=always RestartSec=10 MemoryMax=256M StandardOutput=journal StandardError=journal SyslogIdentifier=frankenphp-site-a</p><p>[Install] WantedBy=multi-user.target</p>
- 启用并启动：
systemctl daemon-reload && systemctl enable --now frankenphp-site-a - 查看日志：
journalctl -u frankenphp-site-a -f
三、生产部署关键注意事项
无论哪种方式，上线前都必须完成以下动作，否则可能启动失败或暴露风险：
- 清理构建环境：删除 .git、tests/、storage/logs、vendor/bin/、.env.local 等非运行必需文件
-
固化配置：确保 .env 中
APP_ENV=prod、APP_DEBUG=false；Laravel/Symfony 运行config:clear和view:clear -
生成优化自动加载器：
composer dump-autoload --optimize --no-dev -
HTTPS 域名必须真实解析：使用
frankenphp build --server-name site-a.com，否则 Let's Encrypt 申请失败 - 端口开放不可省略：服务器防火墙需放行 TCP 80/443 和 UDP 443（HTTP/3）
四、常见误区澄清
很多用户会误以为可以“让 Caddy 把 site-a.com 的请求转发给某个 worker 端口”，这是不成立的：
- php_server 是 HTTP 请求处理器，运行在主线程池中，处理浏览器发来的请求
- frankenphp worker 是后台常驻进程，不接收任何 HTTP 请求，只执行你写的 PHP 脚本逻辑（如 while(true) { consume(); sleep(1); }）
- 两者不在同一抽象层，Caddy 无法也不应该把 HTTP 流量“代理”给 worker 进程
- 若需跨站点触发逻辑（如 site-a 的 worker 要通知 site-b 的业务），必须通过 Redis、数据库 NOTIFY 或 HTTP API 显式通信
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
