Symfony 6服务器子目录部署失败求助：求正确.htaccess配置及虚拟主机设置指导

我之前部署Symfony应用到子目录时踩过一模一样的坑，给你整理一套能解决问题的完整方案，分虚拟主机配置、项目内.htaccess调整和Symfony本身的设置三部分：

首先纠正你之前配置的几个问题：DocumentRoot的设置要根据域名下的主应用情况来，同时Alias和Directory块的路径必须用绝对路径，还要适配Apache 2.4+的权限规则。以下是完整的虚拟主机配置示例：

<VirtualHost *:80>
    # 如果域名下还有另一个主应用，这里指向主应用的public目录；如果没有主应用，可设为服务器基础目录（比如/var/www/html）
    DocumentRoot /var/www/main_app/public
    ServerName your-domain.com

    # 关键：将/controlpanel URL映射到你的Symfony应用public目录（必须写绝对路径）
    Alias /controlpanel /var/www/controlpanel/public

    # 针对controlpanel子目录的重写与权限配置
    <Directory /var/www/controlpanel/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All  # 允许.htaccess生效
        Require all granted  # Apache 2.4+的权限规则，替代旧的Order指令

        RewriteEngine On
        RewriteBase /controlpanel/
        # 当请求的文件/目录不存在时，转发到index.php
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule ^(.*)$ index.php [QSA,L]
    </Directory>

    # 如果有主应用，添加主应用的目录配置（可省略，如果没有主应用）
    <Directory /var/www/main_app/public>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Require all granted

        RewriteEngine On
        RewriteBase /
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule ^(.*)$ index.php [QSA,L]
    </Directory>
</VirtualHost>

进入你的controlpanel/public目录，修改默认的.htaccess，确保RewriteBase正确指向子目录：

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteBase /controlpanel/
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>

为了让Symfony生成的路由自动带上子目录前缀，避免把/controlpanel识别成路由，需要做两个配置：

1. 在.env文件中设置应用的基础URL：

APP_URL=https://your-domain.com/controlpanel

2. 在config/packages/framework.yaml中配置路由器的默认URI：

framework:
    # 保留其他原有配置...
    router:
        default_uri: '%env(APP_URL)%'

• 确保Apache启用了必要模块：执行sudo a2enmod rewrite alias，然后重启Apache（sudo systemctl restart apache2）。
• 检查目录权限：确保Apache的运行用户（通常是www-data）对/var/www/controlpanel/public有读取权限，可执行sudo chown -R www-data:www-data /var/www/controlpanel。
• 清空Symfony缓存：部署到生产环境时，执行php bin/console cache:clear --env=prod，避免旧缓存导致的路由问题。

内容的提问来源于stack exchange，提问作者Azad KAYA