搭建Symfony 7.4.21线上应用需四步闭环：一、安装PHP 8.2并启用intl、mbstring、xml、pdo_mysql、opcache、zip扩展；二、用composer create-project symfony/skeleton指定7.4版本，设APP_ENV=prod执行composer install --no-dev；三、Nginx根目录指向public/并配置front controller伪静态；四、chown www-data:www-data var/、预热缓存、校验路由及数据库。
要搭建一个可线上部署的 Symfony 7.4.21 Web 应用，核心不是“装个框架就完事”，而是构建一套稳定、安全、可复现的生产环境。Symfony 7.4 是当前 LTS（长期支持）版本，官方明确要求 PHP ≥ 8.2，且必须启用关键扩展。直接用 symfony new 创建的开发环境不能直接上线，需完成环境适配、入口配置、缓存预热与权限加固四步闭环。
确认并安装兼容的 PHP 运行环境
Symfony 7.4.21 强制依赖 PHP 8.2 或更高版本，PHP 8.1 已不被支持（会报 fatal error）。同时必须启用以下扩展：
- intl（国际化必需，路由、验证、翻译都依赖）
- mbstring（多字节字符串处理，模板、表单、请求解析均需）
- xml（YAML/XML 配置加载、Serializer 组件底层依赖）
- pdo_mysql（如使用 MySQL 数据库）
- opcache（生产环境必须开启，大幅提升性能）
- zip（Composer 安装、Asset 公共资源压缩所需）
推荐在宝塔面板中安装 PHP 8.2（非 8.3，因部分生产级扩展如 xdebug 8.3 兼容性尚未完全稳定），进入【PHP 设置】→【安装扩展】一次性勾选上述项，并重启 PHP 服务。命令行用户可用：sudo apt install php8.2-intl php8.2-mbstring php8.2-xml php8.2-zip php8.2-opcache
创建项目并切换为生产模式
不要用 symfony new myapp 默认的开发版（含 Webpack Encore、debug toolbar 等非生产组件）。应使用 skeleton + 显式指定环境：
- 运行：
composer create-project symfony/skeleton myapp ^7.4（确保 Composer 使用最新版） - 进入项目：
cd myapp - 设为生产环境：
APP_ENV=prod APP_DEBUG=0 composer install --no-dev --optimize-autoloader - 生成生产密钥：
php bin/console secrets:set APP_SECRET --env=prod
此时 var/cache/prod/ 将生成优化后的容器和路由缓存，public/index.php 也已自动指向生产入口。
正确配置 Web 服务器（Nginx / Apache）
线上部署最常出错的是入口路径错误。Symfony 7 的 public 目录是唯一 Web 可访问路径，但服务器根目录必须指向 public/，而非项目根目录。
-
Nginx（宝塔用户）：站点根目录填
/www/wwwroot/myapp.com/public；或保持默认根目录后，在【配置文件】中将root指向/www/wwwroot/myapp.com/public，并添加以下伪静态规则：
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ ^/index\.php(/|$) {
fastcgi_pass 127.0.0.1:9000; # 或 unix:/tmp/php-cgi.sock
fastcgi_split_path_info ^(.+\.php)(/.*)$;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
internal;
}-
Apache：确保
.htaccess在 public 目录下存在且未被禁用；启用mod_rewrite并设置AllowOverride All。
上线前必做：权限、缓存与健康检查
忽略这步会导致 500 错误、白屏或缓存写入失败：
- 设
var/目录为 Web 服务器用户可写：sudo chown -R www-data:www-data var/（宝塔默认用户为www） - 预热生产缓存：
php bin/console cache:warmup --env=prod - 校验路由是否生效：
php bin/console debug:router --env=prod应列出全部定义路由 - 关闭调试工具栏（确认
APP_DEBUG=0）、禁用 profiler（framework.profiler.only_exceptions: false设为true或注释掉） - 数据库连接测试：
php bin/console doctrine:database:create --if-not-exists --env=prod
完成后访问域名，应看到 Symfony 默认欢迎页（无调试栏），控制台执行 php bin/console about 可确认当前为 prod 环境、PHP 版本及扩展状态。
