Slim框架路由404错误求助：访问/contact报错，加index.php正常

这个问题我之前帮不少开发者排查过——本质是Slim框架依赖的URL重写规则未在服务器上正确配置。当你直接访问/contact时，服务器会尝试寻找名为contact的文件或目录，找不到就返回404；而加上index.php/contact时，你直接指定了框架的入口文件，Slim就能接管请求并匹配对应的路由了。

下面分不同服务器给出具体解决方案：

Apache服务器配置步骤 #

1. 确保启用mod_rewrite模块

   • Linux系统可通过命令启用：sudo a2enmod rewrite，然后重启Apache：sudo systemctl restart apache2
   • Windows系统需在Apache的httpd.conf文件里取消注释LoadModule rewrite_module modules/mod_rewrite.so这一行，再重启服务。

2. 创建/更新.htaccess文件
   在你的Slim项目根目录（或public目录，取决于项目结构）创建.htaccess文件，写入以下规则：

   RewriteEngine On
   # 如果请求的不是文件或目录，转发到index.php
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteRule ^ index.php [QSA,L]
   

3. 允许.htaccess覆盖服务器配置
   打开Apache的站点配置文件（比如/etc/apache2/sites-available/your-site.conf），确保对应目录的AllowOverride设置为All：

   <Directory /var/www/your-slim-project/public>
       AllowOverride All
       Require all granted
   </Directory>
   

   修改后记得重启Apache生效。

Nginx服务器配置步骤 #

在你的Nginx站点配置文件的server块中，添加以下重写规则：

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/your-slim-project/public; # 指向Slim的public目录
    index index.php;

    location / {
        # 尝试访问文件、目录，都找不到就转发到index.php
        try_files $uri $uri/ /index.php$is_args$args;
    }

    # 处理PHP请求的配置
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.2-fpm.sock; # 根据你的PHP版本调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

修改后重启Nginx：sudo systemctl restart nginx

额外检查点 #

• 确认项目根目录指向：如果你的Slim项目使用标准骨架结构（根目录下有public文件夹，index.php在其中），请确保服务器的根目录设置为public，而非项目根目录，否则路径会出现问题。
• Slim基础路径配置：如果项目部署在域名的子目录下（比如http://example.com/my-slim-app/），需要在Slim应用中设置基础路径：

  $app->setBasePath('/my-slim-app');
  

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