[{"data":1,"prerenderedAt":2185},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fbridging-the-gap-connecting-your-frontend-and-backend":3,"series-context-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api":1975},{"id":4,"title":5,"body":6,"contentId":1962,"date":1963,"description":1964,"extension":1965,"github":1966,"meetTheInstructor":1966,"meta":1967,"navigation":131,"part":152,"path":1968,"rawbody":1969,"robots":1966,"schemaOrg":1966,"seo":1970,"seriesSlug":1971,"sitemap":1972,"stem":1973,"subtitle":1966,"topics":1966,"__hash__":1974},"series\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fbridging-the-gap-connecting-your-frontend-and-backend.md","Connecter le front-end, VitePress et le back-end, Laravel",{"type":7,"value":8,"toc":1954},"minimark",[9,13,30,33,41,46,55,58,85,88,105,108,111,114,258,261,268,271,321,324,335,338,370,373,380,400,403,406,421,471,474,525,530,539,600,603,608,643,650,665,676,683,687,690,697,702,709,716,726,734,737,954,969,972,981,1070,1075,1094,1099,1110,1152,1159,1168,1171,1175,1178,1189,1205,1212,1215,1349,1356,1386,1389,1392,1395,1402,1407,1410,1797,1807,1810,1817,1820,1823,1829,1856,1867,1874,1931,1934,1938,1941,1950],[10,11,12],"p",{},"La synchronisation des articles est en place. L'étape suivante consiste à connecter le site VitePress à l'API Laravel.",[10,14,15,16,23,24,29],{},"Comme les deux applications seront déployées séparément, il ne suffit pas d'envoyer une requête vers une URL. Nous devons configurer ",[17,18,22],"a",{"href":19,"rel":20},"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FCross-origin_resource_sharing",[21],"nofollow","CORS (Cross-Origin Resource Sharing)"," et la protection contre les ",[17,25,28],{"href":26,"rel":27},"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FCross-site_request_forgery",[21],"CSRF (Cross-Site Request Forgery)",", puis faire en sorte que le navigateur envoie les identifiants dont Laravel a besoin pour l'authentification par session.",[10,31,32],{},"La configuration peut sembler intimidante au début, mais nous allons traiter chaque élément séparément. Laravel fournit déjà la plupart des briques nécessaires.",[34,35,38],"callout",{"color":36,"icon":37},"success","i-ph-lightbulb-duotone",[10,39,40],{},"Je vous recommande de lire les articles liés si vous souhaitez approfondir ces concepts. La configuration de cet article sera plus facile à comprendre.",[42,43,45],"h2",{"id":44},"installer-laravel-sanctum","Installer Laravel Sanctum",[10,47,48,49,54],{},"L'écosystème Laravel fournit ",[17,50,53],{"href":51,"rel":52},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Fsanctum#spa-authentication",[21],"Sanctum",", qui prend en charge les jetons d'API et l'authentification par cookie pour les applications monopages (SPA).",[10,56,57],{},"Pour commencer, installons Sanctum :",[59,60,66],"pre",{"className":61,"code":62,"filename":63,"language":64,"meta":65,"style":65},"language-bash shiki shiki-themes github-light github-light github-dark","php artisan install:api\n","terminal","bash","",[67,68,69],"code",{"__ignoreMap":65},[70,71,74,78,82],"span",{"class":72,"line":73},"line",1,[70,75,77],{"class":76},"snPdu","php",[70,79,81],{"class":80},"sIIMD"," artisan",[70,83,84],{"class":80}," install:api\n",[10,86,87],{},"Publions ensuite le fichier de configuration de CORS :",[59,89,91],{"className":61,"code":90,"filename":63,"language":64,"meta":65,"style":65},"php artisan config:publish cors\n",[67,92,93],{"__ignoreMap":65},[70,94,95,97,99,102],{"class":72,"line":73},[70,96,77],{"class":76},[70,98,81],{"class":80},[70,100,101],{"class":80}," config:publish",[70,103,104],{"class":80}," cors\n",[10,106,107],{},"CORS, ou Cross-Origin Resource Sharing, est un mécanisme de sécurité du navigateur. Par défaut, les navigateurs empêchent une page d'effectuer des requêtes vers une autre origine. Cela protège les utilisateurs contre les sites malveillants qui tenteraient d'effectuer des actions en leur nom.",[10,109,110],{},"Notre front-end doit communiquer avec une API hébergée sur une autre origine. Nous devons donc autoriser explicitement cette origine dans la configuration de l'API.",[10,112,113],{},"Configurons CORS pour autoriser les requêtes provenant de notre front-end :",[59,115,119],{"className":116,"code":117,"filename":118,"language":77,"meta":65,"style":65},"language-php shiki shiki-themes github-light github-light github-dark has-highlighted","\u003C?php\n\ndeclare(strict_types=1);\n\nreturn [\n    'paths' => ['api\u002F*', 'sanctum\u002Fcsrf-cookie'],\n\n    'allowed_methods' => ['*'],\n\n    'allowed_origins' => [\n        env('APP_FRONTEND_URL'), \u002F\u002F [!code ++]\n    ],\n\n    'allowed_origins_patterns' => [],\n\n    'allowed_headers' => ['*'],\n\n    'exposed_headers' => [],\n\n    'max_age' => 0,\n\n    'supports_credentials' => true, \u002F\u002F [!code highlight]\n\n];\n","config\u002Fcors.php",[67,120,121,126,133,139,144,150,156,161,167,172,178,184,190,195,201,206,212,217,223,228,234,239,247,252],{"__ignoreMap":65},[70,122,123],{"class":72,"line":73},[70,124,125],{},"\u003C?php\n",[70,127,129],{"class":72,"line":128},2,[70,130,132],{"emptyLinePlaceholder":131},true,"\n",[70,134,136],{"class":72,"line":135},3,[70,137,138],{},"declare(strict_types=1);\n",[70,140,142],{"class":72,"line":141},4,[70,143,132],{"emptyLinePlaceholder":131},[70,145,147],{"class":72,"line":146},5,[70,148,149],{},"return [\n",[70,151,153],{"class":72,"line":152},6,[70,154,155],{},"    'paths' => ['api\u002F*', 'sanctum\u002Fcsrf-cookie'],\n",[70,157,159],{"class":72,"line":158},7,[70,160,132],{"emptyLinePlaceholder":131},[70,162,164],{"class":72,"line":163},8,[70,165,166],{},"    'allowed_methods' => ['*'],\n",[70,168,170],{"class":72,"line":169},9,[70,171,132],{"emptyLinePlaceholder":131},[70,173,175],{"class":72,"line":174},10,[70,176,177],{},"    'allowed_origins' => [\n",[70,179,181],{"class":72,"line":180},11,[70,182,183],{},"        env('APP_FRONTEND_URL'), \u002F\u002F [!code ++]\n",[70,185,187],{"class":72,"line":186},12,[70,188,189],{},"    ],\n",[70,191,193],{"class":72,"line":192},13,[70,194,132],{"emptyLinePlaceholder":131},[70,196,198],{"class":72,"line":197},14,[70,199,200],{},"    'allowed_origins_patterns' => [],\n",[70,202,204],{"class":72,"line":203},15,[70,205,132],{"emptyLinePlaceholder":131},[70,207,209],{"class":72,"line":208},16,[70,210,211],{},"    'allowed_headers' => ['*'],\n",[70,213,215],{"class":72,"line":214},17,[70,216,132],{"emptyLinePlaceholder":131},[70,218,220],{"class":72,"line":219},18,[70,221,222],{},"    'exposed_headers' => [],\n",[70,224,226],{"class":72,"line":225},19,[70,227,132],{"emptyLinePlaceholder":131},[70,229,231],{"class":72,"line":230},20,[70,232,233],{},"    'max_age' => 0,\n",[70,235,237],{"class":72,"line":236},21,[70,238,132],{"emptyLinePlaceholder":131},[70,240,244],{"class":241,"line":243},[72,242],"highlighted",22,[70,245,246],{},"    'supports_credentials' => true,",[70,248,250],{"class":72,"line":249},23,[70,251,132],{"emptyLinePlaceholder":131},[70,253,255],{"class":72,"line":254},24,[70,256,257],{},"];\n",[10,259,260],{},"Nous parlerons du déploiement plus tard, mais retenez que nous créons deux applications : le blog et l'API qui l'enrichit. Elles seront déployées séparément, c'est pourquoi l'API doit autoriser les requêtes provenant du blog.",[34,262,265],{"color":263,"icon":264},"info","i-ph-info-duotone",[10,266,267],{},"Nous pourrions déployer les deux applications derrière le même domaine avec un reverse proxy, mais cela ajouterait une complexité dont nous n'avons pas besoin ici.",[10,269,270],{},"Configurons ensuite Sanctum pour autoriser les requêtes de notre front-end :",[59,272,275],{"className":116,"code":273,"filename":274,"language":77,"meta":65,"style":65},"return [\n    'stateful' => explode(',', (string) env('SANCTUM_STATEFUL_DOMAINS', sprintf(\n        '%s%s',\n        'localhost:4173,localhost:5173', \u002F\u002F [!code highlight]\n        Sanctum::currentApplicationUrlWithPort()\n    ))),\n\n  \u002F\u002F ...\n]\n","config\u002Fsanctum.php",[67,276,277,281,286,291,297,302,307,311,316],{"__ignoreMap":65},[70,278,279],{"class":72,"line":73},[70,280,149],{},[70,282,283],{"class":72,"line":128},[70,284,285],{},"    'stateful' => explode(',', (string) env('SANCTUM_STATEFUL_DOMAINS', sprintf(\n",[70,287,288],{"class":72,"line":135},[70,289,290],{},"        '%s%s',\n",[70,292,294],{"class":293,"line":141},[72,242],[70,295,296],{},"        'localhost:4173,localhost:5173',",[70,298,299],{"class":72,"line":146},[70,300,301],{},"        Sanctum::currentApplicationUrlWithPort()\n",[70,303,304],{"class":72,"line":152},[70,305,306],{},"    ))),\n",[70,308,309],{"class":72,"line":158},[70,310,132],{"emptyLinePlaceholder":131},[70,312,313],{"class":72,"line":163},[70,314,315],{},"  \u002F\u002F ...\n",[70,317,318],{"class":72,"line":169},[70,319,320],{},"]\n",[10,322,323],{},"La modification importante consiste à ajouter les origines de développement du front-end aux domaines stateful de Sanctum.",[10,325,326,327,330,331,334],{},"Une origine de navigateur combine le protocole, le nom d'hôte et le port. En développement, ",[67,328,329],{},"localhost:5173"," et ",[67,332,333],{},"localhost:8000"," sont des origines différentes, même si elles partagent le même nom d'hôte.",[10,336,337],{},"Ajoutons ensuite un middleware :",[59,339,343],{"className":340,"code":341,"filename":342,"language":77,"meta":65,"style":65},"language-php shiki shiki-themes github-light github-light github-dark","return Application::configure(basePath: dirname(__DIR__))\n    ->withMiddleware(function (Middleware $middleware): void {\n        $middleware->statefulApi(); \u002F\u002F [!code ++]\n    })\n     ->create();\n","bootstrap\u002Fapp.php",[67,344,345,350,355,360,365],{"__ignoreMap":65},[70,346,347],{"class":72,"line":73},[70,348,349],{},"return Application::configure(basePath: dirname(__DIR__))\n",[70,351,352],{"class":72,"line":128},[70,353,354],{},"    ->withMiddleware(function (Middleware $middleware): void {\n",[70,356,357],{"class":72,"line":135},[70,358,359],{},"        $middleware->statefulApi(); \u002F\u002F [!code ++]\n",[70,361,362],{"class":72,"line":141},[70,363,364],{},"    })\n",[70,366,367],{"class":72,"line":146},[70,368,369],{},"     ->create();\n",[10,371,372],{},"Ce middleware indique à Sanctum d'authentifier les requêtes avec le cookie de session Laravel plutôt qu'avec un jeton d'API. C'est l'approche que nous utiliserons depuis le front-end.",[10,374,375,376,379],{},"Enfin, modifions le middleware d'authentification dans ",[67,377,378],{},"routes\u002Fapi.php",". En réalité, nous utilisons le middleware Laravel par défaut, qui garantit que les requêtes respectent la configuration de Sanctum, notamment les domaines stateful.",[59,381,383],{"className":340,"code":382,"filename":378,"language":77,"meta":65,"style":65},"Route::middleware('auth:sanctum')->group(function () { \u002F\u002F [!code highlight]\n    \u002F\u002F Handle authenticated requests...\n});\n",[67,384,385,390,395],{"__ignoreMap":65},[70,386,387],{"class":72,"line":73},[70,388,389],{},"Route::middleware('auth:sanctum')->group(function () { \u002F\u002F [!code highlight]\n",[70,391,392],{"class":72,"line":128},[70,393,394],{},"    \u002F\u002F Handle authenticated requests...\n",[70,396,397],{"class":72,"line":135},[70,398,399],{},"});\n",[10,401,402],{},"Notre back-end est maintenant prêt à accepter les requêtes du front-end.",[10,404,405],{},"Avant de passer au front-end, terminons quelques modifications du back-end.",[407,408,409],"ol",{},[410,411,412,413,416,417,420],"li",{},"Mettez à jour ",[67,414,415],{},"store"," dans ",[67,418,419],{},"RegisteredViaGitHubController"," afin qu'elle redirige l'utilisateur vers le front-end :",[59,422,425],{"className":340,"code":423,"filename":424,"language":77,"meta":65,"style":65},"final class RegisteredViaGitHubController extends Controller\n{\n    public function store(): RedirectResponse\n    {\n        \u002F\u002F ...\n\n        return redirect(Config::get('app.frontend_url'));\n    }\n}\n","app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php",[67,426,427,432,437,442,447,452,456,461,466],{"__ignoreMap":65},[70,428,429],{"class":72,"line":73},[70,430,431],{},"final class RegisteredViaGitHubController extends Controller\n",[70,433,434],{"class":72,"line":128},[70,435,436],{},"{\n",[70,438,439],{"class":72,"line":135},[70,440,441],{},"    public function store(): RedirectResponse\n",[70,443,444],{"class":72,"line":141},[70,445,446],{},"    {\n",[70,448,449],{"class":72,"line":146},[70,450,451],{},"        \u002F\u002F ...\n",[70,453,454],{"class":72,"line":152},[70,455,132],{"emptyLinePlaceholder":131},[70,457,458],{"class":72,"line":158},[70,459,460],{},"        return redirect(Config::get('app.frontend_url'));\n",[70,462,463],{"class":72,"line":163},[70,464,465],{},"    }\n",[70,467,468],{"class":72,"line":169},[70,469,470],{},"}\n",[10,472,473],{},"Mettez également son test à jour :",[59,475,478],{"className":340,"code":476,"filename":477,"language":77,"meta":65,"style":65},"\u002F\u002F ...\n\ntest('redirects to the frontend', function () {\n    fakeGitHubUser();\n\n    $this->get(route('auth.github.callback'))\n        ->assertRedirect(config('app.frontend_url')); \u002F\u002F [!code highlight]\n});\n\n\u002F\u002F ...\n","tests\u002FHttp\u002FRegisteredViaGitHub\u002FStoreTest.php",[67,479,480,485,489,494,499,503,508,513,517,521],{"__ignoreMap":65},[70,481,482],{"class":72,"line":73},[70,483,484],{},"\u002F\u002F ...\n",[70,486,487],{"class":72,"line":128},[70,488,132],{"emptyLinePlaceholder":131},[70,490,491],{"class":72,"line":135},[70,492,493],{},"test('redirects to the frontend', function () {\n",[70,495,496],{"class":72,"line":141},[70,497,498],{},"    fakeGitHubUser();\n",[70,500,501],{"class":72,"line":146},[70,502,132],{"emptyLinePlaceholder":131},[70,504,505],{"class":72,"line":152},[70,506,507],{},"    $this->get(route('auth.github.callback'))\n",[70,509,510],{"class":72,"line":158},[70,511,512],{},"        ->assertRedirect(config('app.frontend_url')); \u002F\u002F [!code highlight]\n",[70,514,515],{"class":72,"line":163},[70,516,399],{},[70,518,519],{"class":72,"line":169},[70,520,132],{"emptyLinePlaceholder":131},[70,522,523],{"class":72,"line":174},[70,524,484],{},[407,526,527],{"start":128},[410,528,529],{},"Ajoutez un seeder qui génère des commentaires d'exemple :",[34,531,532],{"color":36,"icon":37},[10,533,534,535,538],{},"Supprimez le contenu existant de la méthode ",[67,536,537],{},"run"," du seeder avant d'ajouter ce code.",[59,540,543],{"className":340,"code":541,"filename":542,"language":77,"meta":65,"style":65},"use App\\Models\\Post;\n\nfinal class DatabaseSeeder extends Seeder\n{\n    public function run(): void\n    {\n        Post::factory()\n            ->count(10)\n            ->hasComments(5)\n            ->create();\n    }\n}\n","database\u002Fseeders\u002FDatabaseSeeder.php",[67,544,545,550,554,559,563,568,572,577,582,587,592,596],{"__ignoreMap":65},[70,546,547],{"class":72,"line":73},[70,548,549],{},"use App\\Models\\Post;\n",[70,551,552],{"class":72,"line":128},[70,553,132],{"emptyLinePlaceholder":131},[70,555,556],{"class":72,"line":135},[70,557,558],{},"final class DatabaseSeeder extends Seeder\n",[70,560,561],{"class":72,"line":141},[70,562,436],{},[70,564,565],{"class":72,"line":146},[70,566,567],{},"    public function run(): void\n",[70,569,570],{"class":72,"line":152},[70,571,446],{},[70,573,574],{"class":72,"line":158},[70,575,576],{},"        Post::factory()\n",[70,578,579],{"class":72,"line":163},[70,580,581],{},"            ->count(10)\n",[70,583,584],{"class":72,"line":169},[70,585,586],{},"            ->hasComments(5)\n",[70,588,589],{"class":72,"line":174},[70,590,591],{},"            ->create();\n",[70,593,594],{"class":72,"line":180},[70,595,465],{},[70,597,598],{"class":72,"line":186},[70,599,470],{},[10,601,602],{},"Cela crée 10 articles avec cinq commentaires chacun, ce qui nous donne des données pour tester le front-end.",[407,604,605],{"start":135},[410,606,607],{},"Recréez la base de données et exécutez les migrations :",[59,609,611],{"className":61,"code":610,"filename":63,"language":64,"meta":65,"style":65},"rm database\u002Fdatabase.sqlite && touch database\u002Fdatabase.sqlite && php artisan migrate --seed\n",[67,612,613],{"__ignoreMap":65},[70,614,615,618,621,625,628,630,632,634,636,639],{"class":72,"line":73},[70,616,617],{"class":76},"rm",[70,619,620],{"class":80}," database\u002Fdatabase.sqlite",[70,622,624],{"class":623},"sxrX7"," && ",[70,626,627],{"class":76},"touch",[70,629,620],{"class":80},[70,631,624],{"class":623},[70,633,77],{"class":76},[70,635,81],{"class":80},[70,637,638],{"class":80}," migrate",[70,640,642],{"class":641},"sBjJW"," --seed\n",[10,644,645,646,649],{},"Nous recréons la base de données car, jusqu'à présent, les tests utilisaient une base SQLite en mémoire. La base locale contient encore la table ",[67,647,648],{},"users"," créée par le scaffold initial, et non la version adaptée à l'authentification GitHub.",[407,651,652],{"start":141},[410,653,654,655,416,658,330,661,664],{},"Définissez ",[67,656,657],{},"APP_FRONTEND_URL",[67,659,660],{},".env",[67,662,663],{},".env.example"," avec l'URL de développement du front-end :",[59,666,670],{"className":667,"code":668,"filename":660,"language":669,"meta":65,"style":65},"language-ini shiki shiki-themes github-light github-light github-dark","APP_FRONTEND_URL=http:\u002F\u002Flocalhost:5173\n","ini",[67,671,672],{"__ignoreMap":65},[70,673,674],{"class":72,"line":73},[70,675,668],{},[10,677,678,679,682],{},"Jusqu'ici, elle pointait vers ",[67,680,681],{},"http:\u002F\u002Flocalhost:4173",", le serveur de prévisualisation VitePress.",[42,684,686],{"id":685},"se-connecter-au-back-end-depuis-le-front-end","Se connecter au back-end depuis le front-end",[10,688,689],{},"Dans cette section, nous effectuerons les premières requêtes depuis le front-end et vérifierons que la connexion fonctionne.",[34,691,694],{"color":692,"icon":693},"warning","i-ph-warning-duotone",[10,695,696],{},"Ce n'est pas la version finale du code. Nous l'améliorerons dans l'article suivant.",[698,699,701],"h3",{"id":700},"authentification-sociale","Authentification sociale",[10,703,704,705,708],{},"La première fonctionnalité que nous pouvons tester est l'authentification sociale. Nous ajouterons un bouton dans l'en-tête qui pointe vers ",[67,706,707],{},"\u002Fauth\u002Fgithub\u002Fredirect"," sur le back-end. Comme l'URL du back-end sera différente en développement et en production, nous stockerons son URL de base dans une variable d'environnement. L'utilisateur sera ensuite redirigé vers GitHub, puis vers le front-end après avoir autorisé l'application.",[10,710,711,712,715],{},"Pour cette variable d'environnement, nous pouvons utiliser le préfixe ",[67,713,714],{},"VITE_"," afin de l'exposer au front-end :",[59,717,720],{"className":667,"code":718,"filename":719,"language":669,"meta":65,"style":65},"VITE_API_URL=http:\u002F\u002Flocalhost:8000\n","src\u002F.env",[67,721,722],{"__ignoreMap":65},[70,723,724],{"class":72,"line":73},[70,725,718],{},[34,727,728],{"color":36,"icon":37},[10,729,730,731,733],{},"Vous pouvez ajouter cette variable sans risque au fichier ",[67,732,663],{},".",[10,735,736],{},"Ajoutez maintenant le bouton à l'en-tête :",[59,738,743],{"className":739,"code":740,"filename":741,"language":742,"meta":65,"style":65},"language-vue shiki shiki-themes github-light github-light github-dark has-diff","\u003Cscript lang=\"ts\" setup>\n\u002F\u002F ...\n\nconst loginUrl = `${import.meta.env.VITE_API_URL}\u002Fauth\u002Fgithub\u002Fredirect` \u002F\u002F [!code ++]\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cheader class=\"border-b-4 border-black bg-white p-8\">\n    \u003C!-- ... -->\n\n    \u003Cdiv class=\"flex items-center gap-6\">\n      \u003C!-- ... -->\n\n      \u003CButton :href=\"loginUrl\" label=\"Connexion\" \u002F> \u003C!-- [!code ++] -->\n    \u003C\u002Fdiv>\n  \u003C\u002Fheader>\n\u003C\u002Ftemplate>\n",".vitepress\u002Ftheme\u002Fcommon\u002Fcomponents\u002FTheHeader.vue","vue",[67,744,745,769,774,778,817,826,830,839,857,862,866,883,888,892,928,937,946],{"__ignoreMap":65},[70,746,747,750,754,757,760,763,766],{"class":72,"line":73},[70,748,749],{"class":623},"\u003C",[70,751,753],{"class":752},"sovSZ","script",[70,755,756],{"class":76}," lang",[70,758,759],{"class":623},"=",[70,761,762],{"class":80},"\"ts\"",[70,764,765],{"class":76}," setup",[70,767,768],{"class":623},">\n",[70,770,771],{"class":72,"line":128},[70,772,484],{"class":773},"sCsY4",[70,775,776],{"class":72,"line":135},[70,777,132],{"emptyLinePlaceholder":131},[70,779,783,787,790,793,796,799,801,804,806,809,811,814],{"class":780,"line":141},[72,781,782],"diff","add",[70,784,786],{"class":785},"s8jYJ","const",[70,788,789],{"class":641}," loginUrl",[70,791,792],{"class":785}," =",[70,794,795],{"class":80}," `${",[70,797,798],{"class":785},"import",[70,800,733],{"class":80},[70,802,803],{"class":641},"meta",[70,805,733],{"class":80},[70,807,808],{"class":623},"env",[70,810,733],{"class":80},[70,812,813],{"class":641},"VITE_API_URL",[70,815,816],{"class":80},"}\u002Fauth\u002Fgithub\u002Fredirect`",[70,818,819,822,824],{"class":72,"line":146},[70,820,821],{"class":623},"\u003C\u002F",[70,823,753],{"class":752},[70,825,768],{"class":623},[70,827,828],{"class":72,"line":152},[70,829,132],{"emptyLinePlaceholder":131},[70,831,832,834,837],{"class":72,"line":158},[70,833,749],{"class":623},[70,835,836],{"class":752},"template",[70,838,768],{"class":623},[70,840,841,844,847,850,852,855],{"class":72,"line":163},[70,842,843],{"class":623},"  \u003C",[70,845,846],{"class":752},"header",[70,848,849],{"class":76}," class",[70,851,759],{"class":623},[70,853,854],{"class":80},"\"border-b-4 border-black bg-white p-8\"",[70,856,768],{"class":623},[70,858,859],{"class":72,"line":169},[70,860,861],{"class":773},"    \u003C!-- ... -->\n",[70,863,864],{"class":72,"line":174},[70,865,132],{"emptyLinePlaceholder":131},[70,867,868,871,874,876,878,881],{"class":72,"line":180},[70,869,870],{"class":623},"    \u003C",[70,872,873],{"class":752},"div",[70,875,849],{"class":76},[70,877,759],{"class":623},[70,879,880],{"class":80},"\"flex items-center gap-6\"",[70,882,768],{"class":623},[70,884,885],{"class":72,"line":186},[70,886,887],{"class":773},"      \u003C!-- ... -->\n",[70,889,890],{"class":72,"line":192},[70,891,132],{"emptyLinePlaceholder":131},[70,893,895,898,901,904,907,909,912,915,917,920,922,925],{"class":894,"line":197},[72,781,782],[70,896,897],{"class":623},"      \u003C",[70,899,900],{"class":752},"Button",[70,902,903],{"class":623}," :",[70,905,906],{"class":76},"href",[70,908,759],{"class":623},[70,910,911],{"class":80},"\"",[70,913,914],{"class":623},"loginUrl",[70,916,911],{"class":80},[70,918,919],{"class":76}," label",[70,921,759],{"class":623},[70,923,924],{"class":80},"\"Connexion\"",[70,926,927],{"class":623}," \u002F> ",[70,929,930,933,935],{"class":72,"line":203},[70,931,932],{"class":623},"    \u003C\u002F",[70,934,873],{"class":752},[70,936,768],{"class":623},[70,938,939,942,944],{"class":72,"line":208},[70,940,941],{"class":623},"  \u003C\u002F",[70,943,846],{"class":752},[70,945,768],{"class":623},[70,947,948,950,952],{"class":72,"line":214},[70,949,821],{"class":623},[70,951,836],{"class":752},[70,953,768],{"class":623},[10,955,956,957,959,960,962,963,965,966,733],{},"Nous utilisons ",[67,958,813],{}," pour construire l'URL de connexion. Lorsque Vite démarre, il charge ",[67,961,719],{}," et expose les variables préfixées par ",[67,964,714],{}," via ",[67,967,968],{},"import.meta.env",[10,970,971],{},"Nous pouvons également ajouter les types de cet objet afin d'améliorer l'expérience de développement.",[407,973,974],{},[410,975,976,977,980],{},"Créez un fichier ",[67,978,979],{},"vite-env.d.ts"," à la racine du projet :",[59,982,986],{"className":983,"code":984,"filename":979,"language":985,"meta":65,"style":65},"language-ts shiki shiki-themes github-light github-light github-dark","\u002F\u002F\u002F \u003Creference types=\"vite\u002Fclient\" \u002F>\n\ninterface ImportMetaEnv {\n  readonly VITE_API_URL: string\n}\n\ninterface ImportMeta {\n  readonly env: ImportMetaEnv\n}\n","ts",[67,987,988,1007,1011,1022,1037,1041,1045,1054,1066],{"__ignoreMap":65},[70,989,990,993,996,999,1001,1004],{"class":72,"line":73},[70,991,992],{"class":773},"\u002F\u002F\u002F \u003C",[70,994,995],{"class":752},"reference",[70,997,998],{"class":76}," types",[70,1000,759],{"class":785},[70,1002,1003],{"class":80},"\"vite\u002Fclient\"",[70,1005,1006],{"class":773}," \u002F>\n",[70,1008,1009],{"class":72,"line":128},[70,1010,132],{"emptyLinePlaceholder":131},[70,1012,1013,1016,1019],{"class":72,"line":135},[70,1014,1015],{"class":785},"interface",[70,1017,1018],{"class":76}," ImportMetaEnv",[70,1020,1021],{"class":623}," {\n",[70,1023,1024,1027,1031,1034],{"class":72,"line":141},[70,1025,1026],{"class":785},"  readonly",[70,1028,1030],{"class":1029},"sP4rz"," VITE_API_URL",[70,1032,1033],{"class":785},":",[70,1035,1036],{"class":641}," string\n",[70,1038,1039],{"class":72,"line":146},[70,1040,470],{"class":623},[70,1042,1043],{"class":72,"line":152},[70,1044,132],{"emptyLinePlaceholder":131},[70,1046,1047,1049,1052],{"class":72,"line":158},[70,1048,1015],{"class":785},[70,1050,1051],{"class":76}," ImportMeta",[70,1053,1021],{"class":623},[70,1055,1056,1058,1061,1063],{"class":72,"line":163},[70,1057,1026],{"class":785},[70,1059,1060],{"class":1029}," env",[70,1062,1033],{"class":785},[70,1064,1065],{"class":76}," ImportMetaEnv\n",[70,1067,1068],{"class":72,"line":169},[70,1069,470],{"class":623},[407,1071,1072],{"start":128},[410,1073,1074],{},"Installez Vite comme dépendance de développement :",[59,1076,1078],{"className":61,"code":1077,"filename":63,"language":64,"meta":65,"style":65},"npm install -D vite\n",[67,1079,1080],{"__ignoreMap":65},[70,1081,1082,1085,1088,1091],{"class":72,"line":73},[70,1083,1084],{"class":76},"npm",[70,1086,1087],{"class":80}," install",[70,1089,1090],{"class":641}," -D",[70,1092,1093],{"class":80}," vite\n",[34,1095,1096],{"color":263,"icon":264},[10,1097,1098],{},"Le gestionnaire de paquets pnpm ne rend accessibles que les packages installés directement dans le projet. Même si VitePress utilise Vite, nous devons donc l'installer pour accéder à ses types.",[407,1100,1101],{"start":135},[410,1102,1103,1104,1106,1107,903],{},"Ajoutez le fichier ",[67,1105,979],{}," à ",[67,1108,1109],{},"tsconfig.json",[59,1111,1115],{"className":1112,"code":1113,"filename":1109,"language":1114,"meta":65,"style":65},"language-json shiki shiki-themes github-light github-light github-dark has-highlighted","{\n  \"include\": [\n    \".\u002F.vitepress\u002F**\u002F*\",\n    \"vite-env.d.ts\" \u002F\u002F [!code highlight]\n  ]\n}\n","json",[67,1116,1117,1121,1129,1137,1143,1148],{"__ignoreMap":65},[70,1118,1119],{"class":72,"line":73},[70,1120,436],{"class":623},[70,1122,1123,1126],{"class":72,"line":128},[70,1124,1125],{"class":641},"  \"include\"",[70,1127,1128],{"class":623},": [\n",[70,1130,1131,1134],{"class":72,"line":135},[70,1132,1133],{"class":80},"    \".\u002F.vitepress\u002F**\u002F*\"",[70,1135,1136],{"class":623},",\n",[70,1138,1140],{"class":1139,"line":141},[72,242],[70,1141,1142],{"class":80},"    \"vite-env.d.ts\"",[70,1144,1145],{"class":72,"line":146},[70,1146,1147],{"class":623},"  ]\n",[70,1149,1150],{"class":72,"line":152},[70,1151,470],{"class":623},[10,1153,1154,1156,1157,733],{},[67,1155,968],{}," est maintenant typé et TypeScript connaît ",[67,1158,813],{},[1160,1161,1162,1163],"video",{"autoPlay":131,"loop":131,"muted":131,"playsInline":131},"\n  ",[1164,1165],"source",{"src":1166,"type":1167},"https:\u002F\u002Fimages.soubiran.dev\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fbridging-the-gap-connecting-your-frontend-and-backend\u002Fsocial-authentication-workflow.mp4","video\u002Fmp4",[10,1169,1170],{},"En cliquant sur le bouton, nous devons être redirigés vers GitHub pour l'autorisation, puis vers le front-end. La première connexion fonctionne.",[698,1172,1174],{"id":1173},"créer-un-commentaire","Créer un commentaire",[10,1176,1177],{},"La deuxième fonctionnalité que nous pouvons tester est la création d'un commentaire. Si elle fonctionne, nous pourrons passer à l'article suivant en sachant que le back-end et le front-end communiquent correctement.",[10,1179,1180,1181,1184,1185,1188],{},"Pour effectuer les requêtes, nous utiliserons ",[67,1182,1183],{},"ofetch",". Il encapsule l'API native ",[67,1186,1187],{},"fetch"," et ajoute la sérialisation des corps JSON, les tentatives automatiques, une URL de base et des intercepteurs.",[59,1190,1192],{"className":61,"code":1191,"filename":63,"language":64,"meta":65,"style":65},"pnpm add ofetch\n",[67,1193,1194],{"__ignoreMap":65},[70,1195,1196,1199,1202],{"class":72,"line":73},[70,1197,1198],{"class":76},"pnpm",[70,1200,1201],{"class":80}," add",[70,1203,1204],{"class":80}," ofetch\n",[10,1206,1207,1208,1211],{},"Nous effectuerons la première requête depuis ",[67,1209,1210],{},"Layout.vue"," comme test temporaire.",[10,1213,1214],{},"Commençons par une requête simple :",[59,1216,1220],{"className":1217,"code":1218,"filename":1219,"language":742,"meta":65,"style":65},"language-vue shiki shiki-themes github-light github-light github-dark","\u003Cscript lang=\"ts\" setup>\nimport { ofetch } from 'ofetch'\n\nofetch('\u002Fapi\u002Fposts\u002F1\u002Fcomments', {\n  baseURL: import.meta.env.VITE_API_URL,\n  method: 'POST',\n  body: {\n    content: 'Hello world!',\n  },\n  headers: {\n    Accept: 'application\u002Fjson',\n  }\n})\n\u003C\u002Fscript>\n",".vitepress\u002Ftheme\u002FLayout.vue",[67,1221,1222,1238,1251,1255,1268,1286,1296,1301,1311,1316,1321,1331,1336,1341],{"__ignoreMap":65},[70,1223,1224,1226,1228,1230,1232,1234,1236],{"class":72,"line":73},[70,1225,749],{"class":623},[70,1227,753],{"class":752},[70,1229,756],{"class":76},[70,1231,759],{"class":623},[70,1233,762],{"class":80},[70,1235,765],{"class":76},[70,1237,768],{"class":623},[70,1239,1240,1242,1245,1248],{"class":72,"line":128},[70,1241,798],{"class":785},[70,1243,1244],{"class":623}," { ofetch } ",[70,1246,1247],{"class":785},"from",[70,1249,1250],{"class":80}," 'ofetch'\n",[70,1252,1253],{"class":72,"line":135},[70,1254,132],{"emptyLinePlaceholder":131},[70,1256,1257,1259,1262,1265],{"class":72,"line":141},[70,1258,1183],{"class":76},[70,1260,1261],{"class":623},"(",[70,1263,1264],{"class":80},"'\u002Fapi\u002Fposts\u002F1\u002Fcomments'",[70,1266,1267],{"class":623},", {\n",[70,1269,1270,1273,1275,1277,1279,1282,1284],{"class":72,"line":146},[70,1271,1272],{"class":623},"  baseURL: ",[70,1274,798],{"class":785},[70,1276,733],{"class":623},[70,1278,803],{"class":641},[70,1280,1281],{"class":623},".env.",[70,1283,813],{"class":641},[70,1285,1136],{"class":623},[70,1287,1288,1291,1294],{"class":72,"line":152},[70,1289,1290],{"class":623},"  method: ",[70,1292,1293],{"class":80},"'POST'",[70,1295,1136],{"class":623},[70,1297,1298],{"class":72,"line":158},[70,1299,1300],{"class":623},"  body: {\n",[70,1302,1303,1306,1309],{"class":72,"line":163},[70,1304,1305],{"class":623},"    content: ",[70,1307,1308],{"class":80},"'Hello world!'",[70,1310,1136],{"class":623},[70,1312,1313],{"class":72,"line":169},[70,1314,1315],{"class":623},"  },\n",[70,1317,1318],{"class":72,"line":174},[70,1319,1320],{"class":623},"  headers: {\n",[70,1322,1323,1326,1329],{"class":72,"line":180},[70,1324,1325],{"class":623},"    Accept: ",[70,1327,1328],{"class":80},"'application\u002Fjson'",[70,1330,1136],{"class":623},[70,1332,1333],{"class":72,"line":186},[70,1334,1335],{"class":623},"  }\n",[70,1337,1338],{"class":72,"line":192},[70,1339,1340],{"class":623},"})\n",[70,1342,1343,1345,1347],{"class":72,"line":197},[70,1344,821],{"class":623},[70,1346,753],{"class":752},[70,1348,768],{"class":623},[10,1350,1351,1352,1355],{},"Cette requête semble suffisante, mais l'onglet réseau du navigateur montre une réponse ",[67,1353,1354],{},"419",". L'aperçu de la réponse contient :",[59,1357,1361],{"className":1358,"code":1359,"filename":1360,"language":1114,"meta":65,"style":65},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"message\": \"CSRF token mismatch.\"\n  \u002F\u002F ...\n}\n","Exemple",[67,1362,1363,1367,1378,1382],{"__ignoreMap":65},[70,1364,1365],{"class":72,"line":73},[70,1366,436],{"class":623},[70,1368,1369,1372,1375],{"class":72,"line":128},[70,1370,1371],{"class":641},"  \"message\"",[70,1373,1374],{"class":623},": ",[70,1376,1377],{"class":80},"\"CSRF token mismatch.\"\n",[70,1379,1380],{"class":72,"line":135},[70,1381,315],{"class":773},[70,1383,1384],{"class":72,"line":141},[70,1385,470],{"class":623},[10,1387,1388],{},"L'erreur est explicite : la requête a besoin d'un jeton CSRF.",[10,1390,1391],{},"Qu'est-ce qu'un jeton CSRF et comment le gérer dans une SPA ?",[10,1393,1394],{},"Un jeton CSRF contribue à empêcher les attaques Cross-Site Request Forgery. Il permet au serveur de vérifier qu'une requête qui modifie l'état vient bien de notre application et non d'un site malveillant agissant au nom d'un utilisateur authentifié. Dans une application rendue côté serveur, le jeton est intégré au HTML. Dans une SPA, nous devons le récupérer et l'envoyer séparément.",[10,1396,1397,1398,1401],{},"Laravel stocke le jeton dans la session et place également une valeur chiffrée dans un cookie que le JavaScript de notre site peut lire. Nous envoyons cette valeur dans l'en-tête ",[67,1399,1400],{},"X-XSRF-TOKEN",", et Laravel la compare à celle de la session.",[34,1403,1404],{"color":263,"icon":264},[10,1405,1406],{},"Nous ne pouvons pas faire confiance au cookie seul, car le navigateur l'envoie automatiquement avec les requêtes. C'est l'en-tête explicite qui prouve que notre JavaScript a volontairement inclus le jeton.",[10,1408,1409],{},"Ajoutons le jeton CSRF à la requête :",[59,1411,1413],{"className":1217,"code":1412,"filename":1219,"language":742,"meta":65,"style":65},"\u003Cscript lang=\"ts\" setup>\nimport { ofetch } from 'ofetch'\n\nfunction getCookie(name: string) {\n  const match = document.cookie.match(new RegExp(`(^| )${name}=([^;]+)`))\n  return match ? match[2] : null\n}\n\nofetch('\u002Fapi\u002Fposts\u002F1\u002Fcomments', {\n  \u002F\u002F ...\n  onRequest: async ({ options }) => {\n    const method = options.method?.toUpperCase() || 'GET'\n\n    if (['GET', 'HEAD', 'OPTIONS'].includes(method)) {\n      return\n    }\n\n    const xsrfToken = getCookie('XSRF-TOKEN')\n\n    if (!xsrfToken) {\n      await ofetch('\u002Fsanctum\u002Fcsrf-cookie', {\n        baseURL: import.meta.env.VITE_API_URL,\n        credentials: 'include',\n      })\n    }\n\n    options.headers.set('X-Xsrf-Token', decodeURIComponent(getCookie('XSRF-TOKEN') || ''))\n  },\n})\n\u003C\u002Fscript>\n",[67,1414,1415,1431,1441,1445,1466,1503,1528,1532,1536,1546,1550,1574,1599,1603,1634,1639,1643,1647,1666,1670,1683,1698,1715,1725,1730,1735,1740,1778,1783,1788],{"__ignoreMap":65},[70,1416,1417,1419,1421,1423,1425,1427,1429],{"class":72,"line":73},[70,1418,749],{"class":623},[70,1420,753],{"class":752},[70,1422,756],{"class":76},[70,1424,759],{"class":623},[70,1426,762],{"class":80},[70,1428,765],{"class":76},[70,1430,768],{"class":623},[70,1432,1433,1435,1437,1439],{"class":72,"line":128},[70,1434,798],{"class":785},[70,1436,1244],{"class":623},[70,1438,1247],{"class":785},[70,1440,1250],{"class":80},[70,1442,1443],{"class":72,"line":135},[70,1444,132],{"emptyLinePlaceholder":131},[70,1446,1447,1450,1453,1455,1458,1460,1463],{"class":72,"line":141},[70,1448,1449],{"class":785},"function",[70,1451,1452],{"class":76}," getCookie",[70,1454,1261],{"class":623},[70,1456,1457],{"class":1029},"name",[70,1459,1033],{"class":785},[70,1461,1462],{"class":641}," string",[70,1464,1465],{"class":623},") {\n",[70,1467,1468,1471,1474,1476,1479,1482,1484,1487,1490,1492,1495,1497,1500],{"class":72,"line":146},[70,1469,1470],{"class":785},"  const",[70,1472,1473],{"class":641}," match",[70,1475,792],{"class":785},[70,1477,1478],{"class":623}," document.cookie.",[70,1480,1481],{"class":76},"match",[70,1483,1261],{"class":623},[70,1485,1486],{"class":785},"new",[70,1488,1489],{"class":76}," RegExp",[70,1491,1261],{"class":623},[70,1493,1494],{"class":80},"`(^| )${",[70,1496,1457],{"class":623},[70,1498,1499],{"class":80},"}=([^;]+)`",[70,1501,1502],{"class":623},"))\n",[70,1504,1505,1508,1511,1514,1517,1520,1523,1525],{"class":72,"line":152},[70,1506,1507],{"class":785},"  return",[70,1509,1510],{"class":623}," match ",[70,1512,1513],{"class":785},"?",[70,1515,1516],{"class":623}," match[",[70,1518,1519],{"class":641},"2",[70,1521,1522],{"class":623},"] ",[70,1524,1033],{"class":785},[70,1526,1527],{"class":641}," null\n",[70,1529,1530],{"class":72,"line":158},[70,1531,470],{"class":623},[70,1533,1534],{"class":72,"line":163},[70,1535,132],{"emptyLinePlaceholder":131},[70,1537,1538,1540,1542,1544],{"class":72,"line":169},[70,1539,1183],{"class":76},[70,1541,1261],{"class":623},[70,1543,1264],{"class":80},[70,1545,1267],{"class":623},[70,1547,1548],{"class":72,"line":174},[70,1549,315],{"class":773},[70,1551,1552,1555,1557,1560,1563,1566,1569,1572],{"class":72,"line":180},[70,1553,1554],{"class":76},"  onRequest",[70,1556,1374],{"class":623},[70,1558,1559],{"class":785},"async",[70,1561,1562],{"class":623}," ({ ",[70,1564,1565],{"class":1029},"options",[70,1567,1568],{"class":623}," }) ",[70,1570,1571],{"class":785},"=>",[70,1573,1021],{"class":623},[70,1575,1576,1579,1582,1584,1587,1590,1593,1596],{"class":72,"line":186},[70,1577,1578],{"class":785},"    const",[70,1580,1581],{"class":641}," method",[70,1583,792],{"class":785},[70,1585,1586],{"class":623}," options.method?.",[70,1588,1589],{"class":76},"toUpperCase",[70,1591,1592],{"class":623},"() ",[70,1594,1595],{"class":785},"||",[70,1597,1598],{"class":80}," 'GET'\n",[70,1600,1601],{"class":72,"line":192},[70,1602,132],{"emptyLinePlaceholder":131},[70,1604,1605,1608,1611,1614,1617,1620,1622,1625,1628,1631],{"class":72,"line":197},[70,1606,1607],{"class":785},"    if",[70,1609,1610],{"class":623}," ([",[70,1612,1613],{"class":80},"'GET'",[70,1615,1616],{"class":623},", ",[70,1618,1619],{"class":80},"'HEAD'",[70,1621,1616],{"class":623},[70,1623,1624],{"class":80},"'OPTIONS'",[70,1626,1627],{"class":623},"].",[70,1629,1630],{"class":76},"includes",[70,1632,1633],{"class":623},"(method)) {\n",[70,1635,1636],{"class":72,"line":203},[70,1637,1638],{"class":785},"      return\n",[70,1640,1641],{"class":72,"line":208},[70,1642,465],{"class":623},[70,1644,1645],{"class":72,"line":214},[70,1646,132],{"emptyLinePlaceholder":131},[70,1648,1649,1651,1654,1656,1658,1660,1663],{"class":72,"line":219},[70,1650,1578],{"class":785},[70,1652,1653],{"class":641}," xsrfToken",[70,1655,792],{"class":785},[70,1657,1452],{"class":76},[70,1659,1261],{"class":623},[70,1661,1662],{"class":80},"'XSRF-TOKEN'",[70,1664,1665],{"class":623},")\n",[70,1667,1668],{"class":72,"line":225},[70,1669,132],{"emptyLinePlaceholder":131},[70,1671,1672,1674,1677,1680],{"class":72,"line":230},[70,1673,1607],{"class":785},[70,1675,1676],{"class":623}," (",[70,1678,1679],{"class":785},"!",[70,1681,1682],{"class":623},"xsrfToken) {\n",[70,1684,1685,1688,1691,1693,1696],{"class":72,"line":236},[70,1686,1687],{"class":785},"      await",[70,1689,1690],{"class":76}," ofetch",[70,1692,1261],{"class":623},[70,1694,1695],{"class":80},"'\u002Fsanctum\u002Fcsrf-cookie'",[70,1697,1267],{"class":623},[70,1699,1700,1703,1705,1707,1709,1711,1713],{"class":72,"line":243},[70,1701,1702],{"class":623},"        baseURL: ",[70,1704,798],{"class":785},[70,1706,733],{"class":623},[70,1708,803],{"class":641},[70,1710,1281],{"class":623},[70,1712,813],{"class":641},[70,1714,1136],{"class":623},[70,1716,1717,1720,1723],{"class":72,"line":249},[70,1718,1719],{"class":623},"        credentials: ",[70,1721,1722],{"class":80},"'include'",[70,1724,1136],{"class":623},[70,1726,1727],{"class":72,"line":254},[70,1728,1729],{"class":623},"      })\n",[70,1731,1733],{"class":72,"line":1732},25,[70,1734,465],{"class":623},[70,1736,1738],{"class":72,"line":1737},26,[70,1739,132],{"emptyLinePlaceholder":131},[70,1741,1743,1746,1749,1751,1754,1756,1759,1761,1764,1766,1768,1771,1773,1776],{"class":72,"line":1742},27,[70,1744,1745],{"class":623},"    options.headers.",[70,1747,1748],{"class":76},"set",[70,1750,1261],{"class":623},[70,1752,1753],{"class":80},"'X-Xsrf-Token'",[70,1755,1616],{"class":623},[70,1757,1758],{"class":76},"decodeURIComponent",[70,1760,1261],{"class":623},[70,1762,1763],{"class":76},"getCookie",[70,1765,1261],{"class":623},[70,1767,1662],{"class":80},[70,1769,1770],{"class":623},") ",[70,1772,1595],{"class":785},[70,1774,1775],{"class":80}," ''",[70,1777,1502],{"class":623},[70,1779,1781],{"class":72,"line":1780},28,[70,1782,1315],{"class":623},[70,1784,1786],{"class":72,"line":1785},29,[70,1787,1340],{"class":623},[70,1789,1791,1793,1795],{"class":72,"line":1790},30,[70,1792,821],{"class":623},[70,1794,753],{"class":752},[70,1796,768],{"class":623},[10,1798,1799,1800,1802,1803,1806],{},"Cette implémentation utilise un intercepteur ",[67,1801,1183],{}," pour ajouter automatiquement le jeton CSRF. Un intercepteur est appelé à une étape précise du cycle de vie de la requête. Ici, ",[67,1804,1805],{},"onRequest"," modifie la requête sortante.",[10,1808,1809],{},"Nous avons besoin du jeton uniquement pour les requêtes qui modifient l'état, nous ignorons donc les méthodes sûres. L'ajouter à ces méthodes ne serait pas forcément dangereux, mais cela déclencherait un travail inutile.",[10,1811,1812,1813,1816],{},"Nous lisons ensuite le jeton dans le cookie. S'il n'existe pas, nous appelons l'endpoint ",[67,1814,1815],{},"\u002Fsanctum\u002Fcsrf-cookie"," de Sanctum pour le créer.",[10,1818,1819],{},"Enfin, nous ajoutons le jeton aux en-têtes de la requête. Grâce à cette aide, le front-end peut effectuer des requêtes qui modifient l'état sans répéter la configuration CSRF à chaque fois.",[10,1821,1822],{},"Nous rendons cette aide complète dès maintenant, car nous la réutiliserons dans l'article suivant.",[10,1824,1825,1826,1828],{},"Actualisez la page. La requête échoue toujours avec le statut ",[67,1827,1354],{},". Inspectez-la :",[59,1830,1834],{"className":1831,"code":1832,"filename":1360,"language":1833,"meta":65,"style":65},"language-http shiki shiki-themes github-light github-light github-dark","POST \u002Fapi\u002Fposts\u002F1\u002Fcomments HTTP\u002F1.1\nOrigin: http:\u002F\u002Flocalhost:5173\naccept: application\u002Fjson\nx-xsrf-token: eyJpdiI6IktwK1I0UXA3K3F6Y3BvMEdKWHhGblE9PSIsInZhbHVlIjoidlgyMXlSbmlRMjhuNFNhODBLMHdUSkFJSDlQZzhObjJ2VDBIOWd1WjBrMzRZVWdqZldMZWxKcFlDMHB5ajZxZTY5bWR2amJLNTdhTFhtRHJqb3kxZlEvOFptNzdMSmZHU1FmeUw0d0pIRE1DWHRCSmZ1eFJ4aDBhN21qMW5KcDEiLCJtYWMiOiJmYjgyN2E1ZDAxMjMxZWZiZDk4MjU4MzAxOGE4OTYwOWY4ZmM1OGE3ZWMyYzM2Y2FjMTM4YWIwNGVmMDU1M2NhIiwidGFnIjoiIn0=\n","http",[67,1835,1836,1841,1846,1851],{"__ignoreMap":65},[70,1837,1838],{"class":72,"line":73},[70,1839,1840],{},"POST \u002Fapi\u002Fposts\u002F1\u002Fcomments HTTP\u002F1.1\n",[70,1842,1843],{"class":72,"line":128},[70,1844,1845],{},"Origin: http:\u002F\u002Flocalhost:5173\n",[70,1847,1848],{"class":72,"line":135},[70,1849,1850],{},"accept: application\u002Fjson\n",[70,1852,1853],{"class":72,"line":141},[70,1854,1855],{},"x-xsrf-token: eyJpdiI6IktwK1I0UXA3K3F6Y3BvMEdKWHhGblE9PSIsInZhbHVlIjoidlgyMXlSbmlRMjhuNFNhODBLMHdUSkFJSDlQZzhObjJ2VDBIOWd1WjBrMzRZVWdqZldMZWxKcFlDMHB5ajZxZTY5bWR2amJLNTdhTFhtRHJqb3kxZlEvOFptNzdMSmZHU1FmeUw0d0pIRE1DWHRCSmZ1eFJ4aDBhN21qMW5KcDEiLCJtYWMiOiJmYjgyN2E1ZDAxMjMxZWZiZDk4MjU4MzAxOGE4OTYwOWY4ZmM1OGE3ZWMyYzM2Y2FjMTM4YWIwNGVmMDU1M2NhIiwidGFnIjoiIn0=\n",[10,1857,1858,1859,1862,1863,1866],{},"La requête contient l'en-tête ",[67,1860,1861],{},"x-xsrf-token",", mais pas d'en-tête ",[67,1864,1865],{},"cookie",". C'est un problème, car l'utilisateur est authentifié avec un cookie de session. Sans le cookie, le back-end ne peut ni authentifier l'utilisateur ni comparer le jeton CSRF à la session.",[10,1868,1869,1870,1873],{},"Pour corriger cela, ajoutez ",[67,1871,1872],{},"credentials: 'include'"," à la requête. Le navigateur inclura ainsi les cookies dans une requête cross-origin, exactement ce dont nous avons besoin.",[59,1875,1877],{"className":739,"code":1876,"filename":1219,"language":742,"meta":65,"style":65},"\u003Cscript lang=\"ts\" setup>\nofetch('\u002Fapi\u002Fposts\u002F1\u002Fcomments', {\n  \u002F\u002F ...\n  credentials: 'include', \u002F\u002F [!code ++]\n})\n\u003C\u002Fscript>\n",[67,1878,1879,1895,1905,1909,1919,1923],{"__ignoreMap":65},[70,1880,1881,1883,1885,1887,1889,1891,1893],{"class":72,"line":73},[70,1882,749],{"class":623},[70,1884,753],{"class":752},[70,1886,756],{"class":76},[70,1888,759],{"class":623},[70,1890,762],{"class":80},[70,1892,765],{"class":76},[70,1894,768],{"class":623},[70,1896,1897,1899,1901,1903],{"class":72,"line":128},[70,1898,1183],{"class":76},[70,1900,1261],{"class":623},[70,1902,1264],{"class":80},[70,1904,1267],{"class":623},[70,1906,1907],{"class":72,"line":135},[70,1908,315],{"class":773},[70,1910,1912,1915,1917],{"class":1911,"line":141},[72,781,782],[70,1913,1914],{"class":623},"  credentials: ",[70,1916,1722],{"class":80},[70,1918,1616],{"class":623},[70,1920,1921],{"class":72,"line":146},[70,1922,1340],{"class":623},[70,1924,1925,1927,1929],{"class":72,"line":152},[70,1926,821],{"class":623},[70,1928,753],{"class":752},[70,1930,768],{"class":623},[10,1932,1933],{},"La requête fonctionne maintenant. 🎉",[42,1935,1937],{"id":1936},"dernières-réflexions","Dernières réflexions",[10,1939,1940],{},"La connexion fonctionne maintenant de bout en bout. Le front-end peut appeler Laravel entre deux origines, obtenir un jeton CSRF si nécessaire et inclure le cookie de session requis pour les requêtes authentifiées.",[10,1942,1943,1944,1949],{},"Cette configuration nous fournit une fondation API réutilisable plutôt qu'une requête isolée. Ensuite, nous construirons une couche d'authentification partagée avec ",[17,1945,1948],{"href":1946,"rel":1947},"https:\u002F\u002Fpinia-colada.esm.dev\u002F",[21],"Pinia Colada"," afin que les composants puissent réagir à l'utilisateur courant et le déconnecter sans dupliquer la logique des requêtes.",[1951,1952,1953],"style",{},"html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":65,"searchDepth":128,"depth":128,"links":1955},[1956,1957,1961],{"id":44,"depth":128,"text":45},{"id":685,"depth":128,"text":686,"children":1958},[1959,1960],{"id":700,"depth":135,"text":701},{"id":1173,"depth":135,"text":1174},{"id":1936,"depth":128,"text":1937},"dfedb4f0-badf-4a05-8b62-977c61fd6d11","2025-02-25","Connectez un front-end VitePress à une API Laravel avec Sanctum, CORS, la protection CSRF et un client API réutilisable.","md",null,{},"\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fbridging-the-gap-connecting-your-frontend-and-backend","---\ncontentId: dfedb4f0-badf-4a05-8b62-977c61fd6d11\npart: 6\ntitle: Connecter le front-end, VitePress et le back-end, Laravel\ndescription: Connectez un front-end VitePress à une API Laravel avec Sanctum, CORS, la protection CSRF et un client API réutilisable.\ndate: 2025-02-25\nseriesSlug: empower-and-dynamize-our-vitepress-blog-with-a-laravel-api\n---\n\nLa synchronisation des articles est en place. L'étape suivante consiste à connecter le site VitePress à l'API Laravel.\n\nComme les deux applications seront déployées séparément, il ne suffit pas d'envoyer une requête vers une URL. Nous devons configurer [CORS (Cross-Origin Resource Sharing)](https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FCross-origin_resource_sharing) et la protection contre les [CSRF (Cross-Site Request Forgery)](https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FCross-site_request_forgery), puis faire en sorte que le navigateur envoie les identifiants dont Laravel a besoin pour l'authentification par session.\n\nLa configuration peut sembler intimidante au début, mais nous allons traiter chaque élément séparément. Laravel fournit déjà la plupart des briques nécessaires.\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nJe vous recommande de lire les articles liés si vous souhaitez approfondir ces concepts. La configuration de cet article sera plus facile à comprendre.\n::\n\n## Installer Laravel Sanctum\n\nL'écosystème Laravel fournit [Sanctum](https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Fsanctum#spa-authentication), qui prend en charge les jetons d'API et l'authentification par cookie pour les applications monopages (SPA).\n\nPour commencer, installons Sanctum :\n\n```bash [terminal]\nphp artisan install:api\n```\n\nPublions ensuite le fichier de configuration de CORS :\n\n```bash [terminal]\nphp artisan config:publish cors\n```\n\nCORS, ou Cross-Origin Resource Sharing, est un mécanisme de sécurité du navigateur. Par défaut, les navigateurs empêchent une page d'effectuer des requêtes vers une autre origine. Cela protège les utilisateurs contre les sites malveillants qui tenteraient d'effectuer des actions en leur nom.\n\nNotre front-end doit communiquer avec une API hébergée sur une autre origine. Nous devons donc autoriser explicitement cette origine dans la configuration de l'API.\n\nConfigurons CORS pour autoriser les requêtes provenant de notre front-end :\n\n```php [config\u002Fcors.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nreturn [\n    'paths' => ['api\u002F*', 'sanctum\u002Fcsrf-cookie'],\n\n    'allowed_methods' => ['*'],\n\n    'allowed_origins' => [\n        env('APP_FRONTEND_URL'), \u002F\u002F [!code ++]\n    ],\n\n    'allowed_origins_patterns' => [],\n\n    'allowed_headers' => ['*'],\n\n    'exposed_headers' => [],\n\n    'max_age' => 0,\n\n    'supports_credentials' => true, \u002F\u002F [!code highlight]\n\n];\n```\n\nNous parlerons du déploiement plus tard, mais retenez que nous créons deux applications : le blog et l'API qui l'enrichit. Elles seront déployées séparément, c'est pourquoi l'API doit autoriser les requêtes provenant du blog.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nNous pourrions déployer les deux applications derrière le même domaine avec un reverse proxy, mais cela ajouterait une complexité dont nous n'avons pas besoin ici.\n::\n\nConfigurons ensuite Sanctum pour autoriser les requêtes de notre front-end :\n\n```php [config\u002Fsanctum.php]\nreturn [\n    'stateful' => explode(',', (string) env('SANCTUM_STATEFUL_DOMAINS', sprintf(\n        '%s%s',\n        'localhost:4173,localhost:5173', \u002F\u002F [!code highlight]\n        Sanctum::currentApplicationUrlWithPort()\n    ))),\n\n  \u002F\u002F ...\n]\n```\n\nLa modification importante consiste à ajouter les origines de développement du front-end aux domaines stateful de Sanctum.\n\nUne origine de navigateur combine le protocole, le nom d'hôte et le port. En développement, `localhost:5173` et `localhost:8000` sont des origines différentes, même si elles partagent le même nom d'hôte.\n\nAjoutons ensuite un middleware :\n\n```php [bootstrap\u002Fapp.php]\nreturn Application::configure(basePath: dirname(__DIR__))\n    ->withMiddleware(function (Middleware $middleware): void {\n        $middleware->statefulApi(); \u002F\u002F [!code ++]\n    })\n     ->create();\n```\n\nCe middleware indique à Sanctum d'authentifier les requêtes avec le cookie de session Laravel plutôt qu'avec un jeton d'API. C'est l'approche que nous utiliserons depuis le front-end.\n\nEnfin, modifions le middleware d'authentification dans `routes\u002Fapi.php`. En réalité, nous utilisons le middleware Laravel par défaut, qui garantit que les requêtes respectent la configuration de Sanctum, notamment les domaines stateful.\n\n```php [routes\u002Fapi.php]\nRoute::middleware('auth:sanctum')->group(function () { \u002F\u002F [!code highlight]\n    \u002F\u002F Handle authenticated requests...\n});\n```\n\nNotre back-end est maintenant prêt à accepter les requêtes du front-end.\n\nAvant de passer au front-end, terminons quelques modifications du back-end.\n\n1. Mettez à jour `store` dans `RegisteredViaGitHubController` afin qu'elle redirige l'utilisateur vers le front-end :\n\n```php [app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php]\nfinal class RegisteredViaGitHubController extends Controller\n{\n    public function store(): RedirectResponse\n    {\n        \u002F\u002F ...\n\n        return redirect(Config::get('app.frontend_url'));\n    }\n}\n```\n\nMettez également son test à jour :\n\n```php [tests\u002FHttp\u002FRegisteredViaGitHub\u002FStoreTest.php]\n\u002F\u002F ...\n\ntest('redirects to the frontend', function () {\n    fakeGitHubUser();\n\n    $this->get(route('auth.github.callback'))\n        ->assertRedirect(config('app.frontend_url')); \u002F\u002F [!code highlight]\n});\n\n\u002F\u002F ...\n```\n\n2. Ajoutez un seeder qui génère des commentaires d'exemple :\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nSupprimez le contenu existant de la méthode `run` du seeder avant d'ajouter ce code.\n::\n\n```php [database\u002Fseeders\u002FDatabaseSeeder.php]\nuse App\\Models\\Post;\n\nfinal class DatabaseSeeder extends Seeder\n{\n    public function run(): void\n    {\n        Post::factory()\n            ->count(10)\n            ->hasComments(5)\n            ->create();\n    }\n}\n```\n\nCela crée 10 articles avec cinq commentaires chacun, ce qui nous donne des données pour tester le front-end.\n\n3. Recréez la base de données et exécutez les migrations :\n\n```bash [terminal]\nrm database\u002Fdatabase.sqlite && touch database\u002Fdatabase.sqlite && php artisan migrate --seed\n```\n\nNous recréons la base de données car, jusqu'à présent, les tests utilisaient une base SQLite en mémoire. La base locale contient encore la table `users` créée par le scaffold initial, et non la version adaptée à l'authentification GitHub.\n\n4. Définissez `APP_FRONTEND_URL` dans `.env` et `.env.example` avec l'URL de développement du front-end :\n\n```ini [.env]\nAPP_FRONTEND_URL=http:\u002F\u002Flocalhost:5173\n```\n\nJusqu'ici, elle pointait vers `http:\u002F\u002Flocalhost:4173`, le serveur de prévisualisation VitePress.\n\n## Se connecter au back-end depuis le front-end\n\nDans cette section, nous effectuerons les premières requêtes depuis le front-end et vérifierons que la connexion fonctionne.\n\n::callout{icon=\"i-ph-warning-duotone\" color=\"warning\"}\nCe n'est pas la version finale du code. Nous l'améliorerons dans l'article suivant.\n::\n\n### Authentification sociale\n\nLa première fonctionnalité que nous pouvons tester est l'authentification sociale. Nous ajouterons un bouton dans l'en-tête qui pointe vers `\u002Fauth\u002Fgithub\u002Fredirect` sur le back-end. Comme l'URL du back-end sera différente en développement et en production, nous stockerons son URL de base dans une variable d'environnement. L'utilisateur sera ensuite redirigé vers GitHub, puis vers le front-end après avoir autorisé l'application.\n\nPour cette variable d'environnement, nous pouvons utiliser le préfixe `VITE_` afin de l'exposer au front-end :\n\n```ini [src\u002F.env]\nVITE_API_URL=http:\u002F\u002Flocalhost:8000\n```\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nVous pouvez ajouter cette variable sans risque au fichier `.env.example`.\n::\n\nAjoutez maintenant le bouton à l'en-tête :\n\n```vue [.vitepress\u002Ftheme\u002Fcommon\u002Fcomponents\u002FTheHeader.vue]\n\u003Cscript lang=\"ts\" setup>\n\u002F\u002F ...\n\nconst loginUrl = `${import.meta.env.VITE_API_URL}\u002Fauth\u002Fgithub\u002Fredirect` \u002F\u002F [!code ++]\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cheader class=\"border-b-4 border-black bg-white p-8\">\n    \u003C!-- ... -->\n\n    \u003Cdiv class=\"flex items-center gap-6\">\n      \u003C!-- ... -->\n\n      \u003CButton :href=\"loginUrl\" label=\"Connexion\" \u002F> \u003C!-- [!code ++] -->\n    \u003C\u002Fdiv>\n  \u003C\u002Fheader>\n\u003C\u002Ftemplate>\n```\n\nNous utilisons `VITE_API_URL` pour construire l'URL de connexion. Lorsque Vite démarre, il charge `src\u002F.env` et expose les variables préfixées par `VITE_` via `import.meta.env`.\n\nNous pouvons également ajouter les types de cet objet afin d'améliorer l'expérience de développement.\n\n1. Créez un fichier `vite-env.d.ts` à la racine du projet :\n\n```ts [vite-env.d.ts]\n\u002F\u002F\u002F \u003Creference types=\"vite\u002Fclient\" \u002F>\n\ninterface ImportMetaEnv {\n  readonly VITE_API_URL: string\n}\n\ninterface ImportMeta {\n  readonly env: ImportMetaEnv\n}\n```\n\n2. Installez Vite comme dépendance de développement :\n\n```bash [terminal]\nnpm install -D vite\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nLe gestionnaire de paquets pnpm ne rend accessibles que les packages installés directement dans le projet. Même si VitePress utilise Vite, nous devons donc l'installer pour accéder à ses types.\n::\n\n3. Ajoutez le fichier `vite-env.d.ts` à `tsconfig.json` :\n\n```json [tsconfig.json]\n{\n  \"include\": [\n    \".\u002F.vitepress\u002F**\u002F*\",\n    \"vite-env.d.ts\" \u002F\u002F [!code highlight]\n  ]\n}\n```\n\n`import.meta.env` est maintenant typé et TypeScript connaît `VITE_API_URL`.\n\n\u003Cvideo autoplay loop muted playsinline>\n  \u003Csource src=\"https:\u002F\u002Fimages.soubiran.dev\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fbridging-the-gap-connecting-your-frontend-and-backend\u002Fsocial-authentication-workflow.mp4\" type=\"video\u002Fmp4\">\n\u003C\u002Fvideo>\n\nEn cliquant sur le bouton, nous devons être redirigés vers GitHub pour l'autorisation, puis vers le front-end. La première connexion fonctionne.\n\n### Créer un commentaire\n\nLa deuxième fonctionnalité que nous pouvons tester est la création d'un commentaire. Si elle fonctionne, nous pourrons passer à l'article suivant en sachant que le back-end et le front-end communiquent correctement.\n\nPour effectuer les requêtes, nous utiliserons `ofetch`. Il encapsule l'API native `fetch` et ajoute la sérialisation des corps JSON, les tentatives automatiques, une URL de base et des intercepteurs.\n\n```bash [terminal]\npnpm add ofetch\n```\n\nNous effectuerons la première requête depuis `Layout.vue` comme test temporaire.\n\nCommençons par une requête simple :\n\n```vue [.vitepress\u002Ftheme\u002FLayout.vue]\n\u003Cscript lang=\"ts\" setup>\nimport { ofetch } from 'ofetch'\n\nofetch('\u002Fapi\u002Fposts\u002F1\u002Fcomments', {\n  baseURL: import.meta.env.VITE_API_URL,\n  method: 'POST',\n  body: {\n    content: 'Hello world!',\n  },\n  headers: {\n    Accept: 'application\u002Fjson',\n  }\n})\n\u003C\u002Fscript>\n```\n\nCette requête semble suffisante, mais l'onglet réseau du navigateur montre une réponse `419`. L'aperçu de la réponse contient :\n\n```json [Exemple]\n{\n  \"message\": \"CSRF token mismatch.\"\n  \u002F\u002F ...\n}\n```\n\nL'erreur est explicite : la requête a besoin d'un jeton CSRF.\n\nQu'est-ce qu'un jeton CSRF et comment le gérer dans une SPA ?\n\nUn jeton CSRF contribue à empêcher les attaques Cross-Site Request Forgery. Il permet au serveur de vérifier qu'une requête qui modifie l'état vient bien de notre application et non d'un site malveillant agissant au nom d'un utilisateur authentifié. Dans une application rendue côté serveur, le jeton est intégré au HTML. Dans une SPA, nous devons le récupérer et l'envoyer séparément.\n\nLaravel stocke le jeton dans la session et place également une valeur chiffrée dans un cookie que le JavaScript de notre site peut lire. Nous envoyons cette valeur dans l'en-tête `X-XSRF-TOKEN`, et Laravel la compare à celle de la session.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nNous ne pouvons pas faire confiance au cookie seul, car le navigateur l'envoie automatiquement avec les requêtes. C'est l'en-tête explicite qui prouve que notre JavaScript a volontairement inclus le jeton.\n::\n\nAjoutons le jeton CSRF à la requête :\n\n```vue [.vitepress\u002Ftheme\u002FLayout.vue]\n\u003Cscript lang=\"ts\" setup>\nimport { ofetch } from 'ofetch'\n\nfunction getCookie(name: string) {\n  const match = document.cookie.match(new RegExp(`(^| )${name}=([^;]+)`))\n  return match ? match[2] : null\n}\n\nofetch('\u002Fapi\u002Fposts\u002F1\u002Fcomments', {\n  \u002F\u002F ...\n  onRequest: async ({ options }) => {\n    const method = options.method?.toUpperCase() || 'GET'\n\n    if (['GET', 'HEAD', 'OPTIONS'].includes(method)) {\n      return\n    }\n\n    const xsrfToken = getCookie('XSRF-TOKEN')\n\n    if (!xsrfToken) {\n      await ofetch('\u002Fsanctum\u002Fcsrf-cookie', {\n        baseURL: import.meta.env.VITE_API_URL,\n        credentials: 'include',\n      })\n    }\n\n    options.headers.set('X-Xsrf-Token', decodeURIComponent(getCookie('XSRF-TOKEN') || ''))\n  },\n})\n\u003C\u002Fscript>\n```\n\nCette implémentation utilise un intercepteur `ofetch` pour ajouter automatiquement le jeton CSRF. Un intercepteur est appelé à une étape précise du cycle de vie de la requête. Ici, `onRequest` modifie la requête sortante.\n\nNous avons besoin du jeton uniquement pour les requêtes qui modifient l'état, nous ignorons donc les méthodes sûres. L'ajouter à ces méthodes ne serait pas forcément dangereux, mais cela déclencherait un travail inutile.\n\nNous lisons ensuite le jeton dans le cookie. S'il n'existe pas, nous appelons l'endpoint `\u002Fsanctum\u002Fcsrf-cookie` de Sanctum pour le créer.\n\nEnfin, nous ajoutons le jeton aux en-têtes de la requête. Grâce à cette aide, le front-end peut effectuer des requêtes qui modifient l'état sans répéter la configuration CSRF à chaque fois.\n\nNous rendons cette aide complète dès maintenant, car nous la réutiliserons dans l'article suivant.\n\nActualisez la page. La requête échoue toujours avec le statut `419`. Inspectez-la :\n\n```http [Exemple]\nPOST \u002Fapi\u002Fposts\u002F1\u002Fcomments HTTP\u002F1.1\nOrigin: http:\u002F\u002Flocalhost:5173\naccept: application\u002Fjson\nx-xsrf-token: eyJpdiI6IktwK1I0UXA3K3F6Y3BvMEdKWHhGblE9PSIsInZhbHVlIjoidlgyMXlSbmlRMjhuNFNhODBLMHdUSkFJSDlQZzhObjJ2VDBIOWd1WjBrMzRZVWdqZldMZWxKcFlDMHB5ajZxZTY5bWR2amJLNTdhTFhtRHJqb3kxZlEvOFptNzdMSmZHU1FmeUw0d0pIRE1DWHRCSmZ1eFJ4aDBhN21qMW5KcDEiLCJtYWMiOiJmYjgyN2E1ZDAxMjMxZWZiZDk4MjU4MzAxOGE4OTYwOWY4ZmM1OGE3ZWMyYzM2Y2FjMTM4YWIwNGVmMDU1M2NhIiwidGFnIjoiIn0=\n```\n\nLa requête contient l'en-tête `x-xsrf-token`, mais pas d'en-tête `cookie`. C'est un problème, car l'utilisateur est authentifié avec un cookie de session. Sans le cookie, le back-end ne peut ni authentifier l'utilisateur ni comparer le jeton CSRF à la session.\n\nPour corriger cela, ajoutez `credentials: 'include'` à la requête. Le navigateur inclura ainsi les cookies dans une requête cross-origin, exactement ce dont nous avons besoin.\n\n```vue [.vitepress\u002Ftheme\u002FLayout.vue]\n\u003Cscript lang=\"ts\" setup>\nofetch('\u002Fapi\u002Fposts\u002F1\u002Fcomments', {\n  \u002F\u002F ...\n  credentials: 'include', \u002F\u002F [!code ++]\n})\n\u003C\u002Fscript>\n```\n\nLa requête fonctionne maintenant. 🎉\n\n## Dernières réflexions\n\nLa connexion fonctionne maintenant de bout en bout. Le front-end peut appeler Laravel entre deux origines, obtenir un jeton CSRF si nécessaire et inclure le cookie de session requis pour les requêtes authentifiées.\n\nCette configuration nous fournit une fondation API réutilisable plutôt qu'une requête isolée. Ensuite, nous construirons une couche d'authentification partagée avec [Pinia Colada](https:\u002F\u002Fpinia-colada.esm.dev\u002F) afin que les composants puissent réagir à l'utilisateur courant et le déconnecter sans dupliquer la logique des requêtes.\n",{"title":5,"description":1964},"empower-and-dynamize-our-vitepress-blog-with-a-laravel-api",{"loc":1968},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fbridging-the-gap-connecting-your-frontend-and-backend","QU6WkhMBgIe7guYwqmgW4DhJAMaxe1mQpMfG3KBj4PY",{"overview":1976,"chapters":2148},{"id":1977,"title":1978,"body":1979,"contentId":2132,"date":2133,"description":2134,"extension":1965,"github":1966,"meetTheInstructor":2135,"meta":2136,"navigation":131,"part":1966,"path":2137,"rawbody":2138,"robots":1966,"schemaOrg":1966,"seo":2139,"seriesSlug":1971,"sitemap":2140,"stem":2141,"subtitle":2142,"topics":2143,"__hash__":2147},"series\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api.md","Améliorer votre blog VitePress avec une API Laravel",{"type":7,"value":1980,"toc":2129},[1981,1984,1987,1990,1994,2003,2006,2013,2016,2019,2101,2104,2107,2110,2119,2123],[10,1982,1983],{},"Bonjour ! 👋",[10,1985,1986],{},"Après avoir créé notre blog VitePress, nous sommes prêts à le rendre plus dynamique grâce à une API Laravel.",[10,1988,1989],{},"Dans la série précédente, nous avons découvert VitePress, de la création du projet jusqu'à son déploiement sur Cloudflare Pages. Nous avons construit un blog fonctionnel et automatisé, avec des métadonnées SEO, des images Open Graph et une page dédiée aux projets GitHub. Le blog gérait tout au moment de sa génération : il ne restait plus qu'à écrire et publier du contenu.",[1991,1992],"callout-read-more",{"id":1993},"43c95b33-041c-4108-ab98-0d21ef60ed7f",[10,1995,1996,1997,2002],{},"Cette série s'intéresse au développement back-end. Nous allons créer une API ",[17,1998,2001],{"href":1999,"rel":2000},"https:\u002F\u002Flaravel.com",[21],"Laravel"," pour ajouter quelques fonctionnalités interactives à notre blog.",[10,2004,2005],{},"Jusqu'à présent, notre blog était principalement statique. Le contenu était généré lors du build, avec seulement quelques données chargées dynamiquement, puis les fichiers HTML résultants étaient distribués par un CDN. En ajoutant une API Laravel, nous permettrons aux lecteurs d'interagir avec le blog grâce à des fonctionnalités comme les réactions et les commentaires.",[10,2007,2008,2009,2012],{},"Même si la série se concentre sur le back-end, nous intégrerons également l'API à notre blog VitePress. Nous utiliserons Vue.js et ",[17,2010,1948],{"href":1946,"rel":2011},[21]," pour récupérer les données. VitePress est une application Vue.js, nous pouvons donc l'étendre avec les composants dont nous avons besoin.",[10,2014,2015],{},"Les exemples sont conçus pour rester faciles à suivre. La complexité inutile et la sur-ingénierie n'ont pas leur place ici. Nous nous concentrerons sur la simplicité, la clarté et l'efficacité.",[10,2017,2018],{},"Tout au long de la série, nous construirons une API Laravel et l'intégrerons à notre blog VitePress. Nous aborderons les sujets suivants :",[2020,2021,2022,2029,2056,2067,2073,2083,2089,2095],"ul",{},[410,2023,2024,2028],{},[2025,2026,2027],"strong",{},"Configurer le projet Laravel"," : Créer un nouveau projet Laravel et se familiariser avec sa structure.",[410,2030,2031,2034,2035,1616,2040,1616,2045,330,2050,2055],{},[2025,2032,2033],{},"Améliorer le workflow de développement"," : Configurer ",[17,2036,2039],{"href":2037,"rel":2038},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fpint",[21],"Pint",[17,2041,2044],{"href":2042,"rel":2043},"https:\u002F\u002Fgithub.com\u002Frectorphp\u002Frector",[21],"Rector",[17,2046,2049],{"href":2047,"rel":2048},"https:\u002F\u002Fgithub.com\u002Flarastan\u002Flarastan",[21],"Larastan",[17,2051,2054],{"href":2052,"rel":2053},"https:\u002F\u002Fpestphp.com\u002F",[21],"Pest"," pour le formatage, la refactorisation, l'analyse statique et les tests.",[410,2057,2058,2061,2062,733],{},[2025,2059,2060],{},"Ajouter l'authentification sociale"," : Permettre aux utilisateurs de se connecter avec GitHub grâce à ",[17,2063,2066],{"href":2064,"rel":2065},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fsocialite",[21],"Laravel Socialite",[410,2068,2069,2072],{},[2025,2070,2071],{},"Connecter les applications"," : Configurer Sanctum, CORS, la protection CSRF et les premières requêtes entre le front-end VitePress et l'API Laravel.",[410,2074,2075,2078,2079,2082],{},[2025,2076,2077],{},"Gérer l'état d'authentification"," : Utiliser ",[17,2080,1948],{"href":1946,"rel":2081},[21]," pour récupérer l'utilisateur courant et le déconnecter avec une mise à jour optimiste.",[410,2084,2085,2088],{},[2025,2086,2087],{},"Construire l'API de commentaires"," : Créer les modèles, les relations, les endpoints, la validation, l'autorisation et les tests des commentaires.",[410,2090,2091,2094],{},[2025,2092,2093],{},"Garder le back-end synchronisé"," : Générer les métadonnées des articles depuis VitePress et les synchroniser avec la base de données Laravel.",[410,2096,2097,2100],{},[2025,2098,2099],{},"Construire l'interface de commentaires"," : Récupérer, créer, modifier et supprimer des commentaires depuis le front-end VitePress.",[10,2102,2103],{},"À la fin de la série, vous aurez un blog soutenu par une API Laravel. Les lecteurs pourront se connecter avec GitHub et laisser des commentaires, tandis que l'architecture sera prête à accueillir d'autres fonctionnalités interactives.",[10,2105,2106],{},"Les tests feront partie du processus de développement et seront ajoutés à chaque étape. Il n'est donc pas nécessaire de leur consacrer un article séparé.",[10,2108,2109],{},"Si vous avez des questions, des retours ou des suggestions, n'hésitez pas à les partager dans les commentaires. Vos remarques contribuent à améliorer la série.",[34,2111,2112],{"color":263,"icon":264},[10,2113,2114,2115,733],{},"Cette série suppose que vous connaissez déjà TypeScript, Vue.js et Laravel. Si ce n'est pas le cas, commencez par consulter la ",[17,2116,2118],{"href":2117},"\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch","Créer un Blog Complet avec VitePress et Vue.js de Zéro",[42,2120,2122],{"id":2121},"chapitres","Chapitres",[2124,2125],"series-chapters-list",{"className":2126},[2127,2128],"mx-auto","max-w-5xl",{"title":65,"searchDepth":128,"depth":128,"links":2130},[2131],{"id":2121,"depth":128,"text":2122},"c95f7904-8ade-4f11-84a8-99688d26c036","2024-11-19","Transformez votre blog VitePress en une plateforme dynamique avec une API Laravel et ajoutez-lui des fonctionnalités interactives.","J'ai créé cette série parce que j'aime \u003Cstrong>VitePress\u003C\u002Fstrong> et \u003Cstrong>Laravel\u003C\u002Fstrong>. Je suis convaincu que leur association offre une solution simple et \u003Cstrong>puissante\u003C\u002Fstrong> pour créer un blog. Je souhaite aider les développeurs à enrichir leurs blogs VitePress avec une API Laravel afin de créer des fonctionnalités avancées.",{},"\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api","---\ncontentId: c95f7904-8ade-4f11-84a8-99688d26c036\ntitle: Améliorer votre blog VitePress avec une API Laravel\nsubtitle: Transformez votre blog VitePress en une plateforme dynamique avec une API\ndescription: Transformez votre blog VitePress en une plateforme dynamique avec une API Laravel et ajoutez-lui des fonctionnalités interactives.\ndate: 2024-11-19\ntopics:\n  - laravel\n  - vitepress\n  - api\nmeetTheInstructor: J'ai créé cette série parce que j'aime \u003Cstrong>VitePress\u003C\u002Fstrong> et \u003Cstrong>Laravel\u003C\u002Fstrong>. Je suis convaincu que leur association offre une solution simple et \u003Cstrong>puissante\u003C\u002Fstrong> pour créer un blog. Je souhaite aider les développeurs à enrichir leurs blogs VitePress avec une API Laravel afin de créer des fonctionnalités avancées.\nseriesSlug: empower-and-dynamize-our-vitepress-blog-with-a-laravel-api\n---\n\nBonjour ! 👋\n\nAprès avoir créé notre blog VitePress, nous sommes prêts à le rendre plus dynamique grâce à une API Laravel.\n\nDans la série précédente, nous avons découvert VitePress, de la création du projet jusqu'à son déploiement sur Cloudflare Pages. Nous avons construit un blog fonctionnel et automatisé, avec des métadonnées SEO, des images Open Graph et une page dédiée aux projets GitHub. Le blog gérait tout au moment de sa génération : il ne restait plus qu'à écrire et publier du contenu.\n\n\u003CCalloutReadMore id=\"43c95b33-041c-4108-ab98-0d21ef60ed7f\" \u002F>\n\nCette série s'intéresse au développement back-end. Nous allons créer une API [Laravel](https:\u002F\u002Flaravel.com) pour ajouter quelques fonctionnalités interactives à notre blog.\n\nJusqu'à présent, notre blog était principalement statique. Le contenu était généré lors du build, avec seulement quelques données chargées dynamiquement, puis les fichiers HTML résultants étaient distribués par un CDN. En ajoutant une API Laravel, nous permettrons aux lecteurs d'interagir avec le blog grâce à des fonctionnalités comme les réactions et les commentaires.\n\nMême si la série se concentre sur le back-end, nous intégrerons également l'API à notre blog VitePress. Nous utiliserons Vue.js et [Pinia Colada](https:\u002F\u002Fpinia-colada.esm.dev\u002F) pour récupérer les données. VitePress est une application Vue.js, nous pouvons donc l'étendre avec les composants dont nous avons besoin.\n\nLes exemples sont conçus pour rester faciles à suivre. La complexité inutile et la sur-ingénierie n'ont pas leur place ici. Nous nous concentrerons sur la simplicité, la clarté et l'efficacité.\n\nTout au long de la série, nous construirons une API Laravel et l'intégrerons à notre blog VitePress. Nous aborderons les sujets suivants :\n\n- **Configurer le projet Laravel** : Créer un nouveau projet Laravel et se familiariser avec sa structure.\n- **Améliorer le workflow de développement** : Configurer [Pint](https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fpint), [Rector](https:\u002F\u002Fgithub.com\u002Frectorphp\u002Frector), [Larastan](https:\u002F\u002Fgithub.com\u002Flarastan\u002Flarastan) et [Pest](https:\u002F\u002Fpestphp.com\u002F) pour le formatage, la refactorisation, l'analyse statique et les tests.\n- **Ajouter l'authentification sociale** : Permettre aux utilisateurs de se connecter avec GitHub grâce à [Laravel Socialite](https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fsocialite).\n- **Connecter les applications** : Configurer Sanctum, CORS, la protection CSRF et les premières requêtes entre le front-end VitePress et l'API Laravel.\n- **Gérer l'état d'authentification** : Utiliser [Pinia Colada](https:\u002F\u002Fpinia-colada.esm.dev\u002F) pour récupérer l'utilisateur courant et le déconnecter avec une mise à jour optimiste.\n- **Construire l'API de commentaires** : Créer les modèles, les relations, les endpoints, la validation, l'autorisation et les tests des commentaires.\n- **Garder le back-end synchronisé** : Générer les métadonnées des articles depuis VitePress et les synchroniser avec la base de données Laravel.\n- **Construire l'interface de commentaires** : Récupérer, créer, modifier et supprimer des commentaires depuis le front-end VitePress.\n\nÀ la fin de la série, vous aurez un blog soutenu par une API Laravel. Les lecteurs pourront se connecter avec GitHub et laisser des commentaires, tandis que l'architecture sera prête à accueillir d'autres fonctionnalités interactives.\n\nLes tests feront partie du processus de développement et seront ajoutés à chaque étape. Il n'est donc pas nécessaire de leur consacrer un article séparé.\n\nSi vous avez des questions, des retours ou des suggestions, n'hésitez pas à les partager dans les commentaires. Vos remarques contribuent à améliorer la série.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nCette série suppose que vous connaissez déjà TypeScript, Vue.js et Laravel. Si ce n'est pas le cas, commencez par consulter la [Créer un Blog Complet avec VitePress et Vue.js de Zéro](\u002Ffr\u002Fseries\u002Fcreate-a-blog-with-vitepress-and-vue-js-from-scratch).\n::\n\n## Chapitres\n\n::series-chapters-list\n---\nclass: mx-auto max-w-5xl\n---\n::\n",{"title":1978,"description":2134},{"loc":2137},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api","Transformez votre blog VitePress en une plateforme dynamique avec une API",[2144,2145,2146],"laravel","vitepress","api","AjkLB8gOXMZAgudegF8LmVWjly_nRao_7y_u2LUCUrQ",[2149,2154,2159,2164,2169,2174,2175,2180],{"contentId":2150,"title":2151,"description":2152,"path":2153,"part":73,"github":1966,"topics":1966},"61204f3d-47bc-4832-a217-8c00b11ab6e1","Configurer la structure et les bases d'un projet Laravel","Découvrez comment configurer un projet Laravel et comprendre sa structure pour commencer le développement sur des bases solides.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fsetting-up-your-laravel-project-structure-and-essentials",{"contentId":2155,"title":2156,"description":2157,"path":2158,"part":128,"github":1966,"topics":1966},"9446fd4c-5ffd-4b4b-8cc2-8075ef1c7a00","Pint, Rector, Larastan et Pest : les essentiels pour réussir","Découvrez quatre outils indispensables pour maintenir la qualité et la cohérence du code dans les projets Laravel : Pint, Rector, Larastan et Pest.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fpint-larastan-rector-and-pest-essential-for-success",{"contentId":2160,"title":2161,"description":2162,"path":2163,"part":135,"github":1966,"topics":1966},"d9a64441-89b3-4f82-a356-10bde7db7669","Authentification sociale simplifiée avec Laravel Socialite","Ajoutez l'authentification GitHub à Laravel avec Socialite, les callbacks OAuth, la synchronisation des utilisateurs et des tests fiables.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Feffortless-social-authentication-with-laravel-socialite",{"contentId":2165,"title":2166,"description":2167,"path":2168,"part":141,"github":1966,"topics":1966},"f41b79a9-943b-4d03-a926-cf461f7bf58a","Construire un système simple de commentaires Laravel","Construisez une API de commentaires Laravel avec des modèles, migrations, ressources, policies, form requests, contrôleurs et tests complets.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fbuilding-a-simple-comment-system-for-user-engagement",{"contentId":2170,"title":2171,"description":2172,"path":2173,"part":146,"github":1966,"topics":1966},"1cf0ee5e-a0df-4f7d-b281-a083099223e9","Automatiser facilement la synchronisation de votre back-end","Générez les métadonnées avec VitePress, synchronisez les articles avec Laravel et gardez automatiquement la base de données à jour.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fautomating-your-backend-to-stay-in-sync-effortlessly",{"contentId":1962,"title":5,"description":1964,"path":1968,"part":152,"github":1966,"topics":1966},{"contentId":2176,"title":2177,"description":2178,"path":2179,"part":158,"github":1966,"topics":1966},"e03c822f-0431-4ece-9293-765cacc2d44e","Authentifier les utilisateurs du front-end au back-end","Reliez l'authentification front-end à Laravel avec une requête utilisateur, une déconnexion GitHub, le cache Pinia Colada et des mises à jour optimistes.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fstreamlining-user-authentication-from-frontend-to-backend",{"contentId":2181,"title":2182,"description":2183,"path":2184,"part":163,"github":1966,"topics":1966},"6ba25b9d-f306-42c5-b788-348fc90c6740","Simplifier les commentaires de VitePress avec Pinia Colada","Construisez l'interface de commentaires VitePress avec Pinia Colada, des composants Vue réutilisables, des mutations optimistes et des permissions.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fsimplifying-comment-querying-and-editing-with-pinia-colada",1795016704622]