Nginx配置去除URL中.php后缀后表单提交失败问题排查

问题根源 #

核心问题出在重写规则未区分请求方法，或是使用了外部跳转而非内部重写：

• 当表单以POST方式提交到register.php时，原有规则会强制跳转到无后缀的register，浏览器处理3xx跳转时会自动将POST请求转为GET请求，导致表单数据完全丢失，后端无法接收参数。
• 如果规则仅处理了带后缀URL的跳转，却未配置无后缀URL到对应.php文件的内部映射，提交到register时Nginx找不到可执行的PHP脚本，同样会导致提交失败。

正确的Nginx配置示例 #

调整规则，区分GET请求的跳转需求和POST请求的直接处理需求：

# 仅对GET请求的带.php后缀URL执行跳转（避免影响POST提交）
if ($request_method = GET) {
    rewrite ^/(.*)\.php$ /$1 permanent;
}

# 处理无后缀URL，内部重写到对应.php文件（支持GET/POST）
location / {
    try_files $uri $uri/ $uri.php?$args;
}

# PHP文件解析配置（根据你的PHP版本调整sock路径）
location ~ \.php$ {
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

关键细节说明 #

1. 区分请求方法：仅GET请求需要跳转无后缀，POST请求直接交给PHP处理，避免表单数据丢失。
2. 内部重写而非外部跳转：try_files实现的是Nginx内部路径映射，不会改变浏览器地址栏，也不会转换请求方法，POST数据能完整传递到后端。
3. 避免循环跳转：通过if ($request_method = GET)限制跳转仅针对GET请求，同时确保直接访问.php文件的请求能被正确解析，防止出现循环重定向。

额外检查点 #

• 确认PHP-FPM服务正常运行，sock文件路径与配置一致。
• 表单action可直接设置为无后缀的register，此时请求会被try_files内部映射到register.php，无需跳转。

内容的提问来源于stack exchange，提问作者Gerrit