[{"data":1,"prerenderedAt":3484},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fstreamlining-user-authentication-from-frontend-to-backend":3,"series-context-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api":3273},{"id":4,"title":5,"body":6,"contentId":3260,"date":3261,"description":3262,"extension":3263,"github":3264,"meetTheInstructor":3264,"meta":3265,"navigation":86,"part":112,"path":3266,"rawbody":3267,"robots":3264,"schemaOrg":3264,"seo":3268,"seriesSlug":3269,"sitemap":3270,"stem":3271,"subtitle":3264,"topics":3264,"__hash__":3272},"series\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fstreamlining-user-authentication-from-frontend-to-backend.md","Authentifier les utilisateurs du front-end au back-end",{"type":7,"value":8,"toc":3249},"minimark",[9,13,16,27,32,35,52,55,60,63,250,253,256,341,360,367,425,428,432,435,524,527,529,636,643,651,656,685,696,710,738,741,745,748,751,754,757,880,893,908,911,914,917,920,929,932,955,958,1066,1069,1076,1087,1090,1116,1127,1131,1140,1571,1575,1582,1878,1889,1893,1896,1901,1925,1931,1996,2006,2014,2017,2146,2149,2209,2212,2254,2260,2263,2271,2274,2556,2571,2577,2786,2789,2956,2962,3016,3034,3040,3124,3129,3214,3221,3224,3235,3239,3242,3245],[10,11,12],"p",{},"Maintenant que le front-end peut joindre l'API Laravel, nous pouvons utiliser cette connexion pour gérer l'authentification dans toute l'application.",[10,14,15],{},"Jusqu'ici, nous avons testé des requêtes isolées. Dans cet article, nous récupérerons l'utilisateur courant au démarrage de l'application, afficherons l'action de connexion ou de déconnexion appropriée et implémenterons la déconnexion avec une mise à jour optimiste. L'interface se mettra à jour immédiatement pendant l'exécution de la requête, puis reviendra à son état précédent si la requête échoue.",[10,17,18,19,26],{},"Pour gérer cela proprement, nous combinerons Pinia avec Pinia Colada, une bibliothèque de récupération de données construite au-dessus de Pinia et créée par ",[20,21,25],"a",{"href":22,"rel":23},"https:\u002F\u002Fgithub.com\u002Fposva",[24],"nofollow","Eduardo",", le créateur de Pinia. Elle nous fournira un état partagé mis en cache, l'état des requêtes et les hooks nécessaires aux mises à jour optimistes.",[28,29,31],"h2",{"id":30},"configurer-lapi","Configurer l'API",[10,33,34],{},"Pour prendre en charge le front-end, nous avons besoin de deux nouvelles routes dans l'application Laravel :",[36,37,38,46],"ol",{},[39,40,41,45],"li",{},[42,43,44],"code",{},"GET \u002Fapi\u002Fuser"," : Retourne l'utilisateur authentifié. Le front-end l'appelle au démarrage de l'application pour adapter l'interface.",[39,47,48,51],{},[42,49,50],{},"POST \u002Flogout"," : Déconnecte l'utilisateur et invalide la session courante lorsque le bouton de déconnexion du front-end est utilisé.",[10,53,54],{},"Pour chaque route, nous écrirons des tests, créerons une méthode de contrôleur et enregistrerons la route. C'est le même processus que dans les articles précédents.",[56,57,59],"h3",{"id":58},"retourner-lutilisateur","Retourner l'utilisateur",[10,61,62],{},"Commençons par la première route. Créons un test pour vérifier que l'utilisateur est authentifié et que ses données sont correctement retournées.",[64,65,71],"pre",{"className":66,"code":67,"filename":68,"language":69,"meta":70,"style":70},"language-php shiki shiki-themes github-light github-light github-dark","\u003C?php\n\ndeclare(strict_types=1);\n\nuse Illuminate\\Testing\\Fluent\\AssertableJson;\n\nit('requires authentification', function () {\n    $this->getJson(route('user.show'))\n        ->assertUnauthorized();\n});\n\nit('returns the authenticated user', function () {\n    $user = App\\Models\\User::factory()->create();\n\n    $response = $this->actingAs($user)\n        ->getJson(route('user.show'));\n\n    $response\n        ->assertOk()\n        ->assertJson(\n            fn (AssertableJson $json) => $json\n                ->has(\n                    'data',\n                    fn (AssertableJson $json) => $json\n                        ->where('name', $user->name)\n                        ->where('username', $user->username)\n                        ->where('avatar', $user->avatar)\n                )\n        );\n});\n","tests\u002FHttp\u002FAuth\u002FAuthenticationSessionTest.php","php","",[42,72,73,81,88,94,99,105,110,116,122,128,134,139,145,151,156,162,168,173,179,185,191,197,203,209,215,221,227,233,239,245],{"__ignoreMap":70},[74,75,78],"span",{"class":76,"line":77},"line",1,[74,79,80],{},"\u003C?php\n",[74,82,84],{"class":76,"line":83},2,[74,85,87],{"emptyLinePlaceholder":86},true,"\n",[74,89,91],{"class":76,"line":90},3,[74,92,93],{},"declare(strict_types=1);\n",[74,95,97],{"class":76,"line":96},4,[74,98,87],{"emptyLinePlaceholder":86},[74,100,102],{"class":76,"line":101},5,[74,103,104],{},"use Illuminate\\Testing\\Fluent\\AssertableJson;\n",[74,106,108],{"class":76,"line":107},6,[74,109,87],{"emptyLinePlaceholder":86},[74,111,113],{"class":76,"line":112},7,[74,114,115],{},"it('requires authentification', function () {\n",[74,117,119],{"class":76,"line":118},8,[74,120,121],{},"    $this->getJson(route('user.show'))\n",[74,123,125],{"class":76,"line":124},9,[74,126,127],{},"        ->assertUnauthorized();\n",[74,129,131],{"class":76,"line":130},10,[74,132,133],{},"});\n",[74,135,137],{"class":76,"line":136},11,[74,138,87],{"emptyLinePlaceholder":86},[74,140,142],{"class":76,"line":141},12,[74,143,144],{},"it('returns the authenticated user', function () {\n",[74,146,148],{"class":76,"line":147},13,[74,149,150],{},"    $user = App\\Models\\User::factory()->create();\n",[74,152,154],{"class":76,"line":153},14,[74,155,87],{"emptyLinePlaceholder":86},[74,157,159],{"class":76,"line":158},15,[74,160,161],{},"    $response = $this->actingAs($user)\n",[74,163,165],{"class":76,"line":164},16,[74,166,167],{},"        ->getJson(route('user.show'));\n",[74,169,171],{"class":76,"line":170},17,[74,172,87],{"emptyLinePlaceholder":86},[74,174,176],{"class":76,"line":175},18,[74,177,178],{},"    $response\n",[74,180,182],{"class":76,"line":181},19,[74,183,184],{},"        ->assertOk()\n",[74,186,188],{"class":76,"line":187},20,[74,189,190],{},"        ->assertJson(\n",[74,192,194],{"class":76,"line":193},21,[74,195,196],{},"            fn (AssertableJson $json) => $json\n",[74,198,200],{"class":76,"line":199},22,[74,201,202],{},"                ->has(\n",[74,204,206],{"class":76,"line":205},23,[74,207,208],{},"                    'data',\n",[74,210,212],{"class":76,"line":211},24,[74,213,214],{},"                    fn (AssertableJson $json) => $json\n",[74,216,218],{"class":76,"line":217},25,[74,219,220],{},"                        ->where('name', $user->name)\n",[74,222,224],{"class":76,"line":223},26,[74,225,226],{},"                        ->where('username', $user->username)\n",[74,228,230],{"class":76,"line":229},27,[74,231,232],{},"                        ->where('avatar', $user->avatar)\n",[74,234,236],{"class":76,"line":235},28,[74,237,238],{},"                )\n",[74,240,242],{"class":76,"line":241},29,[74,243,244],{},"        );\n",[74,246,248],{"class":76,"line":247},30,[74,249,133],{},[10,251,252],{},"Ces tests ressemblent à ceux des commentaires. Le premier vérifie l'authentification et le second contrôle les données de l'utilisateur dans la réponse JSON.",[10,254,255],{},"Créons maintenant le contrôleur :",[64,257,260],{"className":66,"code":258,"filename":259,"language":69,"meta":70,"style":70},"\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Http\\Controllers\\Api;\n\nuse App\\Http\\Resources\\UserResource;\nuse Illuminate\\Http\\Request;\nuse Illuminate\\Http\\Resources\\Json\\JsonResource;\n\nfinal class UserController\n{\n    public function show(Request $request): JsonResource\n    {\n        return UserResource::make($request->user());\n    }\n}\n","app\u002FHttp\u002FControllers\u002FAuth\u002FAuthenticatedSessionController.php",[42,261,262,266,270,274,278,283,287,292,297,302,306,311,316,321,326,331,336],{"__ignoreMap":70},[74,263,264],{"class":76,"line":77},[74,265,80],{},[74,267,268],{"class":76,"line":83},[74,269,87],{"emptyLinePlaceholder":86},[74,271,272],{"class":76,"line":90},[74,273,93],{},[74,275,276],{"class":76,"line":96},[74,277,87],{"emptyLinePlaceholder":86},[74,279,280],{"class":76,"line":101},[74,281,282],{},"namespace App\\Http\\Controllers\\Api;\n",[74,284,285],{"class":76,"line":107},[74,286,87],{"emptyLinePlaceholder":86},[74,288,289],{"class":76,"line":112},[74,290,291],{},"use App\\Http\\Resources\\UserResource;\n",[74,293,294],{"class":76,"line":118},[74,295,296],{},"use Illuminate\\Http\\Request;\n",[74,298,299],{"class":76,"line":124},[74,300,301],{},"use Illuminate\\Http\\Resources\\Json\\JsonResource;\n",[74,303,304],{"class":76,"line":130},[74,305,87],{"emptyLinePlaceholder":86},[74,307,308],{"class":76,"line":136},[74,309,310],{},"final class UserController\n",[74,312,313],{"class":76,"line":141},[74,314,315],{},"{\n",[74,317,318],{"class":76,"line":147},[74,319,320],{},"    public function show(Request $request): JsonResource\n",[74,322,323],{"class":76,"line":153},[74,324,325],{},"    {\n",[74,327,328],{"class":76,"line":158},[74,329,330],{},"        return UserResource::make($request->user());\n",[74,332,333],{"class":76,"line":164},[74,334,335],{},"    }\n",[74,337,338],{"class":76,"line":170},[74,339,340],{},"}\n",[10,342,343,344,347,348,351,352,355,356,359],{},"Ce contrôleur utilise ",[42,345,346],{},"UserResource"," pour transformer l'utilisateur authentifié en réponse JSON. Nous avons créé cette ressource dans l'article consacré au système de commentaires ; elle expose les champs ",[42,349,350],{},"name",", ",[42,353,354],{},"username"," et ",[42,357,358],{},"avatar",".",[10,361,362,363,366],{},"Enregistrons enfin la route dans ",[42,364,365],{},"routes\u002Fapi.php"," :",[64,368,370],{"className":66,"code":369,"filename":365,"language":69,"meta":70,"style":70},"\u003C?php\n\ndeclare(strict_types=1);\n\nuse App\\Http\\Controllers\\Api\\UserController;\n\nRoute::middleware('auth:sanctum')->group(function () {\n    Route::get('\u002Fuser', [UserController::class, 'show'])\n        ->name('user.show');\n\n    \u002F\u002F ...\n});\n",[42,371,372,376,380,384,388,393,397,402,407,412,416,421],{"__ignoreMap":70},[74,373,374],{"class":76,"line":77},[74,375,80],{},[74,377,378],{"class":76,"line":83},[74,379,87],{"emptyLinePlaceholder":86},[74,381,382],{"class":76,"line":90},[74,383,93],{},[74,385,386],{"class":76,"line":96},[74,387,87],{"emptyLinePlaceholder":86},[74,389,390],{"class":76,"line":101},[74,391,392],{},"use App\\Http\\Controllers\\Api\\UserController;\n",[74,394,395],{"class":76,"line":107},[74,396,87],{"emptyLinePlaceholder":86},[74,398,399],{"class":76,"line":112},[74,400,401],{},"Route::middleware('auth:sanctum')->group(function () {\n",[74,403,404],{"class":76,"line":118},[74,405,406],{},"    Route::get('\u002Fuser', [UserController::class, 'show'])\n",[74,408,409],{"class":76,"line":124},[74,410,411],{},"        ->name('user.show');\n",[74,413,414],{"class":76,"line":130},[74,415,87],{"emptyLinePlaceholder":86},[74,417,418],{"class":76,"line":136},[74,419,420],{},"    \u002F\u002F ...\n",[74,422,423],{"class":76,"line":141},[74,424,133],{},[10,426,427],{},"Cela suffit pour récupérer l'utilisateur courant.",[56,429,431],{"id":430},"déconnecter-lutilisateur","Déconnecter l'utilisateur",[10,433,434],{},"Commençons par les tests :",[64,436,438],{"className":66,"code":437,"filename":68,"language":69,"meta":70,"style":70},"\u003C?php\n\ndeclare(strict_types=1);\n\nuse App\\Models\\User;\n\nit('requires authentification', function () {\n    $this->postJson(route('logout'))\n        ->assertUnauthorized();\n});\n\nit('destroys the session', function () {\n    $response = $this->actingAs(User::factory()->create())\n        ->post(route('logout'))\n        ->assertNoContent();\n\n    $this->assertGuest('web');\n    $response->assertNoContent();\n});\n",[42,439,440,444,448,452,456,461,465,469,474,478,482,486,491,496,501,506,510,515,520],{"__ignoreMap":70},[74,441,442],{"class":76,"line":77},[74,443,80],{},[74,445,446],{"class":76,"line":83},[74,447,87],{"emptyLinePlaceholder":86},[74,449,450],{"class":76,"line":90},[74,451,93],{},[74,453,454],{"class":76,"line":96},[74,455,87],{"emptyLinePlaceholder":86},[74,457,458],{"class":76,"line":101},[74,459,460],{},"use App\\Models\\User;\n",[74,462,463],{"class":76,"line":107},[74,464,87],{"emptyLinePlaceholder":86},[74,466,467],{"class":76,"line":112},[74,468,115],{},[74,470,471],{"class":76,"line":118},[74,472,473],{},"    $this->postJson(route('logout'))\n",[74,475,476],{"class":76,"line":124},[74,477,127],{},[74,479,480],{"class":76,"line":130},[74,481,133],{},[74,483,484],{"class":76,"line":136},[74,485,87],{"emptyLinePlaceholder":86},[74,487,488],{"class":76,"line":141},[74,489,490],{},"it('destroys the session', function () {\n",[74,492,493],{"class":76,"line":147},[74,494,495],{},"    $response = $this->actingAs(User::factory()->create())\n",[74,497,498],{"class":76,"line":153},[74,499,500],{},"        ->post(route('logout'))\n",[74,502,503],{"class":76,"line":158},[74,504,505],{},"        ->assertNoContent();\n",[74,507,508],{"class":76,"line":164},[74,509,87],{"emptyLinePlaceholder":86},[74,511,512],{"class":76,"line":170},[74,513,514],{},"    $this->assertGuest('web');\n",[74,516,517],{"class":76,"line":175},[74,518,519],{},"    $response->assertNoContent();\n",[74,521,522],{"class":76,"line":181},[74,523,133],{},[10,525,526],{},"Ces tests suivent les mêmes patterns que les précédents.",[10,528,255],{},[64,530,533],{"className":66,"code":531,"filename":532,"language":69,"meta":70,"style":70},"\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Http\\Controllers\\Auth;\n\nuse Illuminate\\Http\\Request;\nuse Illuminate\\Http\\Response;\nuse Illuminate\\Support\\Facades\\Auth;\n\nfinal class AuthenticatedSessionController\n{\n    public function destroy(Request $request): Response\n    {\n        Auth::guard('web')->logout();\n\n        $request->session()->invalidate();\n\n        $request->session()->regenerateToken();\n\n        return response()->noContent();\n    }\n}\n","app\u002FHttp\u002FControllers\u002FAuth\u002FAuthenticationSessionController.php",[42,534,535,539,543,547,551,556,560,564,569,574,578,583,587,592,596,601,605,610,614,619,623,628,632],{"__ignoreMap":70},[74,536,537],{"class":76,"line":77},[74,538,80],{},[74,540,541],{"class":76,"line":83},[74,542,87],{"emptyLinePlaceholder":86},[74,544,545],{"class":76,"line":90},[74,546,93],{},[74,548,549],{"class":76,"line":96},[74,550,87],{"emptyLinePlaceholder":86},[74,552,553],{"class":76,"line":101},[74,554,555],{},"namespace App\\Http\\Controllers\\Auth;\n",[74,557,558],{"class":76,"line":107},[74,559,87],{"emptyLinePlaceholder":86},[74,561,562],{"class":76,"line":112},[74,563,296],{},[74,565,566],{"class":76,"line":118},[74,567,568],{},"use Illuminate\\Http\\Response;\n",[74,570,571],{"class":76,"line":124},[74,572,573],{},"use Illuminate\\Support\\Facades\\Auth;\n",[74,575,576],{"class":76,"line":130},[74,577,87],{"emptyLinePlaceholder":86},[74,579,580],{"class":76,"line":136},[74,581,582],{},"final class AuthenticatedSessionController\n",[74,584,585],{"class":76,"line":141},[74,586,315],{},[74,588,589],{"class":76,"line":147},[74,590,591],{},"    public function destroy(Request $request): Response\n",[74,593,594],{"class":76,"line":153},[74,595,325],{},[74,597,598],{"class":76,"line":158},[74,599,600],{},"        Auth::guard('web')->logout();\n",[74,602,603],{"class":76,"line":164},[74,604,87],{"emptyLinePlaceholder":86},[74,606,607],{"class":76,"line":170},[74,608,609],{},"        $request->session()->invalidate();\n",[74,611,612],{"class":76,"line":175},[74,613,87],{"emptyLinePlaceholder":86},[74,615,616],{"class":76,"line":181},[74,617,618],{},"        $request->session()->regenerateToken();\n",[74,620,621],{"class":76,"line":187},[74,622,87],{"emptyLinePlaceholder":86},[74,624,625],{"class":76,"line":193},[74,626,627],{},"        return response()->noContent();\n",[74,629,630],{"class":76,"line":199},[74,631,335],{},[74,633,634],{"class":76,"line":205},[74,635,340],{},[10,637,638,639,642],{},"Le contrôleur utilise la façade ",[42,640,641],{},"Auth"," de Laravel pour déconnecter l'utilisateur. Il invalide ensuite la session et régénère le jeton CSRF. Ces étapes contribuent à prévenir les attaques par fixation de session.",[644,645,648],"callout",{"color":646,"icon":647},"info","i-ph-info-duotone",[10,649,650],{},"Le contrôleur retourne une réponse vide, car le front-end n'a pas besoin d'un corps de réponse pour la déconnexion.",[10,652,362,653,366],{},[42,654,655],{},"routes\u002Fweb.php",[64,657,659],{"className":66,"code":658,"filename":655,"language":69,"meta":70,"style":70},"use App\\Http\\Controllers\\Auth\\AuthenticatedSessionController;\n\nRoute::post('logout', [AuthenticatedSessionController::class, 'destroy'])\n    ->middleware('auth:sanctum')\n    ->name('logout');\n",[42,660,661,666,670,675,680],{"__ignoreMap":70},[74,662,663],{"class":76,"line":77},[74,664,665],{},"use App\\Http\\Controllers\\Auth\\AuthenticatedSessionController;\n",[74,667,668],{"class":76,"line":83},[74,669,87],{"emptyLinePlaceholder":86},[74,671,672],{"class":76,"line":90},[74,673,674],{},"Route::post('logout', [AuthenticatedSessionController::class, 'destroy'])\n",[74,676,677],{"class":76,"line":96},[74,678,679],{},"    ->middleware('auth:sanctum')\n",[74,681,682],{"class":76,"line":101},[74,683,684],{},"    ->name('logout');\n",[10,686,687,688,691,692,695],{},"Cette route utilise le middleware ",[42,689,690],{},"auth:sanctum"," même si elle est définie dans ",[42,693,694],{},"web.php",". Elle ne retourne pas de JSON et n'a pas besoin d'être versionnée avec les autres routes d'API ; la conserver comme route web est donc raisonnable.",[10,697,698,699,702,703,706,707,366],{},"Dans le fichier de configuration ",[42,700,701],{},"config\u002Fcors.php",", nous devons également ajouter la route ",[42,704,705],{},"logout"," au tableau ",[42,708,709],{},"paths",[64,711,713],{"className":66,"code":712,"filename":701,"language":69,"meta":70,"style":70},"return [\n    'paths' => ['api\u002F*', 'logout'],\n\n    \u002F\u002F ...\n];\n",[42,714,715,720,725,729,733],{"__ignoreMap":70},[74,716,717],{"class":76,"line":77},[74,718,719],{},"return [\n",[74,721,722],{"class":76,"line":83},[74,723,724],{},"    'paths' => ['api\u002F*', 'logout'],\n",[74,726,727],{"class":76,"line":90},[74,728,87],{"emptyLinePlaceholder":86},[74,730,731],{"class":76,"line":96},[74,732,420],{},[74,734,735],{"class":76,"line":101},[74,736,737],{},"];\n",[10,739,740],{},"Cela permet au front-end d'appeler la route depuis une autre origine. Sans cette configuration, le navigateur bloquerait la requête à cause de CORS.",[28,742,744],{"id":743},"préparer-le-front-end","Préparer le front-end",[10,746,747],{},"Le back-end est prêt, passons au front-end.",[10,749,750],{},"Nous récupérerons l'utilisateur au démarrage de l'application afin que l'interface puisse réagir à l'état d'authentification. Plusieurs composants ont besoin de cette information. L'en-tête affiche actuellement un bouton de connexion ; nous ajouterons un bouton de déconnexion pour les utilisateurs authentifiés et masquerons le bouton de connexion dans ce cas.",[10,752,753],{},"Le pied de page pourrait également avoir besoin d'un lien de connexion ou de déconnexion, et le système de commentaires utilisera le même état pour décider s'il doit afficher un bouton de connexion ou un formulaire de commentaire.",[10,755,756],{},"La solution la plus simple serait un composable partagé :",[64,758,763],{"className":759,"code":760,"filename":761,"language":762,"meta":70,"style":70},"language-js shiki shiki-themes github-light github-light github-dark","const user = ref(null)\n\nexport function useUser() {\n  async function fetch() {\n    \u002F\u002F Simulate fetching user data from the backend\n    user.value = await fetchUserData()\n  }\n\n  return {\n    user,\n    fetch,\n  }\n}\n","Exemple","js",[42,764,765,792,796,810,822,828,845,850,854,862,867,872,876],{"__ignoreMap":70},[74,766,767,771,775,778,782,786,789],{"class":76,"line":77},[74,768,770],{"class":769},"s8jYJ","const",[74,772,774],{"class":773},"sBjJW"," user",[74,776,777],{"class":769}," =",[74,779,781],{"class":780},"snPdu"," ref",[74,783,785],{"class":784},"sxrX7","(",[74,787,788],{"class":773},"null",[74,790,791],{"class":784},")\n",[74,793,794],{"class":76,"line":83},[74,795,87],{"emptyLinePlaceholder":86},[74,797,798,801,804,807],{"class":76,"line":90},[74,799,800],{"class":769},"export",[74,802,803],{"class":769}," function",[74,805,806],{"class":780}," useUser",[74,808,809],{"class":784},"() {\n",[74,811,812,815,817,820],{"class":76,"line":96},[74,813,814],{"class":769},"  async",[74,816,803],{"class":769},[74,818,819],{"class":780}," fetch",[74,821,809],{"class":784},[74,823,824],{"class":76,"line":101},[74,825,827],{"class":826},"sCsY4","    \u002F\u002F Simulate fetching user data from the backend\n",[74,829,830,833,836,839,842],{"class":76,"line":107},[74,831,832],{"class":784},"    user.value ",[74,834,835],{"class":769},"=",[74,837,838],{"class":769}," await",[74,840,841],{"class":780}," fetchUserData",[74,843,844],{"class":784},"()\n",[74,846,847],{"class":76,"line":112},[74,848,849],{"class":784},"  }\n",[74,851,852],{"class":76,"line":118},[74,853,87],{"emptyLinePlaceholder":86},[74,855,856,859],{"class":76,"line":124},[74,857,858],{"class":769},"  return",[74,860,861],{"class":784}," {\n",[74,863,864],{"class":76,"line":130},[74,865,866],{"class":784},"    user,\n",[74,868,869],{"class":76,"line":136},[74,870,871],{"class":784},"    fetch,\n",[74,873,874],{"class":76,"line":141},[74,875,849],{"class":784},[74,877,878],{"class":76,"line":147},[74,879,340],{"class":784},[644,881,882],{"color":646,"icon":647},[10,883,884,885,892],{},"Nous pourrions aussi utiliser ",[20,886,889],{"href":887,"rel":888},"https:\u002F\u002Fvueuse.org\u002Fshared\u002FcreateSharedComposable\u002F#createsharedcomposable",[24],[42,890,891],{},"createSharedComposable"," de VueUse pour éviter un état global tout en conservant la même instance du composable dans tous les composants.",[10,894,895,896,899,900,903,904,907],{},"Nous appellerions ensuite ",[42,897,898],{},"fetch"," dans le hook ",[42,901,902],{},"onMounted"," du composant principal, ",[42,905,906],{},"Layout.vue"," dans notre cas.",[10,909,910],{},"Cette solution fonctionne un temps, mais devient rapidement difficile à maintenir. Un composant effectue la récupération tandis que beaucoup d'autres consomment le résultat. Cela reste gérable pour un seul type de données, mais devient désordonné à mesure que l'application grandit.",[10,912,913],{},"Nous aurions également besoin de code répétitif pour gérer l'état des mutations. Se déconnecter, créer un commentaire et supprimer un commentaire nécessitent tous un état de chargement et d'erreur. Répéter ce code rendrait les composants verbeux ou nous pousserait à créer un ensemble d'utilitaires personnalisés.",[10,915,916],{},"Nous pourrions aussi vouloir des mises à jour optimistes. La déconnexion en est un bon exemple : retirer immédiatement l'utilisateur de l'état, appeler l'API, puis restaurer l'utilisateur si la requête échoue. Implémenter cela de manière fiable et générique n'est pas trivial.",[10,918,919],{},"Pour éviter ce code répétitif, nous allons combiner Pinia et Pinia Colada.",[921,922,923,926],"ul",{},[39,924,925],{},"Pinia est la bibliothèque de gestion d'état de Vue. Un store centralise l'état, les getters et les actions, tandis que l'interface réagit aux changements de cet état.",[39,927,928],{},"Pinia Colada est une bibliothèque de récupération de données construite au-dessus de Pinia. Elle gère les requêtes et l'état du cache, et fournit les hooks nécessaires aux mises à jour optimistes.",[10,930,931],{},"Installez Pinia et Pinia Colada dans le projet Garabit :",[64,933,938],{"className":934,"code":935,"filename":936,"language":937,"meta":70,"style":70},"language-bash shiki shiki-themes github-light github-light github-dark","pnpm install pinia @pinia\u002Fcolada\n","terminal","bash",[42,939,940],{"__ignoreMap":70},[74,941,942,945,949,952],{"class":76,"line":77},[74,943,944],{"class":780},"pnpm",[74,946,948],{"class":947},"sIIMD"," install",[74,950,951],{"class":947}," pinia",[74,953,954],{"class":947}," @pinia\u002Fcolada\n",[10,956,957],{},"Enregistrons-les ensuite dans notre application Vue :",[64,959,964],{"className":960,"code":961,"filename":962,"language":963,"meta":70,"style":70},"language-ts shiki shiki-themes github-light github-light github-dark","import { PiniaColada } from '@pinia\u002Fcolada'\nimport { createPinia } from 'pinia'\n\nexport default {\n  Layout,\n  enhanceApp({ app }) {\n    app.use(createPinia())\n    app.use(PiniaColada)\n  },\n} satisfies Theme\n",".vitepress\u002Ftheme\u002Findex.ts","ts",[42,965,966,980,992,996,1005,1010,1025,1041,1050,1055],{"__ignoreMap":70},[74,967,968,971,974,977],{"class":76,"line":77},[74,969,970],{"class":769},"import",[74,972,973],{"class":784}," { PiniaColada } ",[74,975,976],{"class":769},"from",[74,978,979],{"class":947}," '@pinia\u002Fcolada'\n",[74,981,982,984,987,989],{"class":76,"line":83},[74,983,970],{"class":769},[74,985,986],{"class":784}," { createPinia } ",[74,988,976],{"class":769},[74,990,991],{"class":947}," 'pinia'\n",[74,993,994],{"class":76,"line":90},[74,995,87],{"emptyLinePlaceholder":86},[74,997,998,1000,1003],{"class":76,"line":96},[74,999,800],{"class":769},[74,1001,1002],{"class":769}," default",[74,1004,861],{"class":784},[74,1006,1007],{"class":76,"line":101},[74,1008,1009],{"class":784},"  Layout,\n",[74,1011,1012,1015,1018,1022],{"class":76,"line":107},[74,1013,1014],{"class":780},"  enhanceApp",[74,1016,1017],{"class":784},"({ ",[74,1019,1021],{"class":1020},"sP4rz","app",[74,1023,1024],{"class":784}," }) {\n",[74,1026,1027,1030,1033,1035,1038],{"class":76,"line":112},[74,1028,1029],{"class":784},"    app.",[74,1031,1032],{"class":780},"use",[74,1034,785],{"class":784},[74,1036,1037],{"class":780},"createPinia",[74,1039,1040],{"class":784},"())\n",[74,1042,1043,1045,1047],{"class":76,"line":118},[74,1044,1029],{"class":784},[74,1046,1032],{"class":780},[74,1048,1049],{"class":784},"(PiniaColada)\n",[74,1051,1052],{"class":76,"line":124},[74,1053,1054],{"class":784},"  },\n",[74,1056,1057,1060,1063],{"class":76,"line":130},[74,1058,1059],{"class":784},"} ",[74,1061,1062],{"class":769},"satisfies",[74,1064,1065],{"class":780}," Theme\n",[10,1067,1068],{},"Les deux packages sont des plugins Vue qui ajoutent des fonctionnalités au niveau de l'application.",[10,1070,1071,1072,1075],{},"Supprimez le code de requête temporaire de ",[42,1073,1074],{},".vitepress\u002Ftheme\u002FLayout.vue"," ; il sera remplacé par le client API partagé.",[10,1077,1078,1079,1082,1083,1086],{},"Avant d'écrire le code de la fonctionnalité, définissons sa structure. Dans ",[42,1080,1081],{},"common\u002Futils\u002Fapi.ts",", nous allons créer une instance personnalisée de ",[42,1084,1085],{},"ofetch"," afin que chaque requête utilise le même hôte, les mêmes en-têtes, les mêmes identifiants et la même gestion CSRF. C'est le code introduit dans l'article précédent.",[10,1088,1089],{},"Chaque fonctionnalité contiendra deux dossiers et un fichier API :",[36,1091,1092,1101,1110],{},[39,1093,1094,1097,1098,1100],{},[42,1095,1096],{},"queries"," : Contient les requêtes qui récupèrent des données. ",[42,1099,44],{}," est une query.",[39,1102,1103,1106,1107,1109],{},[42,1104,1105],{},"mutations"," : Contient les requêtes qui modifient des données. ",[42,1108,50],{}," est une mutation.",[39,1111,1112,1115],{},[42,1113,1114],{},"api.ts"," : Contient les fonctions bas niveau qui effectuent les requêtes. Ce fichier reste indépendant de la bibliothèque de gestion d'état, ce qui rend la couche API facile à lire et à tester.",[10,1117,1118,1119,1122,1123,1126],{},"Ces dossiers et ce fichier API existeront pour chaque fonctionnalité. Aujourd'hui, nous allons créer la fonctionnalité ",[42,1120,1121],{},"user",". L'article suivant ajoutera une fonctionnalité ",[42,1124,1125],{},"comments",". Cette séparation rassemble le code lié et facilite sa recherche.",[28,1128,1130],{"id":1129},"étendre-ofetch","Étendre ofetch",[10,1132,1133,1134,1136,1137,366],{},"Créons l'instance personnalisée de ",[42,1135,1085],{}," dans ",[42,1138,1139],{},".vitepress\u002Ftheme\u002Fcommon\u002Futils\u002Fapi.ts",[64,1141,1143],{"className":960,"code":1142,"filename":1139,"language":963,"meta":70,"style":70},"import { ofetch } from 'ofetch'\n\nexport const api = ofetch.create({\n  baseURL: import.meta.env.VITE_API_URL,\n  headers: {\n    Accept: 'application\u002Fjson',\n  },\n  credentials: 'include',\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(\n      'X-Xsrf-Token',\n      decodeURIComponent(getCookie('XSRF-TOKEN') || ''),\n    )\n  },\n})\n\nfunction getCookie(name: string) {\n  const match = document.cookie.match(new RegExp(`(^| )${name}=([^;]+)`))\n  return match ? match[2] : null\n}\n",[42,1144,1145,1157,1161,1182,1203,1208,1218,1222,1232,1257,1282,1286,1316,1321,1325,1329,1348,1352,1365,1381,1398,1407,1412,1416,1420,1431,1438,1463,1468,1472,1477,1482,1503,1541,1566],{"__ignoreMap":70},[74,1146,1147,1149,1152,1154],{"class":76,"line":77},[74,1148,970],{"class":769},[74,1150,1151],{"class":784}," { ofetch } ",[74,1153,976],{"class":769},[74,1155,1156],{"class":947}," 'ofetch'\n",[74,1158,1159],{"class":76,"line":83},[74,1160,87],{"emptyLinePlaceholder":86},[74,1162,1163,1165,1168,1171,1173,1176,1179],{"class":76,"line":90},[74,1164,800],{"class":769},[74,1166,1167],{"class":769}," const",[74,1169,1170],{"class":773}," api",[74,1172,777],{"class":769},[74,1174,1175],{"class":784}," ofetch.",[74,1177,1178],{"class":780},"create",[74,1180,1181],{"class":784},"({\n",[74,1183,1184,1187,1189,1191,1194,1197,1200],{"class":76,"line":96},[74,1185,1186],{"class":784},"  baseURL: ",[74,1188,970],{"class":769},[74,1190,359],{"class":784},[74,1192,1193],{"class":773},"meta",[74,1195,1196],{"class":784},".env.",[74,1198,1199],{"class":773},"VITE_API_URL",[74,1201,1202],{"class":784},",\n",[74,1204,1205],{"class":76,"line":101},[74,1206,1207],{"class":784},"  headers: {\n",[74,1209,1210,1213,1216],{"class":76,"line":107},[74,1211,1212],{"class":784},"    Accept: ",[74,1214,1215],{"class":947},"'application\u002Fjson'",[74,1217,1202],{"class":784},[74,1219,1220],{"class":76,"line":112},[74,1221,1054],{"class":784},[74,1223,1224,1227,1230],{"class":76,"line":118},[74,1225,1226],{"class":784},"  credentials: ",[74,1228,1229],{"class":947},"'include'",[74,1231,1202],{"class":784},[74,1233,1234,1237,1240,1243,1246,1249,1252,1255],{"class":76,"line":124},[74,1235,1236],{"class":780},"  onRequest",[74,1238,1239],{"class":784},": ",[74,1241,1242],{"class":769},"async",[74,1244,1245],{"class":784}," ({ ",[74,1247,1248],{"class":1020},"options",[74,1250,1251],{"class":784}," }) ",[74,1253,1254],{"class":769},"=>",[74,1256,861],{"class":784},[74,1258,1259,1262,1265,1267,1270,1273,1276,1279],{"class":76,"line":130},[74,1260,1261],{"class":769},"    const",[74,1263,1264],{"class":773}," method",[74,1266,777],{"class":769},[74,1268,1269],{"class":784}," options.method?.",[74,1271,1272],{"class":780},"toUpperCase",[74,1274,1275],{"class":784},"() ",[74,1277,1278],{"class":769},"||",[74,1280,1281],{"class":947}," 'GET'\n",[74,1283,1284],{"class":76,"line":136},[74,1285,87],{"emptyLinePlaceholder":86},[74,1287,1288,1291,1294,1297,1299,1302,1304,1307,1310,1313],{"class":76,"line":141},[74,1289,1290],{"class":769},"    if",[74,1292,1293],{"class":784}," ([",[74,1295,1296],{"class":947},"'GET'",[74,1298,351],{"class":784},[74,1300,1301],{"class":947},"'HEAD'",[74,1303,351],{"class":784},[74,1305,1306],{"class":947},"'OPTIONS'",[74,1308,1309],{"class":784},"].",[74,1311,1312],{"class":780},"includes",[74,1314,1315],{"class":784},"(method)) {\n",[74,1317,1318],{"class":76,"line":147},[74,1319,1320],{"class":769},"      return\n",[74,1322,1323],{"class":76,"line":153},[74,1324,335],{"class":784},[74,1326,1327],{"class":76,"line":158},[74,1328,87],{"emptyLinePlaceholder":86},[74,1330,1331,1333,1336,1338,1341,1343,1346],{"class":76,"line":164},[74,1332,1261],{"class":769},[74,1334,1335],{"class":773}," xsrfToken",[74,1337,777],{"class":769},[74,1339,1340],{"class":780}," getCookie",[74,1342,785],{"class":784},[74,1344,1345],{"class":947},"'XSRF-TOKEN'",[74,1347,791],{"class":784},[74,1349,1350],{"class":76,"line":170},[74,1351,87],{"emptyLinePlaceholder":86},[74,1353,1354,1356,1359,1362],{"class":76,"line":175},[74,1355,1290],{"class":769},[74,1357,1358],{"class":784}," (",[74,1360,1361],{"class":769},"!",[74,1363,1364],{"class":784},"xsrfToken) {\n",[74,1366,1367,1370,1373,1375,1378],{"class":76,"line":181},[74,1368,1369],{"class":769},"      await",[74,1371,1372],{"class":780}," ofetch",[74,1374,785],{"class":784},[74,1376,1377],{"class":947},"'\u002Fsanctum\u002Fcsrf-cookie'",[74,1379,1380],{"class":784},", {\n",[74,1382,1383,1386,1388,1390,1392,1394,1396],{"class":76,"line":187},[74,1384,1385],{"class":784},"        baseURL: ",[74,1387,970],{"class":769},[74,1389,359],{"class":784},[74,1391,1193],{"class":773},[74,1393,1196],{"class":784},[74,1395,1199],{"class":773},[74,1397,1202],{"class":784},[74,1399,1400,1403,1405],{"class":76,"line":193},[74,1401,1402],{"class":784},"        credentials: ",[74,1404,1229],{"class":947},[74,1406,1202],{"class":784},[74,1408,1409],{"class":76,"line":199},[74,1410,1411],{"class":784},"      })\n",[74,1413,1414],{"class":76,"line":205},[74,1415,335],{"class":784},[74,1417,1418],{"class":76,"line":211},[74,1419,87],{"emptyLinePlaceholder":86},[74,1421,1422,1425,1428],{"class":76,"line":217},[74,1423,1424],{"class":784},"    options.headers.",[74,1426,1427],{"class":780},"set",[74,1429,1430],{"class":784},"(\n",[74,1432,1433,1436],{"class":76,"line":223},[74,1434,1435],{"class":947},"      'X-Xsrf-Token'",[74,1437,1202],{"class":784},[74,1439,1440,1443,1445,1448,1450,1452,1455,1457,1460],{"class":76,"line":229},[74,1441,1442],{"class":780},"      decodeURIComponent",[74,1444,785],{"class":784},[74,1446,1447],{"class":780},"getCookie",[74,1449,785],{"class":784},[74,1451,1345],{"class":947},[74,1453,1454],{"class":784},") ",[74,1456,1278],{"class":769},[74,1458,1459],{"class":947}," ''",[74,1461,1462],{"class":784},"),\n",[74,1464,1465],{"class":76,"line":235},[74,1466,1467],{"class":784},"    )\n",[74,1469,1470],{"class":76,"line":241},[74,1471,1054],{"class":784},[74,1473,1474],{"class":76,"line":247},[74,1475,1476],{"class":784},"})\n",[74,1478,1480],{"class":76,"line":1479},31,[74,1481,87],{"emptyLinePlaceholder":86},[74,1483,1485,1488,1490,1492,1494,1497,1500],{"class":76,"line":1484},32,[74,1486,1487],{"class":769},"function",[74,1489,1340],{"class":780},[74,1491,785],{"class":784},[74,1493,350],{"class":1020},[74,1495,1496],{"class":769},":",[74,1498,1499],{"class":773}," string",[74,1501,1502],{"class":784},") {\n",[74,1504,1506,1509,1512,1514,1517,1520,1522,1525,1528,1530,1533,1535,1538],{"class":76,"line":1505},33,[74,1507,1508],{"class":769},"  const",[74,1510,1511],{"class":773}," match",[74,1513,777],{"class":769},[74,1515,1516],{"class":784}," document.cookie.",[74,1518,1519],{"class":780},"match",[74,1521,785],{"class":784},[74,1523,1524],{"class":769},"new",[74,1526,1527],{"class":780}," RegExp",[74,1529,785],{"class":784},[74,1531,1532],{"class":947},"`(^| )${",[74,1534,350],{"class":784},[74,1536,1537],{"class":947},"}=([^;]+)`",[74,1539,1540],{"class":784},"))\n",[74,1542,1544,1546,1549,1552,1555,1558,1561,1563],{"class":76,"line":1543},34,[74,1545,858],{"class":769},[74,1547,1548],{"class":784}," match ",[74,1550,1551],{"class":769},"?",[74,1553,1554],{"class":784}," match[",[74,1556,1557],{"class":773},"2",[74,1559,1560],{"class":784},"] ",[74,1562,1496],{"class":769},[74,1564,1565],{"class":773}," null\n",[74,1567,1569],{"class":76,"line":1568},35,[74,1570,340],{"class":784},[28,1572,1574],{"id":1573},"tout-importer-automatiquement","Tout importer automatiquement",[10,1576,1577,1578,1581],{},"Comme pour la configuration de la série, mettez à jour ",[42,1579,1580],{},".vitepress\u002Fconfig.mts"," pour importer automatiquement les nouveaux utilitaires, queries, mutations et composables Pinia Colada.",[64,1583,1586],{"className":1584,"code":1585,"filename":1580,"language":963,"meta":70,"style":70},"language-ts shiki shiki-themes github-light github-light github-dark has-diff has-highlighted","const currentDir = dirname(fileURLToPath(import.meta.url))\nconst themeDir = resolve(currentDir, 'theme')\n\nconst utilsDir = resolve(themeDir, '**', 'utils') \u002F\u002F [!code ++]\nconst queriesDir = resolve(themeDir, '**', 'queries') \u002F\u002F [!code ++]\nconst mutationsDir = resolve(themeDir, '**', 'mutations') \u002F\u002F [!code ++]\nconst apiFile = resolve(themeDir, '**', 'api.ts') \u002F\u002F [!code ++]\n\nexport default defineConfig({\n  vite: {\n    plugins: [\n      AutoImport({\n        imports: [\n          { \u002F\u002F [!code ++]\n            from: '@pinia\u002Fcolada', \u002F\u002F [!code ++]\n            imports: [ \u002F\u002F [!code ++]\n              'defineQuery', \u002F\u002F [!code ++]\n              'useQuery', \u002F\u002F [!code ++]\n              'defineMutation', \u002F\u002F [!code ++]\n              'useMutation', \u002F\u002F [!code ++]\n              'useQueryCache', \u002F\u002F [!code ++]\n            ], \u002F\u002F [!code ++]\n          }, \u002F\u002F [!code ++]\n        ],\n        dirs: [composablesDir, utilsDir, queriesDir, mutationsDir, apiFile], \u002F\u002F [!code highlight]\n      }),\n    ],\n  },\n})\n",[42,1587,1588,1616,1636,1640,1667,1690,1713,1736,1740,1751,1756,1761,1768,1773,1779,1790,1796,1804,1812,1820,1828,1836,1842,1848,1853,1860,1865,1870,1874],{"__ignoreMap":70},[74,1589,1590,1592,1595,1597,1600,1602,1605,1607,1609,1611,1613],{"class":76,"line":77},[74,1591,770],{"class":769},[74,1593,1594],{"class":773}," currentDir",[74,1596,777],{"class":769},[74,1598,1599],{"class":780}," dirname",[74,1601,785],{"class":784},[74,1603,1604],{"class":780},"fileURLToPath",[74,1606,785],{"class":784},[74,1608,970],{"class":769},[74,1610,359],{"class":784},[74,1612,1193],{"class":773},[74,1614,1615],{"class":784},".url))\n",[74,1617,1618,1620,1623,1625,1628,1631,1634],{"class":76,"line":83},[74,1619,770],{"class":769},[74,1621,1622],{"class":773}," themeDir",[74,1624,777],{"class":769},[74,1626,1627],{"class":780}," resolve",[74,1629,1630],{"class":784},"(currentDir, ",[74,1632,1633],{"class":947},"'theme'",[74,1635,791],{"class":784},[74,1637,1638],{"class":76,"line":90},[74,1639,87],{"emptyLinePlaceholder":86},[74,1641,1645,1647,1650,1652,1654,1657,1660,1662,1665],{"class":1642,"line":96},[76,1643,1644],"diff","add",[74,1646,770],{"class":769},[74,1648,1649],{"class":773}," utilsDir",[74,1651,777],{"class":769},[74,1653,1627],{"class":780},[74,1655,1656],{"class":784},"(themeDir, ",[74,1658,1659],{"class":947},"'**'",[74,1661,351],{"class":784},[74,1663,1664],{"class":947},"'utils'",[74,1666,1454],{"class":784},[74,1668,1670,1672,1675,1677,1679,1681,1683,1685,1688],{"class":1669,"line":101},[76,1643,1644],[74,1671,770],{"class":769},[74,1673,1674],{"class":773}," queriesDir",[74,1676,777],{"class":769},[74,1678,1627],{"class":780},[74,1680,1656],{"class":784},[74,1682,1659],{"class":947},[74,1684,351],{"class":784},[74,1686,1687],{"class":947},"'queries'",[74,1689,1454],{"class":784},[74,1691,1693,1695,1698,1700,1702,1704,1706,1708,1711],{"class":1692,"line":107},[76,1643,1644],[74,1694,770],{"class":769},[74,1696,1697],{"class":773}," mutationsDir",[74,1699,777],{"class":769},[74,1701,1627],{"class":780},[74,1703,1656],{"class":784},[74,1705,1659],{"class":947},[74,1707,351],{"class":784},[74,1709,1710],{"class":947},"'mutations'",[74,1712,1454],{"class":784},[74,1714,1716,1718,1721,1723,1725,1727,1729,1731,1734],{"class":1715,"line":112},[76,1643,1644],[74,1717,770],{"class":769},[74,1719,1720],{"class":773}," apiFile",[74,1722,777],{"class":769},[74,1724,1627],{"class":780},[74,1726,1656],{"class":784},[74,1728,1659],{"class":947},[74,1730,351],{"class":784},[74,1732,1733],{"class":947},"'api.ts'",[74,1735,1454],{"class":784},[74,1737,1738],{"class":76,"line":118},[74,1739,87],{"emptyLinePlaceholder":86},[74,1741,1742,1744,1746,1749],{"class":76,"line":124},[74,1743,800],{"class":769},[74,1745,1002],{"class":769},[74,1747,1748],{"class":780}," defineConfig",[74,1750,1181],{"class":784},[74,1752,1753],{"class":76,"line":130},[74,1754,1755],{"class":784},"  vite: {\n",[74,1757,1758],{"class":76,"line":136},[74,1759,1760],{"class":784},"    plugins: [\n",[74,1762,1763,1766],{"class":76,"line":141},[74,1764,1765],{"class":780},"      AutoImport",[74,1767,1181],{"class":784},[74,1769,1770],{"class":76,"line":147},[74,1771,1772],{"class":784},"        imports: [\n",[74,1774,1776],{"class":1775,"line":153},[76,1643,1644],[74,1777,1778],{"class":784},"          { ",[74,1780,1782,1785,1788],{"class":1781,"line":158},[76,1643,1644],[74,1783,1784],{"class":784},"            from: ",[74,1786,1787],{"class":947},"'@pinia\u002Fcolada'",[74,1789,351],{"class":784},[74,1791,1793],{"class":1792,"line":164},[76,1643,1644],[74,1794,1795],{"class":784},"            imports: [ ",[74,1797,1799,1802],{"class":1798,"line":170},[76,1643,1644],[74,1800,1801],{"class":947},"              'defineQuery'",[74,1803,351],{"class":784},[74,1805,1807,1810],{"class":1806,"line":175},[76,1643,1644],[74,1808,1809],{"class":947},"              'useQuery'",[74,1811,351],{"class":784},[74,1813,1815,1818],{"class":1814,"line":181},[76,1643,1644],[74,1816,1817],{"class":947},"              'defineMutation'",[74,1819,351],{"class":784},[74,1821,1823,1826],{"class":1822,"line":187},[76,1643,1644],[74,1824,1825],{"class":947},"              'useMutation'",[74,1827,351],{"class":784},[74,1829,1831,1834],{"class":1830,"line":193},[76,1643,1644],[74,1832,1833],{"class":947},"              'useQueryCache'",[74,1835,351],{"class":784},[74,1837,1839],{"class":1838,"line":199},[76,1643,1644],[74,1840,1841],{"class":784},"            ], ",[74,1843,1845],{"class":1844,"line":205},[76,1643,1644],[74,1846,1847],{"class":784},"          }, ",[74,1849,1850],{"class":76,"line":211},[74,1851,1852],{"class":784},"        ],\n",[74,1854,1857],{"class":1855,"line":217},[76,1856],"highlighted",[74,1858,1859],{"class":784},"        dirs: [composablesDir, utilsDir, queriesDir, mutationsDir, apiFile], ",[74,1861,1862],{"class":76,"line":223},[74,1863,1864],{"class":784},"      }),\n",[74,1866,1867],{"class":76,"line":229},[74,1868,1869],{"class":784},"    ],\n",[74,1871,1872],{"class":76,"line":235},[74,1873,1054],{"class":784},[74,1875,1876],{"class":76,"line":241},[74,1877,1476],{"class":784},[10,1879,1880,1881,351,1884,355,1886,1888],{},"Toutes les fonctions exportées depuis les dossiers ",[42,1882,1883],{},"utils",[42,1885,1096],{},[42,1887,1105],{}," sont maintenant disponibles dans toute l'application.",[28,1890,1892],{"id":1891},"créer-la-fonctionnalité-utilisateur","Créer la fonctionnalité utilisateur",[10,1894,1895],{},"Suivons maintenant notre plan.",[10,1897,1898,1899,366],{},"Créons la fonctionnalité ",[42,1900,1121],{},[64,1902,1904],{"className":934,"code":1903,"filename":936,"language":937,"meta":70,"style":70},"mkdir -p .vitepress\u002Ftheme\u002Fuser\u002F{queries,mutations}\ntouch .vitepress\u002Ftheme\u002Fuser\u002Fapi.ts\n",[42,1905,1906,1917],{"__ignoreMap":70},[74,1907,1908,1911,1914],{"class":76,"line":77},[74,1909,1910],{"class":780},"mkdir",[74,1912,1913],{"class":773}," -p",[74,1915,1916],{"class":947}," .vitepress\u002Ftheme\u002Fuser\u002F{queries,mutations}\n",[74,1918,1919,1922],{"class":76,"line":83},[74,1920,1921],{"class":780},"touch",[74,1923,1924],{"class":947}," .vitepress\u002Ftheme\u002Fuser\u002Fapi.ts\n",[10,1926,1927,1928,366],{},"Écrivons ensuite le code qui récupère les données utilisateur et déconnecte l'utilisateur dans ",[42,1929,1930],{},".vitepress\u002Ftheme\u002Fuser\u002Fapi.ts",[64,1932,1934],{"className":960,"code":1933,"filename":1930,"language":963,"meta":70,"style":70},"export const fetchUser = () => api('api\u002Fuser')\n\nexport const postLogoutUser = () => api('logout', { method: 'POST' })\n",[42,1935,1936,1961,1965],{"__ignoreMap":70},[74,1937,1938,1940,1942,1945,1947,1950,1952,1954,1956,1959],{"class":76,"line":77},[74,1939,800],{"class":769},[74,1941,1167],{"class":769},[74,1943,1944],{"class":780}," fetchUser",[74,1946,777],{"class":769},[74,1948,1949],{"class":784}," () ",[74,1951,1254],{"class":769},[74,1953,1170],{"class":780},[74,1955,785],{"class":784},[74,1957,1958],{"class":947},"'api\u002Fuser'",[74,1960,791],{"class":784},[74,1962,1963],{"class":76,"line":83},[74,1964,87],{"emptyLinePlaceholder":86},[74,1966,1967,1969,1971,1974,1976,1978,1980,1982,1984,1987,1990,1993],{"class":76,"line":90},[74,1968,800],{"class":769},[74,1970,1167],{"class":769},[74,1972,1973],{"class":780}," postLogoutUser",[74,1975,777],{"class":769},[74,1977,1949],{"class":784},[74,1979,1254],{"class":769},[74,1981,1170],{"class":780},[74,1983,785],{"class":784},[74,1985,1986],{"class":947},"'logout'",[74,1988,1989],{"class":784},", { method: ",[74,1991,1992],{"class":947},"'POST'",[74,1994,1995],{"class":784}," })\n",[10,1997,1998,1999,355,2002,2005],{},"Ces fonctions abstraient les appels API bruts. Le reste de la fonctionnalité peut utiliser les noms explicites ",[42,2000,2001],{},"fetchUser",[42,2003,2004],{},"postLogoutUser"," sans connaître les détails de la requête.",[644,2007,2008],{"color":646,"icon":647},[10,2009,2010,2011,2013],{},"Comment nommer les fonctions API ? J'utilise le préfixe ",[42,2012,898],{}," pour les queries, suivi du nom de la ressource. Pour les mutations, j'utilise le verbe HTTP suivi du nom de la ressource. Les fonctions sont ainsi faciles à reconnaître et à retenir.",[10,2015,2016],{},"Créons maintenant la query qui récupère les données utilisateur :",[64,2018,2021],{"className":960,"code":2019,"filename":2020,"language":963,"meta":70,"style":70},"import type { User } from '@\u002Fuser\u002Ftypes\u002Fuser'\n\nexport const useUser = defineQuery(() => {\n  return useQuery\u003CUser>({\n    key: ['user'],\n    query: () => fetchUser().then(response => response.data),\n    enabled: typeof document !== 'undefined',\n  })\n})\n",".vitepress\u002Ftheme\u002Fuser\u002Fqueries\u002Fusers.ts",[42,2022,2023,2038,2042,2062,2078,2089,2118,2137,2142],{"__ignoreMap":70},[74,2024,2025,2027,2030,2033,2035],{"class":76,"line":77},[74,2026,970],{"class":769},[74,2028,2029],{"class":769}," type",[74,2031,2032],{"class":784}," { User } ",[74,2034,976],{"class":769},[74,2036,2037],{"class":947}," '@\u002Fuser\u002Ftypes\u002Fuser'\n",[74,2039,2040],{"class":76,"line":83},[74,2041,87],{"emptyLinePlaceholder":86},[74,2043,2044,2046,2048,2050,2052,2055,2058,2060],{"class":76,"line":90},[74,2045,800],{"class":769},[74,2047,1167],{"class":769},[74,2049,806],{"class":773},[74,2051,777],{"class":769},[74,2053,2054],{"class":780}," defineQuery",[74,2056,2057],{"class":784},"(() ",[74,2059,1254],{"class":769},[74,2061,861],{"class":784},[74,2063,2064,2066,2069,2072,2075],{"class":76,"line":96},[74,2065,858],{"class":769},[74,2067,2068],{"class":780}," useQuery",[74,2070,2071],{"class":784},"\u003C",[74,2073,2074],{"class":780},"User",[74,2076,2077],{"class":784},">({\n",[74,2079,2080,2083,2086],{"class":76,"line":101},[74,2081,2082],{"class":784},"    key: [",[74,2084,2085],{"class":947},"'user'",[74,2087,2088],{"class":784},"],\n",[74,2090,2091,2094,2097,2099,2101,2104,2107,2109,2112,2115],{"class":76,"line":107},[74,2092,2093],{"class":780},"    query",[74,2095,2096],{"class":784},": () ",[74,2098,1254],{"class":769},[74,2100,1944],{"class":780},[74,2102,2103],{"class":784},"().",[74,2105,2106],{"class":780},"then",[74,2108,785],{"class":784},[74,2110,2111],{"class":1020},"response",[74,2113,2114],{"class":769}," =>",[74,2116,2117],{"class":784}," response.data),\n",[74,2119,2120,2123,2126,2129,2132,2135],{"class":76,"line":112},[74,2121,2122],{"class":784},"    enabled: ",[74,2124,2125],{"class":769},"typeof",[74,2127,2128],{"class":784}," document ",[74,2130,2131],{"class":769},"!==",[74,2133,2134],{"class":947}," 'undefined'",[74,2136,1202],{"class":784},[74,2138,2139],{"class":76,"line":118},[74,2140,2141],{"class":784},"  })\n",[74,2143,2144],{"class":76,"line":124},[74,2145,1476],{"class":784},[10,2147,2148],{},"Nous devons également définir un nouveau type pour l'utilisateur :",[64,2150,2153],{"className":960,"code":2151,"filename":2152,"language":963,"meta":70,"style":70},"export interface User {\n  id: number\n  name: string\n  username: string\n  avatar: string\n}\n",".vitepress\u002Ftheme\u002Fuser\u002Ftypes\u002Fuser.ts",[42,2154,2155,2167,2177,2187,2196,2205],{"__ignoreMap":70},[74,2156,2157,2159,2162,2165],{"class":76,"line":77},[74,2158,800],{"class":769},[74,2160,2161],{"class":769}," interface",[74,2163,2164],{"class":780}," User",[74,2166,861],{"class":784},[74,2168,2169,2172,2174],{"class":76,"line":83},[74,2170,2171],{"class":1020},"  id",[74,2173,1496],{"class":769},[74,2175,2176],{"class":773}," number\n",[74,2178,2179,2182,2184],{"class":76,"line":90},[74,2180,2181],{"class":1020},"  name",[74,2183,1496],{"class":769},[74,2185,2186],{"class":773}," string\n",[74,2188,2189,2192,2194],{"class":76,"line":96},[74,2190,2191],{"class":1020},"  username",[74,2193,1496],{"class":769},[74,2195,2186],{"class":773},[74,2197,2198,2201,2203],{"class":76,"line":101},[74,2199,2200],{"class":1020},"  avatar",[74,2202,1496],{"class":769},[74,2204,2186],{"class":773},[74,2206,2207],{"class":76,"line":107},[74,2208,340],{"class":784},[10,2210,2211],{},"Voici le fonctionnement de la query :",[921,2213,2214,2220,2226,2236,2248],{},[39,2215,2216,2219],{},[42,2217,2218],{},"defineQuery"," définit une query réutilisable dans le contexte Vue.",[39,2221,2222,2225],{},[42,2223,2224],{},"useQuery"," décrit la clé, la fonction de requête et l'état retourné aux composants.",[39,2227,2228,2231,2232,2235],{},[42,2229,2230],{},"key"," identifie la query dans le cache de Pinia Colada. Lorsque ",[42,2233,2234],{},"useUser"," est appelée à nouveau, Pinia Colada peut réutiliser un résultat récent en cache au lieu d'envoyer une autre requête.",[39,2237,2238,2241,2242,2245,2246,359],{},[42,2239,2240],{},"query"," retourne la promesse de la requête API. Nous retournons la propriété ",[42,2243,2244],{},"data"," de la réponse, car les ressources Laravel encapsulent leur contenu dans ",[42,2247,2244],{},[39,2249,2250,2253],{},[42,2251,2252],{},"enabled"," limite la requête au navigateur. Nous ne voulons pas appeler l'API lorsque VitePress génère le site.",[10,2255,2256,2257,2259],{},"Nous pouvons maintenant appeler ",[42,2258,2234],{}," n'importe où dans l'application. Les composants n'ont pas besoin d'attendre la requête ; ils consomment son état réactif et laissent Vue mettre à jour l'interface lorsque les données arrivent.",[10,2261,2262],{},"Pinia Colada déduplique également les requêtes, recharge les données obsolètes si nécessaire, expose le cache et fournit des hooks pour les mises à jour optimistes.",[644,2264,2265],{"color":646,"icon":647},[10,2266,2267,2268,2270],{},"La déduplication est importante, car plusieurs composants peuvent appeler ",[42,2269,2234],{}," sur la même page. Pinia Colada effectue une seule requête API et partage le résultat entre ces appels.",[10,2272,2273],{},"Écrivons maintenant la mutation qui déconnecte l'utilisateur :",[64,2275,2278],{"className":960,"code":2276,"filename":2277,"language":963,"meta":70,"style":70},"import type { User } from '@\u002Fuser\u002Ftypes\u002Fuser'\n\nexport const useLogoutUser = defineMutation(() => {\n  const queryCache = useQueryCache()\n\n  return useMutation({\n    mutation: () => postLogoutUser(),\n\n    onMutate: () => {\n      const oldUser = queryCache.getQueryData\u003CUser>(['user'])\n\n      queryCache.setQueryData(['user'], null)\n      queryCache.cancelQueries({ key: ['user'], exact: true })\n\n      return { oldUser }\n    },\n    onError: (_, __, { oldUser }) => {\n      if (oldUser) {\n        queryCache.setQueryData(['user'], oldUser)\n      }\n    },\n    onSettled: () =>\n      queryCache.invalidateQueries({ key: ['user'], exact: true }),\n  })\n})\n",".vitepress\u002Ftheme\u002Fuser\u002Fmutations\u002Fusers.ts",[42,2279,2280,2292,2296,2316,2330,2334,2343,2357,2361,2372,2400,2404,2424,2444,2448,2456,2461,2489,2497,2511,2516,2520,2530,2548,2552],{"__ignoreMap":70},[74,2281,2282,2284,2286,2288,2290],{"class":76,"line":77},[74,2283,970],{"class":769},[74,2285,2029],{"class":769},[74,2287,2032],{"class":784},[74,2289,976],{"class":769},[74,2291,2037],{"class":947},[74,2293,2294],{"class":76,"line":83},[74,2295,87],{"emptyLinePlaceholder":86},[74,2297,2298,2300,2302,2305,2307,2310,2312,2314],{"class":76,"line":90},[74,2299,800],{"class":769},[74,2301,1167],{"class":769},[74,2303,2304],{"class":773}," useLogoutUser",[74,2306,777],{"class":769},[74,2308,2309],{"class":780}," defineMutation",[74,2311,2057],{"class":784},[74,2313,1254],{"class":769},[74,2315,861],{"class":784},[74,2317,2318,2320,2323,2325,2328],{"class":76,"line":96},[74,2319,1508],{"class":769},[74,2321,2322],{"class":773}," queryCache",[74,2324,777],{"class":769},[74,2326,2327],{"class":780}," useQueryCache",[74,2329,844],{"class":784},[74,2331,2332],{"class":76,"line":101},[74,2333,87],{"emptyLinePlaceholder":86},[74,2335,2336,2338,2341],{"class":76,"line":107},[74,2337,858],{"class":769},[74,2339,2340],{"class":780}," useMutation",[74,2342,1181],{"class":784},[74,2344,2345,2348,2350,2352,2354],{"class":76,"line":112},[74,2346,2347],{"class":780},"    mutation",[74,2349,2096],{"class":784},[74,2351,1254],{"class":769},[74,2353,1973],{"class":780},[74,2355,2356],{"class":784},"(),\n",[74,2358,2359],{"class":76,"line":118},[74,2360,87],{"emptyLinePlaceholder":86},[74,2362,2363,2366,2368,2370],{"class":76,"line":124},[74,2364,2365],{"class":780},"    onMutate",[74,2367,2096],{"class":784},[74,2369,1254],{"class":769},[74,2371,861],{"class":784},[74,2373,2374,2377,2380,2382,2385,2388,2390,2392,2395,2397],{"class":76,"line":130},[74,2375,2376],{"class":769},"      const",[74,2378,2379],{"class":773}," oldUser",[74,2381,777],{"class":769},[74,2383,2384],{"class":784}," queryCache.",[74,2386,2387],{"class":780},"getQueryData",[74,2389,2071],{"class":784},[74,2391,2074],{"class":780},[74,2393,2394],{"class":784},">([",[74,2396,2085],{"class":947},[74,2398,2399],{"class":784},"])\n",[74,2401,2402],{"class":76,"line":136},[74,2403,87],{"emptyLinePlaceholder":86},[74,2405,2406,2409,2412,2415,2417,2420,2422],{"class":76,"line":141},[74,2407,2408],{"class":784},"      queryCache.",[74,2410,2411],{"class":780},"setQueryData",[74,2413,2414],{"class":784},"([",[74,2416,2085],{"class":947},[74,2418,2419],{"class":784},"], ",[74,2421,788],{"class":773},[74,2423,791],{"class":784},[74,2425,2426,2428,2431,2434,2436,2439,2442],{"class":76,"line":147},[74,2427,2408],{"class":784},[74,2429,2430],{"class":780},"cancelQueries",[74,2432,2433],{"class":784},"({ key: [",[74,2435,2085],{"class":947},[74,2437,2438],{"class":784},"], exact: ",[74,2440,2441],{"class":773},"true",[74,2443,1995],{"class":784},[74,2445,2446],{"class":76,"line":153},[74,2447,87],{"emptyLinePlaceholder":86},[74,2449,2450,2453],{"class":76,"line":158},[74,2451,2452],{"class":769},"      return",[74,2454,2455],{"class":784}," { oldUser }\n",[74,2457,2458],{"class":76,"line":164},[74,2459,2460],{"class":784},"    },\n",[74,2462,2463,2466,2469,2472,2474,2477,2480,2483,2485,2487],{"class":76,"line":170},[74,2464,2465],{"class":780},"    onError",[74,2467,2468],{"class":784},": (",[74,2470,2471],{"class":1020},"_",[74,2473,351],{"class":784},[74,2475,2476],{"class":1020},"__",[74,2478,2479],{"class":784},", { ",[74,2481,2482],{"class":1020},"oldUser",[74,2484,1251],{"class":784},[74,2486,1254],{"class":769},[74,2488,861],{"class":784},[74,2490,2491,2494],{"class":76,"line":175},[74,2492,2493],{"class":769},"      if",[74,2495,2496],{"class":784}," (oldUser) {\n",[74,2498,2499,2502,2504,2506,2508],{"class":76,"line":181},[74,2500,2501],{"class":784},"        queryCache.",[74,2503,2411],{"class":780},[74,2505,2414],{"class":784},[74,2507,2085],{"class":947},[74,2509,2510],{"class":784},"], oldUser)\n",[74,2512,2513],{"class":76,"line":187},[74,2514,2515],{"class":784},"      }\n",[74,2517,2518],{"class":76,"line":193},[74,2519,2460],{"class":784},[74,2521,2522,2525,2527],{"class":76,"line":199},[74,2523,2524],{"class":780},"    onSettled",[74,2526,2096],{"class":784},[74,2528,2529],{"class":769},"=>\n",[74,2531,2532,2534,2537,2539,2541,2543,2545],{"class":76,"line":205},[74,2533,2408],{"class":784},[74,2535,2536],{"class":780},"invalidateQueries",[74,2538,2433],{"class":784},[74,2540,2085],{"class":947},[74,2542,2438],{"class":784},[74,2544,2441],{"class":773},[74,2546,2547],{"class":784}," }),\n",[74,2549,2550],{"class":76,"line":211},[74,2551,2141],{"class":784},[74,2553,2554],{"class":76,"line":217},[74,2555,1476],{"class":784},[10,2557,2558,2559,2562,2563,2566,2567,2570],{},"Cette mutation utilise une mise à jour optimiste. Lorsque l'utilisateur clique sur « Déconnexion », ",[42,2560,2561],{},"onMutate"," retire immédiatement l'utilisateur du cache. L'interface remplace donc le bouton de déconnexion par celui de connexion sans attendre le serveur. La mutation retourne l'ancien utilisateur afin que ",[42,2564,2565],{},"onError"," puisse le restaurer si la requête échoue. ",[42,2568,2569],{},"onSettled"," s'exécute dans les deux cas et invalide la query utilisateur, ce qui permettra à Pinia Colada de la rafraîchir lors de sa prochaine utilisation.",[10,2572,2573,2574,2576],{},"Mettez à jour l'en-tête pour appeler ",[42,2575,2234],{}," et afficher le bouton approprié :",[64,2578,2583],{"className":2579,"code":2580,"filename":2581,"language":2582,"meta":70,"style":70},"language-vue shiki shiki-themes github-light github-light github-dark","\u003Cscript lang=\"ts\" setup>\nconst { state } = useUser()\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cheader>\n    \u003Cdiv>\n      \u003C!-- ... -->\n      \u003Cdiv>\n        \u003C!-- ... -->\n        \u003CButton v-if=\"state.data\" label=\"Déconnexion\" \u002F>\n        \u003CButton v-else :href=\"loginUrl\" label=\"Connexion\" \u002F>\n      \u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  \u003C\u002Fheader>\n\u003C\u002Ftemplate>\n",".vitepress\u002Ftheme\u002Fcommon\u002Fcomponents\u002FTheHeader.vue","vue",[42,2584,2585,2607,2626,2635,2639,2648,2658,2668,2673,2682,2687,2719,2751,2760,2769,2778],{"__ignoreMap":70},[74,2586,2587,2589,2593,2596,2598,2601,2604],{"class":76,"line":77},[74,2588,2071],{"class":784},[74,2590,2592],{"class":2591},"sovSZ","script",[74,2594,2595],{"class":780}," lang",[74,2597,835],{"class":784},[74,2599,2600],{"class":947},"\"ts\"",[74,2602,2603],{"class":780}," setup",[74,2605,2606],{"class":784},">\n",[74,2608,2609,2611,2614,2617,2620,2622,2624],{"class":76,"line":83},[74,2610,770],{"class":769},[74,2612,2613],{"class":784}," { ",[74,2615,2616],{"class":773},"state",[74,2618,2619],{"class":784}," } ",[74,2621,835],{"class":769},[74,2623,806],{"class":780},[74,2625,844],{"class":784},[74,2627,2628,2631,2633],{"class":76,"line":90},[74,2629,2630],{"class":784},"\u003C\u002F",[74,2632,2592],{"class":2591},[74,2634,2606],{"class":784},[74,2636,2637],{"class":76,"line":96},[74,2638,87],{"emptyLinePlaceholder":86},[74,2640,2641,2643,2646],{"class":76,"line":101},[74,2642,2071],{"class":784},[74,2644,2645],{"class":2591},"template",[74,2647,2606],{"class":784},[74,2649,2650,2653,2656],{"class":76,"line":107},[74,2651,2652],{"class":784},"  \u003C",[74,2654,2655],{"class":2591},"header",[74,2657,2606],{"class":784},[74,2659,2660,2663,2666],{"class":76,"line":112},[74,2661,2662],{"class":784},"    \u003C",[74,2664,2665],{"class":2591},"div",[74,2667,2606],{"class":784},[74,2669,2670],{"class":76,"line":118},[74,2671,2672],{"class":826},"      \u003C!-- ... -->\n",[74,2674,2675,2678,2680],{"class":76,"line":124},[74,2676,2677],{"class":784},"      \u003C",[74,2679,2665],{"class":2591},[74,2681,2606],{"class":784},[74,2683,2684],{"class":76,"line":130},[74,2685,2686],{"class":826},"        \u003C!-- ... -->\n",[74,2688,2689,2692,2695,2698,2700,2703,2706,2708,2711,2713,2716],{"class":76,"line":136},[74,2690,2691],{"class":784},"        \u003C",[74,2693,2694],{"class":2591},"Button",[74,2696,2697],{"class":769}," v-if",[74,2699,835],{"class":784},[74,2701,2702],{"class":947},"\"",[74,2704,2705],{"class":784},"state.data",[74,2707,2702],{"class":947},[74,2709,2710],{"class":780}," label",[74,2712,835],{"class":784},[74,2714,2715],{"class":947},"\"Déconnexion\"",[74,2717,2718],{"class":784}," \u002F>\n",[74,2720,2721,2723,2725,2728,2730,2733,2735,2737,2740,2742,2744,2746,2749],{"class":76,"line":141},[74,2722,2691],{"class":784},[74,2724,2694],{"class":2591},[74,2726,2727],{"class":769}," v-else",[74,2729,366],{"class":784},[74,2731,2732],{"class":780},"href",[74,2734,835],{"class":784},[74,2736,2702],{"class":947},[74,2738,2739],{"class":784},"loginUrl",[74,2741,2702],{"class":947},[74,2743,2710],{"class":780},[74,2745,835],{"class":784},[74,2747,2748],{"class":947},"\"Connexion\"",[74,2750,2718],{"class":784},[74,2752,2753,2756,2758],{"class":76,"line":147},[74,2754,2755],{"class":784},"      \u003C\u002F",[74,2757,2665],{"class":2591},[74,2759,2606],{"class":784},[74,2761,2762,2765,2767],{"class":76,"line":153},[74,2763,2764],{"class":784},"    \u003C\u002F",[74,2766,2665],{"class":2591},[74,2768,2606],{"class":784},[74,2770,2771,2774,2776],{"class":76,"line":158},[74,2772,2773],{"class":784},"  \u003C\u002F",[74,2775,2655],{"class":2591},[74,2777,2606],{"class":784},[74,2779,2780,2782,2784],{"class":76,"line":164},[74,2781,2630],{"class":784},[74,2783,2645],{"class":2591},[74,2785,2606],{"class":784},[10,2787,2788],{},"Ajoutons maintenant notre mutation :",[64,2790,2793],{"className":2791,"code":2792,"filename":761,"language":2582,"meta":70,"style":70},"language-vue shiki shiki-themes github-light github-light github-dark has-diff","\u003Cscript lang=\"ts\" setup>\nconst { mutate: logout } = useLogoutUser()\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cheader>\n    \u003Cdiv>\n      \u003C!-- ... -->\n      \u003Cdiv>\n        \u003C!-- ... -->\n        \u003CButton v-if=\"state.data\" label=\"Déconnexion\" @click=\"logout\" \u002F> \u003C!-- [!code ++] -->\n      \u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  \u003C\u002Fheader>\n\u003C\u002Ftemplate>\n",[42,2794,2795,2811,2832,2840,2844,2852,2860,2868,2872,2880,2884,2924,2932,2940,2948],{"__ignoreMap":70},[74,2796,2797,2799,2801,2803,2805,2807,2809],{"class":76,"line":77},[74,2798,2071],{"class":784},[74,2800,2592],{"class":2591},[74,2802,2595],{"class":780},[74,2804,835],{"class":784},[74,2806,2600],{"class":947},[74,2808,2603],{"class":780},[74,2810,2606],{"class":784},[74,2812,2813,2815,2817,2820,2822,2824,2826,2828,2830],{"class":76,"line":83},[74,2814,770],{"class":769},[74,2816,2613],{"class":784},[74,2818,2819],{"class":1020},"mutate",[74,2821,1239],{"class":784},[74,2823,705],{"class":773},[74,2825,2619],{"class":784},[74,2827,835],{"class":769},[74,2829,2304],{"class":780},[74,2831,844],{"class":784},[74,2833,2834,2836,2838],{"class":76,"line":90},[74,2835,2630],{"class":784},[74,2837,2592],{"class":2591},[74,2839,2606],{"class":784},[74,2841,2842],{"class":76,"line":96},[74,2843,87],{"emptyLinePlaceholder":86},[74,2845,2846,2848,2850],{"class":76,"line":101},[74,2847,2071],{"class":784},[74,2849,2645],{"class":2591},[74,2851,2606],{"class":784},[74,2853,2854,2856,2858],{"class":76,"line":107},[74,2855,2652],{"class":784},[74,2857,2655],{"class":2591},[74,2859,2606],{"class":784},[74,2861,2862,2864,2866],{"class":76,"line":112},[74,2863,2662],{"class":784},[74,2865,2665],{"class":2591},[74,2867,2606],{"class":784},[74,2869,2870],{"class":76,"line":118},[74,2871,2672],{"class":826},[74,2873,2874,2876,2878],{"class":76,"line":124},[74,2875,2677],{"class":784},[74,2877,2665],{"class":2591},[74,2879,2606],{"class":784},[74,2881,2882],{"class":76,"line":130},[74,2883,2686],{"class":826},[74,2885,2887,2889,2891,2893,2895,2897,2899,2901,2903,2905,2907,2910,2913,2915,2917,2919,2921],{"class":2886,"line":136},[76,1643,1644],[74,2888,2691],{"class":784},[74,2890,2694],{"class":2591},[74,2892,2697],{"class":769},[74,2894,835],{"class":784},[74,2896,2702],{"class":947},[74,2898,2705],{"class":784},[74,2900,2702],{"class":947},[74,2902,2710],{"class":780},[74,2904,835],{"class":784},[74,2906,2715],{"class":947},[74,2908,2909],{"class":784}," @",[74,2911,2912],{"class":780},"click",[74,2914,835],{"class":784},[74,2916,2702],{"class":947},[74,2918,705],{"class":784},[74,2920,2702],{"class":947},[74,2922,2923],{"class":784}," \u002F> ",[74,2925,2926,2928,2930],{"class":76,"line":141},[74,2927,2755],{"class":784},[74,2929,2665],{"class":2591},[74,2931,2606],{"class":784},[74,2933,2934,2936,2938],{"class":76,"line":147},[74,2935,2764],{"class":784},[74,2937,2665],{"class":2591},[74,2939,2606],{"class":784},[74,2941,2942,2944,2946],{"class":76,"line":153},[74,2943,2773],{"class":784},[74,2945,2655],{"class":2591},[74,2947,2606],{"class":784},[74,2949,2950,2952,2954],{"class":76,"line":158},[74,2951,2630],{"class":784},[74,2953,2645],{"class":2591},[74,2955,2606],{"class":784},[10,2957,2958,2959,2961],{},"Essayez maintenant, mais l'action de déconnexion ne fonctionnera pas encore. Notre composant ",[42,2960,2694],{}," est actuellement uniquement un lien :",[64,2963,2966],{"className":2579,"code":2964,"filename":2965,"language":2582,"meta":70,"style":70},"\u003Ctemplate>\n  \u003Ca :href :class=\"ui\">\n    {{ props.label }}\n  \u003C\u002Fa>\n\u003C\u002Ftemplate>\n",".vitepress\u002Ftheme\u002Fcommon\u002Fcomponents\u002FButton.vue",[42,2967,2968,2976,2995,3000,3008],{"__ignoreMap":70},[74,2969,2970,2972,2974],{"class":76,"line":77},[74,2971,2071],{"class":784},[74,2973,2645],{"class":2591},[74,2975,2606],{"class":784},[74,2977,2978,2980,2982,2985,2988,2990,2993],{"class":76,"line":83},[74,2979,2652],{"class":784},[74,2981,20],{"class":2591},[74,2983,2984],{"class":780}," :href",[74,2986,2987],{"class":780}," :class",[74,2989,835],{"class":784},[74,2991,2992],{"class":947},"\"ui\"",[74,2994,2606],{"class":784},[74,2996,2997],{"class":76,"line":90},[74,2998,2999],{"class":784},"    {{ props.label }}\n",[74,3001,3002,3004,3006],{"class":76,"line":96},[74,3003,2773],{"class":784},[74,3005,20],{"class":2591},[74,3007,2606],{"class":784},[74,3009,3010,3012,3014],{"class":76,"line":101},[74,3011,2630],{"class":784},[74,3013,2645],{"class":2591},[74,3015,2606],{"class":784},[10,3017,3018,3019,3021,3022,3025,3026,3033],{},"Nous avons besoin d'un composant qui rende une ancre lorsqu'il reçoit ",[42,3020,2732],{}," et un bouton lorsqu'il reçoit ",[42,3023,3024],{},"onClick",". L'élément ",[20,3027,3030],{"href":3028,"rel":3029},"https:\u002F\u002Fvuejs.org\u002Fapi\u002Fbuilt-in-special-elements#component",[24],[42,3031,3032],{},"component"," intégré à Vue rend cela possible.",[10,3035,3036,3037,3039],{},"Commençons par autoriser ",[42,3038,3024],{}," dans les props :",[64,3041,3043],{"className":1584,"code":3042,"filename":761,"language":963,"meta":70,"style":70},"export interface ButtonProps {\n  href?: string \u002F\u002F [!code highlight]\n  label: string\n  color?: ButtonVariants['color']\n  class?: any\n  onClick?: () => void \u002F\u002F [!code ++]\n}\n",[42,3044,3045,3056,3067,3076,3095,3105,3120],{"__ignoreMap":70},[74,3046,3047,3049,3051,3054],{"class":76,"line":77},[74,3048,800],{"class":769},[74,3050,2161],{"class":769},[74,3052,3053],{"class":780}," ButtonProps",[74,3055,861],{"class":784},[74,3057,3059,3062,3065],{"class":3058,"line":83},[76,1856],[74,3060,3061],{"class":1020},"  href",[74,3063,3064],{"class":769},"?:",[74,3066,1499],{"class":773},[74,3068,3069,3072,3074],{"class":76,"line":90},[74,3070,3071],{"class":1020},"  label",[74,3073,1496],{"class":769},[74,3075,2186],{"class":773},[74,3077,3078,3081,3083,3086,3089,3092],{"class":76,"line":96},[74,3079,3080],{"class":1020},"  color",[74,3082,3064],{"class":769},[74,3084,3085],{"class":780}," ButtonVariants",[74,3087,3088],{"class":784},"[",[74,3090,3091],{"class":947},"'color'",[74,3093,3094],{"class":784},"]\n",[74,3096,3097,3100,3102],{"class":76,"line":101},[74,3098,3099],{"class":1020},"  class",[74,3101,3064],{"class":769},[74,3103,3104],{"class":773}," any\n",[74,3106,3108,3111,3113,3115,3117],{"class":3107,"line":107},[76,1643,1644],[74,3109,3110],{"class":780},"  onClick",[74,3112,3064],{"class":769},[74,3114,1949],{"class":784},[74,3116,1254],{"class":769},[74,3118,3119],{"class":773}," void",[74,3121,3122],{"class":76,"line":112},[74,3123,340],{"class":784},[10,3125,3126,3127,366],{},"Utilisons ensuite le composant spécial intégré ",[42,3128,3032],{},[64,3130,3132],{"className":2579,"code":3131,"filename":761,"language":2582,"meta":70,"style":70},"\u003Ctemplate>\n  \u003Ccomponent\n    :is=\"props.href ? 'a' : 'button'\"\n    :href=\"props.href\"\n    :class=\"ui\"\n    @click=\"props.onClick\"\n  >\n    {{ props.label }}\n  \u003C\u002Fcomponent>\n\u003C\u002Ftemplate>\n",[42,3133,3134,3142,3149,3159,3169,3179,3189,3194,3198,3206],{"__ignoreMap":70},[74,3135,3136,3138,3140],{"class":76,"line":77},[74,3137,2071],{"class":784},[74,3139,2645],{"class":2591},[74,3141,2606],{"class":784},[74,3143,3144,3146],{"class":76,"line":83},[74,3145,2652],{"class":784},[74,3147,3148],{"class":2591},"component\n",[74,3150,3151,3154,3156],{"class":76,"line":90},[74,3152,3153],{"class":780},"    :is",[74,3155,835],{"class":784},[74,3157,3158],{"class":947},"\"props.href ? 'a' : 'button'\"\n",[74,3160,3161,3164,3166],{"class":76,"line":96},[74,3162,3163],{"class":780},"    :href",[74,3165,835],{"class":784},[74,3167,3168],{"class":947},"\"props.href\"\n",[74,3170,3171,3174,3176],{"class":76,"line":101},[74,3172,3173],{"class":780},"    :class",[74,3175,835],{"class":784},[74,3177,3178],{"class":947},"\"ui\"\n",[74,3180,3181,3184,3186],{"class":76,"line":107},[74,3182,3183],{"class":780},"    @click",[74,3185,835],{"class":784},[74,3187,3188],{"class":947},"\"props.onClick\"\n",[74,3190,3191],{"class":76,"line":112},[74,3192,3193],{"class":784},"  >\n",[74,3195,3196],{"class":76,"line":118},[74,3197,2999],{"class":784},[74,3199,3200,3202,3204],{"class":76,"line":124},[74,3201,2773],{"class":784},[74,3203,3032],{"class":2591},[74,3205,2606],{"class":784},[74,3207,3208,3210,3212],{"class":76,"line":130},[74,3209,2630],{"class":784},[74,3211,2645],{"class":2591},[74,3213,2606],{"class":784},[10,3215,3216,3217,3220],{},"La ligne importante est ",[42,3218,3219],{},":is=\"props.href ? 'a' : 'button'\""," : elle choisit une ancre ou un bouton en fonction des props.",[10,3222,3223],{},"Le flux complet fonctionne maintenant :",[36,3225,3226,3229,3232],{},[39,3227,3228],{},"Les utilisateurs peuvent se connecter avec GitHub.",[39,3230,3231],{},"Les utilisateurs peuvent se déconnecter facilement depuis le front-end.",[39,3233,3234],{},"Les utilisateurs peuvent se reconnecter.",[28,3236,3238],{"id":3237},"conclusion","Conclusion",[10,3240,3241],{},"L'authentification est maintenant une fonctionnalité front-end réutilisable. L'application peut récupérer l'utilisateur courant, partager le résultat en cache entre les composants et mettre à jour l'interface de manière optimiste lors de la déconnexion.",[10,3243,3244],{},"Le système de commentaires dispose ainsi de toutes les informations nécessaires pour savoir si quelqu'un est connecté et quels contrôles afficher. Dans le dernier article, nous utiliserons la même structure Pinia Colada organisée par fonctionnalité pour lister, créer, modifier et supprimer des commentaires.",[3246,3247,3248],"style",{},"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 .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}",{"title":70,"searchDepth":83,"depth":83,"links":3250},[3251,3255,3256,3257,3258,3259],{"id":30,"depth":83,"text":31,"children":3252},[3253,3254],{"id":58,"depth":90,"text":59},{"id":430,"depth":90,"text":431},{"id":743,"depth":83,"text":744},{"id":1129,"depth":83,"text":1130},{"id":1573,"depth":83,"text":1574},{"id":1891,"depth":83,"text":1892},{"id":3237,"depth":83,"text":3238},"e03c822f-0431-4ece-9293-765cacc2d44e","2025-02-25","Reliez l'authentification front-end à Laravel avec une requête utilisateur, une déconnexion GitHub, le cache Pinia Colada et des mises à jour optimistes.","md",null,{},"\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fstreamlining-user-authentication-from-frontend-to-backend","---\ncontentId: e03c822f-0431-4ece-9293-765cacc2d44e\npart: 7\ntitle: Authentifier les utilisateurs du front-end au back-end\ndescription: Reliez l'authentification front-end à Laravel avec une requête utilisateur, une déconnexion GitHub, le cache Pinia Colada et des mises à jour optimistes.\ndate: 2025-02-25\nseriesSlug: empower-and-dynamize-our-vitepress-blog-with-a-laravel-api\n---\n\nMaintenant que le front-end peut joindre l'API Laravel, nous pouvons utiliser cette connexion pour gérer l'authentification dans toute l'application.\n\nJusqu'ici, nous avons testé des requêtes isolées. Dans cet article, nous récupérerons l'utilisateur courant au démarrage de l'application, afficherons l'action de connexion ou de déconnexion appropriée et implémenterons la déconnexion avec une mise à jour optimiste. L'interface se mettra à jour immédiatement pendant l'exécution de la requête, puis reviendra à son état précédent si la requête échoue.\n\nPour gérer cela proprement, nous combinerons Pinia avec Pinia Colada, une bibliothèque de récupération de données construite au-dessus de Pinia et créée par [Eduardo](https:\u002F\u002Fgithub.com\u002Fposva), le créateur de Pinia. Elle nous fournira un état partagé mis en cache, l'état des requêtes et les hooks nécessaires aux mises à jour optimistes.\n\n## Configurer l'API\n\nPour prendre en charge le front-end, nous avons besoin de deux nouvelles routes dans l'application Laravel :\n\n1. `GET \u002Fapi\u002Fuser` : Retourne l'utilisateur authentifié. Le front-end l'appelle au démarrage de l'application pour adapter l'interface.\n2. `POST \u002Flogout` : Déconnecte l'utilisateur et invalide la session courante lorsque le bouton de déconnexion du front-end est utilisé.\n\nPour chaque route, nous écrirons des tests, créerons une méthode de contrôleur et enregistrerons la route. C'est le même processus que dans les articles précédents.\n\n### Retourner l'utilisateur\n\nCommençons par la première route. Créons un test pour vérifier que l'utilisateur est authentifié et que ses données sont correctement retournées.\n\n```php [tests\u002FHttp\u002FAuth\u002FAuthenticationSessionTest.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nuse Illuminate\\Testing\\Fluent\\AssertableJson;\n\nit('requires authentification', function () {\n    $this->getJson(route('user.show'))\n        ->assertUnauthorized();\n});\n\nit('returns the authenticated user', function () {\n    $user = App\\Models\\User::factory()->create();\n\n    $response = $this->actingAs($user)\n        ->getJson(route('user.show'));\n\n    $response\n        ->assertOk()\n        ->assertJson(\n            fn (AssertableJson $json) => $json\n                ->has(\n                    'data',\n                    fn (AssertableJson $json) => $json\n                        ->where('name', $user->name)\n                        ->where('username', $user->username)\n                        ->where('avatar', $user->avatar)\n                )\n        );\n});\n```\n\nCes tests ressemblent à ceux des commentaires. Le premier vérifie l'authentification et le second contrôle les données de l'utilisateur dans la réponse JSON.\n\nCréons maintenant le contrôleur :\n\n```php [app\u002FHttp\u002FControllers\u002FAuth\u002FAuthenticatedSessionController.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Http\\Controllers\\Api;\n\nuse App\\Http\\Resources\\UserResource;\nuse Illuminate\\Http\\Request;\nuse Illuminate\\Http\\Resources\\Json\\JsonResource;\n\nfinal class UserController\n{\n    public function show(Request $request): JsonResource\n    {\n        return UserResource::make($request->user());\n    }\n}\n```\n\nCe contrôleur utilise `UserResource` pour transformer l'utilisateur authentifié en réponse JSON. Nous avons créé cette ressource dans l'article consacré au système de commentaires ; elle expose les champs `name`, `username` et `avatar`.\n\nEnregistrons enfin la route dans `routes\u002Fapi.php` :\n\n```php [routes\u002Fapi.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nuse App\\Http\\Controllers\\Api\\UserController;\n\nRoute::middleware('auth:sanctum')->group(function () {\n    Route::get('\u002Fuser', [UserController::class, 'show'])\n        ->name('user.show');\n\n    \u002F\u002F ...\n});\n```\n\nCela suffit pour récupérer l'utilisateur courant.\n\n### Déconnecter l'utilisateur\n\nCommençons par les tests :\n\n```php [tests\u002FHttp\u002FAuth\u002FAuthenticationSessionTest.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nuse App\\Models\\User;\n\nit('requires authentification', function () {\n    $this->postJson(route('logout'))\n        ->assertUnauthorized();\n});\n\nit('destroys the session', function () {\n    $response = $this->actingAs(User::factory()->create())\n        ->post(route('logout'))\n        ->assertNoContent();\n\n    $this->assertGuest('web');\n    $response->assertNoContent();\n});\n```\n\nCes tests suivent les mêmes patterns que les précédents.\n\nCréons maintenant le contrôleur :\n\n```php [app\u002FHttp\u002FControllers\u002FAuth\u002FAuthenticationSessionController.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Http\\Controllers\\Auth;\n\nuse Illuminate\\Http\\Request;\nuse Illuminate\\Http\\Response;\nuse Illuminate\\Support\\Facades\\Auth;\n\nfinal class AuthenticatedSessionController\n{\n    public function destroy(Request $request): Response\n    {\n        Auth::guard('web')->logout();\n\n        $request->session()->invalidate();\n\n        $request->session()->regenerateToken();\n\n        return response()->noContent();\n    }\n}\n```\n\nLe contrôleur utilise la façade `Auth` de Laravel pour déconnecter l'utilisateur. Il invalide ensuite la session et régénère le jeton CSRF. Ces étapes contribuent à prévenir les attaques par fixation de session.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nLe contrôleur retourne une réponse vide, car le front-end n'a pas besoin d'un corps de réponse pour la déconnexion.\n::\n\nEnregistrons enfin la route dans `routes\u002Fweb.php` :\n\n```php [routes\u002Fweb.php]\nuse App\\Http\\Controllers\\Auth\\AuthenticatedSessionController;\n\nRoute::post('logout', [AuthenticatedSessionController::class, 'destroy'])\n    ->middleware('auth:sanctum')\n    ->name('logout');\n```\n\nCette route utilise le middleware `auth:sanctum` même si elle est définie dans `web.php`. Elle ne retourne pas de JSON et n'a pas besoin d'être versionnée avec les autres routes d'API ; la conserver comme route web est donc raisonnable.\n\nDans le fichier de configuration `config\u002Fcors.php`, nous devons également ajouter la route `logout` au tableau `paths` :\n\n```php [config\u002Fcors.php]\nreturn [\n    'paths' => ['api\u002F*', 'logout'],\n\n    \u002F\u002F ...\n];\n```\n\nCela permet au front-end d'appeler la route depuis une autre origine. Sans cette configuration, le navigateur bloquerait la requête à cause de CORS.\n\n## Préparer le front-end\n\nLe back-end est prêt, passons au front-end.\n\nNous récupérerons l'utilisateur au démarrage de l'application afin que l'interface puisse réagir à l'état d'authentification. Plusieurs composants ont besoin de cette information. L'en-tête affiche actuellement un bouton de connexion ; nous ajouterons un bouton de déconnexion pour les utilisateurs authentifiés et masquerons le bouton de connexion dans ce cas.\n\nLe pied de page pourrait également avoir besoin d'un lien de connexion ou de déconnexion, et le système de commentaires utilisera le même état pour décider s'il doit afficher un bouton de connexion ou un formulaire de commentaire.\n\nLa solution la plus simple serait un composable partagé :\n\n```js [Exemple]\nconst user = ref(null)\n\nexport function useUser() {\n  async function fetch() {\n    \u002F\u002F Simulate fetching user data from the backend\n    user.value = await fetchUserData()\n  }\n\n  return {\n    user,\n    fetch,\n  }\n}\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nNous pourrions aussi utiliser [`createSharedComposable`](https:\u002F\u002Fvueuse.org\u002Fshared\u002FcreateSharedComposable\u002F#createsharedcomposable) de VueUse pour éviter un état global tout en conservant la même instance du composable dans tous les composants.\n::\n\nNous appellerions ensuite `fetch` dans le hook `onMounted` du composant principal, `Layout.vue` dans notre cas.\n\nCette solution fonctionne un temps, mais devient rapidement difficile à maintenir. Un composant effectue la récupération tandis que beaucoup d'autres consomment le résultat. Cela reste gérable pour un seul type de données, mais devient désordonné à mesure que l'application grandit.\n\nNous aurions également besoin de code répétitif pour gérer l'état des mutations. Se déconnecter, créer un commentaire et supprimer un commentaire nécessitent tous un état de chargement et d'erreur. Répéter ce code rendrait les composants verbeux ou nous pousserait à créer un ensemble d'utilitaires personnalisés.\n\nNous pourrions aussi vouloir des mises à jour optimistes. La déconnexion en est un bon exemple : retirer immédiatement l'utilisateur de l'état, appeler l'API, puis restaurer l'utilisateur si la requête échoue. Implémenter cela de manière fiable et générique n'est pas trivial.\n\nPour éviter ce code répétitif, nous allons combiner Pinia et Pinia Colada.\n\n- Pinia est la bibliothèque de gestion d'état de Vue. Un store centralise l'état, les getters et les actions, tandis que l'interface réagit aux changements de cet état.\n- Pinia Colada est une bibliothèque de récupération de données construite au-dessus de Pinia. Elle gère les requêtes et l'état du cache, et fournit les hooks nécessaires aux mises à jour optimistes.\n\nInstallez Pinia et Pinia Colada dans le projet Garabit :\n\n```bash [terminal]\npnpm install pinia @pinia\u002Fcolada\n```\n\nEnregistrons-les ensuite dans notre application Vue :\n\n```ts [.vitepress\u002Ftheme\u002Findex.ts]\nimport { PiniaColada } from '@pinia\u002Fcolada'\nimport { createPinia } from 'pinia'\n\nexport default {\n  Layout,\n  enhanceApp({ app }) {\n    app.use(createPinia())\n    app.use(PiniaColada)\n  },\n} satisfies Theme\n```\n\nLes deux packages sont des plugins Vue qui ajoutent des fonctionnalités au niveau de l'application.\n\nSupprimez le code de requête temporaire de `.vitepress\u002Ftheme\u002FLayout.vue` ; il sera remplacé par le client API partagé.\n\nAvant d'écrire le code de la fonctionnalité, définissons sa structure. Dans `common\u002Futils\u002Fapi.ts`, nous allons créer une instance personnalisée de `ofetch` afin que chaque requête utilise le même hôte, les mêmes en-têtes, les mêmes identifiants et la même gestion CSRF. C'est le code introduit dans l'article précédent.\n\nChaque fonctionnalité contiendra deux dossiers et un fichier API :\n\n1. `queries` : Contient les requêtes qui récupèrent des données. `GET \u002Fapi\u002Fuser` est une query.\n2. `mutations` : Contient les requêtes qui modifient des données. `POST \u002Flogout` est une mutation.\n3. `api.ts` : Contient les fonctions bas niveau qui effectuent les requêtes. Ce fichier reste indépendant de la bibliothèque de gestion d'état, ce qui rend la couche API facile à lire et à tester.\n\nCes dossiers et ce fichier API existeront pour chaque fonctionnalité. Aujourd'hui, nous allons créer la fonctionnalité `user`. L'article suivant ajoutera une fonctionnalité `comments`. Cette séparation rassemble le code lié et facilite sa recherche.\n\n## Étendre ofetch\n\nCréons l'instance personnalisée de `ofetch` dans `.vitepress\u002Ftheme\u002Fcommon\u002Futils\u002Fapi.ts` :\n\n```ts [.vitepress\u002Ftheme\u002Fcommon\u002Futils\u002Fapi.ts]\nimport { ofetch } from 'ofetch'\n\nexport const api = ofetch.create({\n  baseURL: import.meta.env.VITE_API_URL,\n  headers: {\n    Accept: 'application\u002Fjson',\n  },\n  credentials: 'include',\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(\n      'X-Xsrf-Token',\n      decodeURIComponent(getCookie('XSRF-TOKEN') || ''),\n    )\n  },\n})\n\nfunction getCookie(name: string) {\n  const match = document.cookie.match(new RegExp(`(^| )${name}=([^;]+)`))\n  return match ? match[2] : null\n}\n```\n\n## Tout importer automatiquement\n\nComme pour la configuration de la série, mettez à jour `.vitepress\u002Fconfig.mts` pour importer automatiquement les nouveaux utilitaires, queries, mutations et composables Pinia Colada.\n\n```ts [.vitepress\u002Fconfig.mts]\nconst currentDir = dirname(fileURLToPath(import.meta.url))\nconst themeDir = resolve(currentDir, 'theme')\n\nconst utilsDir = resolve(themeDir, '**', 'utils') \u002F\u002F [!code ++]\nconst queriesDir = resolve(themeDir, '**', 'queries') \u002F\u002F [!code ++]\nconst mutationsDir = resolve(themeDir, '**', 'mutations') \u002F\u002F [!code ++]\nconst apiFile = resolve(themeDir, '**', 'api.ts') \u002F\u002F [!code ++]\n\nexport default defineConfig({\n  vite: {\n    plugins: [\n      AutoImport({\n        imports: [\n          { \u002F\u002F [!code ++]\n            from: '@pinia\u002Fcolada', \u002F\u002F [!code ++]\n            imports: [ \u002F\u002F [!code ++]\n              'defineQuery', \u002F\u002F [!code ++]\n              'useQuery', \u002F\u002F [!code ++]\n              'defineMutation', \u002F\u002F [!code ++]\n              'useMutation', \u002F\u002F [!code ++]\n              'useQueryCache', \u002F\u002F [!code ++]\n            ], \u002F\u002F [!code ++]\n          }, \u002F\u002F [!code ++]\n        ],\n        dirs: [composablesDir, utilsDir, queriesDir, mutationsDir, apiFile], \u002F\u002F [!code highlight]\n      }),\n    ],\n  },\n})\n```\n\nToutes les fonctions exportées depuis les dossiers `utils`, `queries` et `mutations` sont maintenant disponibles dans toute l'application.\n\n## Créer la fonctionnalité utilisateur\n\nSuivons maintenant notre plan.\n\nCréons la fonctionnalité `user` :\n\n```bash [terminal]\nmkdir -p .vitepress\u002Ftheme\u002Fuser\u002F{queries,mutations}\ntouch .vitepress\u002Ftheme\u002Fuser\u002Fapi.ts\n```\n\nÉcrivons ensuite le code qui récupère les données utilisateur et déconnecte l'utilisateur dans `.vitepress\u002Ftheme\u002Fuser\u002Fapi.ts` :\n\n```ts [.vitepress\u002Ftheme\u002Fuser\u002Fapi.ts]\nexport const fetchUser = () => api('api\u002Fuser')\n\nexport const postLogoutUser = () => api('logout', { method: 'POST' })\n```\n\nCes fonctions abstraient les appels API bruts. Le reste de la fonctionnalité peut utiliser les noms explicites `fetchUser` et `postLogoutUser` sans connaître les détails de la requête.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nComment nommer les fonctions API ? J'utilise le préfixe `fetch` pour les queries, suivi du nom de la ressource. Pour les mutations, j'utilise le verbe HTTP suivi du nom de la ressource. Les fonctions sont ainsi faciles à reconnaître et à retenir.\n::\n\nCréons maintenant la query qui récupère les données utilisateur :\n\n```ts [.vitepress\u002Ftheme\u002Fuser\u002Fqueries\u002Fusers.ts]\nimport type { User } from '@\u002Fuser\u002Ftypes\u002Fuser'\n\nexport const useUser = defineQuery(() => {\n  return useQuery\u003CUser>({\n    key: ['user'],\n    query: () => fetchUser().then(response => response.data),\n    enabled: typeof document !== 'undefined',\n  })\n})\n```\n\nNous devons également définir un nouveau type pour l'utilisateur :\n\n```ts [.vitepress\u002Ftheme\u002Fuser\u002Ftypes\u002Fuser.ts]\nexport interface User {\n  id: number\n  name: string\n  username: string\n  avatar: string\n}\n```\n\nVoici le fonctionnement de la query :\n\n- `defineQuery` définit une query réutilisable dans le contexte Vue.\n- `useQuery` décrit la clé, la fonction de requête et l'état retourné aux composants.\n- `key` identifie la query dans le cache de Pinia Colada. Lorsque `useUser` est appelée à nouveau, Pinia Colada peut réutiliser un résultat récent en cache au lieu d'envoyer une autre requête.\n- `query` retourne la promesse de la requête API. Nous retournons la propriété `data` de la réponse, car les ressources Laravel encapsulent leur contenu dans `data`.\n- `enabled` limite la requête au navigateur. Nous ne voulons pas appeler l'API lorsque VitePress génère le site.\n\nNous pouvons maintenant appeler `useUser` n'importe où dans l'application. Les composants n'ont pas besoin d'attendre la requête ; ils consomment son état réactif et laissent Vue mettre à jour l'interface lorsque les données arrivent.\n\nPinia Colada déduplique également les requêtes, recharge les données obsolètes si nécessaire, expose le cache et fournit des hooks pour les mises à jour optimistes.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nLa déduplication est importante, car plusieurs composants peuvent appeler `useUser` sur la même page. Pinia Colada effectue une seule requête API et partage le résultat entre ces appels.\n::\n\nÉcrivons maintenant la mutation qui déconnecte l'utilisateur :\n\n```ts [.vitepress\u002Ftheme\u002Fuser\u002Fmutations\u002Fusers.ts]\nimport type { User } from '@\u002Fuser\u002Ftypes\u002Fuser'\n\nexport const useLogoutUser = defineMutation(() => {\n  const queryCache = useQueryCache()\n\n  return useMutation({\n    mutation: () => postLogoutUser(),\n\n    onMutate: () => {\n      const oldUser = queryCache.getQueryData\u003CUser>(['user'])\n\n      queryCache.setQueryData(['user'], null)\n      queryCache.cancelQueries({ key: ['user'], exact: true })\n\n      return { oldUser }\n    },\n    onError: (_, __, { oldUser }) => {\n      if (oldUser) {\n        queryCache.setQueryData(['user'], oldUser)\n      }\n    },\n    onSettled: () =>\n      queryCache.invalidateQueries({ key: ['user'], exact: true }),\n  })\n})\n```\n\nCette mutation utilise une mise à jour optimiste. Lorsque l'utilisateur clique sur « Déconnexion », `onMutate` retire immédiatement l'utilisateur du cache. L'interface remplace donc le bouton de déconnexion par celui de connexion sans attendre le serveur. La mutation retourne l'ancien utilisateur afin que `onError` puisse le restaurer si la requête échoue. `onSettled` s'exécute dans les deux cas et invalide la query utilisateur, ce qui permettra à Pinia Colada de la rafraîchir lors de sa prochaine utilisation.\n\nMettez à jour l'en-tête pour appeler `useUser` et afficher le bouton approprié :\n\n```vue [.vitepress\u002Ftheme\u002Fcommon\u002Fcomponents\u002FTheHeader.vue]\n\u003Cscript lang=\"ts\" setup>\nconst { state } = useUser()\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cheader>\n    \u003Cdiv>\n      \u003C!-- ... -->\n      \u003Cdiv>\n        \u003C!-- ... -->\n        \u003CButton v-if=\"state.data\" label=\"Déconnexion\" \u002F>\n        \u003CButton v-else :href=\"loginUrl\" label=\"Connexion\" \u002F>\n      \u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  \u003C\u002Fheader>\n\u003C\u002Ftemplate>\n```\n\nAjoutons maintenant notre mutation :\n\n```vue [Exemple]\n\u003Cscript lang=\"ts\" setup>\nconst { mutate: logout } = useLogoutUser()\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cheader>\n    \u003Cdiv>\n      \u003C!-- ... -->\n      \u003Cdiv>\n        \u003C!-- ... -->\n        \u003CButton v-if=\"state.data\" label=\"Déconnexion\" @click=\"logout\" \u002F> \u003C!-- [!code ++] -->\n      \u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  \u003C\u002Fheader>\n\u003C\u002Ftemplate>\n```\n\nEssayez maintenant, mais l'action de déconnexion ne fonctionnera pas encore. Notre composant `Button` est actuellement uniquement un lien :\n\n```vue [.vitepress\u002Ftheme\u002Fcommon\u002Fcomponents\u002FButton.vue]\n\u003Ctemplate>\n  \u003Ca :href :class=\"ui\">\n    {{ props.label }}\n  \u003C\u002Fa>\n\u003C\u002Ftemplate>\n```\n\nNous avons besoin d'un composant qui rende une ancre lorsqu'il reçoit `href` et un bouton lorsqu'il reçoit `onClick`. L'élément [`component`](https:\u002F\u002Fvuejs.org\u002Fapi\u002Fbuilt-in-special-elements#component) intégré à Vue rend cela possible.\n\nCommençons par autoriser `onClick` dans les props :\n\n```ts [Exemple]\nexport interface ButtonProps {\n  href?: string \u002F\u002F [!code highlight]\n  label: string\n  color?: ButtonVariants['color']\n  class?: any\n  onClick?: () => void \u002F\u002F [!code ++]\n}\n```\n\nUtilisons ensuite le composant spécial intégré `component` :\n\n```vue [Exemple]\n\u003Ctemplate>\n  \u003Ccomponent\n    :is=\"props.href ? 'a' : 'button'\"\n    :href=\"props.href\"\n    :class=\"ui\"\n    @click=\"props.onClick\"\n  >\n    {{ props.label }}\n  \u003C\u002Fcomponent>\n\u003C\u002Ftemplate>\n```\n\nLa ligne importante est `:is=\"props.href ? 'a' : 'button'\"` : elle choisit une ancre ou un bouton en fonction des props.\n\nLe flux complet fonctionne maintenant :\n\n1. Les utilisateurs peuvent se connecter avec GitHub.\n2. Les utilisateurs peuvent se déconnecter facilement depuis le front-end.\n3. Les utilisateurs peuvent se reconnecter.\n\n## Conclusion\n\nL'authentification est maintenant une fonctionnalité front-end réutilisable. L'application peut récupérer l'utilisateur courant, partager le résultat en cache entre les composants et mettre à jour l'interface de manière optimiste lors de la déconnexion.\n\nLe système de commentaires dispose ainsi de toutes les informations nécessaires pour savoir si quelqu'un est connecté et quels contrôles afficher. Dans le dernier article, nous utiliserons la même structure Pinia Colada organisée par fonctionnalité pour lister, créer, modifier et supprimer des commentaires.\n",{"title":5,"description":3262},"empower-and-dynamize-our-vitepress-blog-with-a-laravel-api",{"loc":3266},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fstreamlining-user-authentication-from-frontend-to-backend","OYU5jG40_pSE68Y14V-ZgfneXCdKOVUsrrpLLPHU-7o",{"overview":3274,"chapters":3447},{"id":3275,"title":3276,"body":3277,"contentId":3431,"date":3432,"description":3433,"extension":3263,"github":3264,"meetTheInstructor":3434,"meta":3435,"navigation":86,"part":3264,"path":3436,"rawbody":3437,"robots":3264,"schemaOrg":3264,"seo":3438,"seriesSlug":3269,"sitemap":3439,"stem":3440,"subtitle":3441,"topics":3442,"__hash__":3446},"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":3278,"toc":3428},[3279,3282,3285,3288,3292,3301,3304,3313,3316,3319,3400,3403,3406,3409,3418,3422],[10,3280,3281],{},"Bonjour ! 👋",[10,3283,3284],{},"Après avoir créé notre blog VitePress, nous sommes prêts à le rendre plus dynamique grâce à une API Laravel.",[10,3286,3287],{},"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.",[3289,3290],"callout-read-more",{"id":3291},"43c95b33-041c-4108-ab98-0d21ef60ed7f",[10,3293,3294,3295,3300],{},"Cette série s'intéresse au développement back-end. Nous allons créer une API ",[20,3296,3299],{"href":3297,"rel":3298},"https:\u002F\u002Flaravel.com",[24],"Laravel"," pour ajouter quelques fonctionnalités interactives à notre blog.",[10,3302,3303],{},"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,3305,3306,3307,3312],{},"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 ",[20,3308,3311],{"href":3309,"rel":3310},"https:\u002F\u002Fpinia-colada.esm.dev\u002F",[24],"Pinia Colada"," 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,3314,3315],{},"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,3317,3318],{},"Tout au long de la série, nous construirons une API Laravel et l'intégrerons à notre blog VitePress. Nous aborderons les sujets suivants :",[921,3320,3321,3328,3355,3366,3372,3382,3388,3394],{},[39,3322,3323,3327],{},[3324,3325,3326],"strong",{},"Configurer le projet Laravel"," : Créer un nouveau projet Laravel et se familiariser avec sa structure.",[39,3329,3330,3333,3334,351,3339,351,3344,355,3349,3354],{},[3324,3331,3332],{},"Améliorer le workflow de développement"," : Configurer ",[20,3335,3338],{"href":3336,"rel":3337},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fpint",[24],"Pint",[20,3340,3343],{"href":3341,"rel":3342},"https:\u002F\u002Fgithub.com\u002Frectorphp\u002Frector",[24],"Rector",[20,3345,3348],{"href":3346,"rel":3347},"https:\u002F\u002Fgithub.com\u002Flarastan\u002Flarastan",[24],"Larastan",[20,3350,3353],{"href":3351,"rel":3352},"https:\u002F\u002Fpestphp.com\u002F",[24],"Pest"," pour le formatage, la refactorisation, l'analyse statique et les tests.",[39,3356,3357,3360,3361,359],{},[3324,3358,3359],{},"Ajouter l'authentification sociale"," : Permettre aux utilisateurs de se connecter avec GitHub grâce à ",[20,3362,3365],{"href":3363,"rel":3364},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fsocialite",[24],"Laravel Socialite",[39,3367,3368,3371],{},[3324,3369,3370],{},"Connecter les applications"," : Configurer Sanctum, CORS, la protection CSRF et les premières requêtes entre le front-end VitePress et l'API Laravel.",[39,3373,3374,3377,3378,3381],{},[3324,3375,3376],{},"Gérer l'état d'authentification"," : Utiliser ",[20,3379,3311],{"href":3309,"rel":3380},[24]," pour récupérer l'utilisateur courant et le déconnecter avec une mise à jour optimiste.",[39,3383,3384,3387],{},[3324,3385,3386],{},"Construire l'API de commentaires"," : Créer les modèles, les relations, les endpoints, la validation, l'autorisation et les tests des commentaires.",[39,3389,3390,3393],{},[3324,3391,3392],{},"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.",[39,3395,3396,3399],{},[3324,3397,3398],{},"Construire l'interface de commentaires"," : Récupérer, créer, modifier et supprimer des commentaires depuis le front-end VitePress.",[10,3401,3402],{},"À 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,3404,3405],{},"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,3407,3408],{},"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.",[644,3410,3411],{"color":646,"icon":647},[10,3412,3413,3414,359],{},"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 ",[20,3415,3417],{"href":3416},"\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",[28,3419,3421],{"id":3420},"chapitres","Chapitres",[3423,3424],"series-chapters-list",{"className":3425},[3426,3427],"mx-auto","max-w-5xl",{"title":70,"searchDepth":83,"depth":83,"links":3429},[3430],{"id":3420,"depth":83,"text":3421},"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":3276,"description":3433},{"loc":3436},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api","Transformez votre blog VitePress en une plateforme dynamique avec une API",[3443,3444,3445],"laravel","vitepress","api","AjkLB8gOXMZAgudegF8LmVWjly_nRao_7y_u2LUCUrQ",[3448,3453,3458,3463,3468,3473,3478,3479],{"contentId":3449,"title":3450,"description":3451,"path":3452,"part":77,"github":3264,"topics":3264},"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":3454,"title":3455,"description":3456,"path":3457,"part":83,"github":3264,"topics":3264},"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":3459,"title":3460,"description":3461,"path":3462,"part":90,"github":3264,"topics":3264},"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":3464,"title":3465,"description":3466,"path":3467,"part":96,"github":3264,"topics":3264},"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":3469,"title":3470,"description":3471,"path":3472,"part":101,"github":3264,"topics":3264},"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":3474,"title":3475,"description":3476,"path":3477,"part":107,"github":3264,"topics":3264},"dfedb4f0-badf-4a05-8b62-977c61fd6d11","Connecter le front-end, VitePress et le back-end, Laravel","Connectez un front-end VitePress à une API Laravel avec Sanctum, CORS, la protection CSRF et un client API réutilisable.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fbridging-the-gap-connecting-your-frontend-and-backend",{"contentId":3260,"title":5,"description":3262,"path":3266,"part":112,"github":3264,"topics":3264},{"contentId":3480,"title":3481,"description":3482,"path":3483,"part":118,"github":3264,"topics":3264},"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",1795016704740]