Linux如何部署PHPSymfony项目-php教程-PHP中文网

将symfony项目部署到linux生产服务器需完成环境安装、代码部署、依赖注入、web服务配置和权限校准五步：安装nginx、php 8.2+及扩展；git克隆或解压项目并运行composer install --no-dev；配置nginx虚拟主机指向public目录；设置var目录权限与.env.local环境变量；最后缓存清除、预热并重启php-fpm。

linux如何部署phpsymfony项目 - php中文网

将本地开发完成的Symfony项目稳定运行在Linux生产服务器上，需完成环境安装、代码部署、依赖注入、Web服务配置和权限校准五个关键环节，缺一不可。

安装基础运行环境

在Ubuntu 22.04或Debian 12系统上执行以下命令，一次性安装Nginx、PHP 8.2+核心及必需扩展：

sudo apt update && sudo apt install -y nginx php-fpm php-mysql php-curl php-xml php-zip php-mbstring php-tokenizer php-bcmath php-intl git unzip

安装完成后验证PHP版本：php -v 必须显示8.2.x或更高版本；【低版本PHP（如7.4）会导致Symfony 6.4+组件加载失败】。若版本不符，请先添加ondrej/php PPA源并重装。

上传并初始化Symfony项目

方法一：使用Git克隆（推荐，便于后续更新）

将项目推送到私有Git仓库后，在服务器执行：git clone https://your-git-repo.com/your-symfony-project.git /var/www/symfony-app

方法二：上传压缩包解压（适用于无Git权限场景）

通过scp上传zip包 → 在服务器执行：unzip your-project.zip -d /var/www/symfony-app → 删除压缩包

进入项目目录：cd /var/www/symfony-app

运行Composer安装生产依赖：COMPOSER_MEMORY_LIMIT=-1 composer install --no-dev --optimize-autoloader。这一步跳过开发依赖，加快启动速度且提升安全性。

配置Nginx虚拟主机

第一步：创建站点配置文件

执行：sudo nano /etc/nginx/sites-available/symfony-app

第二步：粘贴以下最小可行配置（注意替换server_name为你的域名或IP）：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

server {
  listen 80;
  server_name example.com;
  root /var/www/symfony-app/public;
  index index.php;

  location / {
    try_files $uri /index.php?$query_string;
  }

  location ~ ^/index\.php(/|$) {
    fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    fastcgi_split_path_info ^(.+\.php)(/.*)$;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    fastcgi_param DOCUMENT_ROOT $realpath_root;
  }

  location ~ \.php$ {
    return 404;
  }
}

第三步：启用站点并重载Nginx

sudo ln -sf /etc/nginx/sites-available/symfony-app /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

设置安全权限与环境变量

执行以下三条命令，确保Web服务器能写入缓存与日志目录：

sudo chown -R www-data:www-data /var/www/symfony-app/var
sudo chmod -R 775 /var/www/symfony-app/var
sudo setfacl -R -m u:www-data:rwx /var/www/symfony-app/var

复制环境配置模板：cp .env.local.dist .env.local

编辑.env.local文件，设置数据库连接、APP_ENV=prod、APP_DEBUG=false，并生成密钥：php bin/console secret:generate --env=prod

【务必关闭APP_DEBUG=true，否则会暴露敏感路径与堆栈信息】