Laravel怎么在api文件里定义POST接口-php教程-PHP中文网

Laravel API 的 POST 接口在 routes/api.php 中通过 Route::post() 注册，绑定控制器方法（如 UserController@login）或闭包，配合请求验证与 JSON 响应实现；API 路由默认禁用 CSRF，自动解析 JSON/表单数据并支持统一 JSON 返回。

laravel怎么在api文件里定义post接口

在 Laravel 中，API 的 POST 接口不是在“某个 api 文件里”硬编码定义的，而是通过 路由 + 控制器（或闭包） 配合请求验证来实现的。核心位置是 routes/api.php，它专门负责 API 路由注册。

1. 在 routes/api.php 中注册 POST 路由

打开 routes/api.php，用 Route::post() 声明接口：

use App\Http\Controllers\Api\UserController;

// 基础写法：指向控制器方法
Route::post('/login', [UserController::class, 'login']);

// 带参数的 POST（如 /users/123/activate）
Route::post('/users/{id}/activate', [UserController::class, 'activate']);

// 匿名闭包方式（适合简单逻辑，不推荐复杂业务）
Route::post('/test', function (Request $request) {
    return response()->json(['message' => 'Received', 'data' => $request->all()]);
});

2. 创建对应控制器并处理请求

运行命令快速生成 API 控制器：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

php artisan make:controller Http/Controllers/Api/UserController --api

该命令会生成一个不含 create、edit 等视图方法的精简控制器。然后在方法中接收和校验数据：

namespace App\Http\Controllers\Api;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
    public function login(Request $request)
    {
        // 自动验证（推荐）
        $validated = $request->validate([
            'email' => 'required|email',
            'password' => 'required|string|min:6'
        ]);

        // 手动获取字段（等价于 $request->input('email')）
        $email = $request->email;
        $password = $request->password;

        // 你的登录逻辑（如 Auth::attempt()、JWT 生成等）
        // ...

        return response()->json(['token' => 'xxx']);
    }
}

3. 注意关键细节

CSRF 保护默认关闭：API 路由（routes/api.php）自动属于 api 中间件组，已禁用 CSRF，无需额外配置
请求体格式：前端需以 application/json 或 application/x-www-form-urlencoded 发送数据，Laravel 自动解析到 $request
参数获取方式：POST 表单用 $request->input('key')；JSON 请求用 $request->json()->get('key') 或统一用 $request->get('key')（自动适配）
响应格式统一：建议返回 JSON，使用 response()->json(...) 或直接 return [...]（Laravel 自动转 JSON）