Building RESTful APIs with PHP and Laravel

Laravel provides an excellent foundation for building RESTful APIs. Let's explore best practices and patterns for creating robust, scalable APIs.

API Resource Controllers

Laravel's resource controllers make it easy to build RESTful APIs:

// app/Http/Controllers/API/ProductController.php
class ProductController extends Controller
{
    public function index()
    {
        return ProductResource::collection(Product::all());
    }

    public function store(Request $request)
    {
        $validated = $request->validate([
            'name' => 'required|string|max:255',
            'price' => 'required|numeric|min:0',
        ]);

        $product = Product::create($validated);
        return new ProductResource($product);
    }
}

API Resources

Transform your models into clean JSON responses:

class ProductResource extends JsonResource
{
    public function toArray($request)
    {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'price' => $this->price,
            'created_at' => $this->created_at->format('Y-m-d'),
        ];
    }
}

Authentication with Sanctum

// Protect your routes
Route::middleware('auth:sanctum')->group(function () {
    Route::apiResource('products', ProductController::class);
});

Conclusion

Laravel makes API development straightforward and maintainable. With built-in features like resource controllers, API resources, and Sanctum authentication, you can build production-ready APIs quickly.