Next.js en front, Laravel en API : l'architecture headless pas à pas
21 Nov 2026 | Développement Web et Mobile
Utiliser Laravel comme API et Next.js comme interface combine le meilleur des deux mondes : un back-end robuste (Eloquent, files d'attente, back-office Filament) et un front-end React rapide, bien référencé grâce au rendu serveur. Voici comment structurer ce duo sans tomber dans les pièges classiques.
Quand choisir cette architecture ?
- Un site public très exposé au SEO et une application métier qui partagent les mêmes données.
- Plusieurs clients pour une même API : site web, application mobile, partenaires.
- Une équipe front qui travaille en React et une équipe back en PHP.
Pour une application interne avec une seule interface, Inertia ou Livewire restent souvent plus simples : un seul projet, une seule authentification, pas de CORS.
La structure
mon-projet/
├── api/ # Laravel (api.mondomaine.com)
└── web/ # Next.js (mondomaine.com)
Un monorepo facilite les changements qui touchent les deux côtés. Laravel Cloud permet d'ailleurs désormais de déployer un front Next.js depuis le même dépôt que l'API (voir notre comparatif Laravel Cloud ou VPS).

Côté Laravel : une API propre
php artisan install:api
La commande installe Sanctum et crée routes/api.php. Exposez vos données via des API Resources, versionnez vos routes et validez avec des Form Requests, comme détaillé dans notre guide API REST Laravel.
L'authentification : deux approches
Option A : cookies de session Sanctum (même domaine parent)
Si le front et l'API partagent un domaine parent (mondomaine.com et api.mondomaine.com), Sanctum peut authentifier le navigateur avec des cookies de session sécurisés et la protection CSRF. Réglages clés côté Laravel :
# .env
SANCTUM_STATEFUL_DOMAINS=mondomaine.com,localhost:3000
SESSION_DOMAIN=.mondomaine.com
Côté navigateur : appeler d'abord /sanctum/csrf-cookie, puis envoyer les requêtes avec credentials: 'include'. Aucun jeton n'est stocké en JavaScript : c'est l'option la plus sûre pour une application web.
Option B : jetons d'API côté serveur Next.js
Next.js reçoit les identifiants, appelle l'API Laravel depuis le serveur (Route Handler ou Server Action), obtient un jeton Sanctum et le conserve dans un cookie HttpOnly de son propre domaine. Les Server Components lisent ce cookie et appellent l'API avec le jeton. Le jeton n'est jamais exposé au JavaScript du navigateur.
// app/lib/api.ts
import { cookies } from 'next/headers';
export async function api(path: string, init: RequestInit = {}) {
const token = (await cookies()).get('api_token')?.value;
const res = await fetch(`${process.env.API_URL}${path}`, {
...init,
headers: {
Accept: 'application/json',
...(token ? { Authorization: `Bearer ${token}` } : {}),
...init.headers,
},
cache: 'no-store',
});
if (!res.ok) throw new Error(`API ${res.status}`);
return res.json();
}
Dans les deux cas, ne stockez jamais un jeton dans localStorage : une seule faille XSS suffirait à le voler.
Le cache : public d'un côté, privé de l'autre
- Données publiques (catalogue, articles) : mises en cache dans Next.js avec
'use cache'et invalidées par tags quand Laravel les modifie (un webhook Laravel appelle une route Next.js qui exécuterevalidateTag()). - Données personnelles : toujours lues à la requête, jamais dans un cache partagé. Les règles d'usage de use cache s'appliquent pleinement ici.
CORS et sécurité
- Dans
config/cors.php, n'autorisez que le domaine du front (jamais*avec des cookies) et activezsupports_credentialspour l'option A. - Limitez le débit des routes d'authentification (
throttle). - Tenez Next.js à jour : les failles de novembre 2026 touchaient précisément le cache et les cookies.
Déploiement
- API Laravel : VPS ou Laravel Cloud, avec files d'attente et tâches planifiées.
- Front Next.js : Vercel, Laravel Cloud ou un VPS avec
next startderrière Nginx. - Variables d'environnement séparées (
API_URLcôté Next.js,FRONTEND_URLcôté Laravel pour les liens dans les e-mails).
Conclusion
Le duo Next.js + Laravel est un excellent choix quand plusieurs interfaces partagent une même API ou que le SEO est critique. La réussite tient en trois points : une API propre et versionnée, une authentification qui ne laisse jamais de jeton dans le navigateur, et une séparation stricte entre cache public et données personnelles.
Commentaires (0)
Aucun commentaire pour le moment.
Laissez un commentaire