API Versioning

Version your API to allow breaking changes without breaking existing clients. Common strategies: URI prefix (/v1/), header, or query parameter.

Example

// routes/api.php — URI versioning
Route::prefix("v1")->namespace("Api\V1")->group(base_path("routes/api_v1.php"));
Route::prefix("v2")->namespace("Api\V2")->group(base_path("routes/api_v2.php"));
// app/Http/Controllers/Api/V1/UserController.php
// app/Http/Controllers/Api/V2/UserController.php
// V2 returns extra fields without breaking V1 consumers

PHP

Full Editor

Pro Tip

Never remove or rename fields in a versioned API — add a new version instead.

Related Resources

PHP Reference

Complete tag & property list

PHP How-To Guides

Step-by-step practical guides

PHP Exercises

Practice what you've learned