如何解决Ubuntu系统中nginx部署PHP项目时所有请求返回404错误的问题？-php教程-PHP中文网

如何解决Ubuntu系统中nginx部署PHP项目时所有请求返回404错误的问题？

花韻仙語

发布： 2025-03-23 09:32:11

原创

832人浏览过

如何解决ubuntu系统中nginx部署php项目时所有请求返回404错误的问题？

在Ubuntu系统中使用Nginx部署PHP项目时，经常会遇到所有请求都返回404错误的情况。这通常是由于Nginx配置文件配置错误导致的。本文将详细讲解如何正确配置Nginx，确保你的PHP项目能够在8088端口正常运行。

一位用户在部署PHP项目时，遇到了所有接口返回404的难题。以下是他的Nginx配置文件：

<code>server {
    listen       8088;
    server_name  localhost;
    root   /var/www/html;

    location / {
        index  index.php index.html index.htm;
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param script_filename $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}</code>

登录后复制

问题出在location ~ \.php$块中的try_files指令。正确的配置如下：

<code>server {
    listen       8088;
    server_name  localhost;
    root   /var/www/html;

    location / {
        index  index.php index.html index.htm;
        try_files $uri $uri/ /index.php$is_args$args;
    }

    location ~ \.php$ {
        # try_files $uri =404;  删除错误的try_files指令
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;

        # 关键修改
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }
}</code>

登录后复制

关键在于添加了fastcgi_split_path_info和fastcgi_param PATH_INFO指令。这两条指令对于处理PHP的URL重写至关重要，尤其是在使用ThinkPHP 6 (TP6)等框架时。如果使用TP6，可以搜索“TP6 Nginx fastcgi”获取更多配置示例。同时，请注意将script_filename参数中的script_filename改为SCRIPT_FILENAME (大小写敏感)。