以下是关于 Laravel 12 接口开发的详细指南(基于当前最新稳定版):
- 基础配置
首先确保已安装 Laravel 12 和必要依赖:
composer create-project laravel/laravel api-project
cd api-project
- 路由配置 (routes/api.php)
Route::middleware('api')->group(function () {
Route::get('/test', function() {
return response()->json(['status' => 'success']);
});
});
- 控制器创建
php artisan make:controller Api/UserController
- 资源控制器示例 (app/Http/Controllers/Api/UserController.php)
namespace App\Http\Controllers\Api;
use App\Http\Controllers\Controller;
use App\Models\User;
use Illuminate\Http\Request;
class UserController extends Controller
{
public function index()
{
return response()->json(User::all());
}
public function store(Request $request)
{
$validated = $request->validate([
'name' => 'required|string',
'email' => 'required|email|unique:users'
]);
$user = User::create($validated);
return response()->json($user, 201);
}
}
- API 认证(推荐使用 Sanctum)
composer require laravel/sanctum
php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"
php artisan migrate
- 测试接口
使用 Postman 或 curl 测试:
curl -X GET http://yourdomain/api/test
最佳实践建议:
- 使用 API 资源类 (php artisan make:resource)
- 实现标准化响应格式
- 添加请求频率限制
- 使用 OpenAPI/Swagger 生成文档
- 实现 JWT 或 OAuth2 认证
需要具体实现哪个功能模块可以告诉我,我可以提供更详细的代码示例。