Nginx与PHP-FPM文件读取故障排除：理解doc_root配置与路径同步

本文详细探讨了nginx与php-fpm在特定目录下无法正确读取php文件（如magento的`pub`目录）的问题。核心原因在于php-fpm配置中的`php_value[doc_root]`与nginx的`root`指令不匹配。文章提供了两种解决方案：一是移除php-fpm中的`php_value[doc_root]`，让nginx通过`script_filename`传递完整路径；二是确保两者路径严格一致，并强调了配置同步的重要性，以避免“no input file specified”错误。

Nginx与PHP-FPM文件读取问题诊断

在使用Nginx作为Web服务器，并结合PHP-FPM处理PHP请求时，有时会遇到特定PHP文件无法被正确执行的问题。典型的症状包括：Nginx错误日志中出现"Unable to open primary script: /path/to/your/file.php (No such file or directory)"，而浏览器端显示“No input file specified.”。奇怪的是，同一目录下的index.php可能正常运行，而其他如get.php等文件则报错。这通常不是文件权限问题，也不是文件本身缺失，而是Nginx与PHP-FPM之间关于“文档根目录”的理解不一致所导致。

以Magento 2为例，当Nginx的root指令指向MAGEROOT/pub目录时，如果pub目录下的index.php可以正常执行，但get.php等其他PHP文件却报错，即便ls -la显示这些文件存在且权限正确，问题很可能出在PHP-FPM的配置上。

核心问题：php_value[doc_root]与Nginx root的冲突

Nginx通过root指令定义其服务文件的根目录，并通过fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;将完整的脚本路径传递给PHP-FPM。其中，$document_root变量的值即为Nginx root指令所定义的路径。

然而，PHP-FPM自身也可能通过php_value[doc_root]配置项来定义一个“文档根目录”。当这个php_value[doc_root]的值与Nginx的root指令不一致时，就会产生冲突。

立即学习“PHP免费学习笔记（深入）”；

例如，Nginx配置中可能将root设置为：

set $MAGE_ROOT /home/goodprice/public_html/releases/current;
root $MAGE_ROOT/pub; # Nginx的文档根目录是 /home/goodprice/public_html/releases/current/pub

同时，PHP-FPM的配置（例如在cPanel或自定义的www.conf或站点专用池配置中）可能错误地将php_value[doc_root]设置为：

; 错误的配置示例
php_value[doc_root] = "/home/goodprice/public_html/releases/current/" 

在这种情况下，当Nginx尝试执行/pub/get.php时，它会向PHP-FPM传递SCRIPT_FILENAME为/home/goodprice/public_html/releases/current/pub/get.php。但PHP-FPM由于其php_value[doc_root]被设置为/home/goodprice/public_html/releases/current/，它会尝试在这个错误的根目录下寻找pub/get.php，从而导致找不到文件并报告“No input file specified.”错误。

解决方案

解决此问题的关键在于确保Nginx和PHP-FPM对“文档根目录”的理解保持一致。有两种主要方法：

文心大模型

百度飞桨-文心大模型 ERNIE 3.0 文本理解与创作

56

查看详情

方案一：移除PHP-FPM中的php_value[doc_root] (推荐)

这是最推荐的方法。如果PHP-FPM配置中存在php_value[doc_root]，请将其移除或注释掉。

; php-fpm pool configuration (e.g., www.conf or a site-specific .conf)

; user = "goodprice"
; group = "goodprice"
; listen.owner = "goodprice"
; listen.group = "nobody"
; listen.mode = 0660

; 移除或注释掉此行
; php_value[doc_root] = "/home/goodprice/public_html/releases/current/" 

当php_value[doc_root]未设置时，PHP-FPM会完全依赖Nginx通过SCRIPT_FILENAME参数传递的完整文件路径来定位脚本。由于Nginx的SCRIPT_FILENAME通常是根据其root指令和请求URI动态生成的，这种方式能够确保路径的准确性，避免了两者配置不同步的问题。

方案二：确保php_value[doc_root]与Nginx root严格一致

如果出于某种原因，您必须在PHP-FPM中设置php_value[doc_root]，那么请务必确保其值与Nginx配置中最终生效的root指令完全一致。

根据Magento的例子，如果Nginx的root是$MAGE_ROOT/pub，那么PHP-FPM的doc_root也应该指向这个最终路径：

; php-fpm pool configuration (e.g., www.conf or a site-specific .conf)
php_value[doc_root] = "/home/goodprice/public_html/releases/current/pub/" 

注意事项：

• 请确保路径末尾的斜杠/与Nginx的root指令行为保持一致。
• 每次修改PHP-FPM配置文件后，都需要重启PHP-FPM服务以使更改生效（例如systemctl restart php-fpm或service php7.3-fpm restart）。
• Nginx配置修改后，也需要重新加载或重启Nginx服务（例如nginx -s reload或systemctl restart nginx）。

Nginx与PHP-FPM配置示例解析

为了更好地理解，我们回顾一下关键的Nginx配置片段：

server {
    listen 8088;
    set $MAGE_ROOT /home/goodprice/public_html/releases/current;
    root $MAGE_ROOT/pub; # Nginx的文档根目录

    # ... 其他配置 ...

    location ~ (index|get|static|report|404|503|health_check|deploy_clear_opcache)\.php$ {
        try_files $uri =404; # 尝试查找文件，如果不存在则返回404

        fastcgi_pass fastcgi_backend; # 将请求转发给PHP-FPM

        fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name; # 关键：传递完整脚本路径
        include        fastcgi_params; # 包含其他FastCGI参数

        # ... 其他FastCGI参数 ...
    }
    # ...
}

这里的root $MAGE_ROOT/pub;明确告诉Nginx，对于这个server块内的请求，文件应从/home/goodprice/public_html/releases/current/pub/开始查找。 而fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;则确保Nginx会将计算出的完整文件路径（例如/home/goodprice/public_html/releases/current/pub/get.php）作为SCRIPT_FILENAME变量传递给PHP-FPM。只要PHP-FPM不被php_value[doc_root]误导，它就能正确地执行该脚本。

总结

当Nginx与PHP-FPM协作时，出现“No input file specified.”或“Unable to open primary script”错误，且确认文件存在、权限无误时，应优先检查PHP-FPM的php_value[doc_root]配置项。最佳实践是移除PHP-FPM中的php_value[doc_root]，让Nginx通过SCRIPT_FILENAME参数全权负责告知PHP-FPM脚本的准确位置。如果必须设置php_value[doc_root]，则务必确保其值与Nginx的root指令所定义的最终文档根目录完全一致，以避免路径解析上的混淆。理解并正确配置这两个组件之间的路径同步机制，是构建稳定高效Web服务环境的关键。

以上就是Nginx与PHP-FPM文件读取故障排除：理解doc_root配置与路径同步的详细内容，更多请关注php中文网其它相关文章！