Symfony 5.4生产环境部署：Apache自定义HTTPS证书配置问题

问题1：替换Symfony服务器证书后仍显示开发证书 #

• 先纠正误区：Symfony自带的开发证书仅适用于它的内置Web服务器（即symfony server:start启动的服务），生产环境用Apache部署时，完全不需要修改Symfony的证书文件，你之前的操作方向错误。
• 排查修复步骤：
  1. 停止Symfony内置服务器：执行symfony server:stop，确保请求走Apache服务而非Symfony自带服务。
  2. 清空浏览器缓存或用隐私窗口访问，避免旧证书缓存干扰。
  3. 重点检查Apache的SSL配置，确保指向自定义证书路径，而非Symfony开发证书的路径。

问题2：Apache配置后证书生效但无法加载Symfony应用 #

核心原因是Apache虚拟主机配置错误，导致请求未转发到Symfony的public/index.php，而是读取了默认的/var/www/html/index.php。

正确配置流程： #

1. 备份原有配置：将httpd.conf和ssl.conf复制到备份目录（如/etc/httpd/backup/），避免配置错误无法恢复。
2. 配置虚拟主机：
   • 可编辑/etc/httpd/conf.d/ssl.conf，或新建独立虚拟主机文件（推荐后者，如/etc/httpd/conf.d/symfony.conf），添加以下配置：

     <VirtualHost *:443>
         ServerName servername  # 替换为你的服务器域名/主机名
         DocumentRoot /实际路径/你的symfony项目/public
     
         # 自定义SSL证书配置
         SSLEngine on
         SSLCertificateFile /实际路径/你的证书文件.crt
         SSLCertificateKeyFile /实际路径/你的私钥文件.key
         # 若有CA证书链，添加此行
         SSLCertificateChainFile /实际路径/你的证书链文件.crt
     
         # Symfony URL重写规则（必须配置）
         <Directory /实际路径/你的symfony项目/public>
             AllowOverride All
             Require all granted
             Options FollowSymLinks
     
             RewriteEngine On
             # 将非静态文件请求转发到index.php
             RewriteCond %{REQUEST_FILENAME} !-f
             RewriteRule ^(.*)$ index.php [QSA,L]
         </Directory>
     
         # 日志配置（可选，方便排查问题）
         ErrorLog /var/log/httpd/symfony_error.log
         CustomLog /var/log/httpd/symfony_access.log combined
     </VirtualHost>
     

   • 所有路径和servername需替换为实际内容。
3. 启用必要Apache模块：
   • 确保mod_ssl和mod_rewrite已启用：

     sudo a2enmod ssl rewrite
     

   • 若a2enmod报错，直接编辑/etc/httpd/conf.modules.d/00-base.conf，确认存在LoadModule rewrite_module modules/mod_rewrite.so；编辑00-ssl.conf，确认存在LoadModule ssl_module modules/mod_ssl.so。
4. 验证配置并重启Apache：
   • 检查配置语法：sudo apachectl configtest，提示Syntax OK再继续。
   • 重启服务：sudo systemctl restart httpd
5. 权限检查：
   • 确保Apache运行用户（apache）可读取Symfony项目文件：

     sudo chown -R apache:apache /实际路径/你的symfony项目
     sudo chmod -R 755 /实际路径/你的symfony项目/public
     

6. Symfony生产环境初始化：
   • 切换到生产环境并清理缓存：

     APP_ENV=prod APP_DEBUG=0 php bin/console cache:clear --no-warmup
     APP_ENV=prod APP_DEBUG=0 php bin/console cache:warmup
     

   • 检查.env.prod中的数据库、环境变量等配置是否正确。

额外注意点 #

• 不要同时运行Symfony内置服务器和Apache，避免潜在冲突，确保内置服务已停止。
• 防火墙需开放443端口：sudo firewall-cmd --add-port=443/tcp --permanent && sudo firewall-cmd --reload

内容的提问来源于stack exchange，提问作者Teka B