ThinkPHP5怎样实现RESTful接口_ThinkPHP5实现RESTful接口技巧【实战】-ThinkPHP-PHP中文网

route::resource('users', 'user')注册资源路由，自动生成7条标准restful路由，控制器需严格实现index/create/save/read/edit/update/delete方法，且必须继承think\controller；put/delete需手动解析php://input。

thinkphp5怎样实现restful接口_thinkphp5实现restful接口技巧【实战】

ThinkPHP5 实现 RESTful 接口，核心不是写一堆 get/post 路由凑数，而是用 Route::resource() 声明资源、控制器严格对齐 7 个方法名、手动处理请求体——漏掉任一环，PUT 拿不到参数、DELETE 走进 index、/users/123 返回 404 就是常态。

Route::resource() 怎么注册才不踩坑

资源路由必须显式注册在 route/app.php 中，且不能被其他规则提前拦截或包裹错层级。

错误写法：Route::get('users', 'User@index') + 单独补 Route::put('users/:id', 'User@update') —— 这不算资源路由，只是手工拼凑，失去自动绑定和命名优势
正确姿势：直接写 Route::resource('users', 'User')，框架会自动生成 7 条标准路由（GET /users → index，PUT /users/:id → update 等）
带版本前缀时别硬塞路径：写 Route::prefix('api/v1')->group(function () { Route::resource('users', 'User'); });，而不是 Route::resource('api/v1/users', 'User')（后者会导致控制器无法解析 v1 段）
命名路由方便生成 URL：Route::resource('users', 'User')->name('api.users')，之后可用 url('api.users/read', ['id' => 5])

控制器方法名必须是这 7 个：index/create/save/read/edit/update/delete

ThinkPHP5 的资源路由靠方法名和 HTTP 动词双重匹配，写成 show() 或 destroy() 就完全失效。

amphp

使用 AMPHP 框架编写非阻塞异步 PHP 代码，依赖 revolt/event-loop、amphp/amp ^3 及完整 amphp/* 生态（http‑server、http‑client 等）。

下载

常见错误现象：GET /users/5 被路由到 index() 而非 read()；DELETE /users/5 报 404 或进 index()
控制器必须继承 think\Controller（不是 think\BaseController），否则 __call() 拦截器不触发，动词映射就断了
save() 对应 POST /users（新建），update() 对应 PUT /users/:id（更新），别把逻辑混在同一个方法里
方法参数可选类型提示：public function read($id) 或 public function read(Request $request, $id)，但 $id 必须作为第一个位置参数接收

POST/PUT/DELETE 请求体怎么取数据

save()、update()、delete() 方法**不会自动调用 input() 或 param()**，你得自己读原始输入并解析。

表单提交（Content-Type: application/x-www-form-urlencoded）：$this->request->post() 可用，但注意 TP6+ 默认 trim 首尾空格，若字段允许空格需手动 $this->request->post('name', '', 'htmlspecialchars')
JSON 提交（Content-Type: application/json）：$this->request->post() 和 input() 全部失效，必须用 file_get_contents('php://input') 读原始流，再 json_decode($raw, true) ?: []
PUT 请求同理：if ($this->request->isPut()) { $raw = file_get_contents('php://input'); $data = json_decode($raw, true) ?: []; }
想后续用 $this->request->put('name')？可以，但要先手动注入：$this->request->put($data)

为什么 /users/5 总是 404 或进错方法

最常忽略的是 URL 重写和参数解析机制——TP5 默认依赖 PATH_INFO，而 Apache/Nginx 配置不对，:id 根本传不到路由层。

Apache 下确保 .htaccess 开启且生效：RewriteCond %{REQUEST_FILENAME} !-d + RewriteCond %{REQUEST_FILENAME} !-f + RewriteRule ^(.*)$ index.php [L,E=PATH_INFO:$1]
Nginx 下需配置 fastcgi_param PATH_INFO $fastcgi_path_info;，并启用 try_files $uri $uri/ /index.php?$query_string;
检查 app_debug = true 时的路由调试页，确认 /users/5 是否出现在已注册路由列表中，以及匹配的变量名是不是 id
别开启 url_convert（默认开），它会把 user_info 转成 user-info，但资源路由只认下划线命名，混用直接失配