Ubuntu中nginx部署PHP项目404错误终极解决方案

本文提供解决Ubuntu下Nginx部署PHP项目时出现404错误的终极方案。许多用户在使用Nginx配置PHP项目时，所有请求都返回404错误，这通常是由于Nginx配置文件错误导致的。文章分析了一个实际案例，指出错误在于Nginx `location ~ \.php$` 块中的 `try_files` 指令，并详细讲解了正确的Nginx配置，包括添加关键指令 `fastcgi_split_path_info` 和 `fastcgi_param PATH_INFO`，以及修正 `script_filename` 参数大小写。此外，文章还强调了检查php-fpm服务和sock文件路径的重要性，确保你的PHP项目能够在指定端口正常运行。

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

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

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;
    }
}

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

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;
    }
}

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

另外，请确保php-fpm服务正在运行，并且/var/run/php/php7.4-fpm.sock路径正确。 如果使用其他版本的PHP，请相应调整sock文件的路径。

通过以上配置和检查，你的PHP项目应该能够在8088端口正常访问。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Ubuntu中nginx部署PHP项目404错误终极解决方案》文章吧，也可关注golang学习网公众号了解相关技术文章。