[{"data":1,"prerenderedAt":3575},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Feffortless-social-authentication-with-laravel-socialite":3,"series-context-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api":3364},{"id":4,"title":5,"body":6,"contentId":3349,"date":3350,"description":3351,"extension":3352,"github":3353,"meetTheInstructor":3353,"meta":3354,"navigation":547,"part":167,"path":3355,"rawbody":3356,"robots":3353,"schemaOrg":3353,"seo":3357,"seriesSlug":3358,"sitemap":3359,"stem":3362,"subtitle":3353,"topics":3353,"__hash__":3363},"series\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Feffortless-social-authentication-with-laravel-socialite.md","Authentification sociale simplifiée avec Laravel Socialite",{"type":7,"value":8,"toc":3339},"minimark",[9,13,30,33,36,39,44,47,50,53,56,84,92,101,106,110,113,140,147,201,212,234,237,240,260,286,291,294,324,335,346,357,367,372,391,397,416,422,425,429,432,437,442,448,466,469,483,486,504,525,532,605,617,627,630,646,649,721,731,785,792,811,826,829,938,941,1007,1009,1061,1072,1083,1087,1090,1100,1112,1122,1125,1343,1354,1361,1364,1374,1389,1397,1479,1495,1512,1520,1642,1650,1661,1666,1673,1676,1705,1715,1752,1757,1766,1777,1929,1932,1953,1958,1963,1970,1979,1989,2003,2165,2176,2196,2203,2213,2288,2296,2299,2302,2305,2308,2405,2411,2414,2542,2552,2799,2806,2812,2821,2835,2942,2945,2948,2997,3004,3007,3062,3065,3069,3072,3077,3080,3203,3210,3282,3289,3308,3311,3314,3319,3323,3329,3332,3335],[10,11,12],"p",{},"Avec la structure du projet et les outils qualité en place, nous pouvons commencer à construire la première fonctionnalité de l'API destinée aux utilisateurs : l'authentification. Comme les commentaires doivent appartenir à de vrais utilisateurs, c'est la suite logique.",[10,14,15,16,23,24,29],{},"Le problème, c'est que l'authentification est difficile, vraiment difficile. Il faut gérer les mots de passe, la vérification des adresses e-mail, la réinitialisation des mots de passe, l'authentification à deux facteurs, et bien plus encore. Heureusement, les frameworks comme Laravel proposent des fonctionnalités d'",[17,18,22],"a",{"href":19,"rel":20},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Fauthentication",[21],"nofollow","authentification intégrées"," et des packages officiels comme ",[17,25,28],{"href":26,"rel":27},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Ffortify",[21],"Fortify"," pour simplifier le processus.",[10,31,32],{},"Même avec ces outils, nous devons encore construire et gérer de nombreuses parties nous-mêmes : l'inscription, la connexion, la réinitialisation des mots de passe, la gestion du profil et les cas particuliers associés. Nous avons également besoin d'un service mail pour envoyer les e-mails.",[10,34,35],{},"Tout cela est possible, mais demande du temps et des efforts. Pour un blog simple comme le nôtre, nous pouvons plutôt utiliser GitHub pour l'authentification sociale. L'implémentation est plus simple et les utilisateurs peuvent se connecter avec un compte qu'ils possèdent déjà.",[10,37,38],{},"Avant de plonger dans l'implémentation, prenons un moment pour comprendre ce qu'est l'authentification sociale et pourquoi elle est utile.",[40,41,43],"h2",{"id":42},"lauthentification-sociale-en-quelques-mots","L'authentification sociale en quelques mots",[10,45,46],{},"Traditionnellement, lorsqu'un utilisateur veut créer un compte sur un site, il doit remplir un formulaire d'inscription avec son adresse e-mail et un mot de passe. Ce fonctionnement est efficace depuis des années, mais il a ses inconvénients. De notre côté, nous devons gérer toutes ces données, tandis que l'utilisateur doit retenir un mot de passe supplémentaire.",[10,48,49],{},"Avec l'authentification sociale, les utilisateurs peuvent se connecter avec leurs comptes existants sur des plateformes comme GitHub, Google, Apple ou Facebook. Ils n'ont donc pas besoin de créer un nouveau compte ni de retenir un autre mot de passe. Ils utilisent leurs identifiants existants pour se connecter rapidement et facilement, ce qui réduit les frictions et améliore l'expérience.",[10,51,52],{},"Pour les plus techniques d'entre vous, voici un schéma de fonctionnement :",[10,54,55],{},"Le flux est simple :",[57,58,59,63,66,69,72,75,78,81],"ol",{},[60,61,62],"li",{},"L'utilisateur clique sur le bouton « Se connecter avec GitHub » de votre site.",[60,64,65],{},"L'utilisateur est redirigé vers la page d'autorisation de GitHub, où il peut autoriser votre application à accéder à son compte GitHub.",[60,67,68],{},"Si l'utilisateur accorde cette autorisation, GitHub le redirige vers votre site avec un code d'autorisation.",[60,70,71],{},"Votre site échange ce code contre un jeton d'accès, qui peut être utilisé pour accéder au compte GitHub de l'utilisateur.",[60,73,74],{},"Votre site peut maintenant utiliser le jeton d'accès pour récupérer les informations du profil de l'utilisateur auprès de GitHub.",[60,76,77],{},"Votre site crée un nouveau compte utilisateur ou met à jour un compte existant, puis connecte l'utilisateur à partir des informations reçues de GitHub.",[60,79,80],{},"Votre site redirige l'utilisateur vers la page appropriée après la connexion.",[60,82,83],{},"L'utilisateur est connecté et peut interagir avec votre site.",[85,86,89],"callout",{"color":87,"icon":88},"info","i-ph-info-duotone",[10,90,91],{},"Notez que l'utilisateur est connecté à notre application, et non à GitHub. C'est essentiel pour éviter d'envoyer le jeton d'accès au client, pour gérer plusieurs fournisseurs ou pour ajouter un fournisseur à une authentification classique par e-mail et mot de passe.",[10,93,94,95,100],{},"Simple, n'est-ce pas ? Laravel propose un package officiel appelé ",[17,96,99],{"href":97,"rel":98},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Fsocialite",[21],"Socialite",", qui rend ce processus encore plus facile. Il gère les détails OAuth propres à chaque fournisseur afin que notre application puisse se concentrer sur ses propres utilisateurs.",[85,102,103],{"color":87,"icon":88},[10,104,105],{},"Gardez à l'esprit que l'authentification sociale n'est pas une solution miracle adaptée à tous les projets. Même si elle peut être séduisante au premier abord, elle apporte aussi son lot de difficultés.",[40,107,109],{"id":108},"ajouter-socialite-au-projet","Ajouter Socialite au projet",[10,111,112],{},"Commençons par installer le package :",[114,115,121],"pre",{"className":116,"code":117,"filename":118,"language":119,"meta":120,"style":120},"language-bash shiki shiki-themes github-light github-light github-dark","composer require laravel\u002Fsocialite\n","terminal","bash","",[122,123,124],"code",{"__ignoreMap":120},[125,126,129,133,137],"span",{"class":127,"line":128},"line",1,[125,130,132],{"class":131},"snPdu","composer",[125,134,136],{"class":135},"sIIMD"," require",[125,138,139],{"class":135}," laravel\u002Fsocialite\n",[10,141,142,143,146],{},"Configurez-le ensuite dans ",[122,144,145],{},"config\u002Fservices.php"," :",[114,148,152],{"className":149,"code":150,"filename":145,"language":151,"meta":120,"style":120},"language-php shiki shiki-themes github-light github-light github-dark","return [\n  \u002F\u002F ...\n  'github' => [\n      'client_id' => env('GITHUB_CLIENT_ID'),\n      'client_secret' => env('GITHUB_CLIENT_SECRET'),\n      'redirect' => env('GITHUB_REDIRECT'),\n  ],\n];\n","php",[122,153,154,159,165,171,177,183,189,195],{"__ignoreMap":120},[125,155,156],{"class":127,"line":128},[125,157,158],{},"return [\n",[125,160,162],{"class":127,"line":161},2,[125,163,164],{},"  \u002F\u002F ...\n",[125,166,168],{"class":127,"line":167},3,[125,169,170],{},"  'github' => [\n",[125,172,174],{"class":127,"line":173},4,[125,175,176],{},"      'client_id' => env('GITHUB_CLIENT_ID'),\n",[125,178,180],{"class":127,"line":179},5,[125,181,182],{},"      'client_secret' => env('GITHUB_CLIENT_SECRET'),\n",[125,184,186],{"class":127,"line":185},6,[125,187,188],{},"      'redirect' => env('GITHUB_REDIRECT'),\n",[125,190,192],{"class":127,"line":191},7,[125,193,194],{},"  ],\n",[125,196,198],{"class":127,"line":197},8,[125,199,200],{},"];\n",[10,202,203,204,207,208,211],{},"La fonction ",[122,205,206],{},"env"," lit ces valeurs depuis ",[122,209,210],{},".env",". Ajoutez les identifiants GitHub et l'URL de callback :",[114,213,217],{"className":214,"code":215,"filename":210,"language":216,"meta":120,"style":120},"language-ini shiki shiki-themes github-light github-light github-dark","GITHUB_CLIENT_ID=your-client-id\nGITHUB_CLIENT_SECRET=your-client-secret\nGITHUB_REDIRECT=http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fcallback\n","ini",[122,218,219,224,229],{"__ignoreMap":120},[125,220,221],{"class":127,"line":128},[125,222,223],{},"GITHUB_CLIENT_ID=your-client-id\n",[125,225,226],{"class":127,"line":161},[125,227,228],{},"GITHUB_CLIENT_SECRET=your-client-secret\n",[125,230,231],{"class":127,"line":167},[125,232,233],{},"GITHUB_REDIRECT=http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fcallback\n",[10,235,236],{},"L'utilisateur est connecté à travers notre application, et non à travers GitHub. Cette distinction est importante : nous n'envoyons pas le jeton d'accès du fournisseur au client et nous pourrons prendre en charge plusieurs fournisseurs d'authentification plus tard.",[10,238,239],{},"À ce stade, deux questions reviennent généralement :",[57,241,242,253],{},[60,243,244,245,248,249,252],{},"Comment obtenir ",[122,246,247],{},"GITHUB_CLIENT_ID"," et ",[122,250,251],{},"GITHUB_CLIENT_SECRET"," ?",[60,254,255,256,259],{},"Pourquoi avons-nous besoin de l'URL ",[122,257,258],{},"GITHUB_REDIRECT"," et comment l'obtenir ?",[10,261,262,263,248,265,267,268,273,274,277,278,281,282,285],{},"GitHub fournit ",[122,264,247],{},[122,266,251],{}," lorsque vous créez une application OAuth. Ouvrez vos ",[17,269,272],{"href":270,"rel":271},"https:\u002F\u002Fgithub.com\u002Fsettings\u002Fprofile",[21],"paramètres GitHub",", accédez à ",[122,275,276],{},"Developer settings",", sélectionnez ",[122,279,280],{},"OAuth Apps",", puis cliquez sur ",[122,283,284],{},"New OAuth App",".",[85,287,288],{"color":87,"icon":88},[10,289,290],{},"Une application OAuth utilise le protocole OAuth pour authentifier les utilisateurs. Dans notre cas, GitHub joue le rôle de fournisseur OAuth. Une application OAuth nous permet d'utiliser le système d'authentification de GitHub pour connecter les utilisateurs à notre site.",[10,292,293],{},"Remplissez le formulaire. GitHub est assez permissif avec les valeurs fournies pendant le développement local.",[57,295,296,302,312],{},[60,297,298,301],{},[122,299,300],{},"Application name"," peut contenir n'importe quelle valeur. Je vous recommande d'utiliser le nom de votre site, car il est affiché aux utilisateurs lorsqu'ils se connectent, au moins la première fois.",[60,303,304,307,308,311],{},[122,305,306],{},"Homepage URL"," est l'URL de votre site. Vous pouvez utiliser ",[122,309,310],{},"http:\u002F\u002Flocalhost:8000"," en développement local.",[60,313,314,317,318,320,321,285],{},[122,315,316],{},"Authorization callback URL"," est l'adresse vers laquelle GitHub redirige les utilisateurs après l'autorisation de l'application. Elle doit correspondre à la valeur de ",[122,319,210],{},". En développement local, utilisez ",[122,322,323],{},"http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fcallback",[10,325,326,327,330,331,334],{},"Cliquez sur ",[122,328,329],{},"Register application"," pour créer l'application OAuth. Sa page contient le ",[122,332,333],{},"Client ID",", qui ressemble à ceci :",[114,336,340],{"className":337,"code":338,"filename":333,"language":339,"meta":120,"style":120},"language-txt shiki shiki-themes github-light github-light github-dark","a1b2c3d4e5f6g7h8i9j0\n","txt",[122,341,342],{"__ignoreMap":120},[125,343,344],{"class":127,"line":128},[125,345,338],{},[10,347,348,349,352,353,356],{},"Vous devez générer un nouveau ",[122,350,351],{},"Client secret",". Cliquez sur ",[122,354,355],{},"Generate a new client secret"," et copiez la valeur. Elle ressemble à ceci :",[114,358,361],{"className":337,"code":359,"filename":360,"language":339,"meta":120,"style":120},"d13f84af84688a69a71bc8b3808f8836e4c23774\n","Client Secret",[122,362,363],{"__ignoreMap":120},[125,364,365],{"class":127,"line":128},[125,366,359],{},[10,368,369,370,146],{},"Ajoutez enfin ces valeurs à ",[122,371,210],{},[114,373,375],{"className":214,"code":374,"filename":210,"language":216,"meta":120,"style":120},"GITHUB_CLIENT_ID=a1b2c3d4e5f6g7h8i9j0\nGITHUB_CLIENT_SECRET=d13f84af84688a69a71bc8b3808f8836e4c23774\nGITHUB_REDIRECT=http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fcallback\n",[122,376,377,382,387],{"__ignoreMap":120},[125,378,379],{"class":127,"line":128},[125,380,381],{},"GITHUB_CLIENT_ID=a1b2c3d4e5f6g7h8i9j0\n",[125,383,384],{"class":127,"line":161},[125,385,386],{},"GITHUB_CLIENT_SECRET=d13f84af84688a69a71bc8b3808f8836e4c23774\n",[125,388,389],{"class":127,"line":167},[125,390,233],{},[10,392,393,394,285],{},"N'oubliez pas d'ajouter également les variables d'environnement dans votre fichier ",[122,395,396],{},".env.example",[114,398,400],{"className":214,"code":399,"filename":396,"language":216,"meta":120,"style":120},"GITHUB_CLIENT_ID=\nGITHUB_CLIENT_SECRET=\nGITHUB_REDIRECT=http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fcallback\n",[122,401,402,407,412],{"__ignoreMap":120},[125,403,404],{"class":127,"line":128},[125,405,406],{},"GITHUB_CLIENT_ID=\n",[125,408,409],{"class":127,"line":161},[125,410,411],{},"GITHUB_CLIENT_SECRET=\n",[125,413,414],{"class":127,"line":167},[125,415,233],{},[10,417,418,419,421],{},"Ne commitez pas le client ID ni le secret. Laissez ces valeurs vides dans ",[122,420,396],{},", mais conservez l'URL de redirection afin que toute personne qui clone le dépôt sache comment configurer une application OAuth locale.",[10,423,424],{},"Maintenant que tout est configuré, écrivons le code qui gère l'authentification.",[40,426,428],{"id":427},"gérer-lauthentification","Gérer l'authentification",[10,430,431],{},"Pour la suite du projet, nous utiliserons une approche centrée sur les tests : écrire un test, observer son échec, puis ajouter uniquement le code nécessaire pour le faire réussir. Cette méthode nous aide à définir le comportement avant l'implémentation et évite les surprises. Elle peut sembler intimidante au début, mais Laravel rend le workflow accessible grâce à ses outils de test intégrés.",[85,433,434],{"color":87,"icon":88},[10,435,436],{},"Il s'agit peut-être de développement piloté par les tests (TDD), mais le nom est moins important ici que le workflow : écrire d'abord le test, puis implémenter uniquement ce qui est nécessaire pour le faire réussir.",[438,439,441],"h3",{"id":440},"la-redirection","La redirection",[10,443,444,445,146],{},"Créons un nouveau contrôleur appelé ",[122,446,447],{},"RegisteredViaGitHubController",[114,449,451],{"className":116,"code":450,"filename":118,"language":119,"meta":120,"style":120},"php artisan make:controller RegisteredViaGitHubController\n",[122,452,453],{"__ignoreMap":120},[125,454,455,457,460,463],{"class":127,"line":128},[125,456,151],{"class":131},[125,458,459],{"class":135}," artisan",[125,461,462],{"class":135}," make:controller",[125,464,465],{"class":135}," RegisteredViaGitHubController\n",[10,467,468],{},"Ce contrôleur contiendra deux méthodes :",[57,470,471,477],{},[60,472,473,476],{},[122,474,475],{},"create"," : Gère la redirection vers GitHub.",[60,478,479,482],{},[122,480,481],{},"store"," : Gère le callback de GitHub.",[10,484,485],{},"J'utilise généralement des noms de méthodes traditionnels pour faciliter la lecture et rester cohérent. Les garder en tête sera utile, car les tests seront organisés autour de ces méthodes.",[10,487,488,489,492,493,496,497,500,501,285],{},"Dans le dossier ",[122,490,491],{},"tests\u002FHttp",", nous pouvons supprimer le fichier ",[122,494,495],{},"ExampleTest.php",", puis créer un dossier ",[122,498,499],{},"RegisteredViaGitHub"," et un nouveau fichier de test ",[122,502,503],{},"CreateTest.php",[114,505,507],{"className":116,"code":506,"filename":118,"language":119,"meta":120,"style":120},"mkdir tests\u002FHttp\u002FRegisteredViaGitHub\ntouch tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n",[122,508,509,517],{"__ignoreMap":120},[125,510,511,514],{"class":127,"line":128},[125,512,513],{"class":131},"mkdir",[125,515,516],{"class":135}," tests\u002FHttp\u002FRegisteredViaGitHub\n",[125,518,519,522],{"class":127,"line":161},[125,520,521],{"class":131},"touch",[125,523,524],{"class":135}," tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n",[10,526,527,528],{},"Dans ce fichier, écrivons notre premier test. ",[529,530,531],"em",{},"C'est vraiment passionnant !",[114,533,536],{"className":149,"code":534,"filename":535,"language":151,"meta":120,"style":120},"\u003C?php\n\ndeclare(strict_types=1);\n\nuse Laravel\\Socialite\\Facades\\Socialite;\n\ntest('redirects for authorization', function () {\n    Socialite::shouldReceive('driver->redirect')->once();\n\n    $this->get(route('auth.github.redirect'));\n\n    expect(true)->toBeTrue();\n});\n","tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php",[122,537,538,543,549,554,558,563,567,572,577,582,588,593,599],{"__ignoreMap":120},[125,539,540],{"class":127,"line":128},[125,541,542],{},"\u003C?php\n",[125,544,545],{"class":127,"line":161},[125,546,548],{"emptyLinePlaceholder":547},true,"\n",[125,550,551],{"class":127,"line":167},[125,552,553],{},"declare(strict_types=1);\n",[125,555,556],{"class":127,"line":173},[125,557,548],{"emptyLinePlaceholder":547},[125,559,560],{"class":127,"line":179},[125,561,562],{},"use Laravel\\Socialite\\Facades\\Socialite;\n",[125,564,565],{"class":127,"line":185},[125,566,548],{"emptyLinePlaceholder":547},[125,568,569],{"class":127,"line":191},[125,570,571],{},"test('redirects for authorization', function () {\n",[125,573,574],{"class":127,"line":197},[125,575,576],{},"    Socialite::shouldReceive('driver->redirect')->once();\n",[125,578,580],{"class":127,"line":579},9,[125,581,548],{"emptyLinePlaceholder":547},[125,583,585],{"class":127,"line":584},10,[125,586,587],{},"    $this->get(route('auth.github.redirect'));\n",[125,589,591],{"class":127,"line":590},11,[125,592,548],{"emptyLinePlaceholder":547},[125,594,596],{"class":127,"line":595},12,[125,597,598],{},"    expect(true)->toBeTrue();\n",[125,600,602],{"class":127,"line":601},13,[125,603,604],{},"});\n",[85,606,607],{"color":87,"icon":88},[10,608,609,612,613,616],{},[122,610,611],{},"expect(true)->toBeTrue()"," fournit une assertion au test sans ajouter de comportement à vérifier. Si ",[122,614,615],{},"Socialite::shouldReceive('driver->redirect')->once()"," n'est pas satisfait, le mock fera de toute façon échouer le test.",[10,618,619,620,622,623,626],{},"C'est notre premier test, mais pas le plus simple. Il simule la façade ",[122,621,99],{}," et vérifie que ",[122,624,625],{},"redirect"," est appelé une fois. Nous utilisons un mock, car le test ne doit pas nous envoyer vers GitHub : il doit seulement vérifier que notre code demande à Socialite d'effectuer la redirection.",[10,628,629],{},"Lançons le test :",[114,631,633],{"className":116,"code":632,"filename":118,"language":119,"meta":120,"style":120},"php artisan test tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n",[122,634,635],{"__ignoreMap":120},[125,636,637,639,641,644],{"class":127,"line":128},[125,638,151],{"class":131},[125,640,459],{"class":135},[125,642,643],{"class":135}," test",[125,645,524],{"class":135},[10,647,648],{},"Il échoue, comme prévu. Dans un workflow piloté par les tests, l'échec nous indique ce qu'il faut implémenter ensuite. Suivons le message d'erreur et ajoutons uniquement le code nécessaire pour faire réussir le test.",[114,650,652],{"className":116,"code":651,"filename":118,"language":119,"meta":120,"style":120},"➜ php artisan test tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n\nFAILED  Tests\\Http\\RegisteredViaGitHub\\CreateTest > redirects for authorization\n  Route [auth.github.redirect] not defined.\n",[122,653,654,668,672,712],{"__ignoreMap":120},[125,655,656,659,662,664,666],{"class":127,"line":128},[125,657,658],{"class":131},"➜",[125,660,661],{"class":135}," php",[125,663,459],{"class":135},[125,665,643],{"class":135},[125,667,524],{"class":135},[125,669,670],{"class":127,"line":161},[125,671,548],{"emptyLinePlaceholder":547},[125,673,674,677,680,684,687,690,693,696,699,703,706,709],{"class":127,"line":167},[125,675,676],{"class":131},"FAILED",[125,678,679],{"class":135},"  Tests",[125,681,683],{"class":682},"sBjJW","\\H",[125,685,686],{"class":135},"ttp",[125,688,689],{"class":682},"\\R",[125,691,692],{"class":135},"egisteredViaGitHub",[125,694,695],{"class":682},"\\C",[125,697,698],{"class":135},"reateTest",[125,700,702],{"class":701},"s8jYJ"," >",[125,704,705],{"class":135}," redirects",[125,707,708],{"class":135}," for",[125,710,711],{"class":135}," authorization\n",[125,713,714,717],{"class":127,"line":173},[125,715,716],{"class":131},"  Route",[125,718,720],{"class":719},"sxrX7"," [auth.github.redirect] not defined.\n",[10,722,723,724,727,728,146],{},"Le message est clair : nous devons définir la route ",[122,725,726],{},"auth.github.redirect",". Faisons-le dans ",[122,729,730],{},"routes\u002Fweb.php",[114,732,734],{"className":149,"code":733,"filename":730,"language":151,"meta":120,"style":120},"\u003C?php\n\ndeclare(strict_types=1);\n\nuse App\\Http\\Controllers\\RegisteredViaGitHubController;\nuse Illuminate\\Support\\Facades\\Route;\n\n\u002F\u002F other routes...\n\nRoute::get('\u002Fauth\u002Fgithub\u002Fredirect', [RegisteredViaGitHubController::class, 'create'])\n    ->name('auth.github.redirect');\n",[122,735,736,740,744,748,752,757,762,766,771,775,780],{"__ignoreMap":120},[125,737,738],{"class":127,"line":128},[125,739,542],{},[125,741,742],{"class":127,"line":161},[125,743,548],{"emptyLinePlaceholder":547},[125,745,746],{"class":127,"line":167},[125,747,553],{},[125,749,750],{"class":127,"line":173},[125,751,548],{"emptyLinePlaceholder":547},[125,753,754],{"class":127,"line":179},[125,755,756],{},"use App\\Http\\Controllers\\RegisteredViaGitHubController;\n",[125,758,759],{"class":127,"line":185},[125,760,761],{},"use Illuminate\\Support\\Facades\\Route;\n",[125,763,764],{"class":127,"line":191},[125,765,548],{"emptyLinePlaceholder":547},[125,767,768],{"class":127,"line":197},[125,769,770],{},"\u002F\u002F other routes...\n",[125,772,773],{"class":127,"line":579},[125,774,548],{"emptyLinePlaceholder":547},[125,776,777],{"class":127,"line":584},[125,778,779],{},"Route::get('\u002Fauth\u002Fgithub\u002Fredirect', [RegisteredViaGitHubController::class, 'create'])\n",[125,781,782],{"class":127,"line":590},[125,783,784],{},"    ->name('auth.github.redirect');\n",[10,786,787,788,791],{},"Mais qu'est-ce que ",[122,789,790],{},"web.php"," ? C'est le fichier dans lequel nous définissons les routes accessibles depuis un navigateur et associons les URL aux méthodes des contrôleurs. Sa lecture offre une vue d'ensemble utile des points d'entrée de l'application.",[85,793,796],{"color":794,"icon":795},"success","i-ph-lightbulb-duotone",[10,797,798,799,804,805,810],{},"Je vous recommande vivement de regarder ",[17,800,803],{"href":801,"rel":802},"https:\u002F\u002Fyoutu.be\u002FNjkxzc-aqts?si=qA5qWuVrm02VtJUX",[21],"Lessons From the Framework"," de ",[17,806,809],{"href":807,"rel":808},"https:\u002F\u002Fgithub.com\u002Flukeraymonddowning",[21],"Luke Dowing"," pour comprendre l'importance de ce fichier.",[10,812,813,814,817,818,804,820,822,823,825],{},"Cette route répond à ",[122,815,816],{},"\u002Fauth\u002Fgithub\u002Fredirect"," et appelle la méthode ",[122,819,475],{},[122,821,447],{},". Nous lui donnons également le nom ",[122,824,726],{},", ce qui permet de la référencer dans le test et ailleurs dans l'application.",[10,827,828],{},"Relançons le test :",[114,830,832],{"className":116,"code":831,"filename":118,"language":119,"meta":120,"style":120},"➜ php artisan test tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n\n FAILED  Tests\\Http\\RegisteredViaGitHub\\CreateTest > redirects for authorization\n  Method redirect(\u003CAny Arguments>) from Mockery_1__demeter_c357969a11a830028afbe426ab0eea17_driver should be called\n exactly 1 times but called 0 times.\n",[122,833,834,846,850,877,915],{"__ignoreMap":120},[125,835,836,838,840,842,844],{"class":127,"line":128},[125,837,658],{"class":131},[125,839,661],{"class":135},[125,841,459],{"class":135},[125,843,643],{"class":135},[125,845,524],{"class":135},[125,847,848],{"class":127,"line":161},[125,849,548],{"emptyLinePlaceholder":547},[125,851,852,855,857,859,861,863,865,867,869,871,873,875],{"class":127,"line":167},[125,853,854],{"class":131}," FAILED",[125,856,679],{"class":135},[125,858,683],{"class":682},[125,860,686],{"class":135},[125,862,689],{"class":682},[125,864,692],{"class":135},[125,866,695],{"class":682},[125,868,698],{"class":135},[125,870,702],{"class":701},[125,872,705],{"class":135},[125,874,708],{"class":135},[125,876,711],{"class":135},[125,878,879,882,885,888,891,894,897,900,903,906,909,912],{"class":127,"line":173},[125,880,881],{"class":131},"  Method",[125,883,884],{"class":135}," redirect",[125,886,887],{"class":719},"(",[125,889,890],{"class":701},"\u003C",[125,892,893],{"class":719},"Any Arguments",[125,895,896],{"class":701},">",[125,898,899],{"class":719},") ",[125,901,902],{"class":135},"from",[125,904,905],{"class":135}," Mockery_1__demeter_c357969a11a830028afbe426ab0eea17_driver",[125,907,908],{"class":135}," should",[125,910,911],{"class":135}," be",[125,913,914],{"class":135}," called\n",[125,916,917,920,923,926,929,932,935],{"class":127,"line":179},[125,918,919],{"class":131}," exactly",[125,921,922],{"class":682}," 1",[125,924,925],{"class":135}," times",[125,927,928],{"class":135}," but",[125,930,931],{"class":135}," called",[125,933,934],{"class":682}," 0",[125,936,937],{"class":135}," times.\n",[10,939,940],{},"Le nouveau message signifie que la route fonctionne, mais que le contrôleur n'appelle pas encore Socialite. Ajoutons cet appel au contrôleur :",[114,942,945],{"className":149,"code":943,"filename":944,"language":151,"meta":120,"style":120},"\u003C?php\n\nnamespace App\\Http\\Controllers;\n\nuse Laravel\\Socialite\\Facades\\Socialite;\n\nclass RegisteredViaGitHubController extends Controller\n{\n    public function create()\n    {\n        return Socialite::driver('github')->redirect();\n    }\n}\n","app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php",[122,946,947,951,955,960,964,968,972,977,982,987,992,997,1002],{"__ignoreMap":120},[125,948,949],{"class":127,"line":128},[125,950,542],{},[125,952,953],{"class":127,"line":161},[125,954,548],{"emptyLinePlaceholder":547},[125,956,957],{"class":127,"line":167},[125,958,959],{},"namespace App\\Http\\Controllers;\n",[125,961,962],{"class":127,"line":173},[125,963,548],{"emptyLinePlaceholder":547},[125,965,966],{"class":127,"line":179},[125,967,562],{},[125,969,970],{"class":127,"line":185},[125,971,548],{"emptyLinePlaceholder":547},[125,973,974],{"class":127,"line":191},[125,975,976],{},"class RegisteredViaGitHubController extends Controller\n",[125,978,979],{"class":127,"line":197},[125,980,981],{},"{\n",[125,983,984],{"class":127,"line":579},[125,985,986],{},"    public function create()\n",[125,988,989],{"class":127,"line":584},[125,990,991],{},"    {\n",[125,993,994],{"class":127,"line":590},[125,995,996],{},"        return Socialite::driver('github')->redirect();\n",[125,998,999],{"class":127,"line":595},[125,1000,1001],{},"    }\n",[125,1003,1004],{"class":127,"line":601},[125,1005,1006],{},"}\n",[10,1008,828],{},[114,1010,1012],{"className":116,"code":1011,"filename":118,"language":119,"meta":120,"style":120},"➜ php artisan test tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n\n   PASS  Tests\\Http\\RegisteredViaGitHub\\CreateTest\n  ✓ redirects for authorization\n",[122,1013,1014,1026,1030,1050],{"__ignoreMap":120},[125,1015,1016,1018,1020,1022,1024],{"class":127,"line":128},[125,1017,658],{"class":131},[125,1019,661],{"class":135},[125,1021,459],{"class":135},[125,1023,643],{"class":135},[125,1025,524],{"class":135},[125,1027,1028],{"class":127,"line":161},[125,1029,548],{"emptyLinePlaceholder":547},[125,1031,1032,1035,1037,1039,1041,1043,1045,1047],{"class":127,"line":167},[125,1033,1034],{"class":131},"   PASS",[125,1036,679],{"class":135},[125,1038,683],{"class":682},[125,1040,686],{"class":135},[125,1042,689],{"class":682},[125,1044,692],{"class":135},[125,1046,695],{"class":682},[125,1048,1049],{"class":135},"reateTest\n",[125,1051,1052,1055,1057,1059],{"class":127,"line":173},[125,1053,1054],{"class":131},"  ✓",[125,1056,705],{"class":135},[125,1058,708],{"class":135},[125,1060,711],{"class":135},[10,1062,1063,1064,1067,1068,1071],{},"Et voilà ! Le test réussit. Démarrez le serveur de développement avec ",[122,1065,1066],{},"composer dev"," et ouvrez ",[122,1069,1070],{},"http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fredirect"," pour vérifier manuellement la redirection. Vous devriez arriver sur la page d'autorisation de GitHub. 🥳",[1073,1074,1075,1080],"figure",{},[1076,1077],"img",{"alt":1078,"src":1079},"Après la redirection, vous devriez arriver sur la page d'autorisation de GitHub","\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Feffortless-social-authentication-with-laravel-socialite\u002Fgithub-authorization.png",[1081,1082,1078],"figcaption",{},[438,1084,1086],{"id":1085},"le-callback","Le callback",[10,1088,1089],{},"Maintenant que vous comprenez le workflow, je ne répéterai pas l'instruction de lancer le test après chaque petite modification. Continuez à suivre cette boucle pour le reste du projet et dans vos propres projets.",[10,1091,1092,1093,1096,1097,285],{},"Créons un fichier de test ",[122,1094,1095],{},"StoreTest.php"," dans le dossier ",[122,1098,1099],{},"tests\u002FHttp\u002FRegisteredViaGitHub",[114,1101,1103],{"className":116,"code":1102,"filename":118,"language":119,"meta":120,"style":120},"touch tests\u002FHttp\u002FRegisteredViaGitHub\u002FStoreTest.php\n",[122,1104,1105],{"__ignoreMap":120},[125,1106,1107,1109],{"class":127,"line":128},[125,1108,521],{"class":131},[125,1110,1111],{"class":135}," tests\u002FHttp\u002FRegisteredViaGitHub\u002FStoreTest.php\n",[10,1113,1114,1116,1117,804,1119,1121],{},[122,1115,1095],{}," testera la méthode ",[122,1118,481],{},[122,1120,447],{},", qui gère le callback de GitHub. Socialite s'occupe de l'échange OAuth ; notre application doit donc seulement récupérer l'utilisateur du fournisseur, l'enregistrer et l'authentifier.",[10,1123,1124],{},"Commençons par écrire un test qui vérifie qu'un utilisateur peut être connecté :",[114,1126,1129],{"className":149,"code":1127,"filename":1128,"language":151,"meta":120,"style":120},"\u003C?php\n\ndeclare(strict_types=1);\n\nuse Laravel\\Socialite\\Facades\\Socialite;\nuse Laravel\\Socialite\\Two\\User as SocialiteUser;\n\ntest('registers successfully', function () {\n    $fakeGitHubUser = fakeGitHubUser();\n\n    $this->get(route('auth.github.callback'));\n\n    $this->assertAuthenticated();\n\n    $this->assertDatabaseHas('users', [\n        'github_id' => $fakeGitHubUser->getId(),\n        'email' => $fakeGitHubUser->getEmail(),\n        'name' => $fakeGitHubUser->getName(),\n    ]);\n});\n\n\u002F**\n * Create a fake GitHub user and mock the Socialite driver.\n *\n * @param  array\u003Cstring, mixed>  $attributes\n *\u002F\nfunction fakeGitHubUser(array $attributes = []): SocialiteUser\n{\n    $fakeGitHubUser = (new SocialiteUser)->map(attributes: array_merge([\n        'id' => '12345',\n        'nickname' => 'testuser',\n        'email' => 'test@example.com',\n        'name' => 'Test User',\n        'avatar' => 'https:\u002F\u002Fexample.com\u002Favatar.jpg',\n    ], $attributes));\n\n    Socialite::shouldReceive('driver->user')->once()->andReturn($fakeGitHubUser);\n\n    return $fakeGitHubUser;\n}\n","tests\u002FHttp\u002FRegisteredViaGitHub\u002FStoreTest.php",[122,1130,1131,1135,1139,1143,1147,1151,1156,1160,1165,1170,1174,1179,1183,1188,1193,1199,1205,1211,1217,1223,1228,1233,1239,1245,1251,1257,1263,1269,1274,1280,1286,1292,1298,1304,1310,1316,1321,1327,1332,1338],{"__ignoreMap":120},[125,1132,1133],{"class":127,"line":128},[125,1134,542],{},[125,1136,1137],{"class":127,"line":161},[125,1138,548],{"emptyLinePlaceholder":547},[125,1140,1141],{"class":127,"line":167},[125,1142,553],{},[125,1144,1145],{"class":127,"line":173},[125,1146,548],{"emptyLinePlaceholder":547},[125,1148,1149],{"class":127,"line":179},[125,1150,562],{},[125,1152,1153],{"class":127,"line":185},[125,1154,1155],{},"use Laravel\\Socialite\\Two\\User as SocialiteUser;\n",[125,1157,1158],{"class":127,"line":191},[125,1159,548],{"emptyLinePlaceholder":547},[125,1161,1162],{"class":127,"line":197},[125,1163,1164],{},"test('registers successfully', function () {\n",[125,1166,1167],{"class":127,"line":579},[125,1168,1169],{},"    $fakeGitHubUser = fakeGitHubUser();\n",[125,1171,1172],{"class":127,"line":584},[125,1173,548],{"emptyLinePlaceholder":547},[125,1175,1176],{"class":127,"line":590},[125,1177,1178],{},"    $this->get(route('auth.github.callback'));\n",[125,1180,1181],{"class":127,"line":595},[125,1182,548],{"emptyLinePlaceholder":547},[125,1184,1185],{"class":127,"line":601},[125,1186,1187],{},"    $this->assertAuthenticated();\n",[125,1189,1191],{"class":127,"line":1190},14,[125,1192,548],{"emptyLinePlaceholder":547},[125,1194,1196],{"class":127,"line":1195},15,[125,1197,1198],{},"    $this->assertDatabaseHas('users', [\n",[125,1200,1202],{"class":127,"line":1201},16,[125,1203,1204],{},"        'github_id' => $fakeGitHubUser->getId(),\n",[125,1206,1208],{"class":127,"line":1207},17,[125,1209,1210],{},"        'email' => $fakeGitHubUser->getEmail(),\n",[125,1212,1214],{"class":127,"line":1213},18,[125,1215,1216],{},"        'name' => $fakeGitHubUser->getName(),\n",[125,1218,1220],{"class":127,"line":1219},19,[125,1221,1222],{},"    ]);\n",[125,1224,1226],{"class":127,"line":1225},20,[125,1227,604],{},[125,1229,1231],{"class":127,"line":1230},21,[125,1232,548],{"emptyLinePlaceholder":547},[125,1234,1236],{"class":127,"line":1235},22,[125,1237,1238],{},"\u002F**\n",[125,1240,1242],{"class":127,"line":1241},23,[125,1243,1244],{}," * Create a fake GitHub user and mock the Socialite driver.\n",[125,1246,1248],{"class":127,"line":1247},24,[125,1249,1250],{}," *\n",[125,1252,1254],{"class":127,"line":1253},25,[125,1255,1256],{}," * @param  array\u003Cstring, mixed>  $attributes\n",[125,1258,1260],{"class":127,"line":1259},26,[125,1261,1262],{}," *\u002F\n",[125,1264,1266],{"class":127,"line":1265},27,[125,1267,1268],{},"function fakeGitHubUser(array $attributes = []): SocialiteUser\n",[125,1270,1272],{"class":127,"line":1271},28,[125,1273,981],{},[125,1275,1277],{"class":127,"line":1276},29,[125,1278,1279],{},"    $fakeGitHubUser = (new SocialiteUser)->map(attributes: array_merge([\n",[125,1281,1283],{"class":127,"line":1282},30,[125,1284,1285],{},"        'id' => '12345',\n",[125,1287,1289],{"class":127,"line":1288},31,[125,1290,1291],{},"        'nickname' => 'testuser',\n",[125,1293,1295],{"class":127,"line":1294},32,[125,1296,1297],{},"        'email' => 'test@example.com',\n",[125,1299,1301],{"class":127,"line":1300},33,[125,1302,1303],{},"        'name' => 'Test User',\n",[125,1305,1307],{"class":127,"line":1306},34,[125,1308,1309],{},"        'avatar' => 'https:\u002F\u002Fexample.com\u002Favatar.jpg',\n",[125,1311,1313],{"class":127,"line":1312},35,[125,1314,1315],{},"    ], $attributes));\n",[125,1317,1319],{"class":127,"line":1318},36,[125,1320,548],{"emptyLinePlaceholder":547},[125,1322,1324],{"class":127,"line":1323},37,[125,1325,1326],{},"    Socialite::shouldReceive('driver->user')->once()->andReturn($fakeGitHubUser);\n",[125,1328,1330],{"class":127,"line":1329},38,[125,1331,548],{"emptyLinePlaceholder":547},[125,1333,1335],{"class":127,"line":1334},39,[125,1336,1337],{},"    return $fakeGitHubUser;\n",[125,1339,1341],{"class":127,"line":1340},40,[125,1342,1006],{},[10,1344,1345,1346,1349,1350,1353],{},"Ce test crée un faux utilisateur GitHub et configure Socialite pour qu'il le retourne lorsque ",[122,1347,1348],{},"user"," est appelé. Nous évitons ainsi une vraie requête HTTP vers GitHub, tandis que l'aide ",[122,1351,1352],{},"fakeGitHubUser"," rend cette configuration réutilisable et le test lisible.",[10,1355,1356,1357,1360],{},"Nous appelons ensuite la route ",[122,1358,1359],{},"auth.github.callback"," et vérifions que l'utilisateur est authentifié et enregistré dans la base de données.",[10,1362,1363],{},"Suivons maintenant le message d'erreur du test.",[57,1365,1366],{},[60,1367,1368,1369,1371,1372,146],{},"La route ",[122,1370,1359],{}," n'est pas définie. Définissons-la dans ",[122,1373,730],{},[114,1375,1377],{"className":149,"code":1376,"filename":730,"language":151,"meta":120,"style":120},"Route::get('\u002Fauth\u002Fgithub\u002Fcallback', [RegisteredViaGitHubController::class, 'store'])\n    ->name('auth.github.callback');\n",[122,1378,1379,1384],{"__ignoreMap":120},[125,1380,1381],{"class":127,"line":128},[125,1382,1383],{},"Route::get('\u002Fauth\u002Fgithub\u002Fcallback', [RegisteredViaGitHubController::class, 'store'])\n",[125,1385,1386],{"class":127,"line":161},[125,1387,1388],{},"    ->name('auth.github.callback');\n",[57,1390,1391],{"start":161},[60,1392,1393,1394,1396],{},"L'utilisateur n'est pas authentifié. Implémentons la méthode ",[122,1395,481],{}," du contrôleur :",[114,1398,1400],{"className":149,"code":1399,"filename":944,"language":151,"meta":120,"style":120},"\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Http\\Controllers;\n\nuse Illuminate\\Support\\Facades\\Auth;\nuse Laravel\\Socialite\\Facades\\Socialite;\n\nfinal class RegisteredViaGitHubController extends Controller\n{\n    public function store()\n    {\n        $githubUser = Socialite::driver('github')->user();\n\n        Auth::login($githubUser);\n    }\n}\n",[122,1401,1402,1406,1410,1414,1418,1422,1426,1431,1435,1439,1444,1448,1453,1457,1462,1466,1471,1475],{"__ignoreMap":120},[125,1403,1404],{"class":127,"line":128},[125,1405,542],{},[125,1407,1408],{"class":127,"line":161},[125,1409,548],{"emptyLinePlaceholder":547},[125,1411,1412],{"class":127,"line":167},[125,1413,553],{},[125,1415,1416],{"class":127,"line":173},[125,1417,548],{"emptyLinePlaceholder":547},[125,1419,1420],{"class":127,"line":179},[125,1421,959],{},[125,1423,1424],{"class":127,"line":185},[125,1425,548],{"emptyLinePlaceholder":547},[125,1427,1428],{"class":127,"line":191},[125,1429,1430],{},"use Illuminate\\Support\\Facades\\Auth;\n",[125,1432,1433],{"class":127,"line":197},[125,1434,562],{},[125,1436,1437],{"class":127,"line":579},[125,1438,548],{"emptyLinePlaceholder":547},[125,1440,1441],{"class":127,"line":584},[125,1442,1443],{},"final class RegisteredViaGitHubController extends Controller\n",[125,1445,1446],{"class":127,"line":590},[125,1447,981],{},[125,1449,1450],{"class":127,"line":595},[125,1451,1452],{},"    public function store()\n",[125,1454,1455],{"class":127,"line":601},[125,1456,991],{},[125,1458,1459],{"class":127,"line":1190},[125,1460,1461],{},"        $githubUser = Socialite::driver('github')->user();\n",[125,1463,1464],{"class":127,"line":1195},[125,1465,548],{"emptyLinePlaceholder":547},[125,1467,1468],{"class":127,"line":1201},[125,1469,1470],{},"        Auth::login($githubUser);\n",[125,1472,1473],{"class":127,"line":1207},[125,1474,1001],{},[125,1476,1477],{"class":127,"line":1213},[125,1478,1006],{},[10,1480,1481,1484,1485,1490,1491,1494],{},[122,1482,1483],{},"Socialite::driver('github')->user()"," gère le flux OAuth et retourne l'",[17,1486,1489],{"href":1487,"rel":1488},"https:\u002F\u002Fgithub.com\u002Flaravel\u002Fsocialite\u002Fblob\u002F5.x\u002Fsrc\u002FAbstractUser.php",[21],"utilisateur"," du fournisseur. Nous utilisons ensuite la façade ",[122,1492,1493],{},"Auth"," de Laravel pour connecter cet utilisateur.",[57,1496,1497],{"start":167},[60,1498,1499,1500,1503,1504,1511],{},"L'utilisateur n'est toujours pas authentifié. La méthode ",[122,1501,1502],{},"login"," attend un utilisateur de l'application qui implémente ",[17,1505,1508],{"href":1506,"rel":1507},"https:\u002F\u002Fgithub.com\u002Flaravel\u002Fframework\u002Fblob\u002F12.x\u002Fsrc\u002FIlluminate\u002FAuth\u002FAuthenticatable.php",[21],[122,1509,1510],{},"Authenticatable",", mais nous lui passons un utilisateur Socialite.",[10,1513,1514,1515,1517,1518,285],{},"Nous ne pouvons pas transmettre directement l'utilisateur Socialite à ",[122,1516,1502],{},". Nous devons d'abord créer ou récupérer un utilisateur de l'application, puis passer ce modèle à ",[122,1519,1502],{},[114,1521,1523],{"className":149,"code":1522,"filename":944,"language":151,"meta":120,"style":120},"\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Http\\Controllers;\n\nuse App\\Models\\User;\nuse Illuminate\\Support\\Facades\\Auth;\nuse Laravel\\Socialite\\Facades\\Socialite;\n\nfinal class RegisteredViaGitHubController extends Controller\n{\n    public function store()\n    {\n        $githubUser = Socialite::driver('github')->user();\n\n        $user = User::create([\n            'name' => $githubUser->getName(),\n            'email' => $githubUser->getEmail(),\n            'username' => $githubUser->getNickname(),\n            'github_id' => $githubUser->getId(),\n            'avatar' => $githubUser->getAvatar(),\n        ]);\n\n        Auth::login($user);\n    }\n}\n",[122,1524,1525,1529,1533,1537,1541,1545,1549,1554,1558,1562,1566,1570,1574,1578,1582,1586,1590,1595,1600,1605,1610,1615,1620,1625,1629,1634,1638],{"__ignoreMap":120},[125,1526,1527],{"class":127,"line":128},[125,1528,542],{},[125,1530,1531],{"class":127,"line":161},[125,1532,548],{"emptyLinePlaceholder":547},[125,1534,1535],{"class":127,"line":167},[125,1536,553],{},[125,1538,1539],{"class":127,"line":173},[125,1540,548],{"emptyLinePlaceholder":547},[125,1542,1543],{"class":127,"line":179},[125,1544,959],{},[125,1546,1547],{"class":127,"line":185},[125,1548,548],{"emptyLinePlaceholder":547},[125,1550,1551],{"class":127,"line":191},[125,1552,1553],{},"use App\\Models\\User;\n",[125,1555,1556],{"class":127,"line":197},[125,1557,1430],{},[125,1559,1560],{"class":127,"line":579},[125,1561,562],{},[125,1563,1564],{"class":127,"line":584},[125,1565,548],{"emptyLinePlaceholder":547},[125,1567,1568],{"class":127,"line":590},[125,1569,1443],{},[125,1571,1572],{"class":127,"line":595},[125,1573,981],{},[125,1575,1576],{"class":127,"line":601},[125,1577,1452],{},[125,1579,1580],{"class":127,"line":1190},[125,1581,991],{},[125,1583,1584],{"class":127,"line":1195},[125,1585,1461],{},[125,1587,1588],{"class":127,"line":1201},[125,1589,548],{"emptyLinePlaceholder":547},[125,1591,1592],{"class":127,"line":1207},[125,1593,1594],{},"        $user = User::create([\n",[125,1596,1597],{"class":127,"line":1213},[125,1598,1599],{},"            'name' => $githubUser->getName(),\n",[125,1601,1602],{"class":127,"line":1219},[125,1603,1604],{},"            'email' => $githubUser->getEmail(),\n",[125,1606,1607],{"class":127,"line":1225},[125,1608,1609],{},"            'username' => $githubUser->getNickname(),\n",[125,1611,1612],{"class":127,"line":1230},[125,1613,1614],{},"            'github_id' => $githubUser->getId(),\n",[125,1616,1617],{"class":127,"line":1235},[125,1618,1619],{},"            'avatar' => $githubUser->getAvatar(),\n",[125,1621,1622],{"class":127,"line":1241},[125,1623,1624],{},"        ]);\n",[125,1626,1627],{"class":127,"line":1247},[125,1628,548],{"emptyLinePlaceholder":547},[125,1630,1631],{"class":127,"line":1253},[125,1632,1633],{},"        Auth::login($user);\n",[125,1635,1636],{"class":127,"line":1259},[125,1637,1001],{},[125,1639,1640],{"class":127,"line":1265},[125,1641,1006],{},[57,1643,1644],{"start":173},[60,1645,1646,1647,146],{},"L'utilisateur n'est toujours pas authentifié. Cette fois, consultez le fichier de log. Dans Laravel, le log se trouve dans ",[122,1648,1649],{},"storage\u002Flogs\u002Flaravel.log",[114,1651,1655],{"className":1652,"code":1653,"filename":1649,"language":1654,"meta":120,"style":120},"language-log shiki shiki-themes github-light github-light github-dark","[2025-02-28 06:51:21] testing.ERROR: SQLSTATE[HY000]: General error: 1 no such table: users (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"updated_at\", \"created_at\") values (Test User, test@example.com, 2025-02-28 06:51:21, 2025-02-28 06:51:21))\n","log",[122,1656,1657],{"__ignoreMap":120},[125,1658,1659],{"class":127,"line":128},[125,1660,1653],{},[85,1662,1663],{"color":794,"icon":795},[10,1664,1665],{},"N'hésitez pas à supprimer tout le contenu du fichier avant de relancer le test. Vous ne verrez ainsi que les logs pertinents.",[10,1667,1668,1669,1672],{},"Ce message est plus explicite que le précédent : la table ",[122,1670,1671],{},"users"," n'existe pas, la requête échoue donc avant l'authentification de l'utilisateur.",[10,1674,1675],{},"Avant de créer la table, inspectons les migrations de la base de données :",[57,1677,1678,1687,1696],{},[60,1679,1680,1683,1684,1686],{},[122,1681,1682],{},"0001_01_01_000000_create_users_table"," : Cette migration crée la table ",[122,1685,1671],{},". La table existe dans le schéma, mais la base de test n'a pas encore exécuté la migration.",[60,1688,1689,1683,1692,1695],{},[122,1690,1691],{},"0001_01_01_000001_create_cache_table",[122,1693,1694],{},"cache",". Elle ne nous intéresse pas ici.",[60,1697,1698,1683,1701,1704],{},[122,1699,1700],{},"0001_01_01_000002_create_failed_jobs_table",[122,1702,1703],{},"failed_jobs",". Elle ne nous intéresse pas non plus.",[10,1706,1707,1708,1711,1712,146],{},"Bonne nouvelle : nous pouvons exécuter automatiquement les migrations avant chaque test afin de conserver une base propre. Ajoutez le trait ",[122,1709,1710],{},"RefreshDatabase"," à ",[122,1713,1714],{},"Pest.php",[114,1716,1719],{"className":149,"code":1717,"filename":1718,"language":151,"meta":120,"style":120},"\u003C?php\n\ndeclare(strict_types=1);\n\npest()->extend(Tests\\TestCase::class)\n    ->use(Illuminate\\Foundation\\Testing\\RefreshDatabase::class)\n    ->in('Http');\n","tests\u002FPest.php",[122,1720,1721,1725,1729,1733,1737,1742,1747],{"__ignoreMap":120},[125,1722,1723],{"class":127,"line":128},[125,1724,542],{},[125,1726,1727],{"class":127,"line":161},[125,1728,548],{"emptyLinePlaceholder":547},[125,1730,1731],{"class":127,"line":167},[125,1732,553],{},[125,1734,1735],{"class":127,"line":173},[125,1736,548],{"emptyLinePlaceholder":547},[125,1738,1739],{"class":127,"line":179},[125,1740,1741],{},"pest()->extend(Tests\\TestCase::class)\n",[125,1743,1744],{"class":127,"line":185},[125,1745,1746],{},"    ->use(Illuminate\\Foundation\\Testing\\RefreshDatabase::class)\n",[125,1748,1749],{"class":127,"line":191},[125,1750,1751],{},"    ->in('Http');\n",[57,1753,1754],{"start":179},[60,1755,1756],{},"L'utilisateur n'est toujours pas authentifié. Consultez à nouveau le log :",[114,1758,1760],{"className":1652,"code":1759,"filename":1649,"language":1654,"meta":120,"style":120},"testing.ERROR: SQLSTATE[23000]: Integrity constraint violation: 19 NOT NULL constraint failed: users.password (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"updated_at\", \"created_at\") values (Test User, test@example.com, 2025-02-28 06:59:57, 2025-02-28 06:59:57))\n",[122,1761,1762],{"__ignoreMap":120},[125,1763,1764],{"class":127,"line":128},[125,1765,1759],{},[10,1767,1768,1769,1772,1773,1776],{},"Cette erreur SQL indique que ",[122,1770,1771],{},"password"," ne peut pas être ",[122,1774,1775],{},"null",", alors que l'authentification GitHub ne fournit pas de mot de passe. Nous devons adapter la migration à l'authentification OAuth.",[114,1778,1781],{"className":149,"code":1779,"filename":1780,"language":151,"meta":120,"style":120},"\u003C?php\n\ndeclare(strict_types=1);\n\nuse Illuminate\\Database\\Migrations\\Migration;\nuse Illuminate\\Database\\Schema\\Blueprint;\nuse Illuminate\\Support\\Facades\\Schema;\n\nreturn new class extends Migration\n{\n    \u002F**\n     * Run the migrations.\n     *\u002F\n    public function up(): void\n    {\n        Schema::create('users', function (Blueprint $table): void {\n            $table->id();\n            $table->string('name')->nullable(); \u002F\u002F [!code ++]\n            $table->string('username')->unique(); \u002F\u002F [!code ++]\n            $table->string('email')->unique();\n            $table->timestamp('email_verified_at')->nullable();\n            $table->string('password'); \u002F\u002F [!code --]\n            $table->rememberToken(); \u002F\u002F [!code --]\n            $table->string('github_id')->nullable()->unique(); \u002F\u002F [!code ++]\n            $table->string('avatar')->nullable(); \u002F\u002F [!code ++]\n            $table->timestamps();\n        });\n\n        \u002F\u002F other migrations...\n    }\n};\n\n","database\u002Fmigrations\u002F0001_01_01_000000_create_users_table.php",[122,1782,1783,1787,1791,1795,1799,1804,1809,1814,1818,1823,1827,1832,1837,1842,1847,1851,1856,1861,1866,1871,1876,1881,1886,1891,1896,1901,1906,1911,1915,1920,1924],{"__ignoreMap":120},[125,1784,1785],{"class":127,"line":128},[125,1786,542],{},[125,1788,1789],{"class":127,"line":161},[125,1790,548],{"emptyLinePlaceholder":547},[125,1792,1793],{"class":127,"line":167},[125,1794,553],{},[125,1796,1797],{"class":127,"line":173},[125,1798,548],{"emptyLinePlaceholder":547},[125,1800,1801],{"class":127,"line":179},[125,1802,1803],{},"use Illuminate\\Database\\Migrations\\Migration;\n",[125,1805,1806],{"class":127,"line":185},[125,1807,1808],{},"use Illuminate\\Database\\Schema\\Blueprint;\n",[125,1810,1811],{"class":127,"line":191},[125,1812,1813],{},"use Illuminate\\Support\\Facades\\Schema;\n",[125,1815,1816],{"class":127,"line":197},[125,1817,548],{"emptyLinePlaceholder":547},[125,1819,1820],{"class":127,"line":579},[125,1821,1822],{},"return new class extends Migration\n",[125,1824,1825],{"class":127,"line":584},[125,1826,981],{},[125,1828,1829],{"class":127,"line":590},[125,1830,1831],{},"    \u002F**\n",[125,1833,1834],{"class":127,"line":595},[125,1835,1836],{},"     * Run the migrations.\n",[125,1838,1839],{"class":127,"line":601},[125,1840,1841],{},"     *\u002F\n",[125,1843,1844],{"class":127,"line":1190},[125,1845,1846],{},"    public function up(): void\n",[125,1848,1849],{"class":127,"line":1195},[125,1850,991],{},[125,1852,1853],{"class":127,"line":1201},[125,1854,1855],{},"        Schema::create('users', function (Blueprint $table): void {\n",[125,1857,1858],{"class":127,"line":1207},[125,1859,1860],{},"            $table->id();\n",[125,1862,1863],{"class":127,"line":1213},[125,1864,1865],{},"            $table->string('name')->nullable(); \u002F\u002F [!code ++]\n",[125,1867,1868],{"class":127,"line":1219},[125,1869,1870],{},"            $table->string('username')->unique(); \u002F\u002F [!code ++]\n",[125,1872,1873],{"class":127,"line":1225},[125,1874,1875],{},"            $table->string('email')->unique();\n",[125,1877,1878],{"class":127,"line":1230},[125,1879,1880],{},"            $table->timestamp('email_verified_at')->nullable();\n",[125,1882,1883],{"class":127,"line":1235},[125,1884,1885],{},"            $table->string('password'); \u002F\u002F [!code --]\n",[125,1887,1888],{"class":127,"line":1241},[125,1889,1890],{},"            $table->rememberToken(); \u002F\u002F [!code --]\n",[125,1892,1893],{"class":127,"line":1247},[125,1894,1895],{},"            $table->string('github_id')->nullable()->unique(); \u002F\u002F [!code ++]\n",[125,1897,1898],{"class":127,"line":1253},[125,1899,1900],{},"            $table->string('avatar')->nullable(); \u002F\u002F [!code ++]\n",[125,1902,1903],{"class":127,"line":1259},[125,1904,1905],{},"            $table->timestamps();\n",[125,1907,1908],{"class":127,"line":1265},[125,1909,1910],{},"        });\n",[125,1912,1913],{"class":127,"line":1271},[125,1914,548],{"emptyLinePlaceholder":547},[125,1916,1917],{"class":127,"line":1276},[125,1918,1919],{},"        \u002F\u002F other migrations...\n",[125,1921,1922],{"class":127,"line":1282},[125,1923,1001],{},[125,1925,1926],{"class":127,"line":1288},[125,1927,1928],{},"};\n",[10,1930,1931],{},"Dans cette migration, nous ajoutons trois colonnes :",[1933,1934,1935,1941,1947],"ul",{},[60,1936,1937,1940],{},[122,1938,1939],{},"username"," : Stocke le nom d'utilisateur GitHub.",[60,1942,1943,1946],{},[122,1944,1945],{},"github_id"," : Stocke l'identifiant GitHub de l'utilisateur. Il est unique pour empêcher deux utilisateurs de l'application de partager le même compte GitHub et nullable afin de pouvoir ajouter d'autres méthodes d'authentification plus tard. Rendre une colonne nullable après coup est plus complexe avec SQLite, nous ajoutons donc cette contrainte maintenant.",[60,1948,1949,1952],{},[122,1950,1951],{},"avatar"," : Stocke l'URL de l'avatar de l'utilisateur.",[85,1954,1955],{"color":87,"icon":88},[10,1956,1957],{},"Nous modifions directement le fichier de migration au lieu d'en créer un nouveau, car l'application n'est pas encore déployée. Si elle l'était, nous aurions créé une migration pour modifier la table.",[57,1959,1960],{"start":185},[60,1961,1962],{},"L'utilisateur n'est toujours pas authentifié. Déboguer l'authentification dans une application fraîche peut sembler répétitif, mais chaque erreur révèle une pièce manquante. Une fois le processus compris, il devient beaucoup plus simple.",[10,1964,1965,1966,1969],{},"Dans ",[122,1967,1968],{},"laravel.log",", nous pouvons lire :",[114,1971,1973],{"className":1652,"code":1972,"filename":1649,"language":1654,"meta":120,"style":120},"[2025-02-28 07:09:29] testing.ERROR: SQLSTATE[23000]: Integrity constraint violation: 19 NOT NULL constraint failed: users.username (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"updated_at\", \"created_at\") values (Test User, test@example.com, 2025-02-28 07:09:29, 2025-02-28 07:09:29))\n",[122,1974,1975],{"__ignoreMap":120},[125,1976,1977],{"class":127,"line":128},[125,1978,1972],{},[10,1980,1981,1982,1984,1985,1988],{},"Cette erreur SQL ressemble à la précédente, mais cette fois ",[122,1983,1939],{}," manque. C'est surprenant, car la migration et ",[122,1986,1987],{},"User::create"," contiennent tous deux ce champ.",[10,1990,1991,1992,1994,1995,248,1997,1999,2000,146],{},"Le problème vient de la protection contre l'assignation en masse de Laravel. Par défaut, nous devons autoriser explicitement ",[122,1993,1939],{},", ",[122,1996,1945],{},[122,1998,1951],{}," dans le modèle ",[122,2001,2002],{},"User",[114,2004,2008],{"className":2005,"code":2006,"filename":2007,"language":151,"meta":120,"style":120},"language-php shiki shiki-themes github-light github-light github-dark has-diff","\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Models;\n\n\u002F\u002F use Illuminate\\Contracts\\Auth\\MustVerifyEmail;\nuse Illuminate\\Database\\Eloquent\\Factories\\HasFactory;\nuse Illuminate\\Foundation\\Auth\\User as Authenticatable;\nuse Illuminate\\Notifications\\Notifiable;\n\nclass User extends Authenticatable\n{\n    \u002F** @use HasFactory\u003C\\Database\\Factories\\UserFactory> *\u002F\n    use HasFactory, Notifiable;\n\n    \u002F**\n     * The attributes that are mass assignable.\n     *\n     * @var list\u003Cstring>\n     *\u002F\n    protected $fillable = [\n        'name',\n        'email',\n        'username', \u002F\u002F [!code ++]\n        'github_id', \u002F\u002F [!code ++]\n        'avatar', \u002F\u002F [!code ++]\n        'password', \u002F\u002F [!code --]\n    ];\n\n    \u002F\u002F ...\n}\n","app\u002FModels\u002FUser.php",[122,2009,2010,2014,2018,2022,2026,2031,2035,2040,2045,2050,2055,2059,2064,2068,2073,2078,2082,2086,2091,2096,2101,2105,2110,2115,2120,2128,2134,2140,2147,2152,2156,2161],{"__ignoreMap":120},[125,2011,2012],{"class":127,"line":128},[125,2013,542],{},[125,2015,2016],{"class":127,"line":161},[125,2017,548],{"emptyLinePlaceholder":547},[125,2019,2020],{"class":127,"line":167},[125,2021,553],{},[125,2023,2024],{"class":127,"line":173},[125,2025,548],{"emptyLinePlaceholder":547},[125,2027,2028],{"class":127,"line":179},[125,2029,2030],{},"namespace App\\Models;\n",[125,2032,2033],{"class":127,"line":185},[125,2034,548],{"emptyLinePlaceholder":547},[125,2036,2037],{"class":127,"line":191},[125,2038,2039],{},"\u002F\u002F use Illuminate\\Contracts\\Auth\\MustVerifyEmail;\n",[125,2041,2042],{"class":127,"line":197},[125,2043,2044],{},"use Illuminate\\Database\\Eloquent\\Factories\\HasFactory;\n",[125,2046,2047],{"class":127,"line":579},[125,2048,2049],{},"use Illuminate\\Foundation\\Auth\\User as Authenticatable;\n",[125,2051,2052],{"class":127,"line":584},[125,2053,2054],{},"use Illuminate\\Notifications\\Notifiable;\n",[125,2056,2057],{"class":127,"line":590},[125,2058,548],{"emptyLinePlaceholder":547},[125,2060,2061],{"class":127,"line":595},[125,2062,2063],{},"class User extends Authenticatable\n",[125,2065,2066],{"class":127,"line":601},[125,2067,981],{},[125,2069,2070],{"class":127,"line":1190},[125,2071,2072],{},"    \u002F** @use HasFactory\u003C\\Database\\Factories\\UserFactory> *\u002F\n",[125,2074,2075],{"class":127,"line":1195},[125,2076,2077],{},"    use HasFactory, Notifiable;\n",[125,2079,2080],{"class":127,"line":1201},[125,2081,548],{"emptyLinePlaceholder":547},[125,2083,2084],{"class":127,"line":1207},[125,2085,1831],{},[125,2087,2088],{"class":127,"line":1213},[125,2089,2090],{},"     * The attributes that are mass assignable.\n",[125,2092,2093],{"class":127,"line":1219},[125,2094,2095],{},"     *\n",[125,2097,2098],{"class":127,"line":1225},[125,2099,2100],{},"     * @var list\u003Cstring>\n",[125,2102,2103],{"class":127,"line":1230},[125,2104,1841],{},[125,2106,2107],{"class":127,"line":1235},[125,2108,2109],{},"    protected $fillable = [\n",[125,2111,2112],{"class":127,"line":1241},[125,2113,2114],{},"        'name',\n",[125,2116,2117],{"class":127,"line":1247},[125,2118,2119],{},"        'email',\n",[125,2121,2125],{"class":2122,"line":1253},[127,2123,2124],"diff","add",[125,2126,2127],{},"        'username',",[125,2129,2131],{"class":2130,"line":1259},[127,2123,2124],[125,2132,2133],{},"        'github_id',",[125,2135,2137],{"class":2136,"line":1265},[127,2123,2124],[125,2138,2139],{},"        'avatar',",[125,2141,2144],{"class":2142,"line":1271},[127,2123,2143],"remove",[125,2145,2146],{},"        'password',",[125,2148,2149],{"class":127,"line":1276},[125,2150,2151],{},"    ];\n",[125,2153,2154],{"class":127,"line":1282},[125,2155,548],{"emptyLinePlaceholder":547},[125,2157,2158],{"class":127,"line":1288},[125,2159,2160],{},"    \u002F\u002F ...\n",[125,2162,2163],{"class":127,"line":1294},[125,2164,1006],{},[10,2166,2167,2168,2171,2172,2175],{},"Cette approche fonctionne, mais elle oblige à modifier ",[122,2169,2170],{},"fillable"," chaque fois qu'une colonne assignable est ajoutée au modèle. La protection contre l'assignation en masse est particulièrement importante lorsque des données de requête sont transmises directement à un modèle. Par exemple, un utilisateur ne doit jamais pouvoir définir le champ ",[122,2173,2174],{},"is_admin"," lors de son inscription.",[114,2177,2180],{"className":149,"code":2178,"filename":2179,"language":151,"meta":120,"style":120},"function (Request $request): void {\n    User::create($request->all()); \u002F\u002F Never write this code.\n}\n","Exemple",[122,2181,2182,2187,2192],{"__ignoreMap":120},[125,2183,2184],{"class":127,"line":128},[125,2185,2186],{},"function (Request $request): void {\n",[125,2188,2189],{"class":127,"line":161},[125,2190,2191],{},"    User::create($request->all()); \u002F\u002F Never write this code.\n",[125,2193,2194],{"class":127,"line":167},[125,2195,1006],{},[10,2197,2198,2199,2202],{},"Sans cette protection, un utilisateur pourrait devenir administrateur en envoyant ",[122,2200,2201],{},"is_admin=true"," dans la requête. Ce serait un grave problème de sécurité.",[10,2204,2205,2206,2209,2210,146],{},"Pour supprimer cette configuration répétitive tout en gardant les entrées sûres, nous pouvons désactiver le mode guarded avec ",[122,2207,2208],{},"Model::unguard()"," dans ",[122,2211,2212],{},"app\u002FProviders\u002FAppServiceProvider.php",[114,2214,2216],{"className":149,"code":2215,"filename":2212,"language":151,"meta":120,"style":120},"\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Providers;\n\nuse Illuminate\\Database\\Eloquent\\Model;\nuse Illuminate\\Support\\ServiceProvider;\n\nclass AppServiceProvider extends ServiceProvider\n{\n    public function boot(): void\n    {\n        Model::unguard();\n    }\n}\n",[122,2217,2218,2222,2226,2230,2234,2239,2243,2248,2253,2257,2262,2266,2271,2275,2280,2284],{"__ignoreMap":120},[125,2219,2220],{"class":127,"line":128},[125,2221,542],{},[125,2223,2224],{"class":127,"line":161},[125,2225,548],{"emptyLinePlaceholder":547},[125,2227,2228],{"class":127,"line":167},[125,2229,553],{},[125,2231,2232],{"class":127,"line":173},[125,2233,548],{"emptyLinePlaceholder":547},[125,2235,2236],{"class":127,"line":179},[125,2237,2238],{},"namespace App\\Providers;\n",[125,2240,2241],{"class":127,"line":185},[125,2242,548],{"emptyLinePlaceholder":547},[125,2244,2245],{"class":127,"line":191},[125,2246,2247],{},"use Illuminate\\Database\\Eloquent\\Model;\n",[125,2249,2250],{"class":127,"line":197},[125,2251,2252],{},"use Illuminate\\Support\\ServiceProvider;\n",[125,2254,2255],{"class":127,"line":579},[125,2256,548],{"emptyLinePlaceholder":547},[125,2258,2259],{"class":127,"line":584},[125,2260,2261],{},"class AppServiceProvider extends ServiceProvider\n",[125,2263,2264],{"class":127,"line":590},[125,2265,981],{},[125,2267,2268],{"class":127,"line":595},[125,2269,2270],{},"    public function boot(): void\n",[125,2272,2273],{"class":127,"line":601},[125,2274,991],{},[125,2276,2277],{"class":127,"line":1190},[125,2278,2279],{},"        Model::unguard();\n",[125,2281,2282],{"class":127,"line":1195},[125,2283,1001],{},[125,2285,2286],{"class":127,"line":1201},[125,2287,1006],{},[10,2289,2290,2291,804,2293,2295],{},"À partir de maintenant, tous les modèles seront non protégés et nous pouvons supprimer ",[122,2292,2170],{},[122,2294,2002],{},". Cependant, toute entrée contrôlée par l'utilisateur doit passer par une form request. Valider les données avant de les enregistrer garantit que les utilisateurs ne peuvent pas définir des champs arbitraires ou des valeurs inattendues.",[10,2297,2298],{},"Dans ce flux OAuth, les données proviennent d'un fournisseur auquel nous faisons confiance, nous n'avons donc pas besoin de form request. Nous en utiliserons plus tard pour implémenter le système de commentaires.",[10,2300,2301],{},"Et voilà ! Le test réussit et les utilisateurs peuvent maintenant créer un compte avec GitHub. 🥳",[10,2303,2304],{},"Nous n'avons cependant pas terminé. Si un utilisateur se reconnecte, l'application tentera de créer un doublon. Nous devons gérer les utilisateurs existants.",[10,2306,2307],{},"Commençons par écrire un test pour vérifier qu'un utilisateur peut se reconnecter :",[114,2309,2311],{"className":149,"code":2310,"filename":1128,"language":151,"meta":120,"style":120},"\u003C?php\n\nuse App\\Models\\User;\n\n\u002F\u002F other tests...\n\ntest('updates the user if they already exist', function () {\n    $fakeGitHubUser = fakeGitHubUser();\n\n    $user = User::factory()->create(['github_id' => $fakeGitHubUser->getId()]);\n\n    $this->get(route('auth.github.callback'));\n\n    $this->assertAuthenticated();\n\n    $this->assertDatabaseHas('users', [\n        'id' => $user->id,\n        'github_id' => $fakeGitHubUser->getId(),\n        'email' => $fakeGitHubUser->getEmail(),\n        'name' => $fakeGitHubUser->getName(),\n    ]);\n});\n\n",[122,2312,2313,2317,2321,2325,2329,2334,2338,2343,2347,2351,2356,2360,2364,2368,2372,2376,2380,2385,2389,2393,2397,2401],{"__ignoreMap":120},[125,2314,2315],{"class":127,"line":128},[125,2316,542],{},[125,2318,2319],{"class":127,"line":161},[125,2320,548],{"emptyLinePlaceholder":547},[125,2322,2323],{"class":127,"line":167},[125,2324,1553],{},[125,2326,2327],{"class":127,"line":173},[125,2328,548],{"emptyLinePlaceholder":547},[125,2330,2331],{"class":127,"line":179},[125,2332,2333],{},"\u002F\u002F other tests...\n",[125,2335,2336],{"class":127,"line":185},[125,2337,548],{"emptyLinePlaceholder":547},[125,2339,2340],{"class":127,"line":191},[125,2341,2342],{},"test('updates the user if they already exist', function () {\n",[125,2344,2345],{"class":127,"line":197},[125,2346,1169],{},[125,2348,2349],{"class":127,"line":579},[125,2350,548],{"emptyLinePlaceholder":547},[125,2352,2353],{"class":127,"line":584},[125,2354,2355],{},"    $user = User::factory()->create(['github_id' => $fakeGitHubUser->getId()]);\n",[125,2357,2358],{"class":127,"line":590},[125,2359,548],{"emptyLinePlaceholder":547},[125,2361,2362],{"class":127,"line":595},[125,2363,1178],{},[125,2365,2366],{"class":127,"line":601},[125,2367,548],{"emptyLinePlaceholder":547},[125,2369,2370],{"class":127,"line":1190},[125,2371,1187],{},[125,2373,2374],{"class":127,"line":1195},[125,2375,548],{"emptyLinePlaceholder":547},[125,2377,2378],{"class":127,"line":1201},[125,2379,1198],{},[125,2381,2382],{"class":127,"line":1207},[125,2383,2384],{},"        'id' => $user->id,\n",[125,2386,2387],{"class":127,"line":1213},[125,2388,1204],{},[125,2390,2391],{"class":127,"line":1219},[125,2392,1210],{},[125,2394,2395],{"class":127,"line":1225},[125,2396,1216],{},[125,2398,2399],{"class":127,"line":1230},[125,2400,1222],{},[125,2402,2403],{"class":127,"line":1235},[125,2404,604],{},[10,2406,2407,2408,2410],{},"Ce test crée un utilisateur avec le même ",[122,2409,1945],{}," que le faux utilisateur GitHub. Il appelle ensuite la route callback et vérifie que l'utilisateur existant est authentifié et mis à jour.",[10,2412,2413],{},"Suivons le message d'erreur :",[114,2415,2417],{"className":116,"code":2416,"filename":118,"language":119,"meta":120,"style":120},"SQLSTATE[HY000]: General error: 1 table users has no column named password (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"email_verified_at\", \"password\", \"remember_token\", \"github_id\", \"updated_at\", \"created_at\") values (Lawrence Herzog, roconnell@example.net, 2025-03-01 18:44:12, $2y$04$NXCZUWIcdKPiCdw3n5cTBOIpQo9\u002FDPc9rmgX5VRTQ3iTeWduC4x36, 0i9tgsiLpA, 12345, 2025-03-01 18:44:12, 2025-03-01 18:44:12))\n",[122,2418,2419],{"__ignoreMap":120},[125,2420,2421,2424,2427,2430,2432,2435,2438,2441,2444,2447,2450,2453,2456,2459,2462,2465,2468,2471,2474,2477,2479,2482,2485,2488,2491,2494,2497,2500,2503,2506,2509,2512,2515,2518,2521,2524,2527,2530,2532,2534,2536,2539],{"class":127,"line":128},[125,2422,2423],{"class":131},"SQLSTATE[HY000]:",[125,2425,2426],{"class":135}," General",[125,2428,2429],{"class":135}," error:",[125,2431,922],{"class":682},[125,2433,2434],{"class":135}," table",[125,2436,2437],{"class":135}," users",[125,2439,2440],{"class":135}," has",[125,2442,2443],{"class":135}," no",[125,2445,2446],{"class":135}," column",[125,2448,2449],{"class":135}," named",[125,2451,2452],{"class":135}," password",[125,2454,2455],{"class":719}," (Connection: ",[125,2457,2458],{"class":135},"sqlite,",[125,2460,2461],{"class":135}," SQL:",[125,2463,2464],{"class":135}," insert",[125,2466,2467],{"class":135}," into",[125,2469,2470],{"class":135}," \"users\"",[125,2472,2473],{"class":719}," (",[125,2475,2476],{"class":135},"\"name\"",[125,2478,1994],{"class":719},[125,2480,2481],{"class":135},"\"email\",",[125,2483,2484],{"class":135}," \"email_verified_at\",",[125,2486,2487],{"class":135}," \"password\",",[125,2489,2490],{"class":135}," \"remember_token\",",[125,2492,2493],{"class":135}," \"github_id\",",[125,2495,2496],{"class":135}," \"updated_at\",",[125,2498,2499],{"class":135}," \"created_at\"",[125,2501,2502],{"class":719},") values (",[125,2504,2505],{"class":131},"Lawrence",[125,2507,2508],{"class":135}," Herzog,",[125,2510,2511],{"class":135}," roconnell@example.net,",[125,2513,2514],{"class":135}," 2025-03-01",[125,2516,2517],{"class":135}," 18:44:12,",[125,2519,2520],{"class":719}," $2y$04$NXCZUWIcdKPiCdw3n5cTBOIpQo9",[125,2522,2523],{"class":135},"\u002FDPc9rmgX5VRTQ3iTeWduC4x36,",[125,2525,2526],{"class":135}," 0i9tgsiLpA,",[125,2528,2529],{"class":135}," 12345,",[125,2531,2514],{"class":135},[125,2533,2517],{"class":135},[125,2535,2514],{"class":135},[125,2537,2538],{"class":135}," 18:44:12",[125,2540,2541],{"class":719},"))\n",[10,2543,2544,2545,2547,2548,2551],{},"Cette erreur SQL mentionne la colonne ",[122,2546,1771],{},". C'est étrange, puisque nous l'avons supprimée de la migration. L'erreur vient de la factory utilisateur, qui contient toujours les champs de mot de passe par défaut de Laravel. Ouvrez ",[122,2549,2550],{},"database\u002Ffactories\u002FUserFactory.php"," et supprimez-les :",[114,2553,2555],{"className":2005,"code":2554,"filename":2550,"language":151,"meta":120,"style":120},"\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace Database\\Factories;\n\nuse Illuminate\\Database\\Eloquent\\Factories\\Factory;\nuse Illuminate\\Support\\Facades\\Hash; \u002F\u002F [!code --]\nuse Illuminate\\Support\\Str; \u002F\u002F [!code --]\n\n\u002F**\n * @extends \\Illuminate\\Database\\Eloquent\\Factories\\Factory\u003C\\App\\Models\\User>\n *\u002F\nclass UserFactory extends Factory\n{\n    \u002F** \u002F\u002F [!code --]\n     * The current password being used by the factory. \u002F\u002F [!code --]\n     *\u002F \u002F\u002F [!code --]\n    protected static ?string $password = null; \u002F\u002F [!code --]\n\n    \u002F**\n     * Define the model's default state.\n     *\n     * @return array\u003Cstring, mixed>\n     *\u002F\n    public function definition(): array\n    {\n        return [\n            'name' => fake()->name(),\n            'username' => fake()->unique()->userName(), \u002F\u002F [!code ++]\n            'email' => fake()->unique()->safeEmail(),\n            'github_id' => fake()->unique()->numberBetween(1, 1000000), \u002F\u002F [!code ++]\n            'avatar' => fake()->imageUrl(), \u002F\u002F [!code ++]\n            'email_verified_at' => now(),\n            'password' => self::$password ??= Hash::make('password'), \u002F\u002F [!code --]\n            'remember_token' => Str::random(10), \u002F\u002F [!code --]\n        ];\n    }\n \u002F\u002F [!code --]\n    \u002F** \u002F\u002F [!code --]\n     * Indicate that the model's email address should be unverified. \u002F\u002F [!code --]\n     *\u002F \u002F\u002F [!code --]\n    public function unverified(): static \u002F\u002F [!code --]\n    { \u002F\u002F [!code --]\n        return $this->state(fn (array $attributes): array => [ \u002F\u002F [!code --]\n            'email_verified_at' => null, \u002F\u002F [!code --]\n        ]);  \u002F\u002F [!code --]\n    } \u002F\u002F [!code --]\n}\n",[122,2556,2557,2561,2565,2569,2573,2578,2582,2587,2592,2597,2601,2605,2610,2614,2619,2623,2628,2634,2640,2645,2649,2653,2658,2662,2667,2671,2676,2680,2685,2690,2696,2701,2707,2713,2718,2724,2730,2735,2739,2744,2751,2757,2763,2769,2775,2782,2788,2794],{"__ignoreMap":120},[125,2558,2559],{"class":127,"line":128},[125,2560,542],{},[125,2562,2563],{"class":127,"line":161},[125,2564,548],{"emptyLinePlaceholder":547},[125,2566,2567],{"class":127,"line":167},[125,2568,553],{},[125,2570,2571],{"class":127,"line":173},[125,2572,548],{"emptyLinePlaceholder":547},[125,2574,2575],{"class":127,"line":179},[125,2576,2577],{},"namespace Database\\Factories;\n",[125,2579,2580],{"class":127,"line":185},[125,2581,548],{"emptyLinePlaceholder":547},[125,2583,2584],{"class":127,"line":191},[125,2585,2586],{},"use Illuminate\\Database\\Eloquent\\Factories\\Factory;\n",[125,2588,2589],{"class":127,"line":197},[125,2590,2591],{},"use Illuminate\\Support\\Facades\\Hash; \u002F\u002F [!code --]\n",[125,2593,2594],{"class":127,"line":579},[125,2595,2596],{},"use Illuminate\\Support\\Str; \u002F\u002F [!code --]\n",[125,2598,2599],{"class":127,"line":584},[125,2600,548],{"emptyLinePlaceholder":547},[125,2602,2603],{"class":127,"line":590},[125,2604,1238],{},[125,2606,2607],{"class":127,"line":595},[125,2608,2609],{}," * @extends \\Illuminate\\Database\\Eloquent\\Factories\\Factory\u003C\\App\\Models\\User>\n",[125,2611,2612],{"class":127,"line":601},[125,2613,1262],{},[125,2615,2616],{"class":127,"line":1190},[125,2617,2618],{},"class UserFactory extends Factory\n",[125,2620,2621],{"class":127,"line":1195},[125,2622,981],{},[125,2624,2625],{"class":127,"line":1201},[125,2626,2627],{},"    \u002F** \u002F\u002F [!code --]\n",[125,2629,2631],{"class":2630,"line":1207},[127,2123,2143],[125,2632,2633],{},"     * The current password being used by the factory.",[125,2635,2637],{"class":2636,"line":1213},[127,2123,2143],[125,2638,2639],{},"     *\u002F",[125,2641,2642],{"class":127,"line":1219},[125,2643,2644],{},"    protected static ?string $password = null; \u002F\u002F [!code --]\n",[125,2646,2647],{"class":127,"line":1225},[125,2648,548],{"emptyLinePlaceholder":547},[125,2650,2651],{"class":127,"line":1230},[125,2652,1831],{},[125,2654,2655],{"class":127,"line":1235},[125,2656,2657],{},"     * Define the model's default state.\n",[125,2659,2660],{"class":127,"line":1241},[125,2661,2095],{},[125,2663,2664],{"class":127,"line":1247},[125,2665,2666],{},"     * @return array\u003Cstring, mixed>\n",[125,2668,2669],{"class":127,"line":1253},[125,2670,1841],{},[125,2672,2673],{"class":127,"line":1259},[125,2674,2675],{},"    public function definition(): array\n",[125,2677,2678],{"class":127,"line":1265},[125,2679,991],{},[125,2681,2682],{"class":127,"line":1271},[125,2683,2684],{},"        return [\n",[125,2686,2687],{"class":127,"line":1276},[125,2688,2689],{},"            'name' => fake()->name(),\n",[125,2691,2693],{"class":2692,"line":1282},[127,2123,2124],[125,2694,2695],{},"            'username' => fake()->unique()->userName(),",[125,2697,2698],{"class":127,"line":1288},[125,2699,2700],{},"            'email' => fake()->unique()->safeEmail(),\n",[125,2702,2704],{"class":2703,"line":1294},[127,2123,2124],[125,2705,2706],{},"            'github_id' => fake()->unique()->numberBetween(1, 1000000),",[125,2708,2710],{"class":2709,"line":1300},[127,2123,2124],[125,2711,2712],{},"            'avatar' => fake()->imageUrl(),",[125,2714,2715],{"class":127,"line":1306},[125,2716,2717],{},"            'email_verified_at' => now(),\n",[125,2719,2721],{"class":2720,"line":1312},[127,2123,2143],[125,2722,2723],{},"            'password' => self::$password ??= Hash::make('password'),",[125,2725,2727],{"class":2726,"line":1318},[127,2123,2143],[125,2728,2729],{},"            'remember_token' => Str::random(10),",[125,2731,2732],{"class":127,"line":1323},[125,2733,2734],{},"        ];\n",[125,2736,2737],{"class":127,"line":1329},[125,2738,1001],{},[125,2740,2742],{"class":2741,"line":1340},[127,2123,2143],[125,2743,2627],{},[125,2745,2748],{"class":2746,"line":2747},[127,2123,2143],41,[125,2749,2750],{},"     * Indicate that the model's email address should be unverified.",[125,2752,2755],{"class":2753,"line":2754},[127,2123,2143],42,[125,2756,2639],{},[125,2758,2760],{"class":127,"line":2759},43,[125,2761,2762],{},"    public function unverified(): static \u002F\u002F [!code --]\n",[125,2764,2766],{"class":127,"line":2765},44,[125,2767,2768],{},"    { \u002F\u002F [!code --]\n",[125,2770,2772],{"class":127,"line":2771},45,[125,2773,2774],{},"        return $this->state(fn (array $attributes): array => [ \u002F\u002F [!code --]\n",[125,2776,2779],{"class":2777,"line":2778},[127,2123,2143],46,[125,2780,2781],{},"            'email_verified_at' => null,",[125,2783,2785],{"class":127,"line":2784},47,[125,2786,2787],{},"        ]);  \u002F\u002F [!code --]\n",[125,2789,2791],{"class":127,"line":2790},48,[125,2792,2793],{},"    } \u002F\u002F [!code --]\n",[125,2795,2797],{"class":127,"line":2796},49,[125,2798,1006],{},[10,2800,2801,2802,2805],{},"Après cette modification, l'erreur devient ",[122,2803,2804],{},"The user is not authenticated",". Nous savons ce que cela signifie : il reste un autre problème à corriger.",[10,2807,2808,2809,2811],{},"En consultant ",[122,2810,1968],{},", nous découvrons le problème que nous cherchions :",[114,2813,2815],{"className":1652,"code":2814,"filename":1649,"language":1654,"meta":120,"style":120},"[2025-03-01 18:51:14] testing.ERROR: SQLSTATE[23000]: Integrity constraint violation: 19 UNIQUE constraint failed: users.github_id (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"username\", \"github_id\", \"avatar\", \"updated_at\", \"created_at\") values (Test User, test@example.com, testuser, 12345, https:\u002F\u002Fexample.com\u002Favatar.jpg, 2025-03-01 18:51:14, 2025-03-01 18:51:14))\n",[122,2816,2817],{"__ignoreMap":120},[125,2818,2819],{"class":127,"line":128},[125,2820,2814],{},[10,2822,2823,2824,2826,2827,2834],{},"Cette erreur SQL signifie qu'un utilisateur avec le même ",[122,2825,1945],{}," existe déjà. Au lieu de toujours créer un nouvel utilisateur, nous devons mettre à jour l'enregistrement existant lorsqu'il est trouvé et en créer un nouveau dans le cas contraire. La méthode ",[17,2828,2831],{"href":2829,"rel":2830},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Feloquent#updates",[21],[122,2832,2833],{},"updateOrCreate"," de Laravel fait exactement cela.",[114,2836,2838],{"className":149,"code":2837,"filename":944,"language":151,"meta":120,"style":120},"\u003C?php\n\nclass RegisteredViaGitHubController extends Controller\n{\n    public function store()\n    {\n        $githubUser = Socialite::driver('github')->user();\n\n        $user = User::updateOrCreate(\n            [\n                'github_id' => $githubUser->getId(),\n            ],\n            [\n                'name' => $githubUser->getName(),\n                'email' => $githubUser->getEmail(),\n                'username' => $githubUser->getNickname(),\n                'avatar' => $githubUser->getAvatar(),\n            ]\n        );\n\n        Auth::login($user);\n    }\n}\n",[122,2839,2840,2844,2848,2852,2856,2860,2864,2868,2872,2877,2882,2887,2892,2896,2901,2906,2911,2916,2921,2926,2930,2934,2938],{"__ignoreMap":120},[125,2841,2842],{"class":127,"line":128},[125,2843,542],{},[125,2845,2846],{"class":127,"line":161},[125,2847,548],{"emptyLinePlaceholder":547},[125,2849,2850],{"class":127,"line":167},[125,2851,976],{},[125,2853,2854],{"class":127,"line":173},[125,2855,981],{},[125,2857,2858],{"class":127,"line":179},[125,2859,1452],{},[125,2861,2862],{"class":127,"line":185},[125,2863,991],{},[125,2865,2866],{"class":127,"line":191},[125,2867,1461],{},[125,2869,2870],{"class":127,"line":197},[125,2871,548],{"emptyLinePlaceholder":547},[125,2873,2874],{"class":127,"line":579},[125,2875,2876],{},"        $user = User::updateOrCreate(\n",[125,2878,2879],{"class":127,"line":584},[125,2880,2881],{},"            [\n",[125,2883,2884],{"class":127,"line":590},[125,2885,2886],{},"                'github_id' => $githubUser->getId(),\n",[125,2888,2889],{"class":127,"line":595},[125,2890,2891],{},"            ],\n",[125,2893,2894],{"class":127,"line":601},[125,2895,2881],{},[125,2897,2898],{"class":127,"line":1190},[125,2899,2900],{},"                'name' => $githubUser->getName(),\n",[125,2902,2903],{"class":127,"line":1195},[125,2904,2905],{},"                'email' => $githubUser->getEmail(),\n",[125,2907,2908],{"class":127,"line":1201},[125,2909,2910],{},"                'username' => $githubUser->getNickname(),\n",[125,2912,2913],{"class":127,"line":1207},[125,2914,2915],{},"                'avatar' => $githubUser->getAvatar(),\n",[125,2917,2918],{"class":127,"line":1213},[125,2919,2920],{},"            ]\n",[125,2922,2923],{"class":127,"line":1219},[125,2924,2925],{},"        );\n",[125,2927,2928],{"class":127,"line":1225},[125,2929,548],{"emptyLinePlaceholder":547},[125,2931,2932],{"class":127,"line":1230},[125,2933,1633],{},[125,2935,2936],{"class":127,"line":1235},[125,2937,1001],{},[125,2939,2940],{"class":127,"line":1241},[125,2941,1006],{},[10,2943,2944],{},"Redirigeons enfin l'utilisateur vers la page d'accueil du front-end après sa connexion.",[10,2946,2947],{},"Le dernier test vérifie que l'utilisateur est redirigé vers la page d'accueil après sa connexion :",[114,2949,2951],{"className":149,"code":2950,"filename":1128,"language":151,"meta":120,"style":120},"\u003C?php\n\n\u002F\u002F other tests...\n\ntest('redirects to the homepage', function () {\n    fakeGitHubUser();\n\n    $this->get(route('auth.github.callback'))\n        ->assertRedirect('\u002F');\n});\n",[122,2952,2953,2957,2961,2965,2969,2974,2979,2983,2988,2993],{"__ignoreMap":120},[125,2954,2955],{"class":127,"line":128},[125,2956,542],{},[125,2958,2959],{"class":127,"line":161},[125,2960,548],{"emptyLinePlaceholder":547},[125,2962,2963],{"class":127,"line":167},[125,2964,2333],{},[125,2966,2967],{"class":127,"line":173},[125,2968,548],{"emptyLinePlaceholder":547},[125,2970,2971],{"class":127,"line":179},[125,2972,2973],{},"test('redirects to the homepage', function () {\n",[125,2975,2976],{"class":127,"line":185},[125,2977,2978],{},"    fakeGitHubUser();\n",[125,2980,2981],{"class":127,"line":191},[125,2982,548],{"emptyLinePlaceholder":547},[125,2984,2985],{"class":127,"line":197},[125,2986,2987],{},"    $this->get(route('auth.github.callback'))\n",[125,2989,2990],{"class":127,"line":579},[125,2991,2992],{},"        ->assertRedirect('\u002F');\n",[125,2994,2995],{"class":127,"line":584},[125,2996,604],{},[10,2998,2999,3000,3003],{},"La méthode ",[122,3001,3002],{},"assertRedirect"," vérifie que l'utilisateur est redirigé vers la page d'accueil après sa connexion.",[10,3005,3006],{},"Il ne reste plus qu'à implémenter la redirection dans le contrôleur :",[114,3008,3010],{"className":149,"code":3009,"filename":944,"language":151,"meta":120,"style":120},"\u003C?php\nclass RegisteredViaGitHubController extends Controller\n{\n    public function store()\n    {\n        \u002F\u002F ...\n\n        Auth::login($user);\n\n        return redirect('\u002F');\n    }\n}\n",[122,3011,3012,3016,3020,3024,3028,3032,3037,3041,3045,3049,3054,3058],{"__ignoreMap":120},[125,3013,3014],{"class":127,"line":128},[125,3015,542],{},[125,3017,3018],{"class":127,"line":161},[125,3019,976],{},[125,3021,3022],{"class":127,"line":167},[125,3023,981],{},[125,3025,3026],{"class":127,"line":173},[125,3027,1452],{},[125,3029,3030],{"class":127,"line":179},[125,3031,991],{},[125,3033,3034],{"class":127,"line":185},[125,3035,3036],{},"        \u002F\u002F ...\n",[125,3038,3039],{"class":127,"line":191},[125,3040,548],{"emptyLinePlaceholder":547},[125,3042,3043],{"class":127,"line":197},[125,3044,1633],{},[125,3046,3047],{"class":127,"line":579},[125,3048,548],{"emptyLinePlaceholder":547},[125,3050,3051],{"class":127,"line":584},[125,3052,3053],{},"        return redirect('\u002F');\n",[125,3055,3056],{"class":127,"line":590},[125,3057,1001],{},[125,3059,3060],{"class":127,"line":595},[125,3061,1006],{},[10,3063,3064],{},"Et voilà, le contrôleur est terminé !",[40,3066,3068],{"id":3067},"atteindre-une-couverture-complète","Atteindre une couverture complète",[10,3070,3071],{},"Avant de conclure, vérifions que le script de test s'exécute correctement.",[85,3073,3074],{"color":794,"icon":795},[10,3075,3076],{},"Avant de lancer le script de test, exécutez d'abord les scripts de lint et de refactorisation.",[10,3078,3079],{},"PHPStan n'est pas satisfait de notre code. Il signale deux erreurs :",[114,3081,3083],{"className":116,"code":3082,"filename":118,"language":119,"meta":120,"style":120}," ------ ---------------------------------------------------------------------------------------------------\n  Line   app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php\n ------ ---------------------------------------------------------------------------------------------------\n  :13    Method App\\Http\\Controllers\\RegisteredViaGitHubController::create() has no return type specified.\n         🪪  missingType.return\n  :18    Method App\\Http\\Controllers\\RegisteredViaGitHubController::store() has no return type specified.\n         🪪  missingType.return\n ------ ---------------------------------------------------------------------------------------------------\n",[122,3084,3085,3093,3101,3107,3149,3157,3191,3197],{"__ignoreMap":120},[125,3086,3087,3090],{"class":127,"line":128},[125,3088,3089],{"class":131}," ------",[125,3091,3092],{"class":682}," ---------------------------------------------------------------------------------------------------\n",[125,3094,3095,3098],{"class":127,"line":161},[125,3096,3097],{"class":131},"  Line",[125,3099,3100],{"class":135},"   app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php\n",[125,3102,3103,3105],{"class":127,"line":167},[125,3104,3089],{"class":131},[125,3106,3092],{"class":682},[125,3108,3109,3112,3115,3118,3120,3122,3124,3127,3129,3132,3135,3138,3140,3143,3146],{"class":127,"line":173},[125,3110,3111],{"class":131},"  :13",[125,3113,3114],{"class":135},"    Method",[125,3116,3117],{"class":135}," App",[125,3119,683],{"class":682},[125,3121,686],{"class":135},[125,3123,695],{"class":682},[125,3125,3126],{"class":135},"ontrollers",[125,3128,689],{"class":682},[125,3130,3131],{"class":135},"egisteredViaGitHubController::create",[125,3133,3134],{"class":719},"() ",[125,3136,3137],{"class":135},"has",[125,3139,2443],{"class":135},[125,3141,3142],{"class":135}," return",[125,3144,3145],{"class":135}," type",[125,3147,3148],{"class":135}," specified.\n",[125,3150,3151,3154],{"class":127,"line":179},[125,3152,3153],{"class":131},"         🪪",[125,3155,3156],{"class":135},"  missingType.return\n",[125,3158,3159,3162,3164,3166,3168,3170,3172,3174,3176,3179,3181,3183,3185,3187,3189],{"class":127,"line":185},[125,3160,3161],{"class":131},"  :18",[125,3163,3114],{"class":135},[125,3165,3117],{"class":135},[125,3167,683],{"class":682},[125,3169,686],{"class":135},[125,3171,695],{"class":682},[125,3173,3126],{"class":135},[125,3175,689],{"class":682},[125,3177,3178],{"class":135},"egisteredViaGitHubController::store",[125,3180,3134],{"class":719},[125,3182,3137],{"class":135},[125,3184,2443],{"class":135},[125,3186,3142],{"class":135},[125,3188,3145],{"class":135},[125,3190,3148],{"class":135},[125,3192,3193,3195],{"class":127,"line":191},[125,3194,3153],{"class":131},[125,3196,3156],{"class":135},[125,3198,3199,3201],{"class":127,"line":197},[125,3200,3089],{"class":131},[125,3202,3092],{"class":682},[10,3204,3205,3206,3209],{},"Les méthodes n'ont pas de type de retour. Ajoutez ",[122,3207,3208],{},": RedirectResponse"," aux deux méthodes :",[114,3211,3213],{"className":149,"code":3212,"filename":944,"language":151,"meta":120,"style":120},"\u003C?php\n\nuse Symfony\\Component\\HttpFoundation\\RedirectResponse;\n\nclass RegisteredViaGitHubController extends Controller\n{\n    public function create(): RedirectResponse\n    {\n        \u002F\u002F ...\n    }\n\n    public function store(): RedirectResponse\n    {\n        \u002F\u002F ...\n    }\n}\n",[122,3214,3215,3219,3223,3228,3232,3236,3240,3245,3249,3253,3257,3261,3266,3270,3274,3278],{"__ignoreMap":120},[125,3216,3217],{"class":127,"line":128},[125,3218,542],{},[125,3220,3221],{"class":127,"line":161},[125,3222,548],{"emptyLinePlaceholder":547},[125,3224,3225],{"class":127,"line":167},[125,3226,3227],{},"use Symfony\\Component\\HttpFoundation\\RedirectResponse;\n",[125,3229,3230],{"class":127,"line":173},[125,3231,548],{"emptyLinePlaceholder":547},[125,3233,3234],{"class":127,"line":179},[125,3235,976],{},[125,3237,3238],{"class":127,"line":185},[125,3239,981],{},[125,3241,3242],{"class":127,"line":191},[125,3243,3244],{},"    public function create(): RedirectResponse\n",[125,3246,3247],{"class":127,"line":197},[125,3248,991],{},[125,3250,3251],{"class":127,"line":579},[125,3252,3036],{},[125,3254,3255],{"class":127,"line":584},[125,3256,1001],{},[125,3258,3259],{"class":127,"line":590},[125,3260,548],{"emptyLinePlaceholder":547},[125,3262,3263],{"class":127,"line":595},[125,3264,3265],{},"    public function store(): RedirectResponse\n",[125,3267,3268],{"class":127,"line":601},[125,3269,991],{},[125,3271,3272],{"class":127,"line":1190},[125,3273,3036],{},[125,3275,3276],{"class":127,"line":1195},[125,3277,1001],{},[125,3279,3280],{"class":127,"line":1201},[125,3281,1006],{},[10,3283,3284,3285,3288],{},"Le script ",[122,3286,3287],{},"test:unit"," échoue encore, car cette route par défaut n'a pas de test :",[114,3290,3292],{"className":149,"code":3291,"filename":730,"language":151,"meta":120,"style":120},"Route::get('\u002F', function () {\n    return view('welcome');\n});\n",[122,3293,3294,3299,3304],{"__ignoreMap":120},[125,3295,3296],{"class":127,"line":128},[125,3297,3298],{},"Route::get('\u002F', function () {\n",[125,3300,3301],{"class":127,"line":161},[125,3302,3303],{},"    return view('welcome');\n",[125,3305,3306],{"class":127,"line":167},[125,3307,604],{},[10,3309,3310],{},"Nous pouvons la supprimer sans risque, car les utilisateurs doivent être redirigés vers la page d'accueil de l'application front-end, et non vers celle de l'application Laravel.",[10,3312,3313],{},"Une fois cette route supprimée, tout est au vert ! 🟢",[10,3315,3316],{},[529,3317,3318],{},"J'adore vraiment, vraiment cette sensation.",[40,3320,3322],{"id":3321},"dernières-réflexions","Dernières réflexions",[10,3324,3325,3326,3328],{},"L'authentification GitHub est maintenant en place. Nous avons un modèle ",[122,3327,2002],{}," local, un flux OAuth complet et des tests qui décrivent le comportement attendu. Le workflow piloté par les tests peut sembler plus lent au début, mais il nous donne confiance à mesure que l'implémentation grandit.",[10,3330,3331],{},"Socialite gère les détails propres au fournisseur afin que nous puissions nous concentrer sur les utilisateurs et les sessions de notre application. Le système de commentaires dispose ainsi d'un propriétaire fiable pour chaque commentaire.",[10,3333,3334],{},"Ensuite, nous allons concevoir et implémenter l'API Laravel permettant de lister, créer, modifier et supprimer des commentaires.",[3336,3337,3338],"style",{},"html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":120,"searchDepth":161,"depth":161,"links":3340},[3341,3342,3343,3347,3348],{"id":42,"depth":161,"text":43},{"id":108,"depth":161,"text":109},{"id":427,"depth":161,"text":428,"children":3344},[3345,3346],{"id":440,"depth":167,"text":441},{"id":1085,"depth":167,"text":1086},{"id":3067,"depth":161,"text":3068},{"id":3321,"depth":161,"text":3322},"d9a64441-89b3-4f82-a356-10bde7db7669","2025-02-25","Ajoutez l'authentification GitHub à Laravel avec Socialite, les callbacks OAuth, la synchronisation des utilisateurs et des tests fiables.","md",null,{},"\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Feffortless-social-authentication-with-laravel-socialite","---\ncontentId: d9a64441-89b3-4f82-a356-10bde7db7669\npart: 3\ntitle: Authentification sociale simplifiée avec Laravel Socialite\ndescription: Ajoutez l'authentification GitHub à Laravel avec Socialite, les callbacks OAuth, la synchronisation des utilisateurs et des tests fiables.\ndate: 2025-02-25\nseriesSlug: empower-and-dynamize-our-vitepress-blog-with-a-laravel-api\n---\n\nAvec la structure du projet et les outils qualité en place, nous pouvons commencer à construire la première fonctionnalité de l'API destinée aux utilisateurs : l'authentification. Comme les commentaires doivent appartenir à de vrais utilisateurs, c'est la suite logique.\n\nLe problème, c'est que l'authentification est difficile, vraiment difficile. Il faut gérer les mots de passe, la vérification des adresses e-mail, la réinitialisation des mots de passe, l'authentification à deux facteurs, et bien plus encore. Heureusement, les frameworks comme Laravel proposent des fonctionnalités d'[authentification intégrées](https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Fauthentication) et des packages officiels comme [Fortify](https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Ffortify) pour simplifier le processus.\n\nMême avec ces outils, nous devons encore construire et gérer de nombreuses parties nous-mêmes : l'inscription, la connexion, la réinitialisation des mots de passe, la gestion du profil et les cas particuliers associés. Nous avons également besoin d'un service mail pour envoyer les e-mails.\n\nTout cela est possible, mais demande du temps et des efforts. Pour un blog simple comme le nôtre, nous pouvons plutôt utiliser GitHub pour l'authentification sociale. L'implémentation est plus simple et les utilisateurs peuvent se connecter avec un compte qu'ils possèdent déjà.\n\nAvant de plonger dans l'implémentation, prenons un moment pour comprendre ce qu'est l'authentification sociale et pourquoi elle est utile.\n\n## L'authentification sociale en quelques mots\n\nTraditionnellement, lorsqu'un utilisateur veut créer un compte sur un site, il doit remplir un formulaire d'inscription avec son adresse e-mail et un mot de passe. Ce fonctionnement est efficace depuis des années, mais il a ses inconvénients. De notre côté, nous devons gérer toutes ces données, tandis que l'utilisateur doit retenir un mot de passe supplémentaire.\n\nAvec l'authentification sociale, les utilisateurs peuvent se connecter avec leurs comptes existants sur des plateformes comme GitHub, Google, Apple ou Facebook. Ils n'ont donc pas besoin de créer un nouveau compte ni de retenir un autre mot de passe. Ils utilisent leurs identifiants existants pour se connecter rapidement et facilement, ce qui réduit les frictions et améliore l'expérience.\n\nPour les plus techniques d'entre vous, voici un schéma de fonctionnement :\n\nLe flux est simple :\n\n1. L'utilisateur clique sur le bouton « Se connecter avec GitHub » de votre site.\n2. L'utilisateur est redirigé vers la page d'autorisation de GitHub, où il peut autoriser votre application à accéder à son compte GitHub.\n3. Si l'utilisateur accorde cette autorisation, GitHub le redirige vers votre site avec un code d'autorisation.\n4. Votre site échange ce code contre un jeton d'accès, qui peut être utilisé pour accéder au compte GitHub de l'utilisateur.\n5. Votre site peut maintenant utiliser le jeton d'accès pour récupérer les informations du profil de l'utilisateur auprès de GitHub.\n6. Votre site crée un nouveau compte utilisateur ou met à jour un compte existant, puis connecte l'utilisateur à partir des informations reçues de GitHub.\n7. Votre site redirige l'utilisateur vers la page appropriée après la connexion.\n8. L'utilisateur est connecté et peut interagir avec votre site.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nNotez que l'utilisateur est connecté à notre application, et non à GitHub. C'est essentiel pour éviter d'envoyer le jeton d'accès au client, pour gérer plusieurs fournisseurs ou pour ajouter un fournisseur à une authentification classique par e-mail et mot de passe.\n::\n\nSimple, n'est-ce pas ? Laravel propose un package officiel appelé [Socialite](https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Fsocialite), qui rend ce processus encore plus facile. Il gère les détails OAuth propres à chaque fournisseur afin que notre application puisse se concentrer sur ses propres utilisateurs.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nGardez à l'esprit que l'authentification sociale n'est pas une solution miracle adaptée à tous les projets. Même si elle peut être séduisante au premier abord, elle apporte aussi son lot de difficultés.\n::\n\n## Ajouter Socialite au projet\n\nCommençons par installer le package :\n\n```bash [terminal]\ncomposer require laravel\u002Fsocialite\n```\n\nConfigurez-le ensuite dans `config\u002Fservices.php` :\n\n```php [config\u002Fservices.php]\nreturn [\n  \u002F\u002F ...\n  'github' => [\n      'client_id' => env('GITHUB_CLIENT_ID'),\n      'client_secret' => env('GITHUB_CLIENT_SECRET'),\n      'redirect' => env('GITHUB_REDIRECT'),\n  ],\n];\n```\n\nLa fonction `env` lit ces valeurs depuis `.env`. Ajoutez les identifiants GitHub et l'URL de callback :\n\n```ini [.env]\nGITHUB_CLIENT_ID=your-client-id\nGITHUB_CLIENT_SECRET=your-client-secret\nGITHUB_REDIRECT=http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fcallback\n```\n\nL'utilisateur est connecté à travers notre application, et non à travers GitHub. Cette distinction est importante : nous n'envoyons pas le jeton d'accès du fournisseur au client et nous pourrons prendre en charge plusieurs fournisseurs d'authentification plus tard.\n\nÀ ce stade, deux questions reviennent généralement :\n\n1. Comment obtenir `GITHUB_CLIENT_ID` et `GITHUB_CLIENT_SECRET` ?\n2. Pourquoi avons-nous besoin de l'URL `GITHUB_REDIRECT` et comment l'obtenir ?\n\nGitHub fournit `GITHUB_CLIENT_ID` et `GITHUB_CLIENT_SECRET` lorsque vous créez une application OAuth. Ouvrez vos [paramètres GitHub](https:\u002F\u002Fgithub.com\u002Fsettings\u002Fprofile), accédez à `Developer settings`, sélectionnez `OAuth Apps`, puis cliquez sur `New OAuth App`.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nUne application OAuth utilise le protocole OAuth pour authentifier les utilisateurs. Dans notre cas, GitHub joue le rôle de fournisseur OAuth. Une application OAuth nous permet d'utiliser le système d'authentification de GitHub pour connecter les utilisateurs à notre site.\n::\n\nRemplissez le formulaire. GitHub est assez permissif avec les valeurs fournies pendant le développement local.\n\n1. `Application name` peut contenir n'importe quelle valeur. Je vous recommande d'utiliser le nom de votre site, car il est affiché aux utilisateurs lorsqu'ils se connectent, au moins la première fois.\n2. `Homepage URL` est l'URL de votre site. Vous pouvez utiliser `http:\u002F\u002Flocalhost:8000` en développement local.\n3. `Authorization callback URL` est l'adresse vers laquelle GitHub redirige les utilisateurs après l'autorisation de l'application. Elle doit correspondre à la valeur de `.env`. En développement local, utilisez `http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fcallback`.\n\nCliquez sur `Register application` pour créer l'application OAuth. Sa page contient le `Client ID`, qui ressemble à ceci :\n\n```txt [Client ID]\na1b2c3d4e5f6g7h8i9j0\n```\n\nVous devez générer un nouveau `Client secret`. Cliquez sur `Generate a new client secret` et copiez la valeur. Elle ressemble à ceci :\n\n```txt [Client Secret]\nd13f84af84688a69a71bc8b3808f8836e4c23774\n```\n\nAjoutez enfin ces valeurs à `.env` :\n\n```ini [.env]\nGITHUB_CLIENT_ID=a1b2c3d4e5f6g7h8i9j0\nGITHUB_CLIENT_SECRET=d13f84af84688a69a71bc8b3808f8836e4c23774\nGITHUB_REDIRECT=http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fcallback\n```\n\nN'oubliez pas d'ajouter également les variables d'environnement dans votre fichier `.env.example`.\n\n```ini [.env.example]\nGITHUB_CLIENT_ID=\nGITHUB_CLIENT_SECRET=\nGITHUB_REDIRECT=http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fcallback\n```\n\nNe commitez pas le client ID ni le secret. Laissez ces valeurs vides dans `.env.example`, mais conservez l'URL de redirection afin que toute personne qui clone le dépôt sache comment configurer une application OAuth locale.\n\nMaintenant que tout est configuré, écrivons le code qui gère l'authentification.\n\n## Gérer l'authentification\n\nPour la suite du projet, nous utiliserons une approche centrée sur les tests : écrire un test, observer son échec, puis ajouter uniquement le code nécessaire pour le faire réussir. Cette méthode nous aide à définir le comportement avant l'implémentation et évite les surprises. Elle peut sembler intimidante au début, mais Laravel rend le workflow accessible grâce à ses outils de test intégrés.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nIl s'agit peut-être de développement piloté par les tests (TDD), mais le nom est moins important ici que le workflow : écrire d'abord le test, puis implémenter uniquement ce qui est nécessaire pour le faire réussir.\n::\n\n### La redirection\n\nCréons un nouveau contrôleur appelé `RegisteredViaGitHubController` :\n\n```bash [terminal]\nphp artisan make:controller RegisteredViaGitHubController\n```\n\nCe contrôleur contiendra deux méthodes :\n\n1. `create` : Gère la redirection vers GitHub.\n2. `store` : Gère le callback de GitHub.\n\nJ'utilise généralement des noms de méthodes traditionnels pour faciliter la lecture et rester cohérent. Les garder en tête sera utile, car les tests seront organisés autour de ces méthodes.\n\nDans le dossier `tests\u002FHttp`, nous pouvons supprimer le fichier `ExampleTest.php`, puis créer un dossier `RegisteredViaGitHub` et un nouveau fichier de test `CreateTest.php`.\n\n```bash [terminal]\nmkdir tests\u002FHttp\u002FRegisteredViaGitHub\ntouch tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n```\n\nDans ce fichier, écrivons notre premier test. _C'est vraiment passionnant !_\n\n```php [tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nuse Laravel\\Socialite\\Facades\\Socialite;\n\ntest('redirects for authorization', function () {\n    Socialite::shouldReceive('driver->redirect')->once();\n\n    $this->get(route('auth.github.redirect'));\n\n    expect(true)->toBeTrue();\n});\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\n`expect(true)->toBeTrue()` fournit une assertion au test sans ajouter de comportement à vérifier. Si `Socialite::shouldReceive('driver->redirect')->once()` n'est pas satisfait, le mock fera de toute façon échouer le test.\n::\n\nC'est notre premier test, mais pas le plus simple. Il simule la façade `Socialite` et vérifie que `redirect` est appelé une fois. Nous utilisons un mock, car le test ne doit pas nous envoyer vers GitHub : il doit seulement vérifier que notre code demande à Socialite d'effectuer la redirection.\n\nLançons le test :\n\n```bash [terminal]\nphp artisan test tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n```\n\nIl échoue, comme prévu. Dans un workflow piloté par les tests, l'échec nous indique ce qu'il faut implémenter ensuite. Suivons le message d'erreur et ajoutons uniquement le code nécessaire pour faire réussir le test.\n\n```bash [terminal]\n➜ php artisan test tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n\nFAILED  Tests\\Http\\RegisteredViaGitHub\\CreateTest > redirects for authorization\n  Route [auth.github.redirect] not defined.\n```\n\nLe message est clair : nous devons définir la route `auth.github.redirect`. Faisons-le dans `routes\u002Fweb.php` :\n\n```php [routes\u002Fweb.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nuse App\\Http\\Controllers\\RegisteredViaGitHubController;\nuse Illuminate\\Support\\Facades\\Route;\n\n\u002F\u002F other routes...\n\nRoute::get('\u002Fauth\u002Fgithub\u002Fredirect', [RegisteredViaGitHubController::class, 'create'])\n    ->name('auth.github.redirect');\n```\n\nMais qu'est-ce que `web.php` ? C'est le fichier dans lequel nous définissons les routes accessibles depuis un navigateur et associons les URL aux méthodes des contrôleurs. Sa lecture offre une vue d'ensemble utile des points d'entrée de l'application.\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nJe vous recommande vivement de regarder [Lessons From the Framework](https:\u002F\u002Fyoutu.be\u002FNjkxzc-aqts?si=qA5qWuVrm02VtJUX) de [Luke Dowing](https:\u002F\u002Fgithub.com\u002Flukeraymonddowning) pour comprendre l'importance de ce fichier.\n::\n\nCette route répond à `\u002Fauth\u002Fgithub\u002Fredirect` et appelle la méthode `create` de `RegisteredViaGitHubController`. Nous lui donnons également le nom `auth.github.redirect`, ce qui permet de la référencer dans le test et ailleurs dans l'application.\n\nRelançons le test :\n\n```bash [terminal]\n➜ php artisan test tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n\n FAILED  Tests\\Http\\RegisteredViaGitHub\\CreateTest > redirects for authorization\n  Method redirect(\u003CAny Arguments>) from Mockery_1__demeter_c357969a11a830028afbe426ab0eea17_driver should be called\n exactly 1 times but called 0 times.\n```\n\nLe nouveau message signifie que la route fonctionne, mais que le contrôleur n'appelle pas encore Socialite. Ajoutons cet appel au contrôleur :\n\n```php [app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php]\n\u003C?php\n\nnamespace App\\Http\\Controllers;\n\nuse Laravel\\Socialite\\Facades\\Socialite;\n\nclass RegisteredViaGitHubController extends Controller\n{\n    public function create()\n    {\n        return Socialite::driver('github')->redirect();\n    }\n}\n```\n\nRelançons le test :\n\n```bash [terminal]\n➜ php artisan test tests\u002FHttp\u002FRegisteredViaGitHub\u002FCreateTest.php\n\n   PASS  Tests\\Http\\RegisteredViaGitHub\\CreateTest\n  ✓ redirects for authorization\n```\n\nEt voilà ! Le test réussit. Démarrez le serveur de développement avec `composer dev` et ouvrez `http:\u002F\u002Flocalhost:8000\u002Fauth\u002Fgithub\u002Fredirect` pour vérifier manuellement la redirection. Vous devriez arriver sur la page d'autorisation de GitHub. 🥳\n\n![Après la redirection, vous devriez arriver sur la page d'autorisation de GitHub](\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Feffortless-social-authentication-with-laravel-socialite\u002Fgithub-authorization.png)\n\n### Le callback\n\nMaintenant que vous comprenez le workflow, je ne répéterai pas l'instruction de lancer le test après chaque petite modification. Continuez à suivre cette boucle pour le reste du projet et dans vos propres projets.\n\nCréons un fichier de test `StoreTest.php` dans le dossier `tests\u002FHttp\u002FRegisteredViaGitHub`.\n\n```bash [terminal]\ntouch tests\u002FHttp\u002FRegisteredViaGitHub\u002FStoreTest.php\n```\n\n`StoreTest.php` testera la méthode `store` de `RegisteredViaGitHubController`, qui gère le callback de GitHub. Socialite s'occupe de l'échange OAuth ; notre application doit donc seulement récupérer l'utilisateur du fournisseur, l'enregistrer et l'authentifier.\n\nCommençons par écrire un test qui vérifie qu'un utilisateur peut être connecté :\n\n```php [tests\u002FHttp\u002FRegisteredViaGitHub\u002FStoreTest.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nuse Laravel\\Socialite\\Facades\\Socialite;\nuse Laravel\\Socialite\\Two\\User as SocialiteUser;\n\ntest('registers successfully', function () {\n    $fakeGitHubUser = fakeGitHubUser();\n\n    $this->get(route('auth.github.callback'));\n\n    $this->assertAuthenticated();\n\n    $this->assertDatabaseHas('users', [\n        'github_id' => $fakeGitHubUser->getId(),\n        'email' => $fakeGitHubUser->getEmail(),\n        'name' => $fakeGitHubUser->getName(),\n    ]);\n});\n\n\u002F**\n * Create a fake GitHub user and mock the Socialite driver.\n *\n * @param  array\u003Cstring, mixed>  $attributes\n *\u002F\nfunction fakeGitHubUser(array $attributes = []): SocialiteUser\n{\n    $fakeGitHubUser = (new SocialiteUser)->map(attributes: array_merge([\n        'id' => '12345',\n        'nickname' => 'testuser',\n        'email' => 'test@example.com',\n        'name' => 'Test User',\n        'avatar' => 'https:\u002F\u002Fexample.com\u002Favatar.jpg',\n    ], $attributes));\n\n    Socialite::shouldReceive('driver->user')->once()->andReturn($fakeGitHubUser);\n\n    return $fakeGitHubUser;\n}\n```\n\nCe test crée un faux utilisateur GitHub et configure Socialite pour qu'il le retourne lorsque `user` est appelé. Nous évitons ainsi une vraie requête HTTP vers GitHub, tandis que l'aide `fakeGitHubUser` rend cette configuration réutilisable et le test lisible.\n\nNous appelons ensuite la route `auth.github.callback` et vérifions que l'utilisateur est authentifié et enregistré dans la base de données.\n\nSuivons maintenant le message d'erreur du test.\n\n1. La route `auth.github.callback` n'est pas définie. Définissons-la dans `routes\u002Fweb.php` :\n\n```php [routes\u002Fweb.php]\nRoute::get('\u002Fauth\u002Fgithub\u002Fcallback', [RegisteredViaGitHubController::class, 'store'])\n    ->name('auth.github.callback');\n```\n\n2. L'utilisateur n'est pas authentifié. Implémentons la méthode `store` du contrôleur :\n\n```php [app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Http\\Controllers;\n\nuse Illuminate\\Support\\Facades\\Auth;\nuse Laravel\\Socialite\\Facades\\Socialite;\n\nfinal class RegisteredViaGitHubController extends Controller\n{\n    public function store()\n    {\n        $githubUser = Socialite::driver('github')->user();\n\n        Auth::login($githubUser);\n    }\n}\n```\n\n`Socialite::driver('github')->user()` gère le flux OAuth et retourne l'[utilisateur](https:\u002F\u002Fgithub.com\u002Flaravel\u002Fsocialite\u002Fblob\u002F5.x\u002Fsrc\u002FAbstractUser.php) du fournisseur. Nous utilisons ensuite la façade `Auth` de Laravel pour connecter cet utilisateur.\n\n3. L'utilisateur n'est toujours pas authentifié. La méthode `login` attend un utilisateur de l'application qui implémente [`Authenticatable`](https:\u002F\u002Fgithub.com\u002Flaravel\u002Fframework\u002Fblob\u002F12.x\u002Fsrc\u002FIlluminate\u002FAuth\u002FAuthenticatable.php), mais nous lui passons un utilisateur Socialite.\n\nNous ne pouvons pas transmettre directement l'utilisateur Socialite à `login`. Nous devons d'abord créer ou récupérer un utilisateur de l'application, puis passer ce modèle à `login`.\n\n```php [app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Http\\Controllers;\n\nuse App\\Models\\User;\nuse Illuminate\\Support\\Facades\\Auth;\nuse Laravel\\Socialite\\Facades\\Socialite;\n\nfinal class RegisteredViaGitHubController extends Controller\n{\n    public function store()\n    {\n        $githubUser = Socialite::driver('github')->user();\n\n        $user = User::create([\n            'name' => $githubUser->getName(),\n            'email' => $githubUser->getEmail(),\n            'username' => $githubUser->getNickname(),\n            'github_id' => $githubUser->getId(),\n            'avatar' => $githubUser->getAvatar(),\n        ]);\n\n        Auth::login($user);\n    }\n}\n```\n\n4. L'utilisateur n'est toujours pas authentifié. Cette fois, consultez le fichier de log. Dans Laravel, le log se trouve dans `storage\u002Flogs\u002Flaravel.log` :\n\n```log [storage\u002Flogs\u002Flaravel.log]\n[2025-02-28 06:51:21] testing.ERROR: SQLSTATE[HY000]: General error: 1 no such table: users (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"updated_at\", \"created_at\") values (Test User, test@example.com, 2025-02-28 06:51:21, 2025-02-28 06:51:21))\n```\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nN'hésitez pas à supprimer tout le contenu du fichier avant de relancer le test. Vous ne verrez ainsi que les logs pertinents.\n::\n\nCe message est plus explicite que le précédent : la table `users` n'existe pas, la requête échoue donc avant l'authentification de l'utilisateur.\n\nAvant de créer la table, inspectons les migrations de la base de données :\n\n1. `0001_01_01_000000_create_users_table` : Cette migration crée la table `users`. La table existe dans le schéma, mais la base de test n'a pas encore exécuté la migration.\n2. `0001_01_01_000001_create_cache_table` : Cette migration crée la table `cache`. Elle ne nous intéresse pas ici.\n3. `0001_01_01_000002_create_failed_jobs_table` : Cette migration crée la table `failed_jobs`. Elle ne nous intéresse pas non plus.\n\nBonne nouvelle : nous pouvons exécuter automatiquement les migrations avant chaque test afin de conserver une base propre. Ajoutez le trait `RefreshDatabase` à `Pest.php` :\n\n```php [tests\u002FPest.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\npest()->extend(Tests\\TestCase::class)\n    ->use(Illuminate\\Foundation\\Testing\\RefreshDatabase::class)\n    ->in('Http');\n```\n\n5. L'utilisateur n'est toujours pas authentifié. Consultez à nouveau le log :\n\n```log [storage\u002Flogs\u002Flaravel.log]\ntesting.ERROR: SQLSTATE[23000]: Integrity constraint violation: 19 NOT NULL constraint failed: users.password (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"updated_at\", \"created_at\") values (Test User, test@example.com, 2025-02-28 06:59:57, 2025-02-28 06:59:57))\n```\n\nCette erreur SQL indique que `password` ne peut pas être `null`, alors que l'authentification GitHub ne fournit pas de mot de passe. Nous devons adapter la migration à l'authentification OAuth.\n\n```php [database\u002Fmigrations\u002F0001_01_01_000000_create_users_table.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nuse Illuminate\\Database\\Migrations\\Migration;\nuse Illuminate\\Database\\Schema\\Blueprint;\nuse Illuminate\\Support\\Facades\\Schema;\n\nreturn new class extends Migration\n{\n    \u002F**\n     * Run the migrations.\n     *\u002F\n    public function up(): void\n    {\n        Schema::create('users', function (Blueprint $table): void {\n            $table->id();\n            $table->string('name')->nullable(); \u002F\u002F [!code ++]\n            $table->string('username')->unique(); \u002F\u002F [!code ++]\n            $table->string('email')->unique();\n            $table->timestamp('email_verified_at')->nullable();\n            $table->string('password'); \u002F\u002F [!code --]\n            $table->rememberToken(); \u002F\u002F [!code --]\n            $table->string('github_id')->nullable()->unique(); \u002F\u002F [!code ++]\n            $table->string('avatar')->nullable(); \u002F\u002F [!code ++]\n            $table->timestamps();\n        });\n\n        \u002F\u002F other migrations...\n    }\n};\n\n```\n\nDans cette migration, nous ajoutons trois colonnes :\n\n- `username` : Stocke le nom d'utilisateur GitHub.\n- `github_id` : Stocke l'identifiant GitHub de l'utilisateur. Il est unique pour empêcher deux utilisateurs de l'application de partager le même compte GitHub et nullable afin de pouvoir ajouter d'autres méthodes d'authentification plus tard. Rendre une colonne nullable après coup est plus complexe avec SQLite, nous ajoutons donc cette contrainte maintenant.\n- `avatar` : Stocke l'URL de l'avatar de l'utilisateur.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nNous modifions directement le fichier de migration au lieu d'en créer un nouveau, car l'application n'est pas encore déployée. Si elle l'était, nous aurions créé une migration pour modifier la table.\n::\n\n6. L'utilisateur n'est toujours pas authentifié. Déboguer l'authentification dans une application fraîche peut sembler répétitif, mais chaque erreur révèle une pièce manquante. Une fois le processus compris, il devient beaucoup plus simple.\n\nDans `laravel.log`, nous pouvons lire :\n\n```log [storage\u002Flogs\u002Flaravel.log]\n[2025-02-28 07:09:29] testing.ERROR: SQLSTATE[23000]: Integrity constraint violation: 19 NOT NULL constraint failed: users.username (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"updated_at\", \"created_at\") values (Test User, test@example.com, 2025-02-28 07:09:29, 2025-02-28 07:09:29))\n```\n\nCette erreur SQL ressemble à la précédente, mais cette fois `username` manque. C'est surprenant, car la migration et `User::create` contiennent tous deux ce champ.\n\nLe problème vient de la protection contre l'assignation en masse de Laravel. Par défaut, nous devons autoriser explicitement `username`, `github_id` et `avatar` dans le modèle `User` :\n\n```php [app\u002FModels\u002FUser.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Models;\n\n\u002F\u002F use Illuminate\\Contracts\\Auth\\MustVerifyEmail;\nuse Illuminate\\Database\\Eloquent\\Factories\\HasFactory;\nuse Illuminate\\Foundation\\Auth\\User as Authenticatable;\nuse Illuminate\\Notifications\\Notifiable;\n\nclass User extends Authenticatable\n{\n    \u002F** @use HasFactory\u003C\\Database\\Factories\\UserFactory> *\u002F\n    use HasFactory, Notifiable;\n\n    \u002F**\n     * The attributes that are mass assignable.\n     *\n     * @var list\u003Cstring>\n     *\u002F\n    protected $fillable = [\n        'name',\n        'email',\n        'username', \u002F\u002F [!code ++]\n        'github_id', \u002F\u002F [!code ++]\n        'avatar', \u002F\u002F [!code ++]\n        'password', \u002F\u002F [!code --]\n    ];\n\n    \u002F\u002F ...\n}\n```\n\nCette approche fonctionne, mais elle oblige à modifier `fillable` chaque fois qu'une colonne assignable est ajoutée au modèle. La protection contre l'assignation en masse est particulièrement importante lorsque des données de requête sont transmises directement à un modèle. Par exemple, un utilisateur ne doit jamais pouvoir définir le champ `is_admin` lors de son inscription.\n\n```php [Exemple]\nfunction (Request $request): void {\n    User::create($request->all()); \u002F\u002F Never write this code.\n}\n```\n\nSans cette protection, un utilisateur pourrait devenir administrateur en envoyant `is_admin=true` dans la requête. Ce serait un grave problème de sécurité.\n\nPour supprimer cette configuration répétitive tout en gardant les entrées sûres, nous pouvons désactiver le mode guarded avec `Model::unguard()` dans `app\u002FProviders\u002FAppServiceProvider.php` :\n\n```php [app\u002FProviders\u002FAppServiceProvider.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Providers;\n\nuse Illuminate\\Database\\Eloquent\\Model;\nuse Illuminate\\Support\\ServiceProvider;\n\nclass AppServiceProvider extends ServiceProvider\n{\n    public function boot(): void\n    {\n        Model::unguard();\n    }\n}\n```\n\nÀ partir de maintenant, tous les modèles seront non protégés et nous pouvons supprimer `fillable` de `User`. Cependant, toute entrée contrôlée par l'utilisateur doit passer par une form request. Valider les données avant de les enregistrer garantit que les utilisateurs ne peuvent pas définir des champs arbitraires ou des valeurs inattendues.\n\nDans ce flux OAuth, les données proviennent d'un fournisseur auquel nous faisons confiance, nous n'avons donc pas besoin de form request. Nous en utiliserons plus tard pour implémenter le système de commentaires.\n\nEt voilà ! Le test réussit et les utilisateurs peuvent maintenant créer un compte avec GitHub. 🥳\n\nNous n'avons cependant pas terminé. Si un utilisateur se reconnecte, l'application tentera de créer un doublon. Nous devons gérer les utilisateurs existants.\n\nCommençons par écrire un test pour vérifier qu'un utilisateur peut se reconnecter :\n\n```php [tests\u002FHttp\u002FRegisteredViaGitHub\u002FStoreTest.php]\n\u003C?php\n\nuse App\\Models\\User;\n\n\u002F\u002F other tests...\n\ntest('updates the user if they already exist', function () {\n    $fakeGitHubUser = fakeGitHubUser();\n\n    $user = User::factory()->create(['github_id' => $fakeGitHubUser->getId()]);\n\n    $this->get(route('auth.github.callback'));\n\n    $this->assertAuthenticated();\n\n    $this->assertDatabaseHas('users', [\n        'id' => $user->id,\n        'github_id' => $fakeGitHubUser->getId(),\n        'email' => $fakeGitHubUser->getEmail(),\n        'name' => $fakeGitHubUser->getName(),\n    ]);\n});\n\n```\n\nCe test crée un utilisateur avec le même `github_id` que le faux utilisateur GitHub. Il appelle ensuite la route callback et vérifie que l'utilisateur existant est authentifié et mis à jour.\n\nSuivons le message d'erreur :\n\n```bash [terminal]\nSQLSTATE[HY000]: General error: 1 table users has no column named password (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"email_verified_at\", \"password\", \"remember_token\", \"github_id\", \"updated_at\", \"created_at\") values (Lawrence Herzog, roconnell@example.net, 2025-03-01 18:44:12, $2y$04$NXCZUWIcdKPiCdw3n5cTBOIpQo9\u002FDPc9rmgX5VRTQ3iTeWduC4x36, 0i9tgsiLpA, 12345, 2025-03-01 18:44:12, 2025-03-01 18:44:12))\n```\n\nCette erreur SQL mentionne la colonne `password`. C'est étrange, puisque nous l'avons supprimée de la migration. L'erreur vient de la factory utilisateur, qui contient toujours les champs de mot de passe par défaut de Laravel. Ouvrez `database\u002Ffactories\u002FUserFactory.php` et supprimez-les :\n\n```php [database\u002Ffactories\u002FUserFactory.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace Database\\Factories;\n\nuse Illuminate\\Database\\Eloquent\\Factories\\Factory;\nuse Illuminate\\Support\\Facades\\Hash; \u002F\u002F [!code --]\nuse Illuminate\\Support\\Str; \u002F\u002F [!code --]\n\n\u002F**\n * @extends \\Illuminate\\Database\\Eloquent\\Factories\\Factory\u003C\\App\\Models\\User>\n *\u002F\nclass UserFactory extends Factory\n{\n    \u002F** \u002F\u002F [!code --]\n     * The current password being used by the factory. \u002F\u002F [!code --]\n     *\u002F \u002F\u002F [!code --]\n    protected static ?string $password = null; \u002F\u002F [!code --]\n\n    \u002F**\n     * Define the model's default state.\n     *\n     * @return array\u003Cstring, mixed>\n     *\u002F\n    public function definition(): array\n    {\n        return [\n            'name' => fake()->name(),\n            'username' => fake()->unique()->userName(), \u002F\u002F [!code ++]\n            'email' => fake()->unique()->safeEmail(),\n            'github_id' => fake()->unique()->numberBetween(1, 1000000), \u002F\u002F [!code ++]\n            'avatar' => fake()->imageUrl(), \u002F\u002F [!code ++]\n            'email_verified_at' => now(),\n            'password' => self::$password ??= Hash::make('password'), \u002F\u002F [!code --]\n            'remember_token' => Str::random(10), \u002F\u002F [!code --]\n        ];\n    }\n \u002F\u002F [!code --]\n    \u002F** \u002F\u002F [!code --]\n     * Indicate that the model's email address should be unverified. \u002F\u002F [!code --]\n     *\u002F \u002F\u002F [!code --]\n    public function unverified(): static \u002F\u002F [!code --]\n    { \u002F\u002F [!code --]\n        return $this->state(fn (array $attributes): array => [ \u002F\u002F [!code --]\n            'email_verified_at' => null, \u002F\u002F [!code --]\n        ]);  \u002F\u002F [!code --]\n    } \u002F\u002F [!code --]\n}\n```\n\nAprès cette modification, l'erreur devient `The user is not authenticated`. Nous savons ce que cela signifie : il reste un autre problème à corriger.\n\nEn consultant `laravel.log`, nous découvrons le problème que nous cherchions :\n\n```log [storage\u002Flogs\u002Flaravel.log]\n[2025-03-01 18:51:14] testing.ERROR: SQLSTATE[23000]: Integrity constraint violation: 19 UNIQUE constraint failed: users.github_id (Connection: sqlite, SQL: insert into \"users\" (\"name\", \"email\", \"username\", \"github_id\", \"avatar\", \"updated_at\", \"created_at\") values (Test User, test@example.com, testuser, 12345, https:\u002F\u002Fexample.com\u002Favatar.jpg, 2025-03-01 18:51:14, 2025-03-01 18:51:14))\n```\n\nCette erreur SQL signifie qu'un utilisateur avec le même `github_id` existe déjà. Au lieu de toujours créer un nouvel utilisateur, nous devons mettre à jour l'enregistrement existant lorsqu'il est trouvé et en créer un nouveau dans le cas contraire. La méthode [`updateOrCreate`](https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Feloquent#updates) de Laravel fait exactement cela.\n\n```php [app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php]\n\u003C?php\n\nclass RegisteredViaGitHubController extends Controller\n{\n    public function store()\n    {\n        $githubUser = Socialite::driver('github')->user();\n\n        $user = User::updateOrCreate(\n            [\n                'github_id' => $githubUser->getId(),\n            ],\n            [\n                'name' => $githubUser->getName(),\n                'email' => $githubUser->getEmail(),\n                'username' => $githubUser->getNickname(),\n                'avatar' => $githubUser->getAvatar(),\n            ]\n        );\n\n        Auth::login($user);\n    }\n}\n```\n\nRedirigeons enfin l'utilisateur vers la page d'accueil du front-end après sa connexion.\n\nLe dernier test vérifie que l'utilisateur est redirigé vers la page d'accueil après sa connexion :\n\n```php [tests\u002FHttp\u002FRegisteredViaGitHub\u002FStoreTest.php]\n\u003C?php\n\n\u002F\u002F other tests...\n\ntest('redirects to the homepage', function () {\n    fakeGitHubUser();\n\n    $this->get(route('auth.github.callback'))\n        ->assertRedirect('\u002F');\n});\n```\n\nLa méthode `assertRedirect` vérifie que l'utilisateur est redirigé vers la page d'accueil après sa connexion.\n\nIl ne reste plus qu'à implémenter la redirection dans le contrôleur :\n\n```php [app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php]\n\u003C?php\nclass RegisteredViaGitHubController extends Controller\n{\n    public function store()\n    {\n        \u002F\u002F ...\n\n        Auth::login($user);\n\n        return redirect('\u002F');\n    }\n}\n```\n\nEt voilà, le contrôleur est terminé !\n\n## Atteindre une couverture complète\n\nAvant de conclure, vérifions que le script de test s'exécute correctement.\n\n::callout{icon=\"i-ph-lightbulb-duotone\" color=\"success\"}\nAvant de lancer le script de test, exécutez d'abord les scripts de lint et de refactorisation.\n::\n\nPHPStan n'est pas satisfait de notre code. Il signale deux erreurs :\n\n```bash [terminal]\n ------ ---------------------------------------------------------------------------------------------------\n  Line   app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php\n ------ ---------------------------------------------------------------------------------------------------\n  :13    Method App\\Http\\Controllers\\RegisteredViaGitHubController::create() has no return type specified.\n         🪪  missingType.return\n  :18    Method App\\Http\\Controllers\\RegisteredViaGitHubController::store() has no return type specified.\n         🪪  missingType.return\n ------ ---------------------------------------------------------------------------------------------------\n```\n\nLes méthodes n'ont pas de type de retour. Ajoutez `: RedirectResponse` aux deux méthodes :\n\n```php [app\u002FHttp\u002FControllers\u002FRegisteredViaGitHubController.php]\n\u003C?php\n\nuse Symfony\\Component\\HttpFoundation\\RedirectResponse;\n\nclass RegisteredViaGitHubController extends Controller\n{\n    public function create(): RedirectResponse\n    {\n        \u002F\u002F ...\n    }\n\n    public function store(): RedirectResponse\n    {\n        \u002F\u002F ...\n    }\n}\n```\n\nLe script `test:unit` échoue encore, car cette route par défaut n'a pas de test :\n\n```php [routes\u002Fweb.php]\nRoute::get('\u002F', function () {\n    return view('welcome');\n});\n```\n\nNous pouvons la supprimer sans risque, car les utilisateurs doivent être redirigés vers la page d'accueil de l'application front-end, et non vers celle de l'application Laravel.\n\nUne fois cette route supprimée, tout est au vert ! 🟢\n\n_J'adore vraiment, vraiment cette sensation._\n\n## Dernières réflexions\n\nL'authentification GitHub est maintenant en place. Nous avons un modèle `User` local, un flux OAuth complet et des tests qui décrivent le comportement attendu. Le workflow piloté par les tests peut sembler plus lent au début, mais il nous donne confiance à mesure que l'implémentation grandit.\n\nSocialite gère les détails propres au fournisseur afin que nous puissions nous concentrer sur les utilisateurs et les sessions de notre application. Le système de commentaires dispose ainsi d'un propriétaire fiable pour chaque commentaire.\n\nEnsuite, nous allons concevoir et implémenter l'API Laravel permettant de lister, créer, modifier et supprimer des commentaires.\n",{"title":5,"description":3351},"empower-and-dynamize-our-vitepress-blog-with-a-laravel-api",{"loc":3355,"images":3360},[3361],{"loc":1079},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Feffortless-social-authentication-with-laravel-socialite","QrLjBCyJBjNlNY08hRf0KU0LkSiW70yIwGRdCMooiew",{"overview":3365,"chapters":3538},{"id":3366,"title":3367,"body":3368,"contentId":3522,"date":3523,"description":3524,"extension":3352,"github":3353,"meetTheInstructor":3525,"meta":3526,"navigation":547,"part":3353,"path":3527,"rawbody":3528,"robots":3353,"schemaOrg":3353,"seo":3529,"seriesSlug":3358,"sitemap":3530,"stem":3531,"subtitle":3532,"topics":3533,"__hash__":3537},"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":3369,"toc":3519},[3370,3373,3376,3379,3383,3392,3395,3404,3407,3410,3491,3494,3497,3500,3509,3513],[10,3371,3372],{},"Bonjour ! 👋",[10,3374,3375],{},"Après avoir créé notre blog VitePress, nous sommes prêts à le rendre plus dynamique grâce à une API Laravel.",[10,3377,3378],{},"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.",[3380,3381],"callout-read-more",{"id":3382},"43c95b33-041c-4108-ab98-0d21ef60ed7f",[10,3384,3385,3386,3391],{},"Cette série s'intéresse au développement back-end. Nous allons créer une API ",[17,3387,3390],{"href":3388,"rel":3389},"https:\u002F\u002Flaravel.com",[21],"Laravel"," pour ajouter quelques fonctionnalités interactives à notre blog.",[10,3393,3394],{},"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,3396,3397,3398,3403],{},"Même si la série se concentre sur le back-end, nous intégrerons également l'API à notre blog VitePress. Nous utiliserons Vue.js et ",[17,3399,3402],{"href":3400,"rel":3401},"https:\u002F\u002Fpinia-colada.esm.dev\u002F",[21],"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,3405,3406],{},"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,3408,3409],{},"Tout au long de la série, nous construirons une API Laravel et l'intégrerons à notre blog VitePress. Nous aborderons les sujets suivants :",[1933,3411,3412,3419,3446,3457,3463,3473,3479,3485],{},[60,3413,3414,3418],{},[3415,3416,3417],"strong",{},"Configurer le projet Laravel"," : Créer un nouveau projet Laravel et se familiariser avec sa structure.",[60,3420,3421,3424,3425,1994,3430,1994,3435,248,3440,3445],{},[3415,3422,3423],{},"Améliorer le workflow de développement"," : Configurer ",[17,3426,3429],{"href":3427,"rel":3428},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fpint",[21],"Pint",[17,3431,3434],{"href":3432,"rel":3433},"https:\u002F\u002Fgithub.com\u002Frectorphp\u002Frector",[21],"Rector",[17,3436,3439],{"href":3437,"rel":3438},"https:\u002F\u002Fgithub.com\u002Flarastan\u002Flarastan",[21],"Larastan",[17,3441,3444],{"href":3442,"rel":3443},"https:\u002F\u002Fpestphp.com\u002F",[21],"Pest"," pour le formatage, la refactorisation, l'analyse statique et les tests.",[60,3447,3448,3451,3452,285],{},[3415,3449,3450],{},"Ajouter l'authentification sociale"," : Permettre aux utilisateurs de se connecter avec GitHub grâce à ",[17,3453,3456],{"href":3454,"rel":3455},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fsocialite",[21],"Laravel Socialite",[60,3458,3459,3462],{},[3415,3460,3461],{},"Connecter les applications"," : Configurer Sanctum, CORS, la protection CSRF et les premières requêtes entre le front-end VitePress et l'API Laravel.",[60,3464,3465,3468,3469,3472],{},[3415,3466,3467],{},"Gérer l'état d'authentification"," : Utiliser ",[17,3470,3402],{"href":3400,"rel":3471},[21]," pour récupérer l'utilisateur courant et le déconnecter avec une mise à jour optimiste.",[60,3474,3475,3478],{},[3415,3476,3477],{},"Construire l'API de commentaires"," : Créer les modèles, les relations, les endpoints, la validation, l'autorisation et les tests des commentaires.",[60,3480,3481,3484],{},[3415,3482,3483],{},"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.",[60,3486,3487,3490],{},[3415,3488,3489],{},"Construire l'interface de commentaires"," : Récupérer, créer, modifier et supprimer des commentaires depuis le front-end VitePress.",[10,3492,3493],{},"À 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,3495,3496],{},"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,3498,3499],{},"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.",[85,3501,3502],{"color":87,"icon":88},[10,3503,3504,3505,285],{},"Cette série suppose que vous connaissez déjà TypeScript, Vue.js et Laravel. Si ce n'est pas le cas, commencez par consulter la ",[17,3506,3508],{"href":3507},"\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",[40,3510,3512],{"id":3511},"chapitres","Chapitres",[3514,3515],"series-chapters-list",{"className":3516},[3517,3518],"mx-auto","max-w-5xl",{"title":120,"searchDepth":161,"depth":161,"links":3520},[3521],{"id":3511,"depth":161,"text":3512},"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":3367,"description":3524},{"loc":3527},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api","Transformez votre blog VitePress en une plateforme dynamique avec une API",[3534,3535,3536],"laravel","vitepress","api","AjkLB8gOXMZAgudegF8LmVWjly_nRao_7y_u2LUCUrQ",[3539,3544,3549,3550,3555,3560,3565,3570],{"contentId":3540,"title":3541,"description":3542,"path":3543,"part":128,"github":3353,"topics":3353},"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":3545,"title":3546,"description":3547,"path":3548,"part":161,"github":3353,"topics":3353},"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":3349,"title":5,"description":3351,"path":3355,"part":167,"github":3353,"topics":3353},{"contentId":3551,"title":3552,"description":3553,"path":3554,"part":173,"github":3353,"topics":3353},"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":3556,"title":3557,"description":3558,"path":3559,"part":179,"github":3353,"topics":3353},"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":3561,"title":3562,"description":3563,"path":3564,"part":185,"github":3353,"topics":3353},"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":3566,"title":3567,"description":3568,"path":3569,"part":191,"github":3353,"topics":3353},"e03c822f-0431-4ece-9293-765cacc2d44e","Authentifier les utilisateurs du front-end au back-end","Reliez l'authentification front-end à Laravel avec une requête utilisateur, une déconnexion GitHub, le cache Pinia Colada et des mises à jour optimistes.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fstreamlining-user-authentication-from-frontend-to-backend",{"contentId":3571,"title":3572,"description":3573,"path":3574,"part":197,"github":3353,"topics":3353},"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",1795016704111]