Symfony 4应用本地访问public目录出现空白页求助

我之前也碰到过类似的情况，咱们一步步来拆解问题：

首先你用内置服务器php -S 127.0.0.1:8000 -t public能正常运行，说明代码逻辑本身没问题，问题大概率出在Apache的配置或者权限上，咱们从这几个方向排查：

• 确认Apache的mod_rewrite模块是否启用
  Symfony的路由依赖URL重写，要是这个模块没开，很容易出现空白页。你可以用命令检查：

  • Linux/macOS：执行apache2ctl -M，看输出里有没有rewrite_module
  • Windows：打开Apache的httpd.conf配置文件，找#LoadModule rewrite_module modules/mod_rewrite.so，去掉前面的#号，重启Apache服务
    如果没启用，Linux下执行sudo a2enmod rewrite再重启Apache就行。

• 检查项目目录的权限
  Apache运行的用户（通常是www-data）需要对项目的var目录有读写权限，因为缓存、日志都存在这里。执行下面的命令调整权限：

  chown -R www-data:www-data var/
  chmod -R 775 var/
  

• 建议配置虚拟主机而非子目录访问
  直接用localhost/nameproject/public这种子目录访问，很容易触发路由解析问题。不如配置一个专属虚拟主机：

  1. 在Apache的sites-available目录新建配置文件（比如myapp.conf）：

     <VirtualHost *:80>
         ServerName myapp.local
         DocumentRoot /你的项目绝对路径/nameproject/public
     
         <Directory /你的项目绝对路径/nameproject/public>
             AllowOverride All
             Require all granted
         </Directory>
     
         ErrorLog ${APACHE_LOG_DIR}/myapp_error.log
         CustomLog ${APACHE_LOG_DIR}/myapp_access.log combined
     </VirtualHost>
     

  2. 启用这个站点：sudo a2ensite myapp.conf，然后重启Apache
  3. 在本地hosts文件添加127.0.0.1 myapp.local，之后用myapp.local访问试试

• 查看错误日志找具体线索
  空白页往往是因为有致命错误但没显示出来，你可以看这两个日志：

  • Symfony的生产环境日志：var/log/prod.log
  • Apache的错误日志：Linux一般在/var/log/apache2/error.log，Windows在Apache的logs目录里
    日志里会明确告诉你哪里出问题——比如某个类找不到、权限不足、配置错误之类的。

• 确认生产环境变量是否生效
  你已经执行了export APP_ENV=prod，但要确保这个变量在Apache环境里也生效。可以临时在public/index.php开头加一行：

  var_dump($_ENV['APP_ENV']);die();
  

  访问页面如果显示的不是prod，就在public/.htaccess里添加SetEnv APP_ENV prod（symfony/apache-pack应该已经生成了这个文件）。

另外，再检查下composer require symfony/apache-pack之后，public目录下有没有生成.htaccess文件，如果没有的话，手动创建一个：

<IfModule mod_rewrite.c>
    RewriteEngine On

    RewriteCond %{REQUEST_URI}::$0 ^(/.+)/(.*)::\2$
    RewriteRule .* - [E=BASE:%1]

    RewriteCond %{HTTP:Authorization} .
    RewriteRule ^ - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

    RewriteCond %{ENV:REDIRECT_STATUS} =""
    RewriteRule ^index\.php(?:/(.*)|$) %{ENV:BASE}/$1 [R=301,L]

    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ %{ENV:BASE}/index.php [L]
</IfModule>

按照上面的步骤排查，应该能定位到问题所在。

内容的提问来源于stack exchange，提问作者Parma Libera