本文详细探讨了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对“文档根目录”的理解保持一致。有两种主要方法：
方案一：移除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中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1326822.html
微信扫一扫 
支付宝扫一扫 
