Ubuntu上Nginx部署PHP项目，搞定404错误攻略

在Ubuntu系统中使用Nginx部署PHP项目时，经常会遇到404错误。本文针对Nginx配置文件中fastcgi部分的常见错误，提供详细的排查和解决方法。主要问题在于Nginx未能正确解析PHP文件，导致所有接口返回404。文章提供了正确的Nginx配置文件示例，并详细解释了`listen`、`server_name`、`root`、`try_files`以及`location ~ \.php$`等关键配置项的作用，帮助用户快速定位并修复404错误，最终成功部署PHP项目。 此外，文章还强调了检查PHP-FPM服务及Nginx配置文件语法的必要性。

Ubuntu系统下Nginx部署PHP项目：404错误排查与解决

在Ubuntu服务器上使用Nginx部署PHP项目时，如果所有接口都返回404错误，通常是Nginx配置文件配置不当导致的。本文将详细分析此问题并提供解决方案。

问题描述

用户尝试在Ubuntu系统上使用Nginx在8088端口部署服务，但经过多次配置调整后，仍然无法访问，所有接口均返回404错误。

配置文件错误分析

提供的Nginx配置文件中，fastcgi部分配置存在问题，导致PHP文件无法正确解析。错误配置示例如下：

# 错误配置示例
location ~ \.php$ {
    fastcgi_pass   127.0.0.1:9000;
    fastcgi_index  index.php;
    include fastcgi_params;
}

此配置可能无法正确处理PHP请求。

正确的Nginx配置文件

针对ThinkPHP 6框架，以下是一个正确的Nginx配置文件示例：

server {
    listen       80;
    server_name  www.h5fiction1.com;
    root         /var/www/h5_fiction_1/public; # 请替换为你的项目public目录的实际路径

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock; # 或你的php-fpm socket路径
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }
}

注意： 请将/var/www/h5_fiction_1/public替换为你的项目public目录的实际路径，并将unix:/run/php/php7.4-fpm.sock替换为你的php-fpm socket路径。

配置详解

1. 监听端口和服务器名称: listen 80; 监听80端口；server_name www.h5fiction1.com; 设置服务器名称。

2. 根目录: root /var/www/h5_fiction_1/public; 指定项目public目录作为网站根目录。

3. URL处理: try_files $uri $uri/ /index.php?$args; 优先查找静态文件，如果找不到则将请求转发到index.php。

4. PHP处理: location ~ \.php$ { ... } 匹配所有.php文件；fastcgi_pass 指定PHP-FPM的socket路径；fastcgi_split_path_info、fastcgi_param 等参数确保正确解析PHP请求的路径信息。

通过以上配置，你应该能够解决Nginx部署PHP项目时遇到的404错误。 请确保PHP-FPM服务已正确安装和运行，并且Nginx配置文件语法正确。 使用 nginx -t 命令检查配置文件语法。 如果仍然存在问题，请检查PHP-FPM的日志文件以获取更多错误信息。

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