使用Laravel开发RESTful API需先创建项目并配置数据库，接着生成模型与迁移文件，再创建API控制器并定义路由，最后统一响应格式并启用Sanctum认证机制保护接口。
如果您正在构建一个前后端分离的应用程序，并希望使用 Laravel 提供数据交互支持，则需要开发符合 RESTful 规范的 API 接口。以下是使用 Laravel 开发 RESTful API 的详细步骤：
一、创建 Laravel 项目
在开始开发 API 之前，需要先搭建 Laravel 基础项目环境。通过 Composer 创建一个新的 Laravel 应用，确保系统具备基本的目录结构和配置文件。
1、打开终端并执行命令：composer create-project laravel/laravel api-project，其中 "api-project" 是项目名称。
2、进入项目目录：cd api-project。
3、启动内置服务器测试是否安装成功：php artisan serve，然后访问 http://localhost:8000 查看欢迎页面。
二、配置数据库连接
RESTful API 通常需要与数据库交互以存储和检索资源数据。Laravel 使用 .env 文件管理环境配置，包括数据库连接信息。
1、打开项目根目录下的 .env 文件，修改以下字段为您的数据库信息：
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_password
2、保存文件后，运行迁移命令生成基础数据表：php artisan migrate。
三、生成模型与迁移文件
每个 API 资源通常对应一个 Eloquent 模型和数据库表。使用 Artisan 命令可以快速生成模型及其关联的迁移文件。
1、执行命令创建模型和迁移，例如创建 Post 模型：php artisan make:model Post -m。
2、打开生成的迁移文件（位于 database/migrations 目录），在 up 方法中定义字段，如添加 title 和 content 字段。
3、编辑 app/Models/Post.php 文件，在 $fillable 属性中指定可填充字段，例如 protected $fillable = ['title', 'content'];
4、再次运行 php artisan migrate 将变更应用到数据库。
四、创建 API 控制器
控制器负责处理 HTTP 请求并返回相应的 JSON 响应。Laravel 支持资源控制器，能自动映射标准 CRUD 操作到 RESTful 路由。
1、使用 Artisan 生成资源控制器：php artisan make:controller Api/PostController --api --model=Post。
2、该命令会生成仅包含 index、store、show、update 和 destroy 方法的控制器，适用于 API 场景。
3、在控制器中编写逻辑，例如在 store 方法中验证输入并保存新记录，在 index 中返回分页的 JSON 列表。
五、定义 API 路由
Laravel 将 API 路由集中注册在 routes/api.php 文件中，默认带有 /api 前缀。通过 Route::resource 可一键绑定控制器方法。
1、打开 routes/api.php 文件，添加路由声明：Route::apiResource('posts', 'PostController');
2、此路由将自动映射 GET、POST、PUT、DELETE 等请求到 PostController 对应方法。
3、可通过 php artisan route:list 查看所有已注册的 API 路由及其对应动作。
六、设置响应格式与状态码
RESTful API 应统一返回结构化的 JSON 数据，并附带合适的 HTTP 状态码，便于前端解析和错误处理。
1、在控制器方法中使用 Laravel 的 response()->json() 返回数据，例如 return response()->json($data, 200);
2、对于创建成功的情况返回 201 状态码：return response()->json($post, 201);
3、当资源未找到时，抛出或手动返回 404 响应：return response()->json(['message' => 'Not found'], 404);
七、启用 API 认证机制
为了保护 API 不被未授权访问，建议集成 Laravel Sanctum 实现 Token 认证。
1、安装 Sanctum 包：composer require laravel/sanctum。
2、发布配置和迁移文件：php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"。
3、运行迁移命令更新数据库：php artisan migrate。
4、在 config/auth.php 中将 api guard 的 driver 设置为 sanctum。
5、在需要保护的路由上添加 middleware('auth:sanctum')，例如 Route::middleware('auth:sanctum')->apiResource('posts', 'PostController');
