宝塔面板不提供Symfony一键部署，但可通过三步完成标准化部署：一、在软件商店安装PHP 8.1+并启用intl、mbstring等扩展；二、上传项目后将public内文件移至根目录；三、修改Nginx配置支持front controller，并修复var/权限及预热缓存。
宝塔面板本身不提供 Symfony 的“一键部署”按钮，但通过其可视化环境管理能力，可以快速完成 Symfony 项目的标准化部署。整个过程核心在于：先准备好运行环境（PHP + Web 服务 + 扩展），再上传并配置项目，最后用宝塔托管静态资源与反向代理。它不是点一下就上线，而是“三步配好、一次跑通”。
一、提前准备 Symfony 运行环境
Symfony 对 PHP 版本和扩展有明确要求（如 PHP ≥ 8.1，需 intl、xml、mbstring、pdo_mysql 等）。宝塔不能自动判断你的项目需求，必须手动配齐：
- 进入【软件商店】→ 搜索并安装「PHP」，推荐选择 8.1 或 8.2 版本（避免选 7.x）
- 点击已安装的 PHP 版本右侧【设置】→ 【安装扩展】→ 勾选：intl、xml、mbstring、opcache、pdo_mysql、zip、bcmath、gd（Symfony 官方推荐基础扩展）
- 【服务】→ 启动或重启 Nginx 和 PHP（确保状态为绿色）
- 如项目含数据库，同步在【数据库】中新建 MySQL 数据库，并记下用户名、密码、主机（默认 localhost）
二、上传并正确放置 Symfony 项目文件
Symfony 默认入口是 public/index.php，宝塔建站时必须指向 public 目录，否则会 403 或白屏：
- 进入【网站】→ 【添加站点】，域名填你的域名或服务器 IP（测试阶段可用 IP）
- 根目录设为
/www/wwwroot/your-domain.com（保持默认即可） - 创建完成后，点击该站点右侧【根目录】→ 进入文件管理器
- 清空默认生成的 index.html，将本地打包好的 Symfony 项目整体上传（建议压缩为 .zip）
- 右键上传的 zip 文件 → 【解压】→ 将解压后所有文件（含 public、src、var、config 等）移入根目录
-
关键一步：把
public文件夹内的所有内容（index.php、robots.txt、assets/ 等）剪切到上一级（即站点根目录），然后删除空的public文件夹 —— 这样 Nginx 才能直接访问 index.php
三、配置 Nginx 支持 Symfony 路由与环境
默认 Nginx 配置不识别 Symfony 的 front controller，需手动补全伪静态规则：
- 点击站点右侧【设置】→ 【网站目录】→ 关闭「防跨站攻击（open_basedir）」（开发调试期建议关闭，上线后可按需开启）
- 切换到【配置文件】选项卡，在
location / { ... }区域内，替换或补充以下内容：
location / {
# 尝试找静态文件，找不到则交由 index.php 处理
try_files $uri /index.php?$query_string;
}
<p>location ~ ^/index.php(/|$) {<br />
fastcgi_pass unix:/tmp/php-cgi-81.sock; # 注意匹配你安装的 PHP 版本 sock 文件名<br />
fastcgi_split_path_info ^(.+.php)(/.*)$;<br />
fastcgi_index index.php;<br />
include fastcgi_params;<br />
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;<br />
fastcgi_param HTTPS on;<br />
} </p>- 保存配置 → 【重载 Nginx】
- 回到【网站】→ 【SSL】→ 免费申请 Let's Encrypt 证书（绑定域名后才可启用）
四、初始化与权限修复（常被忽略）
Symfony 运行依赖 var/ 目录可写、缓存需预热，这些在宝塔里需手动干预：
- 打开【终端】，执行以下命令（替换 your-domain.com 为实际路径）：
cd /www/wwwroot/your-domain.com chmod -R 777 var/ public/ php bin/console cache:clear --env=prod --no-debug php bin/console assets:install public/ --env=prod
- 若提示 “No such file or directory”，说明未安装 Composer；可在【软件商店】搜索安装「Composer」，或手动下载：
wget https://getcomposer.org/installer && php installer && mv composer.phar /usr/local/bin/composer - 检查日志：访问
http://你的域名/_profiler（开发模式）或查看var/log/prod.log（生产模式）定位报错
