Symfony 3.4部署至服务器后出现空白页问题求助

咱们一步步拆解你遇到的部署问题，下面是具体的排查和修复步骤：

1. 先解决核心的空白页问题 #

空白页通常是PHP错误被屏蔽、权限不足或者缓存异常导致的，按下面的步骤排查：

• 强制显示错误找根源：在服务器的web/app.php最开头加上这两行代码（排查完一定要删掉，避免泄露敏感信息）：

  error_reporting(E_ALL);
  ini_set('display_errors', 1);
  

  刷新页面后就能看到具体的错误提示，比如文件权限不足、路径配置错误等，这是最快定位问题的方法。
• 修复目录/文件权限：Symfony 3.x需要app/cache和app/logs目录有读写权限，因为FTP上传的文件权限默认是你本地用户的，服务器的web进程（比如apache的www-data、nginx的nginx用户）可能没有读写权限，导致缓存生成失败。
  你可以通过FTP工具修改权限：把app/cache、app/logs设为775（或者根据服务器配置调整，确保web用户能读写），其他PHP文件设为644、目录设为755更安全。
• 手动清理缓存：你在本地执行的cache:clear是针对本地环境的，服务器环境可能不同，所以建议手动删除服务器上app/cache/prod下的所有文件，然后重新访问页面，让Symfony自动生成适配服务器环境的缓存。

2. 解决app_dev.php无访问权限的问题 #

Symfony默认的app_dev.php是限制仅本地IP访问的，代码里有这样的判断逻辑：

if (isset($_SERVER['HTTP_CLIENT_IP'])
    || isset($_SERVER['HTTP_X_FORWARDED_FOR'])
    || !(in_array(@$_SERVER['REMOTE_ADDR'], ['127.0.0.1', '::1']) || php_sapi_name() === 'cli-server')
) {
    header('HTTP/1.0 403 Forbidden');
    exit('You are not allowed to access this file. Check '.basename(__FILE__).' for more information.');
}

你需要把自己的访问IP（比如你的公网IP）加入允许列表，修改成这样：

// 把下面的「你的实际访问IP」替换成你真实的IP地址
if (isset($_SERVER['HTTP_CLIENT_IP'])
    || isset($_SERVER['HTTP_X_FORWARDED_FOR'])
    || !(in_array(@$_SERVER['REMOTE_ADDR'], ['127.0.0.1', '::1', '你的实际访问IP']) || php_sapi_name() === 'cli-server')
) {

⚠️ 注意：生产环境下尽量不要长期开启app_dev.php，debug模式性能差且存在安全风险，只用来临时排查问题。

3. 检查部署路径的配置适配 #

你把本地的web文件夹改成了public_html/web，需要确认路径配置是否正确：

• 如果用Apache服务器，检查web/.htaccess里的Rewrite规则是否正确，确保转发到app.php：

  RewriteRule ^(.*)$ app.php [QSA,L]
  

  这个规则要适配当前的路径结构，确保请求能正确转发到入口文件。
• 如果是Nginx服务器，要确认服务器配置里的root指向是public_html/web，同时location规则正确把请求转发给app.php。

4. 关于Symfony 3.2的测试问题 #

如果你部署3.2也遇到类似问题，大概率是服务器环境不符合要求：

• 检查PHP版本：Symfony 3.2和3.4都要求PHP 5.5.9及以上，服务器PHP版本过低会导致运行异常。
• 检查PHP扩展：Symfony依赖mbstring、xml、ctype、json等扩展，缺少这些也会导致页面空白或报错。
  你可以创建一个phpinfo.php文件，内容如下，上传到服务器的public_html/web目录，访问它查看服务器的PHP环境信息：

  <?php phpinfo(); ?>
  

内容的提问来源于stack exchange，提问作者Milo K