FrankenPHP 容器化部署 Symfony 项目完整配置-php教程-PHP中文网

根本原因是frankenphp默认以www-data用户运行，而symfony的var/cache和var/log目录未预设正确属主权限，导致写入失败；需在dockerfile中提前执行mkdir -p /app/var/cache /app/var/log && chown -r www-data:www-data /app，并确保挂载整个项目目录而非仅public/。

frankenphp 容器化部署 symfony 项目完整配置

FrankenPHP 容器启动时为什么 Symfony 报 `file_put_contents(/app/var/cache/prod/App_KernelProdContainer.php): failed to open stream`

根本原因是 FrankenPHP 的默认容器镜像以非 root 用户（www-data）运行，而 Symfony 的 var/cache 和 var/log 目录在首次构建时未预设正确属主和权限，导致运行时写入失败。

解决方式不是改用户，而是提前初始化目录权限：

在 Dockerfile 中添加 RUN mkdir -p /app/var/cache /app/var/log && chown -R www-data:www-data /app/var
确保 docker-compose.yml 挂载的是整个项目目录（./:/app），而非只挂载 public/；否则 var/ 不在容器内，缓存根本无法生成
不要依赖 symfony console cache:warmup 在容器启动后执行——FrankenPHP 启动即服务，必须在 ENTRYPOINT 前完成缓存预热

如何让 FrankenPHP 正确加载 Symfony 的环境变量和 `.env` 文件

FrankenPHP 默认不读取 .env，它依赖 PHP 的 getenv() 或 $_SERVER，而 Symfony 的 Dotenv 组件需显式启用。常见错误是环境变量全为 null，数据库连不上、密钥为空。

关键操作有两处：

在 public/index.php 顶部（use 语句前）插入：

if (file_exists(dirname(__DIR__).'/config/bootstrap.php')) {
    require dirname(__DIR__).'/config/bootstrap.php';
}

这行确保 Dotenv 被加载

在 docker-compose.yml 的 FrankenPHP 服务中，用 environment: 显式传入必要变量（如 APP_ENV=prod, APP_SECRET, DATABASE_URL），或挂载 .env 到容器内并设 DOTENV_FILE=/app/.env
注意：生产环境禁用 Dotenv::createUnsafeImmutable()，应改用 Dotenv::createMutable() 并确保 .env 不被 Web 访问（FrankenPHP 默认禁止访问 .env，但要检查 public/ 外路径是否暴露）

`docker run -v .:/app/public` 为什么会导致 Symfony 路由 404

这是 FrankenPHP 官方文档里最易误导的写法。挂载 ./:/app/public 实际把整个项目根目录（含 src/, config/, var/）都压到了 /app/public 下，Symfony 找不到 config/ 和 src/，自动 fallback 到默认路由或报错。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

正确挂载方式必须分层：

-v $(pwd):/app：挂整个项目到 /app（保持原始结构）
-v $(pwd)/public:/app/public：单独覆盖 public 目录（可选，仅当需动态替换静态资源）
同时在容器启动命令中指定入口点：frankenphp php-server --document-root /app/public
如果你用的是 dunglas/frankenphp 镜像，它默认 document-root 就是 /app/public，所以只需确保 /app/public 存在且含 index.php

生产环境启用 HTTPS 和 HTTP/3 后，Symfony 的 `url()` 生成链接仍是 `http://`

FrankenPHP 自动处理 TLS 终止，但 Symfony 不知道请求来自 HTTPS，仍按 $_SERVER['HTTP_X_FORWARDED_PROTO'] 或 $_SERVER['HTTPS'] 判断协议。若没透传，所有生成 URL 都是 http。

必须配置反向代理信任：

在 config/packages/framework.yaml 中设置：

framework:
    trusted_proxies: '**'
    # 或更安全的：'172.16.0.0/12,192.168.0.0/16'

确保 FrankenPHP 容器或前置 Caddy/Nginx 设置了 X-Forwarded-Proto: https 头（Docker 镜像默认已设，但自定义 Caddyfile 需手动加 header_up X-Forwarded-Proto https）
验证方式：在控制器中 dump $request->getSchemeAndHttpHost()，应返回 https://example.com 而非 http://example.com

FrankenPHP 对 Symfony 的支持很直接，但它的“零配置”假定和 Symfony 的目录约定之间存在几处隐性冲突，最容易卡在缓存权限和环境变量加载上。别跳过 chown 和 bootstrap.php 这两步——它们不是可选项，是 FrankenPHP + Symfony 能跑通的硬性前提。