Symfony 3.4 Nginx共享主机路由配置异常求助

这个问题我之前帮不少Symfony开发者解决过，核心原因是Nginx没把路由请求正确转发给Symfony的前端控制器app.php，咱们一步步来排查和解决：

你现在能通过domain/app.php访问Symfony页面，但访问/home时提示“File not found”，本质是Nginx默认会把/home当成一个文件/文件夹去查找，而不是交给app.php解析Symfony路由——只有直接访问app.php时，请求才会被Symfony的核心处理流程接管。

针对Symfony 3.4在Nginx共享主机的场景，重点要调整Nginx的URL重写规则，让所有动态请求都通过app.php处理：

1. 配置Nginx核心转发规则 #

如果你的共享主机允许自定义Nginx配置（比如通过控制面板添加站点配置，或者在web目录下创建nginx.conf/.nginx.conf文件），添加以下关键配置：

# 确认root指向你的web目录（你已经设置过，可跳过）
root /path/to/your/public_html/web;

# 处理所有动态请求：先找静态文件，找不到就转发给app.php
location / {
    try_files $uri $uri/ /app.php$is_args$args;
}

# 正确转发app.php请求给PHP-FPM
location ~ ^/app\.php(/|$) {
    # 这里的fastcgi_pass要根据主机的PHP版本调整，比如unix套接字或IP:端口
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
    fastcgi_split_path_info ^(.+\.php)(/.*)$;
    include fastcgi_params;
    # 传递正确的文件路径给PHP，避免路径错误
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    fastcgi_param DOCUMENT_ROOT $realpath_root;
    # 标记为内部请求，防止直接访问非app.php的PHP文件
    internal;
}

# 禁止直接访问其他PHP文件，提升安全性
location ~ \.php$ {
    return 404;
}

2. 共享主机无法修改Nginx配置的替代方案 #

如果你的主机不允许自定义Nginx配置，部分服务商支持通过web/.htaccess文件实现兼容重写（虽然Nginx本身不解析.htaccess，但有些主机做了适配），可以在web目录下创建.htaccess文件，内容如下：

<IfModule mod_rewrite.c>
    RewriteEngine On
    # 如果请求的不是文件/文件夹，就转发给app.php
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^(.*)$ app.php [QSA,L]
</IfModule>

3. 确认Symfony路由与缓存正常 #

• 检查DefaultController的路由配置是否正确，比如：

  // src/AppBundle/Controller/DefaultController.php
  use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
  
  class DefaultController extends Controller
  {
      /**
       * @Route("/home", name="home")
       */
      public function indexAction()
      {
          return $this->render('default/index.html.twig');
      }
  }
  

• 清除生产环境缓存（共享主机一般运行在prod环境）：

  php bin/console cache:clear --env=prod
  

配置完成后，等待主机配置生效（或手动重启Nginx，如果有权限），再访问domain/home就能正常加载Symfony的页面了。

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