[{"data":1,"prerenderedAt":1012},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fsetting-up-your-laravel-project-structure-and-essentials":3,"series-context-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api":802},{"id":4,"title":5,"body":6,"contentId":789,"date":790,"description":791,"extension":792,"github":793,"meetTheInstructor":793,"meta":794,"navigation":152,"part":63,"path":795,"rawbody":796,"robots":793,"schemaOrg":793,"seo":797,"seriesSlug":798,"sitemap":799,"stem":800,"subtitle":793,"topics":793,"__hash__":801},"series\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fsetting-up-your-laravel-project-structure-and-essentials.md","Configurer la structure et les bases d'un projet Laravel",{"type":7,"value":8,"toc":758},"minimark",[9,13,22,25,30,45,48,83,96,99,104,190,196,199,238,241,244,261,264,267,271,274,283,286,292,298,303,312,322,327,332,337,342,348,353,358,363,372,377,389,395,400,413,418,423,444,455,460,465,468,473,481,485,488,494,500,506,511,517,525,531,536,542,547,553,558,563,568,574,579,598,676,679,689,695,700,706,711,717,722,728,733,739,744,748,751,754],[10,11,12],"p",{},"Bienvenue dans la partie Laravel de cette série ! 👋",[10,14,15,16,21],{},"Dans la série précédente, nous avons configuré un blog VitePress avec la ",[17,18,20],"a",{"href":19},"\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",". Nous sommes maintenant prêts à construire l'API Laravel qui alimentera ses fonctionnalités interactives. Vous n'avez pas besoin d'avoir lu cette série, mais elle fournit un contexte utile pour la suite.",[10,23,24],{},"Dans ce premier article, nous allons créer le projet Laravel, explorer sa structure et identifier l'emplacement du code que nous écrirons tout au long de la série. À la fin, vous devriez pouvoir vous repérer facilement dans l'application.",[26,27,29],"h2",{"id":28},"configurer-le-projet","Configurer le projet",[31,32,35],"callout",{"color":33,"icon":34},"info","i-ph-info-duotone",[10,36,37,38,44],{},"Cet article ne traite pas de l'installation de Laravel. Pour cela, consultez ",[17,39,43],{"href":40,"rel":41},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Finstallation",[42],"nofollow","la documentation officielle",".",[10,46,47],{},"L'un des points forts de Laravel est son interface en ligne de commande, qui permet de créer rapidement un nouveau projet. Exécutez la commande suivante :",[49,50,56],"pre",{"className":51,"code":52,"filename":53,"language":54,"meta":55,"style":55},"language-bash shiki shiki-themes github-light github-light github-dark","laravel new mimram --pest # Mimram est le nom du projet\n","terminal","bash","",[57,58,59],"code",{"__ignoreMap":55},[60,61,64,68,72,75,79],"span",{"class":62,"line":63},"line",1,[60,65,67],{"class":66},"snPdu","laravel",[60,69,71],{"class":70},"sIIMD"," new",[60,73,74],{"class":70}," mimram",[60,76,78],{"class":77},"sBjJW"," --pest",[60,80,82],{"class":81},"sCsY4"," # Mimram est le nom du projet\n",[31,84,85],{"color":33,"icon":34},[10,86,87,88,91,92,95],{},"Depuis Laravel 12, la commande ",[57,89,90],{},"laravel new"," ne demande plus quel framework de test utiliser. L'option ",[57,93,94],{},"--pest"," configure automatiquement Pest.",[10,97,98],{},"La configuration devrait ressembler à ceci :",[31,100,101],{"color":33,"icon":34},[10,102,103],{},"Pour cet article, j'utilise la version 12.x de Laravel.",[49,105,110],{"className":106,"code":107,"filename":108,"language":109,"meta":55,"style":55},"language-txt shiki shiki-themes github-light github-light github-dark","   _                               _\n  | |                             | |\n  | |     __ _ _ __ __ ___   _____| |\n  | |    \u002F _` |  __\u002F _` \\ \\ \u002F \u002F _ \\ |\n  | |___| (_| | | | (_| |\\ V \u002F  __\u002F |\n  |______\\__,_|_|  \\__,_| \\_\u002F \\___|_|\n\n ┌ Which starter kit would you like to install? ────────────────┐\n │ › ● None                                                     │\n │   ○ React                                                    │\n │   ○ Vue                                                      │\n │   ○ Livewire                                                 │\n └──────────────────────────────────────────────────────────────┘\n","Exemple","txt",[57,111,112,117,123,129,135,141,147,154,160,166,172,178,184],{"__ignoreMap":55},[60,113,114],{"class":62,"line":63},[60,115,116],{},"   _                               _\n",[60,118,120],{"class":62,"line":119},2,[60,121,122],{},"  | |                             | |\n",[60,124,126],{"class":62,"line":125},3,[60,127,128],{},"  | |     __ _ _ __ __ ___   _____| |\n",[60,130,132],{"class":62,"line":131},4,[60,133,134],{},"  | |    \u002F _` |  __\u002F _` \\ \\ \u002F \u002F _ \\ |\n",[60,136,138],{"class":62,"line":137},5,[60,139,140],{},"  | |___| (_| | | | (_| |\\ V \u002F  __\u002F |\n",[60,142,144],{"class":62,"line":143},6,[60,145,146],{},"  |______\\__,_|_|  \\__,_| \\_\u002F \\___|_|\n",[60,148,150],{"class":62,"line":149},7,[60,151,153],{"emptyLinePlaceholder":152},true,"\n",[60,155,157],{"class":62,"line":156},8,[60,158,159],{}," ┌ Which starter kit would you like to install? ────────────────┐\n",[60,161,163],{"class":62,"line":162},9,[60,164,165],{}," │ › ● None                                                     │\n",[60,167,169],{"class":62,"line":168},10,[60,170,171],{}," │   ○ React                                                    │\n",[60,173,175],{"class":62,"line":174},11,[60,176,177],{}," │   ○ Vue                                                      │\n",[60,179,181],{"class":62,"line":180},12,[60,182,183],{}," │   ○ Livewire                                                 │\n",[60,185,187],{"class":62,"line":186},13,[60,188,189],{}," └──────────────────────────────────────────────────────────────┘\n",[10,191,192,193,44],{},"Comme nous avons déjà un front-end, sélectionnez l'option ",[57,194,195],{},"None",[10,197,198],{},"La commande vous demandera ensuite quelle base de données l'application doit utiliser.",[49,200,202],{"className":106,"code":201,"filename":108,"language":109,"meta":55,"style":55}," ┌ Which database will your application use? ───────────────────┐\n │ › ● SQLite                                                   │\n │   ○ MySQL                                                    │\n │   ○ MariaDB                                                  │\n │   ○ PostgreSQL                                               │\n │   ○ SQL Server (Missing PDO extension)                       │\n └──────────────────────────────────────────────────────────────┘\n",[57,203,204,209,214,219,224,229,234],{"__ignoreMap":55},[60,205,206],{"class":62,"line":63},[60,207,208],{}," ┌ Which database will your application use? ───────────────────┐\n",[60,210,211],{"class":62,"line":119},[60,212,213],{}," │ › ● SQLite                                                   │\n",[60,215,216],{"class":62,"line":125},[60,217,218],{}," │   ○ MySQL                                                    │\n",[60,220,221],{"class":62,"line":131},[60,222,223],{}," │   ○ MariaDB                                                  │\n",[60,225,226],{"class":62,"line":137},[60,227,228],{}," │   ○ PostgreSQL                                               │\n",[60,230,231],{"class":62,"line":143},[60,232,233],{}," │   ○ SQL Server (Missing PDO extension)                       │\n",[60,235,236],{"class":62,"line":149},[60,237,189],{},[10,239,240],{},"Pour ce projet, choisissez SQLite.",[10,242,243],{},"SQLite est une bibliothèque C qui stocke les données dans un seul fichier sur le disque, ce qui la rend portable et simple à maintenir. Elle ne convient pas à tous les cas d'usage, mais c'est un excellent choix pour un blog simple qui ne connaîtra pas un trafic important.",[31,245,246],{"color":33,"icon":34},[10,247,248,249,254,255,260],{},"Pour en savoir plus sur SQLite, je vous recommande ",[17,250,253],{"href":251,"rel":252},"https:\u002F\u002Fhighperformancesqlite.com\u002F",[42],"High Performance SQLite"," d'",[17,256,259],{"href":257,"rel":258},"https:\u002F\u002Fx.com\u002Faarondfrancis",[42],"Aaron Francis",". C'est une excellente série pour maîtriser SQLite.",[10,262,263],{},"Enfin, répondez oui lorsque la commande vous demande si vous souhaitez installer les dépendances JavaScript et compiler les ressources.",[10,265,266],{},"Parfait ! Nous avons maintenant un projet Laravel vierge dans lequel construire notre API.",[26,268,270],{"id":269},"structure-du-projet","Structure du projet",[10,272,273],{},"Voici la structure du projet avec laquelle nous allons travailler :",[49,275,281],{"className":276,"code":278,"filename":279,"language":280,"meta":55},[277],"language-text","├── app\n│   ├── Http\u002F\n│   ├── Models\u002F\n│   └── Providers\u002F\n├── bootstrap\n│   ├── app.php\n│   └── cache\u002F\n├── config\n│   ├── app.php\n│   ├── database.php\n│   └── mail.php\n├── database\n│   ├── migrations\u002F\n│   ├── factories\u002F\n│   └── seeders\u002F\n├── public\n│   ├── index.php\n│   ├── css\u002F\n│   └── js\u002F\n├── resources\n│   ├── views\u002F\n│   ├── css\u002F\n│   └── js\u002F\n├── routes\n│   ├── web.php\n│   └── api.php\n├── storage\n│   ├── app\u002F\n│   ├── framework\u002F\n│   └── logs\u002F\n├── tests\n│   ├── Feature\u002F\n│   └── Unit\u002F\n└── vendor\n","Structure du projet Laravel","text",[57,282,278],{"__ignoreMap":55},[10,284,285],{},"Examinons les différents dossiers et fichiers.",[287,288,290],"h3",{"id":289},"app",[57,291,289],{},[10,293,294,295,297],{},"Le dossier ",[57,296,289],{}," contient le code principal de l'application, notamment les contrôleurs, les modèles et les services. C'est le cœur du projet et l'endroit où vous passerez le plus de temps à coder.",[287,299,301],{"id":300},"bootstrap",[57,302,300],{},[10,304,294,305,307,308,311],{},[57,306,300],{}," contient les fichiers qui initialisent l'application. Il comprend ",[57,309,310],{},"app.php",", qui crée et configure l'application.",[10,313,314,315,318,319,44],{},"Le dossier contient également le fichier ",[57,316,317],{},"providers.php",", qui charge les fournisseurs de services. Un fournisseur de services enregistre des services, des routes et des extensions Laravel comme les macros et les helpers. Chaque package Laravel possède un fournisseur de services comme point d'entrée, et les fournisseurs de votre application se trouvent dans ",[57,320,321],{},"app\u002FProviders",[287,323,325],{"id":324},"config",[57,326,324],{},[10,328,294,329,331],{},[57,330,324],{}," contient tous les fichiers de configuration. Vous y trouverez les paramètres de la base de données, du mail, du cache et bien d'autres choses.",[287,333,335],{"id":334},"database",[57,336,334],{},[10,338,294,339,341],{},[57,340,334],{}," contient les migrations de base de données, les factories de modèles et les seeders. Les migrations versionnent le schéma de la base de données. Les factories de modèles génèrent facilement des données de test, tandis que les seeders remplissent la base de données, souvent à l'aide de ces factories.",[10,343,344,345,44],{},"Les factories de modèles sont liées aux modèles situés dans le dossier ",[57,346,347],{},"app\u002FModels",[287,349,351],{"id":350},"node_modules",[57,352,350],{},[10,354,294,355,357],{},[57,356,350],{}," contient les dépendances JavaScript installées par npm, pnpm ou yarn. Il est généré automatiquement et ne doit pas être ajouté au contrôle de version.",[287,359,361],{"id":360},"public",[57,362,360],{},[10,364,294,365,367,368,371],{},[57,366,360],{}," contient le contrôleur frontal et les ressources publiques comme les fichiers JavaScript, CSS et les images. C'est le répertoire servi par le serveur web. Le fichier ",[57,369,370],{},"index.php"," est le point d'entrée de l'application et redirige les requêtes entrantes vers Laravel.",[287,373,375],{"id":374},"resources",[57,376,374],{},[10,378,294,379,381,382,385,386,44],{},[57,380,374],{}," contient les fichiers de vue et les ressources brutes comme les fichiers CSS et JavaScript. Dans Laravel, les vues sont des fichiers PHP appelés templates Blade. Blade fournit une syntaxe élégante pour le code PHP et les directives comme ",[57,383,384],{},"@if"," et ",[57,387,388],{},"@foreach",[10,390,391,392,44],{},"Les ressources brutes sont compilées par Vite et stockées dans le dossier ",[57,393,394],{},"public\u002Fbuild",[287,396,398],{"id":397},"routes",[57,399,397],{},[10,401,294,402,404,405,408,409,412],{},[57,403,397],{}," contient les routes de l'application. Il comprend les routes web, les routes API et les routes de console. Chaque fichier gère un type de route précis : ",[57,406,407],{},"web.php"," gère les routes accessibles depuis un navigateur, tandis que ",[57,410,411],{},"api.php"," gère les routes d'API.",[287,414,416],{"id":415},"storage",[57,417,415],{},[10,419,294,420,422],{},[57,421,415],{}," contient les templates Blade compilés, les sessions stockées dans des fichiers, les caches, les logs et d'autres fichiers générés par le framework. Il est organisé ainsi :",[424,425,426,432,438],"ol",{},[427,428,429,431],"li",{},[57,430,289],{}," : Fichiers générés par l'application.",[427,433,434,437],{},[57,435,436],{},"framework"," : Fichiers générés par le framework.",[427,439,440,443],{},[57,441,442],{},"logs"," : Fichiers de log de l'application.",[10,445,446,447,450,451,454],{},"Consultez le fichier ",[57,448,449],{},"laravel.log"," dans ",[57,452,453],{},"storage\u002Flogs"," pour trouver les logs d'erreur et les traces d'exécution.",[287,456,458],{"id":457},"tests",[57,459,457],{},[10,461,294,462,464],{},[57,463,457],{}," contient les tests automatisés. Laravel inclut Pest, un framework de test construit sur PHPUnit, pour écrire des tests unitaires et fonctionnels. Les tests vérifient que l'application se comporte comme prévu et aident à éviter les régressions.",[10,466,467],{},"Tout au long de cette série, nous écrirons des tests pour notre application afin de montrer à quel point Laravel facilite leur rédaction.",[287,469,471],{"id":470},"vendor",[57,472,470],{},[10,474,294,475,477,478,480],{},[57,476,470],{}," contient toutes les dépendances PHP, générées automatiquement par Composer. Il joue pour PHP un rôle comparable à celui de ",[57,479,350],{}," pour JavaScript.",[287,482,484],{"id":483},"fichiers-à-la-racine","Fichiers à la racine",[10,486,487],{},"Voici la liste des fichiers à la racine du projet :",[287,489,491],{"id":490},"editorconfig",[57,492,493],{},".editorconfig",[10,495,496,497,499],{},"Le fichier ",[57,498,493],{}," aide à maintenir un style de code cohérent entre plusieurs développeurs, éditeurs et IDE. Il définit notamment l'indentation, les fins de ligne et l'encodage des caractères.",[287,501,503],{"id":502},"env",[57,504,505],{},".env",[10,507,496,508,510],{},[57,509,505],{}," contient les valeurs de configuration propres à l'environnement. Il permet de configurer l'application sans modifier son code et peut contenir des informations sensibles comme des identifiants de base de données ou des clés d'API.",[287,512,514],{"id":513},"envexample",[57,515,516],{},".env.example",[10,518,496,519,521,522,524],{},[57,520,516],{}," sert de modèle pour ",[57,523,505],{}," et fournit les valeurs nécessaires à la création d'une configuration locale. Il doit être commité afin que les autres développeurs sachent quelles variables sont disponibles.",[287,526,528],{"id":527},"gitattributes",[57,529,530],{},".gitattributes",[10,532,496,533,535],{},[57,534,530],{}," définit des attributs pour les chemins du dépôt. Il contrôle notamment la gestion des fins de ligne, les stratégies de fusion et d'autres comportements de Git pour certains fichiers ou répertoires.",[287,537,539],{"id":538},"gitignore",[57,540,541],{},".gitignore",[10,543,496,544,546],{},[57,545,541],{}," indique à Git quels fichiers et répertoires ignorer, afin d'éviter de commiter des données sensibles ou des fichiers inutiles.",[287,548,550],{"id":549},"readmemd",[57,551,552],{},"README.md",[10,554,496,555,557],{},[57,556,552],{}," présente le projet, sa configuration, son utilisation et d'autres informations essentielles. C'est souvent la première référence pour les nouveaux développeurs.",[287,559,561],{"id":560},"artisan",[57,562,560],{},[10,564,496,565,567],{},[57,566,560],{}," est l'interface en ligne de commande de Laravel. Il fournit des commandes pour développer l'application, exécuter les migrations, générer du code et lancer les tests.",[287,569,571],{"id":570},"composerjson",[57,572,573],{},"composer.json",[10,575,496,576,578],{},[57,577,573],{}," est le fichier de configuration de Composer. Il liste les dépendances PHP et les métadonnées du projet, comme son nom et sa description.",[10,580,581,582,585,586,589,590,593,594,597],{},"Ce fichier contient une clé ",[57,583,584],{},"scripts"," pour exécuter des commandes ",[57,587,588],{},"composer run",". Par exemple, ",[57,591,592],{},"composer run test"," exécute les tests de l'application. Parmi ces scripts, le script ",[57,595,596],{},"dev"," lance les processus nécessaires au développement :",[49,599,601],{"className":51,"code":600,"filename":573,"language":54,"meta":55,"style":55},"npx concurrently -c \\\"#93c5fd,#c4b5fd,#fb7185,#fdba74\\\" \\\"php artisan serve\\\" \\\"php artisan queue:listen --tries=1\\\" \\\"php artisan pail --timeout=0\\\" \\\"npm run dev\\\" --names=server,queue,logs,vite\n",[57,602,603],{"__ignoreMap":55},[60,604,605,608,611,614,617,620,623,625,628,631,634,636,638,640,642,645,648,650,652,654,657,660,662,665,668,671,673],{"class":62,"line":63},[60,606,607],{"class":66},"npx",[60,609,610],{"class":70}," concurrently",[60,612,613],{"class":77}," -c",[60,615,616],{"class":77}," \\\"",[60,618,619],{"class":70},"#93c5fd,#c4b5fd,#fb7185,#fdba74",[60,621,622],{"class":77},"\\\"",[60,624,616],{"class":77},[60,626,627],{"class":70},"php",[60,629,630],{"class":70}," artisan",[60,632,633],{"class":70}," serve",[60,635,622],{"class":77},[60,637,616],{"class":77},[60,639,627],{"class":70},[60,641,630],{"class":70},[60,643,644],{"class":70}," queue:listen",[60,646,647],{"class":77}," --tries=1\\\"",[60,649,616],{"class":77},[60,651,627],{"class":70},[60,653,630],{"class":70},[60,655,656],{"class":70}," pail",[60,658,659],{"class":77}," --timeout=0\\\"",[60,661,616],{"class":77},[60,663,664],{"class":70},"npm",[60,666,667],{"class":70}," run",[60,669,670],{"class":70}," dev",[60,672,622],{"class":77},[60,674,675],{"class":77}," --names=server,queue,logs,vite\n",[10,677,678],{},"Laravel ne se limite pas à un seul processus pendant le développement. Le serveur web traite les requêtes, le serveur Vite sert les ressources, et les processus de queue et de logs s'occupent de leurs tâches respectives.",[10,680,681,682,685,686,44],{},"La commande ",[57,683,684],{},"composer run dev"," lance ces processus en parallèle grâce au package npm ",[57,687,688],{},"concurrently",[287,690,692],{"id":691},"composerlock",[57,693,694],{},"composer.lock",[10,696,496,697,699],{},[57,698,694],{},", généré par Composer, verrouille les dépendances sur des versions précises et rend les installations reproductibles. Commitez-le dans le contrôle de version.",[287,701,703],{"id":702},"phpunitxml",[57,704,705],{},"phpunit.xml",[10,707,496,708,710],{},[57,709,705],{}," configure PHPUnit, notamment ses suites de tests, son fichier de bootstrap et ses options d'environnement.",[287,712,714],{"id":713},"viteconfigjs",[57,715,716],{},"vite.config.js",[10,718,496,719,721],{},[57,720,716],{}," configure Vite, l'outil de build front-end de Laravel, notamment les points d'entrée JavaScript et CSS.",[287,723,725],{"id":724},"packagejson",[57,726,727],{},"package.json",[10,729,496,730,732],{},[57,731,727],{}," est le fichier de configuration de npm. Il liste les dépendances JavaScript et les scripts utilisés par le projet.",[287,734,736],{"id":735},"package-lockjson",[57,737,738],{},"package-lock.json",[10,740,496,741,743],{},[57,742,738],{},", généré par npm, verrouille les dépendances JavaScript sur des versions précises. Commitez-le dans le contrôle de version lorsque vous utilisez npm.",[26,745,747],{"id":746},"derniers-mots","Derniers mots",[10,749,750],{},"Cette première étape pose les fondations du reste de la série. Vous savez maintenant où Laravel place le code de l'application, la configuration, les fichiers de base de données, les routes et les tests. Au fil de l'ajout des fonctionnalités, ces dossiers vous deviendront familiers.",[10,752,753],{},"Ensuite, nous rendrons ces fondations plus faciles à maintenir en configurant le formatage, la refactorisation automatique, l'analyse statique et les tests.",[755,756,757],"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 pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}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);}",{"title":55,"searchDepth":119,"depth":119,"links":759},[760,761,788],{"id":28,"depth":119,"text":29},{"id":269,"depth":119,"text":270,"children":762},[763,764,765,766,767,768,769,770,771,772,773,774,775,776,777,778,779,780,781,782,783,784,785,786,787],{"id":289,"depth":125,"text":289},{"id":300,"depth":125,"text":300},{"id":324,"depth":125,"text":324},{"id":334,"depth":125,"text":334},{"id":350,"depth":125,"text":350},{"id":360,"depth":125,"text":360},{"id":374,"depth":125,"text":374},{"id":397,"depth":125,"text":397},{"id":415,"depth":125,"text":415},{"id":457,"depth":125,"text":457},{"id":470,"depth":125,"text":470},{"id":483,"depth":125,"text":484},{"id":490,"depth":125,"text":493},{"id":502,"depth":125,"text":505},{"id":513,"depth":125,"text":516},{"id":527,"depth":125,"text":530},{"id":538,"depth":125,"text":541},{"id":549,"depth":125,"text":552},{"id":560,"depth":125,"text":560},{"id":570,"depth":125,"text":573},{"id":691,"depth":125,"text":694},{"id":702,"depth":125,"text":705},{"id":713,"depth":125,"text":716},{"id":724,"depth":125,"text":727},{"id":735,"depth":125,"text":738},{"id":746,"depth":119,"text":747},"61204f3d-47bc-4832-a217-8c00b11ab6e1","2025-02-25","Découvrez comment configurer un projet Laravel et comprendre sa structure pour commencer le développement sur des bases solides.","md",null,{},"\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fsetting-up-your-laravel-project-structure-and-essentials","---\ncontentId: 61204f3d-47bc-4832-a217-8c00b11ab6e1\npart: 1\ntitle: \"Configurer la structure et les bases d'un projet Laravel\"\ndescription: Découvrez comment configurer un projet Laravel et comprendre sa structure pour commencer le développement sur des bases solides.\ndate: 2025-02-25\nseriesSlug: empower-and-dynamize-our-vitepress-blog-with-a-laravel-api\n---\n\nBienvenue dans la partie Laravel de cette série ! 👋\n\nDans la série précédente, nous avons configuré un blog VitePress avec 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). Nous sommes maintenant prêts à construire l'API Laravel qui alimentera ses fonctionnalités interactives. Vous n'avez pas besoin d'avoir lu cette série, mais elle fournit un contexte utile pour la suite.\n\nDans ce premier article, nous allons créer le projet Laravel, explorer sa structure et identifier l'emplacement du code que nous écrirons tout au long de la série. À la fin, vous devriez pouvoir vous repérer facilement dans l'application.\n\n## Configurer le projet\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nCet article ne traite pas de l'installation de Laravel. Pour cela, consultez [la documentation officielle](https:\u002F\u002Flaravel.com\u002Fdocs\u002F12.x\u002Finstallation).\n::\n\nL'un des points forts de Laravel est son interface en ligne de commande, qui permet de créer rapidement un nouveau projet. Exécutez la commande suivante :\n\n```bash [terminal]\nlaravel new mimram --pest # Mimram est le nom du projet\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nDepuis Laravel 12, la commande `laravel new` ne demande plus quel framework de test utiliser. L'option `--pest` configure automatiquement Pest.\n::\n\nLa configuration devrait ressembler à ceci :\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nPour cet article, j'utilise la version 12.x de Laravel.\n::\n\n```txt [Exemple]\n   _                               _\n  | |                             | |\n  | |     __ _ _ __ __ ___   _____| |\n  | |    \u002F _` |  __\u002F _` \\ \\ \u002F \u002F _ \\ |\n  | |___| (_| | | | (_| |\\ V \u002F  __\u002F |\n  |______\\__,_|_|  \\__,_| \\_\u002F \\___|_|\n\n ┌ Which starter kit would you like to install? ────────────────┐\n │ › ● None                                                     │\n │   ○ React                                                    │\n │   ○ Vue                                                      │\n │   ○ Livewire                                                 │\n └──────────────────────────────────────────────────────────────┘\n```\n\nComme nous avons déjà un front-end, sélectionnez l'option `None`.\n\nLa commande vous demandera ensuite quelle base de données l'application doit utiliser.\n\n```txt [Exemple]\n ┌ Which database will your application use? ───────────────────┐\n │ › ● SQLite                                                   │\n │   ○ MySQL                                                    │\n │   ○ MariaDB                                                  │\n │   ○ PostgreSQL                                               │\n │   ○ SQL Server (Missing PDO extension)                       │\n └──────────────────────────────────────────────────────────────┘\n```\n\nPour ce projet, choisissez SQLite.\n\nSQLite est une bibliothèque C qui stocke les données dans un seul fichier sur le disque, ce qui la rend portable et simple à maintenir. Elle ne convient pas à tous les cas d'usage, mais c'est un excellent choix pour un blog simple qui ne connaîtra pas un trafic important.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nPour en savoir plus sur SQLite, je vous recommande [High Performance SQLite](https:\u002F\u002Fhighperformancesqlite.com\u002F) d'[Aaron Francis](https:\u002F\u002Fx.com\u002Faarondfrancis). C'est une excellente série pour maîtriser SQLite.\n::\n\nEnfin, répondez oui lorsque la commande vous demande si vous souhaitez installer les dépendances JavaScript et compiler les ressources.\n\nParfait ! Nous avons maintenant un projet Laravel vierge dans lequel construire notre API.\n\n## Structure du projet\n\nVoici la structure du projet avec laquelle nous allons travailler :\n\n```text [Structure du projet Laravel]\n├── app\n│   ├── Http\u002F\n│   ├── Models\u002F\n│   └── Providers\u002F\n├── bootstrap\n│   ├── app.php\n│   └── cache\u002F\n├── config\n│   ├── app.php\n│   ├── database.php\n│   └── mail.php\n├── database\n│   ├── migrations\u002F\n│   ├── factories\u002F\n│   └── seeders\u002F\n├── public\n│   ├── index.php\n│   ├── css\u002F\n│   └── js\u002F\n├── resources\n│   ├── views\u002F\n│   ├── css\u002F\n│   └── js\u002F\n├── routes\n│   ├── web.php\n│   └── api.php\n├── storage\n│   ├── app\u002F\n│   ├── framework\u002F\n│   └── logs\u002F\n├── tests\n│   ├── Feature\u002F\n│   └── Unit\u002F\n└── vendor\n```\n\nExaminons les différents dossiers et fichiers.\n\n### `app`\n\nLe dossier `app` contient le code principal de l'application, notamment les contrôleurs, les modèles et les services. C'est le cœur du projet et l'endroit où vous passerez le plus de temps à coder.\n\n### `bootstrap`\n\nLe dossier `bootstrap` contient les fichiers qui initialisent l'application. Il comprend `app.php`, qui crée et configure l'application.\n\nLe dossier contient également le fichier `providers.php`, qui charge les fournisseurs de services. Un fournisseur de services enregistre des services, des routes et des extensions Laravel comme les macros et les helpers. Chaque package Laravel possède un fournisseur de services comme point d'entrée, et les fournisseurs de votre application se trouvent dans `app\u002FProviders`.\n\n### `config`\n\nLe dossier `config` contient tous les fichiers de configuration. Vous y trouverez les paramètres de la base de données, du mail, du cache et bien d'autres choses.\n\n### `database`\n\nLe dossier `database` contient les migrations de base de données, les factories de modèles et les seeders. Les migrations versionnent le schéma de la base de données. Les factories de modèles génèrent facilement des données de test, tandis que les seeders remplissent la base de données, souvent à l'aide de ces factories.\n\nLes factories de modèles sont liées aux modèles situés dans le dossier `app\u002FModels`.\n\n### `node_modules`\n\nLe dossier `node_modules` contient les dépendances JavaScript installées par npm, pnpm ou yarn. Il est généré automatiquement et ne doit pas être ajouté au contrôle de version.\n\n### `public`\n\nLe dossier `public` contient le contrôleur frontal et les ressources publiques comme les fichiers JavaScript, CSS et les images. C'est le répertoire servi par le serveur web. Le fichier `index.php` est le point d'entrée de l'application et redirige les requêtes entrantes vers Laravel.\n\n### `resources`\n\nLe dossier `resources` contient les fichiers de vue et les ressources brutes comme les fichiers CSS et JavaScript. Dans Laravel, les vues sont des fichiers PHP appelés templates Blade. Blade fournit une syntaxe élégante pour le code PHP et les directives comme `@if` et `@foreach`.\n\nLes ressources brutes sont compilées par Vite et stockées dans le dossier `public\u002Fbuild`.\n\n### `routes`\n\nLe dossier `routes` contient les routes de l'application. Il comprend les routes web, les routes API et les routes de console. Chaque fichier gère un type de route précis : `web.php` gère les routes accessibles depuis un navigateur, tandis que `api.php` gère les routes d'API.\n\n### `storage`\n\nLe dossier `storage` contient les templates Blade compilés, les sessions stockées dans des fichiers, les caches, les logs et d'autres fichiers générés par le framework. Il est organisé ainsi :\n\n1. `app` : Fichiers générés par l'application.\n2. `framework` : Fichiers générés par le framework.\n3. `logs` : Fichiers de log de l'application.\n\nConsultez le fichier `laravel.log` dans `storage\u002Flogs` pour trouver les logs d'erreur et les traces d'exécution.\n\n### `tests`\n\nLe dossier `tests` contient les tests automatisés. Laravel inclut Pest, un framework de test construit sur PHPUnit, pour écrire des tests unitaires et fonctionnels. Les tests vérifient que l'application se comporte comme prévu et aident à éviter les régressions.\n\nTout au long de cette série, nous écrirons des tests pour notre application afin de montrer à quel point Laravel facilite leur rédaction.\n\n### `vendor`\n\nLe dossier `vendor` contient toutes les dépendances PHP, générées automatiquement par Composer. Il joue pour PHP un rôle comparable à celui de `node_modules` pour JavaScript.\n\n### Fichiers à la racine\n\nVoici la liste des fichiers à la racine du projet :\n\n### `.editorconfig`\n\nLe fichier `.editorconfig` aide à maintenir un style de code cohérent entre plusieurs développeurs, éditeurs et IDE. Il définit notamment l'indentation, les fins de ligne et l'encodage des caractères.\n\n### `.env`\n\nLe fichier `.env` contient les valeurs de configuration propres à l'environnement. Il permet de configurer l'application sans modifier son code et peut contenir des informations sensibles comme des identifiants de base de données ou des clés d'API.\n\n### `.env.example`\n\nLe fichier `.env.example` sert de modèle pour `.env` et fournit les valeurs nécessaires à la création d'une configuration locale. Il doit être commité afin que les autres développeurs sachent quelles variables sont disponibles.\n\n### `.gitattributes`\n\nLe fichier `.gitattributes` définit des attributs pour les chemins du dépôt. Il contrôle notamment la gestion des fins de ligne, les stratégies de fusion et d'autres comportements de Git pour certains fichiers ou répertoires.\n\n### `.gitignore`\n\nLe fichier `.gitignore` indique à Git quels fichiers et répertoires ignorer, afin d'éviter de commiter des données sensibles ou des fichiers inutiles.\n\n### `README.md`\n\nLe fichier `README.md` présente le projet, sa configuration, son utilisation et d'autres informations essentielles. C'est souvent la première référence pour les nouveaux développeurs.\n\n### `artisan`\n\nLe fichier `artisan` est l'interface en ligne de commande de Laravel. Il fournit des commandes pour développer l'application, exécuter les migrations, générer du code et lancer les tests.\n\n### `composer.json`\n\nLe fichier `composer.json` est le fichier de configuration de Composer. Il liste les dépendances PHP et les métadonnées du projet, comme son nom et sa description.\n\nCe fichier contient une clé `scripts` pour exécuter des commandes `composer run`. Par exemple, `composer run test` exécute les tests de l'application. Parmi ces scripts, le script `dev` lance les processus nécessaires au développement :\n\n```bash [composer.json]\nnpx concurrently -c \\\"#93c5fd,#c4b5fd,#fb7185,#fdba74\\\" \\\"php artisan serve\\\" \\\"php artisan queue:listen --tries=1\\\" \\\"php artisan pail --timeout=0\\\" \\\"npm run dev\\\" --names=server,queue,logs,vite\n```\n\nLaravel ne se limite pas à un seul processus pendant le développement. Le serveur web traite les requêtes, le serveur Vite sert les ressources, et les processus de queue et de logs s'occupent de leurs tâches respectives.\n\nLa commande `composer run dev` lance ces processus en parallèle grâce au package npm `concurrently`.\n\n### `composer.lock`\n\nLe fichier `composer.lock`, généré par Composer, verrouille les dépendances sur des versions précises et rend les installations reproductibles. Commitez-le dans le contrôle de version.\n\n### `phpunit.xml`\n\nLe fichier `phpunit.xml` configure PHPUnit, notamment ses suites de tests, son fichier de bootstrap et ses options d'environnement.\n\n### `vite.config.js`\n\nLe fichier `vite.config.js` configure Vite, l'outil de build front-end de Laravel, notamment les points d'entrée JavaScript et CSS.\n\n### `package.json`\n\nLe fichier `package.json` est le fichier de configuration de npm. Il liste les dépendances JavaScript et les scripts utilisés par le projet.\n\n### `package-lock.json`\n\nLe fichier `package-lock.json`, généré par npm, verrouille les dépendances JavaScript sur des versions précises. Commitez-le dans le contrôle de version lorsque vous utilisez npm.\n\n## Derniers mots\n\nCette première étape pose les fondations du reste de la série. Vous savez maintenant où Laravel place le code de l'application, la configuration, les fichiers de base de données, les routes et les tests. Au fil de l'ajout des fonctionnalités, ces dossiers vous deviendront familiers.\n\nEnsuite, nous rendrons ces fondations plus faciles à maintenir en configurant le formatage, la refactorisation automatique, l'analyse statique et les tests.\n",{"title":5,"description":791},"empower-and-dynamize-our-vitepress-blog-with-a-laravel-api",{"loc":795},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fsetting-up-your-laravel-project-structure-and-essentials","mz0KTtapByNKacBdBt0DhG-5FP1TkDacXjireeDzuNw",{"overview":803,"chapters":975},{"id":804,"title":805,"body":806,"contentId":960,"date":961,"description":962,"extension":792,"github":793,"meetTheInstructor":963,"meta":964,"navigation":152,"part":793,"path":965,"rawbody":966,"robots":793,"schemaOrg":793,"seo":967,"seriesSlug":798,"sitemap":968,"stem":969,"subtitle":970,"topics":971,"__hash__":974},"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":807,"toc":957},[808,811,814,817,821,830,833,842,845,848,931,934,937,940,947,951],[10,809,810],{},"Bonjour ! 👋",[10,812,813],{},"Après avoir créé notre blog VitePress, nous sommes prêts à le rendre plus dynamique grâce à une API Laravel.",[10,815,816],{},"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.",[818,819],"callout-read-more",{"id":820},"43c95b33-041c-4108-ab98-0d21ef60ed7f",[10,822,823,824,829],{},"Cette série s'intéresse au développement back-end. Nous allons créer une API ",[17,825,828],{"href":826,"rel":827},"https:\u002F\u002Flaravel.com",[42],"Laravel"," pour ajouter quelques fonctionnalités interactives à notre blog.",[10,831,832],{},"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,834,835,836,841],{},"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,837,840],{"href":838,"rel":839},"https:\u002F\u002Fpinia-colada.esm.dev\u002F",[42],"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,843,844],{},"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,846,847],{},"Tout au long de la série, nous construirons une API Laravel et l'intégrerons à notre blog VitePress. Nous aborderons les sujets suivants :",[849,850,851,858,886,897,903,913,919,925],"ul",{},[427,852,853,857],{},[854,855,856],"strong",{},"Configurer le projet Laravel"," : Créer un nouveau projet Laravel et se familiariser avec sa structure.",[427,859,860,863,864,869,870,869,875,385,880,885],{},[854,861,862],{},"Améliorer le workflow de développement"," : Configurer ",[17,865,868],{"href":866,"rel":867},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fpint",[42],"Pint",", ",[17,871,874],{"href":872,"rel":873},"https:\u002F\u002Fgithub.com\u002Frectorphp\u002Frector",[42],"Rector",[17,876,879],{"href":877,"rel":878},"https:\u002F\u002Fgithub.com\u002Flarastan\u002Flarastan",[42],"Larastan",[17,881,884],{"href":882,"rel":883},"https:\u002F\u002Fpestphp.com\u002F",[42],"Pest"," pour le formatage, la refactorisation, l'analyse statique et les tests.",[427,887,888,891,892,44],{},[854,889,890],{},"Ajouter l'authentification sociale"," : Permettre aux utilisateurs de se connecter avec GitHub grâce à ",[17,893,896],{"href":894,"rel":895},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fsocialite",[42],"Laravel Socialite",[427,898,899,902],{},[854,900,901],{},"Connecter les applications"," : Configurer Sanctum, CORS, la protection CSRF et les premières requêtes entre le front-end VitePress et l'API Laravel.",[427,904,905,908,909,912],{},[854,906,907],{},"Gérer l'état d'authentification"," : Utiliser ",[17,910,840],{"href":838,"rel":911},[42]," pour récupérer l'utilisateur courant et le déconnecter avec une mise à jour optimiste.",[427,914,915,918],{},[854,916,917],{},"Construire l'API de commentaires"," : Créer les modèles, les relations, les endpoints, la validation, l'autorisation et les tests des commentaires.",[427,920,921,924],{},[854,922,923],{},"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.",[427,926,927,930],{},[854,928,929],{},"Construire l'interface de commentaires"," : Récupérer, créer, modifier et supprimer des commentaires depuis le front-end VitePress.",[10,932,933],{},"À 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,935,936],{},"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,938,939],{},"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.",[31,941,942],{"color":33,"icon":34},[10,943,944,945,44],{},"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,946,20],{"href":19},[26,948,950],{"id":949},"chapitres","Chapitres",[952,953],"series-chapters-list",{"className":954},[955,956],"mx-auto","max-w-5xl",{"title":55,"searchDepth":119,"depth":119,"links":958},[959],{"id":949,"depth":119,"text":950},"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":805,"description":962},{"loc":965},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api","Transformez votre blog VitePress en une plateforme dynamique avec une API",[67,972,973],"vitepress","api","AjkLB8gOXMZAgudegF8LmVWjly_nRao_7y_u2LUCUrQ",[976,977,982,987,992,997,1002,1007],{"contentId":789,"title":5,"description":791,"path":795,"part":63,"github":793,"topics":793},{"contentId":978,"title":979,"description":980,"path":981,"part":119,"github":793,"topics":793},"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":983,"title":984,"description":985,"path":986,"part":125,"github":793,"topics":793},"d9a64441-89b3-4f82-a356-10bde7db7669","Authentification sociale simplifiée avec Laravel Socialite","Ajoutez l'authentification GitHub à Laravel avec Socialite, les callbacks OAuth, la synchronisation des utilisateurs et des tests fiables.","\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Feffortless-social-authentication-with-laravel-socialite",{"contentId":988,"title":989,"description":990,"path":991,"part":131,"github":793,"topics":793},"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":993,"title":994,"description":995,"path":996,"part":137,"github":793,"topics":793},"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":998,"title":999,"description":1000,"path":1001,"part":143,"github":793,"topics":793},"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":1003,"title":1004,"description":1005,"path":1006,"part":149,"github":793,"topics":793},"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":1008,"title":1009,"description":1010,"path":1011,"part":156,"github":793,"topics":793},"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",1795016703947]