symfony部署核心是环境一致性与自动化:开发推荐docker容器化(10分钟启动),生产建议lemp手动部署,需严格管理数据库连接、.env配置及ci/cd流程。

Symfony项目部署核心在于环境一致性与流程自动化。本地能跑不等于线上稳定,关键要把PHP运行时、Web服务器、数据库、缓存和配置这几块理清楚。推荐优先用Docker容器化,其次才是传统LAMP/LEMP手动部署。
用Docker一键启动开发环境(最快上手)
适合开发、测试及预发布环境,10分钟内可跑起来:
- 安装Docker Engine(20.10+)和Docker Compose(v2+)
- 克隆成熟栈:
git clone https://gitcode.com/gh_mirrors/do/docker-symfony - 把你的代码放进
./symfony/目录(不是根目录) - 按版本改数据库地址:Symfony ≥4 就改
.env里的DATABASE_URL,主机名写db;旧版改parameters.yml中database_host: db - 绑定域名:
echo "127.0.0.1 symfony.localhost" | sudo tee -a /etc/hosts - 执行
docker-compose up,首次会自动拉镜像、构建容器
成功后访问 http://symfony.localhost,phpMyAdmin在 :8080,Kibana日志界面在 :81。
生产环境手动部署(Nginx + PHP-FPM + MySQL)
适用于云服务器或私有IDC,强调安全与性能:
- 安装LAMP或LEMP:Ubuntu下用
apt install nginx php-fpm mysql-server php-mysql php-curl php-xml php-zip - 把项目代码传到服务器(如
/var/www/myapp),确保var/和public/可写 - 配置Nginx虚拟主机,root指向
public/目录,启用try_files $uri /index.php?$query_string; - 设置
.env为prod环境:APP_ENV=prod APP_DEBUG=0 - 执行关键命令(在项目根目录):
php bin/console doctrine:migrations:migrate --no-interactionphp bin/console cache:warmup --env=prodphp bin/console assets:install public --env=prod - 调整PHP-FPM用户权限,避免以
www-data运行时写入var/cache失败
数据库与配置管理要点
配置出错是上线失败最常见原因:
-
.env文件不要提交到Git,生产环境通过服务器变量或挂载方式注入 - SQLite仅限开发,生产必须用MySQL或PostgreSQL,连接串格式要严格匹配:
mysql://user:pass@db:3306/myapp?serverVersion=8.0&charset=utf8mb4 - 敏感参数如数据库密码、JWT密钥等,建议用环境变量替代硬编码
- 使用
php bin/console debug:container --env-vars验证环境变量是否生效
CI/CD与自动化部署(进阶推荐)
减少人工操作,提升发布可靠性:
- 用Symfony Filesystem组件写部署脚本,支持目录镜像、权限设置、文件重命名等原子操作
- 在CI工具(如Jenkins、GitLab CI)中集成:
安装依赖 → 运行测试 → 构建前端资源 → 打包 → 推送至目标服务器 - 部署时清空旧缓存但保留
var/log,避免日志丢失;用--no-warmup跳过预热,上线后再异步触发 - 配合rsync做增量同步,比全量上传快,也支持回滚到上一版本目录











