thinkphp5 restful路由需显式启用并正确配置服务器path_info：nginx须添加fastcgi_param path_info $fastcgi_path_info，apache需将.htaccess置于public目录并用index.php?/$1；否则路由无法解析。
ThinkPHP5 RESTful 路由必须显式启用
默认情况下，ThinkPHP5 的 Route::rule() 不支持 RESTful 风格的自动动词映射（如 GET /users → UsersController@index），必须手动开启 RESTful 支持并配置对应路由类型。否则即使 URL 看起来像 RESTful（如 /api/v1/users），框架也不会按 HTTP 方法分发到不同操作方法。
实操建议：
- 在
route/route.php开头调用Route::domain('api', function () { ... })或直接使用Route::group()划定 API 前缀 - 用
Route::resource('users', 'api.Users')替代手写多条rule()，它会自动生成 7 个标准 REST 动作路由（index/show/create/store/update/destroy/edit） - 确保
config/app.php中'url_route_on' => true且'url_route_must' => false（若设为true，所有请求必须命中显式定义的路由，RESTful 未覆盖的 OPTIONS/PATCH 等可能 404） - RESTful 资源路由默认不带后缀，如需
.json或.html，需配合'url_html_suffix' => '.json'并在控制器中判断input('suffix')
Nginx 下 RESTful 伪静态必须传 PATH_INFO
ThinkPHP5 的 RESTful 路由依赖 $_SERVER['PATH_INFO'] 解析路径段（如 /users/123 中的 /users/123），但 Nginx 默认不设置该变量。若只配了 try_files $uri $uri/ /index.php?$query_string;，会报错 URL pathinfo not supported 或直接 404。
实操建议：
- 在 Nginx 的
location ~ \.php$块内，**必须添加**：fastcgi_param PATH_INFO $fastcgi_path_info; - 入口文件路径要对：TP5 默认入口是
public/index.php，所以try_files应指向/public/index.php?s=$uri&$args，而非根目录下的/index.php - 若用
if (!-e $request_filename)写法（宝塔常见），规则末尾必须用last，不可用break，否则重写后不再进入 PHP 处理块，PATH_INFO无法注入 - 验证是否生效：在控制器里打印
dump($_SERVER['PATH_INFO'])，访问/api/v1/users/5时应输出类似/api/v1/users/5
Apache .htaccess 对 RESTful 路径兼容性差
Apache 的 .htaccess 规则在处理多级路径（如 /api/v1/users/5）时容易因 RewriteBase 缺失或 PATH_INFO 注入方式不当导致截断。常见现象是只解析到第一级（/api），后面全丢。
实操建议：
-
.htaccess必须放在public/目录下（不是项目根目录），且内容用这一版最稳：<ifmodule mod_rewrite.c><br>Options +FollowSymlinks -Multiviews<br>RewriteEngine On<br>RewriteCond %{REQUEST_FILENAME} !-d<br>RewriteCond %{REQUEST_FILENAME} !-f<br>RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]<br></ifmodule> - 关键点是
index.php?/$1—— 问号后加斜杠，让 PHP 将后续部分识别为PATH_INFO；用index.php/$1在某些 Apache 版本下会丢失查询参数 - 如果部署在子目录（如
http://domain.com/myapp/），必须补RewriteBase /myapp/，且与实际 URL 路径严格一致，大小写都不能错 - 避免在
.htaccess里写针对 RESTful 的专用规则（如匹配/users/(\d+)），交给框架路由统一处理更可靠
RESTful 接口的伪静态与真实静态文件冲突
当 API 路径和静态资源路径前缀重叠（如 /api/v1/assets/logo.png），Nginx/Apache 可能误判为动态请求，转发给 PHP，导致图片 500 或返回 HTML 内容。
实操建议：
- 在 Nginx 的
location /块内，**优先匹配静态文件**：location ^~ /api/v1/assets/ { alias /path/to/static/assets/; } - Apache 下可在
.htaccess顶部加白名单规则：RewriteCond %{REQUEST_URI} !^/api/v1/assets/ - ThinkPHP5 的
Route::miss()只捕获未匹配路由，不拦截已匹配但文件存在的请求，所以服务器层拦截更前置、更安全 - 开发阶段可用
php -S localhost:8000 router.php启动内置服务器，router.php中手动判断is_file()并返回静态文件，避免配置遗漏
PATH_INFO 交给了框架——漏掉 fastcgi_param PATH_INFO 或放错位置，或者 Apache 下 .htaccess 没落在 public/ 目录，都会让整个 RESTful 路由链从第一步就断裂。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
