V Laravel 12 chybí routes/api.php: jak ho přidat?

Pochopení tras API v Laravel 12 Pokud vytváříte rozhraní API pomocí Laravel 12 a všimněte si, že známé routes/api.php soubor chybí, nejste sami. Začněte s Laravel 11, rámec již ve...

Poptat web
Přejít na recenze Přejít na reference

06. 11. 2025

V Laravel 12 chybí routes/api.php: jak ho přidat?

Pochopení tras API v Laravel 12

Pokud vytváříte rozhraní API pomocí Laravel 12 a všimněte si, že známé routes/api.php soubor chybí, nejste sami. Začněte s Laravel 11, rámec již ve výchozím nastavení neobsahuje soubor tras API.

V této příručce je vysvětleno, proč byl soubor odstraněn, jak jej správně obnovit a jaké jsou nejlepší postupy pro strukturování a zabezpečení tras API v systému Laravel 12.

Proč byl Laravel odstraněn api.php ve výchozím nastavení

Filozofie návrhu Laravelu klade důraz na jednoduchost a minimalismus. Protože ne každá aplikace vyžaduje API, rozhodl se hlavní tým vyloučit api.php soubor z nových instalací počínaje Laravelem 11.

Tato změna pomáhá udržet nové projekty lehké. Pokud potřebujete vytvořit API, Laravel nabízí explicitní instalační proces pro přidání potřebných tras a middlewaru.

Jak přidat soubor tras API v Laravel 12

Chcete-li přidat nastavení tras API, spusťte následující příkaz Artisan:

php artisan install:api

Tento příkaz vygeneruje nový routes/api.php a zaregistruje jej v konfiguraci směrování aplikace. Po jeho spuštění můžete definovat trasy API přesně jako v předchozích verzích Laravelu.

Příklad:

use Illuminate\Support\Facades\Route;
 
Route::get('/users', function () {
    return [
        'name' => 'John Doe',
        'email' => 'john@example.com',
    ];
});

Nyní při návštěvě /api/users v prohlížeči nebo klientovi API vrátí odpověď JSON.

Pokud zapomenete spustit php artisan install:api, všechny odkazy na trasy API budou mít za následek. Chyby související s "route not found".

Běžné problémy a opravy

1. api.php soubor nebyl nalezen: Spustit php artisan install:api znovu vytvořit chybějící soubor.

2. Trasa vrací 404: Zkontrolujte, zda je trasa definována pod správným prefixem (/api/...). Laravel automaticky vytvoří předponu všech tras API s koncovkou /api.

Závěr

Pokud váš projekt Laravel 12 neobsahuje routes/api.php, to je záměr. Soubor byl odstraněn, aby byl rámec minimální. Když jej budete potřebovat, jednoduše jej spusťte:

php artisan install:api

Pomocí tohoto příkazu obnovíte úplné lešení API a můžete okamžitě začít vytvářet bezpečné, verzované a efektivní koncové body.

Nový modulární přístup Laravelu zajišťuje, že projekty zůstanou štíhlé a zároveň poskytují vše, co potřebujete pro robustní vývoj API.

Původní článek publikoval Nabil Hassen.