[{"data":1,"prerenderedAt":2342},["ShallowReactive",2],{"series-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fautomating-your-backend-to-stay-in-sync-effortlessly":3,"series-context-\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api":2129},{"id":4,"title":5,"body":6,"contentId":2117,"date":2118,"description":2119,"extension":870,"github":2120,"meetTheInstructor":2120,"meta":2121,"navigation":237,"part":234,"path":2122,"rawbody":2123,"robots":2120,"schemaOrg":2120,"seo":2124,"seriesSlug":2125,"sitemap":2126,"stem":2127,"subtitle":2120,"topics":2120,"__hash__":2128},"series\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fautomating-your-backend-to-stay-in-sync-effortlessly.md","Automatiser facilement la synchronisation de votre back-end",{"type":7,"value":8,"toc":2109},"minimark",[9,22,25,33,50,53,56,67,70,77,95,109,119,142,151,164,167,742,749,754,766,862,865,920,967,976,992,1005,1008,1085,1088,1092,1102,1110,1113,1132,1139,1150,1153,1395,1410,1431,1443,1480,1483,1486,1510,1513,1527,1538,1548,1562,1565,1570,1577,1591,1993,2004,2071,2074,2095,2099,2102,2105],[10,11,12,13,17,18,21],"p",{},"À la fin de l'article précédent, nous avons créé une table ",[14,15,16],"code",{},"posts"," avec une colonne ",[14,19,20],{},"meta_id",". Nous ne l'avons pas encore utilisée, cet article va donc la relier au front-end.",[10,23,24],{},"VitePress génère un site statique au moment du build, tandis que les commentaires sont chargés dynamiquement pour l'article actuellement consulté. Pour que cela fonctionne, le front-end et le back-end doivent disposer d'un moyen stable d'identifier le même article.",[10,26,27,28,32],{},"Par exemple, le blog ",[29,30],"git-hub-link",{"repo":31},"barbapapazes\u002Fgarabit"," possède deux articles avec les slugs suivants :",[34,35,36,44],"ol",{},[37,38,39,40,43],"li",{},"Getting Started with Laravel (",[14,41,42],{},"getting-started-with-laravel",")",[37,45,46,47,43],{},"Getting Started with Vue 3 and Vite (",[14,48,49],{},"getting-started-with-vue-3-and-vite",[10,51,52],{},"Nous pourrions utiliser le slug comme identifiant, mais les slugs changent parfois à cause d'une faute de frappe, du référencement ou d'une évolution du contenu. Conserver un ancien slug uniquement pour préserver un identifiant rend les URL moins utiles. Nous avons besoin d'un identifiant distinct, qui reste stable même lorsque le slug change.",[10,54,55],{},"La solution consiste à stocker un identifiant stable dans le frontmatter de chaque article. Cet identifiant représente l'article et ne change pas lorsque son titre, son contenu ou son slug évolue.",[10,57,58,59,62,63,66],{},"Il reste à savoir comment envoyer ces identifiants au back-end. Une synchronisation manuelle est source d'erreurs et facile à automatiser ; le front-end va donc générer un fichier ",[14,60,61],{},"meta.json"," au moment du build. Il contiendra l'identifiant et le titre de chaque article. Le back-end lira ce fichier et créera ou mettra à jour les enregistrements correspondants dans la base de données. Le front-end pourra ensuite récupérer les commentaires en utilisant l'identifiant du frontmatter, tandis que la colonne ",[14,64,65],{},"posts.id"," restera une clé interne servant à relier les articles aux commentaires.",[10,68,69],{},"L'architecture est simple : VitePress écrit les métadonnées des articles et Laravel les lit pour garder ses enregistrements synchronisés.",[71,72,74,75],"h2",{"id":73},"générer-le-fichier-metajson","Générer le fichier ",[14,76,61],{},[10,78,79,80,82,83,86,87,90,91,94],{},"Pour cette partie, ouvrez le projet ",[29,81],{"repo":31},". Nous allons créer une fonction ",[14,84,85],{},"genMeta"," qui lit tous les fichiers Markdown, extrait leur identifiant et leur titre depuis le frontmatter, puis les écrit dans ",[14,88,89],{},"dist\u002Fmeta.json"," grâce au hook ",[14,92,93],{},"buildEnd"," de VitePress. VitePress appelle ce hook une fois le reste du build terminé, ce qui en fait un bon endroit pour générer le fichier.",[10,96,97,98,101,102,105,106,108],{},"Commencez par créer un dossier ",[14,99,100],{},"generators"," dans ",[14,103,104],{},".vitepress",". Il contiendra les fonctions appelées par le hook ",[14,107,93],{},".",[110,111,114],"callout",{"color":112,"icon":113},"info","i-ph-info-duotone",[10,115,116,118],{},[14,117,100],{}," n'est qu'un choix de nom. Vous pouvez utiliser celui qui vous convient.",[120,121,127],"pre",{"className":122,"code":123,"filename":124,"language":125,"meta":126,"style":126},"language-bash shiki shiki-themes github-light github-light github-dark","mkdir .vitepress\u002Fgenerators\n","terminal","bash","",[14,128,129],{"__ignoreMap":126},[130,131,134,138],"span",{"class":132,"line":133},"line",1,[130,135,137],{"class":136},"snPdu","mkdir",[130,139,141],{"class":140},"sIIMD"," .vitepress\u002Fgenerators\n",[10,143,144,145,148,149,108],{},"Créez ",[14,146,147],{},"meta.ts"," dans ce dossier. Il contiendra ",[14,150,85],{},[120,152,154],{"className":122,"code":153,"filename":124,"language":125,"meta":126,"style":126},"touch .vitepress\u002Fgenerators\u002Fmeta.ts\n",[14,155,156],{"__ignoreMap":126},[130,157,158,161],{"class":132,"line":133},[130,159,160],{"class":136},"touch",[130,162,163],{"class":140}," .vitepress\u002Fgenerators\u002Fmeta.ts\n",[10,165,166],{},"Écrivons enfin la fonction :",[120,168,173],{"className":169,"code":170,"filename":171,"language":172,"meta":126,"style":126},"language-ts shiki shiki-themes github-light github-light github-dark","import type { ContentData, SiteConfig } from 'vitepress'\nimport { writeFileSync } from 'node:fs'\nimport path from 'node:path'\nimport { createContentLoader } from 'vitepress'\n\nexport async function genMeta(config: SiteConfig) {\n  const posts = await createContentLoader('**\u002Fblog\u002F**\u002F*.md').load()\n\n  validatePosts(posts)\n\n  const meta = []\n\n  for (const item of posts) {\n    meta.push({\n      id: item.frontmatter.id,\n      title: item.frontmatter.title,\n    })\n  }\n\n  writeFileSync(path.join(config.outDir, 'meta.json'), JSON.stringify(meta.sort((a, b) => a.id - b.id), null, 2))\n}\n\nfunction validatePosts(items: ContentData[]) {\n  const ids = new Set\u003Cstring>()\n\n  for (const item of items) {\n    if (!item.frontmatter.id) {\n      throw new Error(`Id is missing: ${item.url}`)\n    }\n\n    if (ids.has(item.frontmatter.id)) {\n      throw new Error(`Id is not unique: ${item.frontmatter.id} (${item.url}) (${items.find(i => i.frontmatter.id === item.frontmatter.id)?.url})`)\n    }\n\n    ids.add(item.frontmatter.id)\n  }\n}\n",".vitepress\u002Fgenerators\u002Fmeta.ts","ts",[14,174,175,194,207,220,232,239,270,303,308,317,322,335,340,361,373,379,385,391,397,402,475,481,486,508,533,538,554,568,598,604,609,623,710,715,720,732,737],{"__ignoreMap":126},[130,176,177,181,184,188,191],{"class":132,"line":133},[130,178,180],{"class":179},"s8jYJ","import",[130,182,183],{"class":179}," type",[130,185,187],{"class":186},"sxrX7"," { ContentData, SiteConfig } ",[130,189,190],{"class":179},"from",[130,192,193],{"class":140}," 'vitepress'\n",[130,195,197,199,202,204],{"class":132,"line":196},2,[130,198,180],{"class":179},[130,200,201],{"class":186}," { writeFileSync } ",[130,203,190],{"class":179},[130,205,206],{"class":140}," 'node:fs'\n",[130,208,210,212,215,217],{"class":132,"line":209},3,[130,211,180],{"class":179},[130,213,214],{"class":186}," path ",[130,216,190],{"class":179},[130,218,219],{"class":140}," 'node:path'\n",[130,221,223,225,228,230],{"class":132,"line":222},4,[130,224,180],{"class":179},[130,226,227],{"class":186}," { createContentLoader } ",[130,229,190],{"class":179},[130,231,193],{"class":140},[130,233,235],{"class":132,"line":234},5,[130,236,238],{"emptyLinePlaceholder":237},true,"\n",[130,240,242,245,248,251,254,257,261,264,267],{"class":132,"line":241},6,[130,243,244],{"class":179},"export",[130,246,247],{"class":179}," async",[130,249,250],{"class":179}," function",[130,252,253],{"class":136}," genMeta",[130,255,256],{"class":186},"(",[130,258,260],{"class":259},"sP4rz","config",[130,262,263],{"class":179},":",[130,265,266],{"class":136}," SiteConfig",[130,268,269],{"class":186},") {\n",[130,271,273,276,280,283,286,289,291,294,297,300],{"class":132,"line":272},7,[130,274,275],{"class":179},"  const",[130,277,279],{"class":278},"sBjJW"," posts",[130,281,282],{"class":179}," =",[130,284,285],{"class":179}," await",[130,287,288],{"class":136}," createContentLoader",[130,290,256],{"class":186},[130,292,293],{"class":140},"'**\u002Fblog\u002F**\u002F*.md'",[130,295,296],{"class":186},").",[130,298,299],{"class":136},"load",[130,301,302],{"class":186},"()\n",[130,304,306],{"class":132,"line":305},8,[130,307,238],{"emptyLinePlaceholder":237},[130,309,311,314],{"class":132,"line":310},9,[130,312,313],{"class":136},"  validatePosts",[130,315,316],{"class":186},"(posts)\n",[130,318,320],{"class":132,"line":319},10,[130,321,238],{"emptyLinePlaceholder":237},[130,323,325,327,330,332],{"class":132,"line":324},11,[130,326,275],{"class":179},[130,328,329],{"class":278}," meta",[130,331,282],{"class":179},[130,333,334],{"class":186}," []\n",[130,336,338],{"class":132,"line":337},12,[130,339,238],{"emptyLinePlaceholder":237},[130,341,343,346,349,352,355,358],{"class":132,"line":342},13,[130,344,345],{"class":179},"  for",[130,347,348],{"class":186}," (",[130,350,351],{"class":179},"const",[130,353,354],{"class":278}," item",[130,356,357],{"class":179}," of",[130,359,360],{"class":186}," posts) {\n",[130,362,364,367,370],{"class":132,"line":363},14,[130,365,366],{"class":186},"    meta.",[130,368,369],{"class":136},"push",[130,371,372],{"class":186},"({\n",[130,374,376],{"class":132,"line":375},15,[130,377,378],{"class":186},"      id: item.frontmatter.id,\n",[130,380,382],{"class":132,"line":381},16,[130,383,384],{"class":186},"      title: item.frontmatter.title,\n",[130,386,388],{"class":132,"line":387},17,[130,389,390],{"class":186},"    })\n",[130,392,394],{"class":132,"line":393},18,[130,395,396],{"class":186},"  }\n",[130,398,400],{"class":132,"line":399},19,[130,401,238],{"emptyLinePlaceholder":237},[130,403,405,408,411,414,417,420,423,426,428,431,434,437,440,443,446,449,452,455,458,461,464,467,469,472],{"class":132,"line":404},20,[130,406,407],{"class":136},"  writeFileSync",[130,409,410],{"class":186},"(path.",[130,412,413],{"class":136},"join",[130,415,416],{"class":186},"(config.outDir, ",[130,418,419],{"class":140},"'meta.json'",[130,421,422],{"class":186},"), ",[130,424,425],{"class":278},"JSON",[130,427,108],{"class":186},[130,429,430],{"class":136},"stringify",[130,432,433],{"class":186},"(meta.",[130,435,436],{"class":136},"sort",[130,438,439],{"class":186},"((",[130,441,442],{"class":259},"a",[130,444,445],{"class":186},", ",[130,447,448],{"class":259},"b",[130,450,451],{"class":186},") ",[130,453,454],{"class":179},"=>",[130,456,457],{"class":186}," a.id ",[130,459,460],{"class":179},"-",[130,462,463],{"class":186}," b.id), ",[130,465,466],{"class":278},"null",[130,468,445],{"class":186},[130,470,471],{"class":278},"2",[130,473,474],{"class":186},"))\n",[130,476,478],{"class":132,"line":477},21,[130,479,480],{"class":186},"}\n",[130,482,484],{"class":132,"line":483},22,[130,485,238],{"emptyLinePlaceholder":237},[130,487,489,492,495,497,500,502,505],{"class":132,"line":488},23,[130,490,491],{"class":179},"function",[130,493,494],{"class":136}," validatePosts",[130,496,256],{"class":186},[130,498,499],{"class":259},"items",[130,501,263],{"class":179},[130,503,504],{"class":136}," ContentData",[130,506,507],{"class":186},"[]) {\n",[130,509,511,513,516,518,521,524,527,530],{"class":132,"line":510},24,[130,512,275],{"class":179},[130,514,515],{"class":278}," ids",[130,517,282],{"class":179},[130,519,520],{"class":179}," new",[130,522,523],{"class":136}," Set",[130,525,526],{"class":186},"\u003C",[130,528,529],{"class":278},"string",[130,531,532],{"class":186},">()\n",[130,534,536],{"class":132,"line":535},25,[130,537,238],{"emptyLinePlaceholder":237},[130,539,541,543,545,547,549,551],{"class":132,"line":540},26,[130,542,345],{"class":179},[130,544,348],{"class":186},[130,546,351],{"class":179},[130,548,354],{"class":278},[130,550,357],{"class":179},[130,552,553],{"class":186}," items) {\n",[130,555,557,560,562,565],{"class":132,"line":556},27,[130,558,559],{"class":179},"    if",[130,561,348],{"class":186},[130,563,564],{"class":179},"!",[130,566,567],{"class":186},"item.frontmatter.id) {\n",[130,569,571,574,576,579,581,584,587,589,592,595],{"class":132,"line":570},28,[130,572,573],{"class":179},"      throw",[130,575,520],{"class":179},[130,577,578],{"class":136}," Error",[130,580,256],{"class":186},[130,582,583],{"class":140},"`Id is missing: ${",[130,585,586],{"class":186},"item",[130,588,108],{"class":140},[130,590,591],{"class":186},"url",[130,593,594],{"class":140},"}`",[130,596,597],{"class":186},")\n",[130,599,601],{"class":132,"line":600},29,[130,602,603],{"class":186},"    }\n",[130,605,607],{"class":132,"line":606},30,[130,608,238],{"emptyLinePlaceholder":237},[130,610,612,614,617,620],{"class":132,"line":611},31,[130,613,559],{"class":179},[130,615,616],{"class":186}," (ids.",[130,618,619],{"class":136},"has",[130,621,622],{"class":186},"(item.frontmatter.id)) {\n",[130,624,626,628,630,632,634,637,639,641,644,646,649,652,654,656,658,661,663,665,668,670,673,676,679,681,683,685,687,690,692,694,696,698,700,703,705,708],{"class":132,"line":625},32,[130,627,573],{"class":179},[130,629,520],{"class":179},[130,631,578],{"class":136},[130,633,256],{"class":186},[130,635,636],{"class":140},"`Id is not unique: ${",[130,638,586],{"class":186},[130,640,108],{"class":140},[130,642,643],{"class":186},"frontmatter",[130,645,108],{"class":140},[130,647,648],{"class":186},"id",[130,650,651],{"class":140},"} (${",[130,653,586],{"class":186},[130,655,108],{"class":140},[130,657,591],{"class":186},[130,659,660],{"class":140},"}) (${",[130,662,499],{"class":186},[130,664,108],{"class":140},[130,666,667],{"class":136},"find",[130,669,256],{"class":140},[130,671,672],{"class":278},"i",[130,674,675],{"class":179}," =>",[130,677,678],{"class":186}," i",[130,680,108],{"class":140},[130,682,643],{"class":186},[130,684,108],{"class":140},[130,686,648],{"class":186},[130,688,689],{"class":179}," ===",[130,691,354],{"class":186},[130,693,108],{"class":140},[130,695,643],{"class":186},[130,697,108],{"class":140},[130,699,648],{"class":186},[130,701,702],{"class":140},")?.",[130,704,591],{"class":186},[130,706,707],{"class":140},"})`",[130,709,597],{"class":186},[130,711,713],{"class":132,"line":712},33,[130,714,603],{"class":186},[130,716,718],{"class":132,"line":717},34,[130,719,238],{"emptyLinePlaceholder":237},[130,721,723,726,729],{"class":132,"line":722},35,[130,724,725],{"class":186},"    ids.",[130,727,728],{"class":136},"add",[130,730,731],{"class":186},"(item.frontmatter.id)\n",[130,733,735],{"class":132,"line":734},36,[130,736,396],{"class":186},[130,738,740],{"class":132,"line":739},37,[130,741,480],{"class":186},[10,743,744,745,748],{},"Le script se déroule en trois étapes. D'abord, ",[14,746,747],{},"createContentLoader"," lit les fichiers Markdown et analyse leur frontmatter. Ensuite, nous vérifions que chaque article possède un identifiant et que les identifiants sont uniques. C'est important : un article sans identifiant ne peut pas participer au système de commentaires, tandis que deux identifiants identiques feraient partager leurs commentaires à deux articles. Dans les deux cas, la validation lève une erreur et arrête le build.",[10,750,751,752,108],{},"Nous créons ensuite un tableau contenant l'identifiant et le titre de chaque article, puis nous l'écrivons dans ",[14,753,89],{},[10,755,756,757,759,760,101,762,765],{},"Pour l'exécuter, ajoutez ",[14,758,85],{}," au hook ",[14,761,93],{},[14,763,764],{},".vitepress\u002Fconfig.ts"," :",[120,767,769],{"className":169,"code":768,"filename":764,"language":172,"meta":126,"style":126},"import { defineConfig } from 'vitepress'\nimport { genMeta } from '.\u002Fgenerators\u002Fmeta'\n\nexport default defineConfig({\n  \u002F\u002F ...\n\n  buildEnd: async (config) => {\n    await genMeta(config)\n  },\n})\n",[14,770,771,782,794,798,810,816,820,842,852,857],{"__ignoreMap":126},[130,772,773,775,778,780],{"class":132,"line":133},[130,774,180],{"class":179},[130,776,777],{"class":186}," { defineConfig } ",[130,779,190],{"class":179},[130,781,193],{"class":140},[130,783,784,786,789,791],{"class":132,"line":196},[130,785,180],{"class":179},[130,787,788],{"class":186}," { genMeta } ",[130,790,190],{"class":179},[130,792,793],{"class":140}," '.\u002Fgenerators\u002Fmeta'\n",[130,795,796],{"class":132,"line":209},[130,797,238],{"emptyLinePlaceholder":237},[130,799,800,802,805,808],{"class":132,"line":222},[130,801,244],{"class":179},[130,803,804],{"class":179}," default",[130,806,807],{"class":136}," defineConfig",[130,809,372],{"class":186},[130,811,812],{"class":132,"line":234},[130,813,815],{"class":814},"sCsY4","  \u002F\u002F ...\n",[130,817,818],{"class":132,"line":241},[130,819,238],{"emptyLinePlaceholder":237},[130,821,822,825,828,831,833,835,837,839],{"class":132,"line":272},[130,823,824],{"class":136},"  buildEnd",[130,826,827],{"class":186},": ",[130,829,830],{"class":179},"async",[130,832,348],{"class":186},[130,834,260],{"class":259},[130,836,451],{"class":186},[130,838,454],{"class":179},[130,840,841],{"class":186}," {\n",[130,843,844,847,849],{"class":132,"line":305},[130,845,846],{"class":179},"    await",[130,848,253],{"class":136},[130,850,851],{"class":186},"(config)\n",[130,853,854],{"class":132,"line":310},[130,855,856],{"class":186},"  },\n",[130,858,859],{"class":132,"line":319},[130,860,861],{"class":186},"})\n",[10,863,864],{},"Ajoutez enfin un identifiant unique à chaque article :",[120,866,871],{"className":867,"code":868,"filename":869,"language":870,"meta":126,"style":126},"language-md shiki shiki-themes github-light github-light github-dark","---\nid: 1 [!code ++]\ntitle: Getting Started with Laravel\ndescription:\ndate: 2024-10-14\n---\n","src\u002Fblog\u002Fgetting-started-with-laravel.md","md",[14,872,873,878,888,898,906,916],{"__ignoreMap":126},[130,874,875],{"class":132,"line":133},[130,876,877],{"class":186},"---\n",[130,879,880,883,885],{"class":132,"line":196},[130,881,648],{"class":882},"sovSZ",[130,884,827],{"class":186},[130,886,887],{"class":140},"1 [!code ++]\n",[130,889,890,893,895],{"class":132,"line":209},[130,891,892],{"class":882},"title",[130,894,827],{"class":186},[130,896,897],{"class":140},"Getting Started with Laravel\n",[130,899,900,903],{"class":132,"line":222},[130,901,902],{"class":882},"description",[130,904,905],{"class":186},":\n",[130,907,908,911,913],{"class":132,"line":234},[130,909,910],{"class":882},"date",[130,912,827],{"class":186},[130,914,915],{"class":278},"2024-10-14\n",[130,917,918],{"class":132,"line":241},[130,919,877],{"class":186},[120,921,924],{"className":867,"code":922,"filename":923,"language":870,"meta":126,"style":126},"---\nid: 2\ntitle: Getting Started with Vue 3 and Vite\ndescription:\ndate: 2024-09-14\n---\n","src\u002Fblog\u002Fgetting-started-with-vue-3-and-vite.md",[14,925,926,930,939,948,954,963],{"__ignoreMap":126},[130,927,928],{"class":132,"line":133},[130,929,877],{"class":186},[130,931,932,934,936],{"class":132,"line":196},[130,933,648],{"class":882},[130,935,827],{"class":186},[130,937,938],{"class":278},"2\n",[130,940,941,943,945],{"class":132,"line":209},[130,942,892],{"class":882},[130,944,827],{"class":186},[130,946,947],{"class":140},"Getting Started with Vue 3 and Vite\n",[130,949,950,952],{"class":132,"line":222},[130,951,902],{"class":882},[130,953,905],{"class":186},[130,955,956,958,960],{"class":132,"line":234},[130,957,910],{"class":882},[130,959,827],{"class":186},[130,961,962],{"class":278},"2024-09-14\n",[130,964,965],{"class":132,"line":241},[130,966,877],{"class":186},[10,968,969,970,101,972,975],{},"Lorsque nous construirons le front-end, VitePress créera ",[14,971,61],{},[14,973,974],{},"dist",". Le fichier contiendra l'identifiant et le titre de chaque article. Vérifiez-le avec :",[120,977,979],{"className":122,"code":978,"filename":124,"language":125,"meta":126,"style":126},"npm run build\n",[14,980,981],{"__ignoreMap":126},[130,982,983,986,989],{"class":132,"line":133},[130,984,985],{"class":136},"npm",[130,987,988],{"class":140}," run",[130,990,991],{"class":140}," build\n",[120,993,995],{"className":122,"code":994,"filename":124,"language":125,"meta":126,"style":126},"cat .vitepress\u002Fdist\u002Fmeta.json\n",[14,996,997],{"__ignoreMap":126},[130,998,999,1002],{"class":132,"line":133},[130,1000,1001],{"class":136},"cat",[130,1003,1004],{"class":140}," .vitepress\u002Fdist\u002Fmeta.json\n",[10,1006,1007],{},"La sortie devrait ressembler à ceci :",[120,1009,1014],{"className":1010,"code":1011,"filename":1012,"language":1013,"meta":126,"style":126},"language-json shiki shiki-themes github-light github-light github-dark","[\n  {\n    \"id\": 1,\n    \"title\": \"Getting Started with Laravel\"\n  },\n  {\n    \"id\": 2,\n    \"title\": \"Getting Started with Vue 3 and Vite\"\n  }\n]\n",".vitepress\u002Fdist\u002Fmeta.json","json",[14,1015,1016,1021,1026,1039,1049,1053,1057,1067,1076,1080],{"__ignoreMap":126},[130,1017,1018],{"class":132,"line":133},[130,1019,1020],{"class":186},"[\n",[130,1022,1023],{"class":132,"line":196},[130,1024,1025],{"class":186},"  {\n",[130,1027,1028,1031,1033,1036],{"class":132,"line":209},[130,1029,1030],{"class":278},"    \"id\"",[130,1032,827],{"class":186},[130,1034,1035],{"class":278},"1",[130,1037,1038],{"class":186},",\n",[130,1040,1041,1044,1046],{"class":132,"line":222},[130,1042,1043],{"class":278},"    \"title\"",[130,1045,827],{"class":186},[130,1047,1048],{"class":140},"\"Getting Started with Laravel\"\n",[130,1050,1051],{"class":132,"line":234},[130,1052,856],{"class":186},[130,1054,1055],{"class":132,"line":241},[130,1056,1025],{"class":186},[130,1058,1059,1061,1063,1065],{"class":132,"line":272},[130,1060,1030],{"class":278},[130,1062,827],{"class":186},[130,1064,471],{"class":278},[130,1066,1038],{"class":186},[130,1068,1069,1071,1073],{"class":132,"line":305},[130,1070,1043],{"class":278},[130,1072,827],{"class":186},[130,1074,1075],{"class":140},"\"Getting Started with Vue 3 and Vite\"\n",[130,1077,1078],{"class":132,"line":310},[130,1079,396],{"class":186},[130,1081,1082],{"class":132,"line":319},[130,1083,1084],{"class":186},"]\n",[10,1086,1087],{},"Si vous voyez ce fichier, la partie front-end de la synchronisation est terminée.",[71,1089,1091],{"id":1090},"récupérer-les-articles-depuis-le-back-end","Récupérer les articles depuis le back-end",[10,1093,1094,1095,1098,1099,1101],{},"Le back-end doit maintenant lire ce fichier et synchroniser la base de données. Nous allons créer une commande ",[14,1096,1097],{},"app:posts-sync"," qui récupère et analyse ",[14,1100,61],{},", puis insère ou met à jour chaque article.",[110,1103,1104],{"color":112,"icon":113},[10,1105,1106,1107,1109],{},"La colonne ",[14,1108,892],{}," n'est utilisée ni par le front-end ni par l'API, mais elle facilite l'identification des enregistrements en base et peut être utile dans un panneau d'administration.",[10,1111,1112],{},"Créez la commande avec Artisan :",[120,1114,1116],{"className":122,"code":1115,"filename":124,"language":125,"meta":126,"style":126},"php artisan make:command PostsSync\n",[14,1117,1118],{"__ignoreMap":126},[130,1119,1120,1123,1126,1129],{"class":132,"line":133},[130,1121,1122],{"class":136},"php",[130,1124,1125],{"class":140}," artisan",[130,1127,1128],{"class":140}," make:command",[130,1130,1131],{"class":140}," PostsSync\n",[10,1133,1134,1135,1138],{},"La commande sera créée dans ",[14,1136,1137],{},"app\u002FConsole\u002FCommands",". Son rôle est simple :",[34,1140,1141,1147],{},[37,1142,1143,1144,1146],{},"Récupérer le fichier ",[14,1145,61],{}," depuis le front-end",[37,1148,1149],{},"Insérer ou mettre à jour chaque article dans la base de données",[10,1151,1152],{},"Voici son implémentation :",[120,1154,1158],{"className":1155,"code":1156,"filename":1157,"language":1122,"meta":126,"style":126},"language-php shiki shiki-themes github-light github-light github-dark","\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Console\\Commands;\n\nuse App\\Models\\Post;\nuse Illuminate\\Console\\Command;\nuse Illuminate\\Support\\Facades\\Config;\nuse Illuminate\\Support\\Facades\\Http;\n\nfinal class PostsSync extends Command\n{\n    \u002F**\n     * The name and signature of the console command.\n     *\n     * @var string\n     *\u002F\n    protected $signature = 'app:posts-sync';\n\n    \u002F**\n     * The console command description.\n     *\n     * @var string\n     *\u002F\n    protected $description = 'Synchronize backend posts with the frontend through the `meta.json` file.';\n\n    \u002F**\n     * Execute the console command.\n     *\u002F\n    public function handle(): void\n    {\n        \u002F**\n         * @var array\u003Carray\u003Cstring, int|string>>\n         *\u002F\n        $response = Http::get(Config::get('app.frontend_url').'\u002Fmeta.json')\n            ->json();\n\n        $meta = collect($response)->map(\n            fn (array $post): array => [\n                'meta_id' => $post['id'],\n                'title' => $post['title'],\n            ]\n        )->toArray();\n\n        Post::upsert($meta, uniqueBy: ['meta_id'], update: ['title']);\n    }\n}\n","app\u002FConsole\u002FCommands\u002FPostsSync.php",[14,1159,1160,1165,1169,1174,1178,1183,1187,1192,1197,1202,1207,1211,1216,1221,1226,1231,1236,1241,1246,1251,1255,1259,1264,1268,1272,1276,1281,1285,1289,1294,1298,1303,1308,1313,1318,1323,1328,1333,1338,1344,1350,1356,1362,1368,1374,1379,1385,1390],{"__ignoreMap":126},[130,1161,1162],{"class":132,"line":133},[130,1163,1164],{},"\u003C?php\n",[130,1166,1167],{"class":132,"line":196},[130,1168,238],{"emptyLinePlaceholder":237},[130,1170,1171],{"class":132,"line":209},[130,1172,1173],{},"declare(strict_types=1);\n",[130,1175,1176],{"class":132,"line":222},[130,1177,238],{"emptyLinePlaceholder":237},[130,1179,1180],{"class":132,"line":234},[130,1181,1182],{},"namespace App\\Console\\Commands;\n",[130,1184,1185],{"class":132,"line":241},[130,1186,238],{"emptyLinePlaceholder":237},[130,1188,1189],{"class":132,"line":272},[130,1190,1191],{},"use App\\Models\\Post;\n",[130,1193,1194],{"class":132,"line":305},[130,1195,1196],{},"use Illuminate\\Console\\Command;\n",[130,1198,1199],{"class":132,"line":310},[130,1200,1201],{},"use Illuminate\\Support\\Facades\\Config;\n",[130,1203,1204],{"class":132,"line":319},[130,1205,1206],{},"use Illuminate\\Support\\Facades\\Http;\n",[130,1208,1209],{"class":132,"line":324},[130,1210,238],{"emptyLinePlaceholder":237},[130,1212,1213],{"class":132,"line":337},[130,1214,1215],{},"final class PostsSync extends Command\n",[130,1217,1218],{"class":132,"line":342},[130,1219,1220],{},"{\n",[130,1222,1223],{"class":132,"line":363},[130,1224,1225],{},"    \u002F**\n",[130,1227,1228],{"class":132,"line":375},[130,1229,1230],{},"     * The name and signature of the console command.\n",[130,1232,1233],{"class":132,"line":381},[130,1234,1235],{},"     *\n",[130,1237,1238],{"class":132,"line":387},[130,1239,1240],{},"     * @var string\n",[130,1242,1243],{"class":132,"line":393},[130,1244,1245],{},"     *\u002F\n",[130,1247,1248],{"class":132,"line":399},[130,1249,1250],{},"    protected $signature = 'app:posts-sync';\n",[130,1252,1253],{"class":132,"line":404},[130,1254,238],{"emptyLinePlaceholder":237},[130,1256,1257],{"class":132,"line":477},[130,1258,1225],{},[130,1260,1261],{"class":132,"line":483},[130,1262,1263],{},"     * The console command description.\n",[130,1265,1266],{"class":132,"line":488},[130,1267,1235],{},[130,1269,1270],{"class":132,"line":510},[130,1271,1240],{},[130,1273,1274],{"class":132,"line":535},[130,1275,1245],{},[130,1277,1278],{"class":132,"line":540},[130,1279,1280],{},"    protected $description = 'Synchronize backend posts with the frontend through the `meta.json` file.';\n",[130,1282,1283],{"class":132,"line":556},[130,1284,238],{"emptyLinePlaceholder":237},[130,1286,1287],{"class":132,"line":570},[130,1288,1225],{},[130,1290,1291],{"class":132,"line":600},[130,1292,1293],{},"     * Execute the console command.\n",[130,1295,1296],{"class":132,"line":606},[130,1297,1245],{},[130,1299,1300],{"class":132,"line":611},[130,1301,1302],{},"    public function handle(): void\n",[130,1304,1305],{"class":132,"line":625},[130,1306,1307],{},"    {\n",[130,1309,1310],{"class":132,"line":712},[130,1311,1312],{},"        \u002F**\n",[130,1314,1315],{"class":132,"line":717},[130,1316,1317],{},"         * @var array\u003Carray\u003Cstring, int|string>>\n",[130,1319,1320],{"class":132,"line":722},[130,1321,1322],{},"         *\u002F\n",[130,1324,1325],{"class":132,"line":734},[130,1326,1327],{},"        $response = Http::get(Config::get('app.frontend_url').'\u002Fmeta.json')\n",[130,1329,1330],{"class":132,"line":739},[130,1331,1332],{},"            ->json();\n",[130,1334,1336],{"class":132,"line":1335},38,[130,1337,238],{"emptyLinePlaceholder":237},[130,1339,1341],{"class":132,"line":1340},39,[130,1342,1343],{},"        $meta = collect($response)->map(\n",[130,1345,1347],{"class":132,"line":1346},40,[130,1348,1349],{},"            fn (array $post): array => [\n",[130,1351,1353],{"class":132,"line":1352},41,[130,1354,1355],{},"                'meta_id' => $post['id'],\n",[130,1357,1359],{"class":132,"line":1358},42,[130,1360,1361],{},"                'title' => $post['title'],\n",[130,1363,1365],{"class":132,"line":1364},43,[130,1366,1367],{},"            ]\n",[130,1369,1371],{"class":132,"line":1370},44,[130,1372,1373],{},"        )->toArray();\n",[130,1375,1377],{"class":132,"line":1376},45,[130,1378,238],{"emptyLinePlaceholder":237},[130,1380,1382],{"class":132,"line":1381},46,[130,1383,1384],{},"        Post::upsert($meta, uniqueBy: ['meta_id'], update: ['title']);\n",[130,1386,1388],{"class":132,"line":1387},47,[130,1389,603],{},[130,1391,1393],{"class":132,"line":1392},48,[130,1394,480],{},[10,1396,1397,1398,1406,1407,1409],{},"La méthode ",[442,1399,1403],{"href":1400,"rel":1401},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Feloquent#upserts",[1402],"nofollow",[14,1404,1405],{},"upsert"," gère les deux cas. Elle insère les enregistrements inexistants en utilisant la clé unique ",[14,1408,20],{},", et met à jour le titre d'un enregistrement existant.",[10,1411,1412,1413,1416,1417,1420,1421,1424,1425,101,1428,108],{},"La commande doit fonctionner dans les environnements local et de production. En local, le front-end peut être servi depuis ",[14,1414,1415],{},"localhost:5173"," ou ",[14,1418,1419],{},"localhost:4173"," pendant une prévisualisation. En production, il est servi depuis une URL publique. Nous gérons cette différence avec la variable d'environnement ",[14,1422,1423],{},"APP_FRONTEND_URL",", exposée sous la clé ",[14,1426,1427],{},"frontend_url",[14,1429,1430],{},"config\u002Fapp.php",[120,1432,1437],{"className":1433,"code":1434,"filename":1435,"language":1436,"meta":126,"style":126},"language-ini shiki shiki-themes github-light github-light github-dark","APP_FRONTEND_URL=http:\u002F\u002Flocalhost:4173\n",".env.example","ini",[14,1438,1439],{"__ignoreMap":126},[130,1440,1441],{"class":132,"line":133},[130,1442,1434],{},[120,1444,1446],{"className":1155,"code":1445,"filename":1430,"language":1122,"meta":126,"style":126},"return [\n    \u002F\u002F ...\n\n    'frontend_url' => env('APP_FRONTEND_URL', 'http:\u002F\u002Flocalhost:4173'),\n\n    \u002F\u002F ...\n];\n",[14,1447,1448,1453,1458,1462,1467,1471,1475],{"__ignoreMap":126},[130,1449,1450],{"class":132,"line":133},[130,1451,1452],{},"return [\n",[130,1454,1455],{"class":132,"line":196},[130,1456,1457],{},"    \u002F\u002F ...\n",[130,1459,1460],{"class":132,"line":209},[130,1461,238],{"emptyLinePlaceholder":237},[130,1463,1464],{"class":132,"line":222},[130,1465,1466],{},"    'frontend_url' => env('APP_FRONTEND_URL', 'http:\u002F\u002Flocalhost:4173'),\n",[130,1468,1469],{"class":132,"line":234},[130,1470,238],{"emptyLinePlaceholder":237},[130,1472,1473],{"class":132,"line":241},[130,1474,1457],{},[130,1476,1477],{"class":132,"line":272},[130,1478,1479],{},"];\n",[10,1481,1482],{},"Le code est alors identique dans les deux environnements ; seule la variable d'environnement change.",[10,1484,1485],{},"En développement, démarrez le serveur de prévisualisation du front-end :",[120,1487,1489],{"className":122,"code":1488,"filename":124,"language":125,"meta":126,"style":126},"npm run build && npm run preview\n",[14,1490,1491],{"__ignoreMap":126},[130,1492,1493,1495,1497,1500,1503,1505,1507],{"class":132,"line":133},[130,1494,985],{"class":136},[130,1496,988],{"class":140},[130,1498,1499],{"class":140}," build",[130,1501,1502],{"class":186}," && ",[130,1504,985],{"class":136},[130,1506,988],{"class":140},[130,1508,1509],{"class":140}," preview\n",[10,1511,1512],{},"Lancez ensuite la commande de synchronisation :",[120,1514,1516],{"className":122,"code":1515,"filename":124,"language":125,"meta":126,"style":126},"php artisan app:posts-sync\n",[14,1517,1518],{"__ignoreMap":126},[130,1519,1520,1522,1524],{"class":132,"line":133},[130,1521,1122],{"class":136},[130,1523,1125],{"class":140},[130,1525,1526],{"class":140}," app:posts-sync\n",[110,1528,1529],{"color":112,"icon":113},[10,1530,1531,1532,101,1534,1537],{},"Définissez la bonne valeur de ",[14,1533,1423],{},[14,1535,1536],{},".env"," avant de lancer la commande.",[10,1539,1540,1541,1544,1545,1547],{},"Si vous voyez ",[14,1542,1543],{},"SQLSTATE[HY000]: General error: 1 no such table: posts",", la table ",[14,1546,16],{}," n'a pas encore été créée. Exécutez :",[120,1549,1551],{"className":122,"code":1550,"filename":124,"language":125,"meta":126,"style":126},"php artisan migrate\n",[14,1552,1553],{"__ignoreMap":126},[130,1554,1555,1557,1559],{"class":132,"line":133},[130,1556,1122],{"class":136},[130,1558,1125],{"class":140},[130,1560,1561],{"class":140}," migrate\n",[10,1563,1564],{},"Vous pouvez maintenant lancer la commande de synchronisation autant de fois que nécessaire sans créer de doublons.",[1566,1567,1569],"h3",{"id":1568},"tester-la-commande","Tester la commande",[10,1571,1572,1573,1576],{},"Cette commande fait partie de notre application, nous devons donc la tester. Pour cela, nous allons simuler la façade ",[14,1574,1575],{},"Http",". Nous pouvons ainsi tester la commande sans dépendre du réseau. C'est l'un des rares cas où un mock est utile.",[10,1578,1579,1580,1587,1588,1590],{},"Pour simuler le client HTTP, utilisez ",[442,1581,1584],{"href":1582,"rel":1583},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fhttp-client#testing",[1402],[14,1585,1586],{},"Http::fake",". Il permet au test de fournir une réponse ",[14,1589,61],{}," prévisible sans dépendre du réseau.",[120,1592,1595],{"className":1155,"code":1593,"filename":1594,"language":1122,"meta":126,"style":126},"\u003C?php\n\ndeclare(strict_types=1);\n\nuse Illuminate\\Support\\Facades\\Config;\nuse Illuminate\\Support\\Facades\\Http;\n\nit('fetches posts meta', function () {\n    Http::fake([\n        Config::get('app.frontend_url').'\u002Fmeta.json' => Http::response([\n            [\n                'id' => 1,\n                'title' => 'Post 1',\n            ],\n            [\n                'id' => 2,\n                'title' => 'Post 2',\n            ],\n        ], 200),\n    ]);\n\n    $this->artisan('app:posts-sync')\n        ->assertExitCode(0);\n\n    Http::assertSentCount(1);\n\n    $this->assertDatabaseCount('posts', 2);\n    $this->assertDatabaseHas('posts', [\n        'meta_id' => 1,\n        'title' => 'Post 1',\n    ]);\n});\n\nit('does not insert duplicates', function () {\n    Http::fake([\n        Config::get('app.frontend_url').'\u002Fmeta.json' => Http::response([\n            [\n                'id' => 1,\n                'title' => 'Post 1',\n            ],\n            [\n                'id' => 1,\n                'title' => 'Post 1',\n            ],\n        ], 200),\n    ]);\n\n    $this->artisan('app:posts-sync')\n        ->assertExitCode(0);\n\n    Http::assertSentCount(1);\n\n    $this->assertDatabaseCount('posts', 1);\n    $this->assertDatabaseHas('posts', [\n        'meta_id' => 1,\n        'title' => 'Post 1',\n    ]);\n});\n\nit('updates the data based on the id', function () {\n    Http::fake([\n        Config::get('app.frontend_url').'\u002Fmeta.json' => Http::response([\n            [\n                'id' => 1,\n                'title' => 'Post 1',\n            ],\n            [\n                'id' => 1,\n                'title' => 'Post 1 Updated',\n            ],\n        ], 200),\n    ]);\n\n    $this->artisan('app:posts-sync')\n        ->assertExitCode(0);\n\n    Http::assertSentCount(1);\n\n    $this->assertDatabaseCount('posts', 1);\n    $this->assertDatabaseHas('posts', [\n        'meta_id' => 1,\n        'title' => 'Post 1 Updated',\n    ]);\n});\n","tests\u002FConsole\u002FPostsSyncTest.php",[14,1596,1597,1601,1605,1609,1613,1617,1621,1625,1630,1635,1640,1645,1650,1655,1660,1664,1669,1674,1678,1683,1688,1692,1697,1702,1706,1711,1715,1720,1725,1730,1735,1739,1744,1748,1753,1757,1761,1765,1769,1773,1777,1781,1785,1789,1793,1797,1801,1805,1809,1814,1819,1824,1829,1835,1840,1845,1850,1855,1860,1865,1871,1876,1881,1886,1891,1896,1901,1906,1911,1917,1922,1927,1932,1937,1942,1947,1952,1957,1962,1967,1972,1977,1983,1988],{"__ignoreMap":126},[130,1598,1599],{"class":132,"line":133},[130,1600,1164],{},[130,1602,1603],{"class":132,"line":196},[130,1604,238],{"emptyLinePlaceholder":237},[130,1606,1607],{"class":132,"line":209},[130,1608,1173],{},[130,1610,1611],{"class":132,"line":222},[130,1612,238],{"emptyLinePlaceholder":237},[130,1614,1615],{"class":132,"line":234},[130,1616,1201],{},[130,1618,1619],{"class":132,"line":241},[130,1620,1206],{},[130,1622,1623],{"class":132,"line":272},[130,1624,238],{"emptyLinePlaceholder":237},[130,1626,1627],{"class":132,"line":305},[130,1628,1629],{},"it('fetches posts meta', function () {\n",[130,1631,1632],{"class":132,"line":310},[130,1633,1634],{},"    Http::fake([\n",[130,1636,1637],{"class":132,"line":319},[130,1638,1639],{},"        Config::get('app.frontend_url').'\u002Fmeta.json' => Http::response([\n",[130,1641,1642],{"class":132,"line":324},[130,1643,1644],{},"            [\n",[130,1646,1647],{"class":132,"line":337},[130,1648,1649],{},"                'id' => 1,\n",[130,1651,1652],{"class":132,"line":342},[130,1653,1654],{},"                'title' => 'Post 1',\n",[130,1656,1657],{"class":132,"line":363},[130,1658,1659],{},"            ],\n",[130,1661,1662],{"class":132,"line":375},[130,1663,1644],{},[130,1665,1666],{"class":132,"line":381},[130,1667,1668],{},"                'id' => 2,\n",[130,1670,1671],{"class":132,"line":387},[130,1672,1673],{},"                'title' => 'Post 2',\n",[130,1675,1676],{"class":132,"line":393},[130,1677,1659],{},[130,1679,1680],{"class":132,"line":399},[130,1681,1682],{},"        ], 200),\n",[130,1684,1685],{"class":132,"line":404},[130,1686,1687],{},"    ]);\n",[130,1689,1690],{"class":132,"line":477},[130,1691,238],{"emptyLinePlaceholder":237},[130,1693,1694],{"class":132,"line":483},[130,1695,1696],{},"    $this->artisan('app:posts-sync')\n",[130,1698,1699],{"class":132,"line":488},[130,1700,1701],{},"        ->assertExitCode(0);\n",[130,1703,1704],{"class":132,"line":510},[130,1705,238],{"emptyLinePlaceholder":237},[130,1707,1708],{"class":132,"line":535},[130,1709,1710],{},"    Http::assertSentCount(1);\n",[130,1712,1713],{"class":132,"line":540},[130,1714,238],{"emptyLinePlaceholder":237},[130,1716,1717],{"class":132,"line":556},[130,1718,1719],{},"    $this->assertDatabaseCount('posts', 2);\n",[130,1721,1722],{"class":132,"line":570},[130,1723,1724],{},"    $this->assertDatabaseHas('posts', [\n",[130,1726,1727],{"class":132,"line":600},[130,1728,1729],{},"        'meta_id' => 1,\n",[130,1731,1732],{"class":132,"line":606},[130,1733,1734],{},"        'title' => 'Post 1',\n",[130,1736,1737],{"class":132,"line":611},[130,1738,1687],{},[130,1740,1741],{"class":132,"line":625},[130,1742,1743],{},"});\n",[130,1745,1746],{"class":132,"line":712},[130,1747,238],{"emptyLinePlaceholder":237},[130,1749,1750],{"class":132,"line":717},[130,1751,1752],{},"it('does not insert duplicates', function () {\n",[130,1754,1755],{"class":132,"line":722},[130,1756,1634],{},[130,1758,1759],{"class":132,"line":734},[130,1760,1639],{},[130,1762,1763],{"class":132,"line":739},[130,1764,1644],{},[130,1766,1767],{"class":132,"line":1335},[130,1768,1649],{},[130,1770,1771],{"class":132,"line":1340},[130,1772,1654],{},[130,1774,1775],{"class":132,"line":1346},[130,1776,1659],{},[130,1778,1779],{"class":132,"line":1352},[130,1780,1644],{},[130,1782,1783],{"class":132,"line":1358},[130,1784,1649],{},[130,1786,1787],{"class":132,"line":1364},[130,1788,1654],{},[130,1790,1791],{"class":132,"line":1370},[130,1792,1659],{},[130,1794,1795],{"class":132,"line":1376},[130,1796,1682],{},[130,1798,1799],{"class":132,"line":1381},[130,1800,1687],{},[130,1802,1803],{"class":132,"line":1387},[130,1804,238],{"emptyLinePlaceholder":237},[130,1806,1807],{"class":132,"line":1392},[130,1808,1696],{},[130,1810,1812],{"class":132,"line":1811},49,[130,1813,1701],{},[130,1815,1817],{"class":132,"line":1816},50,[130,1818,238],{"emptyLinePlaceholder":237},[130,1820,1822],{"class":132,"line":1821},51,[130,1823,1710],{},[130,1825,1827],{"class":132,"line":1826},52,[130,1828,238],{"emptyLinePlaceholder":237},[130,1830,1832],{"class":132,"line":1831},53,[130,1833,1834],{},"    $this->assertDatabaseCount('posts', 1);\n",[130,1836,1838],{"class":132,"line":1837},54,[130,1839,1724],{},[130,1841,1843],{"class":132,"line":1842},55,[130,1844,1729],{},[130,1846,1848],{"class":132,"line":1847},56,[130,1849,1734],{},[130,1851,1853],{"class":132,"line":1852},57,[130,1854,1687],{},[130,1856,1858],{"class":132,"line":1857},58,[130,1859,1743],{},[130,1861,1863],{"class":132,"line":1862},59,[130,1864,238],{"emptyLinePlaceholder":237},[130,1866,1868],{"class":132,"line":1867},60,[130,1869,1870],{},"it('updates the data based on the id', function () {\n",[130,1872,1874],{"class":132,"line":1873},61,[130,1875,1634],{},[130,1877,1879],{"class":132,"line":1878},62,[130,1880,1639],{},[130,1882,1884],{"class":132,"line":1883},63,[130,1885,1644],{},[130,1887,1889],{"class":132,"line":1888},64,[130,1890,1649],{},[130,1892,1894],{"class":132,"line":1893},65,[130,1895,1654],{},[130,1897,1899],{"class":132,"line":1898},66,[130,1900,1659],{},[130,1902,1904],{"class":132,"line":1903},67,[130,1905,1644],{},[130,1907,1909],{"class":132,"line":1908},68,[130,1910,1649],{},[130,1912,1914],{"class":132,"line":1913},69,[130,1915,1916],{},"                'title' => 'Post 1 Updated',\n",[130,1918,1920],{"class":132,"line":1919},70,[130,1921,1659],{},[130,1923,1925],{"class":132,"line":1924},71,[130,1926,1682],{},[130,1928,1930],{"class":132,"line":1929},72,[130,1931,1687],{},[130,1933,1935],{"class":132,"line":1934},73,[130,1936,238],{"emptyLinePlaceholder":237},[130,1938,1940],{"class":132,"line":1939},74,[130,1941,1696],{},[130,1943,1945],{"class":132,"line":1944},75,[130,1946,1701],{},[130,1948,1950],{"class":132,"line":1949},76,[130,1951,238],{"emptyLinePlaceholder":237},[130,1953,1955],{"class":132,"line":1954},77,[130,1956,1710],{},[130,1958,1960],{"class":132,"line":1959},78,[130,1961,238],{"emptyLinePlaceholder":237},[130,1963,1965],{"class":132,"line":1964},79,[130,1966,1834],{},[130,1968,1970],{"class":132,"line":1969},80,[130,1971,1724],{},[130,1973,1975],{"class":132,"line":1974},81,[130,1976,1729],{},[130,1978,1980],{"class":132,"line":1979},82,[130,1981,1982],{},"        'title' => 'Post 1 Updated',\n",[130,1984,1986],{"class":132,"line":1985},83,[130,1987,1687],{},[130,1989,1991],{"class":132,"line":1990},84,[130,1992,1743],{},[10,1994,1995,1996,1999,2000,2003],{},"Les tests de la commande se trouvent dans un nouveau dossier ",[14,1997,1998],{},"Console",". Ajoutez ce dossier à ",[14,2001,2002],{},"phpunit.xml"," pour que PHPUnit les découvre :",[120,2005,2009],{"className":2006,"code":2007,"filename":2002,"language":2008,"meta":126,"style":126},"language-xml shiki shiki-themes github-light github-light github-dark","\u003C?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\u003Cphpunit xmlns:xsi=\"http:\u002F\u002Fwww.w3.org\u002F2001\u002FXMLSchema-instance\"\n         xsi:noNamespaceSchemaLocation=\"vendor\u002Fphpunit\u002Fphpunit\u002Fphpunit.xsd\"\n         bootstrap=\"vendor\u002Fautoload.php\"\n         colors=\"true\"\n>\n    \u003Ctestsuites>\n        \u003Ctestsuite name=\"Console\"> \u003C!-- [!code ++] -->\n            \u003Cdirectory>tests\u002FConsole\u003C\u002Fdirectory> \u003C!-- [!code ++] -->\n        \u003C\u002Ftestsuite> \u003C!-- [!code ++] -->\n    \u003C\u002Ftestsuites>\n\u003C\u002Fphpunit>\n","xml",[14,2010,2011,2016,2021,2026,2031,2036,2041,2046,2051,2056,2061,2066],{"__ignoreMap":126},[130,2012,2013],{"class":132,"line":133},[130,2014,2015],{},"\u003C?xml version=\"1.0\" encoding=\"UTF-8\"?>\n",[130,2017,2018],{"class":132,"line":196},[130,2019,2020],{},"\u003Cphpunit xmlns:xsi=\"http:\u002F\u002Fwww.w3.org\u002F2001\u002FXMLSchema-instance\"\n",[130,2022,2023],{"class":132,"line":209},[130,2024,2025],{},"         xsi:noNamespaceSchemaLocation=\"vendor\u002Fphpunit\u002Fphpunit\u002Fphpunit.xsd\"\n",[130,2027,2028],{"class":132,"line":222},[130,2029,2030],{},"         bootstrap=\"vendor\u002Fautoload.php\"\n",[130,2032,2033],{"class":132,"line":234},[130,2034,2035],{},"         colors=\"true\"\n",[130,2037,2038],{"class":132,"line":241},[130,2039,2040],{},">\n",[130,2042,2043],{"class":132,"line":272},[130,2044,2045],{},"    \u003Ctestsuites>\n",[130,2047,2048],{"class":132,"line":305},[130,2049,2050],{},"        \u003Ctestsuite name=\"Console\"> \u003C!-- [!code ++] -->\n",[130,2052,2053],{"class":132,"line":310},[130,2054,2055],{},"            \u003Cdirectory>tests\u002FConsole\u003C\u002Fdirectory> \u003C!-- [!code ++] -->\n",[130,2057,2058],{"class":132,"line":319},[130,2059,2060],{},"        \u003C\u002Ftestsuite> \u003C!-- [!code ++] -->\n",[130,2062,2063],{"class":132,"line":324},[130,2064,2065],{},"    \u003C\u002Ftestsuites>\n",[130,2067,2068],{"class":132,"line":337},[130,2069,2070],{},"\u003C\u002Fphpunit>\n",[10,2072,2073],{},"Comme ces tests accèdent à la base de données, mettez à jour Pest afin qu'il la réinitialise avant chaque test :",[120,2075,2078],{"className":1155,"code":2076,"filename":2077,"language":1122,"meta":126,"style":126},"pest()->extend(Tests\\TestCase::class)\n    ->use(Illuminate\\Foundation\\Testing\\RefreshDatabase::class)\n    ->in('Console', 'Http', 'Unit'); \u002F\u002F [!code highlighter]\n","tests\u002FPest.php",[14,2079,2080,2085,2090],{"__ignoreMap":126},[130,2081,2082],{"class":132,"line":133},[130,2083,2084],{},"pest()->extend(Tests\\TestCase::class)\n",[130,2086,2087],{"class":132,"line":196},[130,2088,2089],{},"    ->use(Illuminate\\Foundation\\Testing\\RefreshDatabase::class)\n",[130,2091,2092],{"class":132,"line":209},[130,2093,2094],{},"    ->in('Console', 'Http', 'Unit'); \u002F\u002F [!code highlighter]\n",[71,2096,2098],{"id":2097},"derniers-mots","Derniers mots",[10,2100,2101],{},"Le front-end et le back-end partagent maintenant un identifiant stable pour chaque article. VitePress génère les métadonnées et Laravel peut synchroniser ses enregistrements sans mise à jour manuelle de la base de données.",[10,2103,2104],{},"Nous disposons maintenant du pont nécessaire aux fonctionnalités interactives. Ensuite, nous configurerons Sanctum, CORS et la protection CSRF, puis nous enverrons les premières requêtes de VitePress vers Laravel.",[2106,2107,2108],"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 .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}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}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 pre.shiki code .sovSZ, html code.shiki .sovSZ{--shiki-light:#22863A;--shiki-default:#22863A;--shiki-dark:#85E89D}",{"title":126,"searchDepth":196,"depth":196,"links":2110},[2111,2113,2116],{"id":73,"depth":196,"text":2112},"Générer le fichier meta.json",{"id":1090,"depth":196,"text":1091,"children":2114},[2115],{"id":1568,"depth":209,"text":1569},{"id":2097,"depth":196,"text":2098},"1cf0ee5e-a0df-4f7d-b281-a083099223e9","2025-02-25","Générez les métadonnées avec VitePress, synchronisez les articles avec Laravel et gardez automatiquement la base de données à jour.",null,{},"\u002Ffr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fautomating-your-backend-to-stay-in-sync-effortlessly","---\ncontentId: 1cf0ee5e-a0df-4f7d-b281-a083099223e9\npart: 5\ntitle: Automatiser facilement la synchronisation de votre back-end\ndescription: Générez les métadonnées avec VitePress, synchronisez les articles avec Laravel et gardez automatiquement la base de données à jour.\ndate: 2025-02-25\nseriesSlug: empower-and-dynamize-our-vitepress-blog-with-a-laravel-api\n---\n\nÀ la fin de l'article précédent, nous avons créé une table `posts` avec une colonne `meta_id`. Nous ne l'avons pas encore utilisée, cet article va donc la relier au front-end.\n\nVitePress génère un site statique au moment du build, tandis que les commentaires sont chargés dynamiquement pour l'article actuellement consulté. Pour que cela fonctionne, le front-end et le back-end doivent disposer d'un moyen stable d'identifier le même article.\n\nPar exemple, le blog \u003CGitHubLink repo=\"barbapapazes\u002Fgarabit\" \u002F> possède deux articles avec les slugs suivants :\n\n1. Getting Started with Laravel (`getting-started-with-laravel`)\n2. Getting Started with Vue 3 and Vite (`getting-started-with-vue-3-and-vite`)\n\nNous pourrions utiliser le slug comme identifiant, mais les slugs changent parfois à cause d'une faute de frappe, du référencement ou d'une évolution du contenu. Conserver un ancien slug uniquement pour préserver un identifiant rend les URL moins utiles. Nous avons besoin d'un identifiant distinct, qui reste stable même lorsque le slug change.\n\nLa solution consiste à stocker un identifiant stable dans le frontmatter de chaque article. Cet identifiant représente l'article et ne change pas lorsque son titre, son contenu ou son slug évolue.\n\nIl reste à savoir comment envoyer ces identifiants au back-end. Une synchronisation manuelle est source d'erreurs et facile à automatiser ; le front-end va donc générer un fichier `meta.json` au moment du build. Il contiendra l'identifiant et le titre de chaque article. Le back-end lira ce fichier et créera ou mettra à jour les enregistrements correspondants dans la base de données. Le front-end pourra ensuite récupérer les commentaires en utilisant l'identifiant du frontmatter, tandis que la colonne `posts.id` restera une clé interne servant à relier les articles aux commentaires.\n\nL'architecture est simple : VitePress écrit les métadonnées des articles et Laravel les lit pour garder ses enregistrements synchronisés.\n\n## Générer le fichier `meta.json`\n\nPour cette partie, ouvrez le projet \u003CGitHubLink repo=\"barbapapazes\u002Fgarabit\" \u002F>. Nous allons créer une fonction `genMeta` qui lit tous les fichiers Markdown, extrait leur identifiant et leur titre depuis le frontmatter, puis les écrit dans `dist\u002Fmeta.json` grâce au hook `buildEnd` de VitePress. VitePress appelle ce hook une fois le reste du build terminé, ce qui en fait un bon endroit pour générer le fichier.\n\nCommencez par créer un dossier `generators` dans `.vitepress`. Il contiendra les fonctions appelées par le hook `buildEnd`.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\n`generators` n'est qu'un choix de nom. Vous pouvez utiliser celui qui vous convient.\n::\n\n```bash [terminal]\nmkdir .vitepress\u002Fgenerators\n```\n\nCréez `meta.ts` dans ce dossier. Il contiendra `genMeta`.\n\n```bash [terminal]\ntouch .vitepress\u002Fgenerators\u002Fmeta.ts\n```\n\nÉcrivons enfin la fonction :\n\n```ts [.vitepress\u002Fgenerators\u002Fmeta.ts]\nimport type { ContentData, SiteConfig } from 'vitepress'\nimport { writeFileSync } from 'node:fs'\nimport path from 'node:path'\nimport { createContentLoader } from 'vitepress'\n\nexport async function genMeta(config: SiteConfig) {\n  const posts = await createContentLoader('**\u002Fblog\u002F**\u002F*.md').load()\n\n  validatePosts(posts)\n\n  const meta = []\n\n  for (const item of posts) {\n    meta.push({\n      id: item.frontmatter.id,\n      title: item.frontmatter.title,\n    })\n  }\n\n  writeFileSync(path.join(config.outDir, 'meta.json'), JSON.stringify(meta.sort((a, b) => a.id - b.id), null, 2))\n}\n\nfunction validatePosts(items: ContentData[]) {\n  const ids = new Set\u003Cstring>()\n\n  for (const item of items) {\n    if (!item.frontmatter.id) {\n      throw new Error(`Id is missing: ${item.url}`)\n    }\n\n    if (ids.has(item.frontmatter.id)) {\n      throw new Error(`Id is not unique: ${item.frontmatter.id} (${item.url}) (${items.find(i => i.frontmatter.id === item.frontmatter.id)?.url})`)\n    }\n\n    ids.add(item.frontmatter.id)\n  }\n}\n```\n\nLe script se déroule en trois étapes. D'abord, `createContentLoader` lit les fichiers Markdown et analyse leur frontmatter. Ensuite, nous vérifions que chaque article possède un identifiant et que les identifiants sont uniques. C'est important : un article sans identifiant ne peut pas participer au système de commentaires, tandis que deux identifiants identiques feraient partager leurs commentaires à deux articles. Dans les deux cas, la validation lève une erreur et arrête le build.\n\nNous créons ensuite un tableau contenant l'identifiant et le titre de chaque article, puis nous l'écrivons dans `dist\u002Fmeta.json`.\n\nPour l'exécuter, ajoutez `genMeta` au hook `buildEnd` dans `.vitepress\u002Fconfig.ts` :\n\n```ts [.vitepress\u002Fconfig.ts]\nimport { defineConfig } from 'vitepress'\nimport { genMeta } from '.\u002Fgenerators\u002Fmeta'\n\nexport default defineConfig({\n  \u002F\u002F ...\n\n  buildEnd: async (config) => {\n    await genMeta(config)\n  },\n})\n```\n\nAjoutez enfin un identifiant unique à chaque article :\n\n```md [src\u002Fblog\u002Fgetting-started-with-laravel.md]\n---\nid: 1 [!code ++]\ntitle: Getting Started with Laravel\ndescription:\ndate: 2024-10-14\n---\n```\n\n```md [src\u002Fblog\u002Fgetting-started-with-vue-3-and-vite.md]\n---\nid: 2\ntitle: Getting Started with Vue 3 and Vite\ndescription:\ndate: 2024-09-14\n---\n```\n\nLorsque nous construirons le front-end, VitePress créera `meta.json` dans `dist`. Le fichier contiendra l'identifiant et le titre de chaque article. Vérifiez-le avec :\n\n```bash [terminal]\nnpm run build\n```\n\n```bash [terminal]\ncat .vitepress\u002Fdist\u002Fmeta.json\n```\n\nLa sortie devrait ressembler à ceci :\n\n```json [.vitepress\u002Fdist\u002Fmeta.json]\n[\n  {\n    \"id\": 1,\n    \"title\": \"Getting Started with Laravel\"\n  },\n  {\n    \"id\": 2,\n    \"title\": \"Getting Started with Vue 3 and Vite\"\n  }\n]\n```\n\nSi vous voyez ce fichier, la partie front-end de la synchronisation est terminée.\n\n## Récupérer les articles depuis le back-end\n\nLe back-end doit maintenant lire ce fichier et synchroniser la base de données. Nous allons créer une commande `app:posts-sync` qui récupère et analyse `meta.json`, puis insère ou met à jour chaque article.\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nLa colonne `title` n'est utilisée ni par le front-end ni par l'API, mais elle facilite l'identification des enregistrements en base et peut être utile dans un panneau d'administration.\n::\n\nCréez la commande avec Artisan :\n\n```bash [terminal]\nphp artisan make:command PostsSync\n```\n\nLa commande sera créée dans `app\u002FConsole\u002FCommands`. Son rôle est simple :\n\n1. Récupérer le fichier `meta.json` depuis le front-end\n2. Insérer ou mettre à jour chaque article dans la base de données\n\nVoici son implémentation :\n\n```php [app\u002FConsole\u002FCommands\u002FPostsSync.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nnamespace App\\Console\\Commands;\n\nuse App\\Models\\Post;\nuse Illuminate\\Console\\Command;\nuse Illuminate\\Support\\Facades\\Config;\nuse Illuminate\\Support\\Facades\\Http;\n\nfinal class PostsSync extends Command\n{\n    \u002F**\n     * The name and signature of the console command.\n     *\n     * @var string\n     *\u002F\n    protected $signature = 'app:posts-sync';\n\n    \u002F**\n     * The console command description.\n     *\n     * @var string\n     *\u002F\n    protected $description = 'Synchronize backend posts with the frontend through the `meta.json` file.';\n\n    \u002F**\n     * Execute the console command.\n     *\u002F\n    public function handle(): void\n    {\n        \u002F**\n         * @var array\u003Carray\u003Cstring, int|string>>\n         *\u002F\n        $response = Http::get(Config::get('app.frontend_url').'\u002Fmeta.json')\n            ->json();\n\n        $meta = collect($response)->map(\n            fn (array $post): array => [\n                'meta_id' => $post['id'],\n                'title' => $post['title'],\n            ]\n        )->toArray();\n\n        Post::upsert($meta, uniqueBy: ['meta_id'], update: ['title']);\n    }\n}\n```\n\nLa méthode [`upsert`](https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Feloquent#upserts) gère les deux cas. Elle insère les enregistrements inexistants en utilisant la clé unique `meta_id`, et met à jour le titre d'un enregistrement existant.\n\nLa commande doit fonctionner dans les environnements local et de production. En local, le front-end peut être servi depuis `localhost:5173` ou `localhost:4173` pendant une prévisualisation. En production, il est servi depuis une URL publique. Nous gérons cette différence avec la variable d'environnement `APP_FRONTEND_URL`, exposée sous la clé `frontend_url` dans `config\u002Fapp.php`.\n\n```ini [.env.example]\nAPP_FRONTEND_URL=http:\u002F\u002Flocalhost:4173\n```\n\n```php [config\u002Fapp.php]\nreturn [\n    \u002F\u002F ...\n\n    'frontend_url' => env('APP_FRONTEND_URL', 'http:\u002F\u002Flocalhost:4173'),\n\n    \u002F\u002F ...\n];\n```\n\nLe code est alors identique dans les deux environnements ; seule la variable d'environnement change.\n\nEn développement, démarrez le serveur de prévisualisation du front-end :\n\n```bash [terminal]\nnpm run build && npm run preview\n```\n\nLancez ensuite la commande de synchronisation :\n\n```bash [terminal]\nphp artisan app:posts-sync\n```\n\n::callout{icon=\"i-ph-info-duotone\" color=\"info\"}\nDéfinissez la bonne valeur de `APP_FRONTEND_URL` dans `.env` avant de lancer la commande.\n::\n\nSi vous voyez `SQLSTATE[HY000]: General error: 1 no such table: posts`, la table `posts` n'a pas encore été créée. Exécutez :\n\n```bash [terminal]\nphp artisan migrate\n```\n\nVous pouvez maintenant lancer la commande de synchronisation autant de fois que nécessaire sans créer de doublons.\n\n### Tester la commande\n\nCette commande fait partie de notre application, nous devons donc la tester. Pour cela, nous allons simuler la façade `Http`. Nous pouvons ainsi tester la commande sans dépendre du réseau. C'est l'un des rares cas où un mock est utile.\n\nPour simuler le client HTTP, utilisez [`Http::fake`](https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fhttp-client#testing). Il permet au test de fournir une réponse `meta.json` prévisible sans dépendre du réseau.\n\n```php [tests\u002FConsole\u002FPostsSyncTest.php]\n\u003C?php\n\ndeclare(strict_types=1);\n\nuse Illuminate\\Support\\Facades\\Config;\nuse Illuminate\\Support\\Facades\\Http;\n\nit('fetches posts meta', function () {\n    Http::fake([\n        Config::get('app.frontend_url').'\u002Fmeta.json' => Http::response([\n            [\n                'id' => 1,\n                'title' => 'Post 1',\n            ],\n            [\n                'id' => 2,\n                'title' => 'Post 2',\n            ],\n        ], 200),\n    ]);\n\n    $this->artisan('app:posts-sync')\n        ->assertExitCode(0);\n\n    Http::assertSentCount(1);\n\n    $this->assertDatabaseCount('posts', 2);\n    $this->assertDatabaseHas('posts', [\n        'meta_id' => 1,\n        'title' => 'Post 1',\n    ]);\n});\n\nit('does not insert duplicates', function () {\n    Http::fake([\n        Config::get('app.frontend_url').'\u002Fmeta.json' => Http::response([\n            [\n                'id' => 1,\n                'title' => 'Post 1',\n            ],\n            [\n                'id' => 1,\n                'title' => 'Post 1',\n            ],\n        ], 200),\n    ]);\n\n    $this->artisan('app:posts-sync')\n        ->assertExitCode(0);\n\n    Http::assertSentCount(1);\n\n    $this->assertDatabaseCount('posts', 1);\n    $this->assertDatabaseHas('posts', [\n        'meta_id' => 1,\n        'title' => 'Post 1',\n    ]);\n});\n\nit('updates the data based on the id', function () {\n    Http::fake([\n        Config::get('app.frontend_url').'\u002Fmeta.json' => Http::response([\n            [\n                'id' => 1,\n                'title' => 'Post 1',\n            ],\n            [\n                'id' => 1,\n                'title' => 'Post 1 Updated',\n            ],\n        ], 200),\n    ]);\n\n    $this->artisan('app:posts-sync')\n        ->assertExitCode(0);\n\n    Http::assertSentCount(1);\n\n    $this->assertDatabaseCount('posts', 1);\n    $this->assertDatabaseHas('posts', [\n        'meta_id' => 1,\n        'title' => 'Post 1 Updated',\n    ]);\n});\n```\n\nLes tests de la commande se trouvent dans un nouveau dossier `Console`. Ajoutez ce dossier à `phpunit.xml` pour que PHPUnit les découvre :\n\n```xml [phpunit.xml]\n\u003C?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\u003Cphpunit xmlns:xsi=\"http:\u002F\u002Fwww.w3.org\u002F2001\u002FXMLSchema-instance\"\n         xsi:noNamespaceSchemaLocation=\"vendor\u002Fphpunit\u002Fphpunit\u002Fphpunit.xsd\"\n         bootstrap=\"vendor\u002Fautoload.php\"\n         colors=\"true\"\n>\n    \u003Ctestsuites>\n        \u003Ctestsuite name=\"Console\"> \u003C!-- [!code ++] -->\n            \u003Cdirectory>tests\u002FConsole\u003C\u002Fdirectory> \u003C!-- [!code ++] -->\n        \u003C\u002Ftestsuite> \u003C!-- [!code ++] -->\n    \u003C\u002Ftestsuites>\n\u003C\u002Fphpunit>\n```\n\nComme ces tests accèdent à la base de données, mettez à jour Pest afin qu'il la réinitialise avant chaque test :\n\n```php [tests\u002FPest.php]\npest()->extend(Tests\\TestCase::class)\n    ->use(Illuminate\\Foundation\\Testing\\RefreshDatabase::class)\n    ->in('Console', 'Http', 'Unit'); \u002F\u002F [!code highlighter]\n```\n\n## Derniers mots\n\nLe front-end et le back-end partagent maintenant un identifiant stable pour chaque article. VitePress génère les métadonnées et Laravel peut synchroniser ses enregistrements sans mise à jour manuelle de la base de données.\n\nNous disposons maintenant du pont nécessaire aux fonctionnalités interactives. Ensuite, nous configurerons Sanctum, CORS et la protection CSRF, puis nous enverrons les premières requêtes de VitePress vers Laravel.\n",{"title":5,"description":2119},"empower-and-dynamize-our-vitepress-blog-with-a-laravel-api",{"loc":2122},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api\u002Fautomating-your-backend-to-stay-in-sync-effortlessly","PDp0Kduu0P5Y61rrIP0GFQnUJMtaX7Mbk4CsM9abfIw",{"overview":2130,"chapters":2305},{"id":2131,"title":2132,"body":2133,"contentId":2289,"date":2290,"description":2291,"extension":870,"github":2120,"meetTheInstructor":2292,"meta":2293,"navigation":237,"part":2120,"path":2294,"rawbody":2295,"robots":2120,"schemaOrg":2120,"seo":2296,"seriesSlug":2125,"sitemap":2297,"stem":2298,"subtitle":2299,"topics":2300,"__hash__":2304},"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":2134,"toc":2286},[2135,2138,2141,2144,2148,2157,2160,2169,2172,2175,2258,2261,2264,2267,2276,2280],[10,2136,2137],{},"Bonjour ! 👋",[10,2139,2140],{},"Après avoir créé notre blog VitePress, nous sommes prêts à le rendre plus dynamique grâce à une API Laravel.",[10,2142,2143],{},"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.",[2145,2146],"callout-read-more",{"id":2147},"43c95b33-041c-4108-ab98-0d21ef60ed7f",[10,2149,2150,2151,2156],{},"Cette série s'intéresse au développement back-end. Nous allons créer une API ",[442,2152,2155],{"href":2153,"rel":2154},"https:\u002F\u002Flaravel.com",[1402],"Laravel"," pour ajouter quelques fonctionnalités interactives à notre blog.",[10,2158,2159],{},"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,2161,2162,2163,2168],{},"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 ",[442,2164,2167],{"href":2165,"rel":2166},"https:\u002F\u002Fpinia-colada.esm.dev\u002F",[1402],"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,2170,2171],{},"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,2173,2174],{},"Tout au long de la série, nous construirons une API Laravel et l'intégrerons à notre blog VitePress. Nous aborderons les sujets suivants :",[2176,2177,2178,2185,2213,2224,2230,2240,2246,2252],"ul",{},[37,2179,2180,2184],{},[2181,2182,2183],"strong",{},"Configurer le projet Laravel"," : Créer un nouveau projet Laravel et se familiariser avec sa structure.",[37,2186,2187,2190,2191,445,2196,445,2201,2206,2207,2212],{},[2181,2188,2189],{},"Améliorer le workflow de développement"," : Configurer ",[442,2192,2195],{"href":2193,"rel":2194},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fpint",[1402],"Pint",[442,2197,2200],{"href":2198,"rel":2199},"https:\u002F\u002Fgithub.com\u002Frectorphp\u002Frector",[1402],"Rector",[442,2202,2205],{"href":2203,"rel":2204},"https:\u002F\u002Fgithub.com\u002Flarastan\u002Flarastan",[1402],"Larastan"," et ",[442,2208,2211],{"href":2209,"rel":2210},"https:\u002F\u002Fpestphp.com\u002F",[1402],"Pest"," pour le formatage, la refactorisation, l'analyse statique et les tests.",[37,2214,2215,2218,2219,108],{},[2181,2216,2217],{},"Ajouter l'authentification sociale"," : Permettre aux utilisateurs de se connecter avec GitHub grâce à ",[442,2220,2223],{"href":2221,"rel":2222},"https:\u002F\u002Flaravel.com\u002Fdocs\u002F11.x\u002Fsocialite",[1402],"Laravel Socialite",[37,2225,2226,2229],{},[2181,2227,2228],{},"Connecter les applications"," : Configurer Sanctum, CORS, la protection CSRF et les premières requêtes entre le front-end VitePress et l'API Laravel.",[37,2231,2232,2235,2236,2239],{},[2181,2233,2234],{},"Gérer l'état d'authentification"," : Utiliser ",[442,2237,2167],{"href":2165,"rel":2238},[1402]," pour récupérer l'utilisateur courant et le déconnecter avec une mise à jour optimiste.",[37,2241,2242,2245],{},[2181,2243,2244],{},"Construire l'API de commentaires"," : Créer les modèles, les relations, les endpoints, la validation, l'autorisation et les tests des commentaires.",[37,2247,2248,2251],{},[2181,2249,2250],{},"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.",[37,2253,2254,2257],{},[2181,2255,2256],{},"Construire l'interface de commentaires"," : Récupérer, créer, modifier et supprimer des commentaires depuis le front-end VitePress.",[10,2259,2260],{},"À 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,2262,2263],{},"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,2265,2266],{},"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.",[110,2268,2269],{"color":112,"icon":113},[10,2270,2271,2272,108],{},"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 ",[442,2273,2275],{"href":2274},"\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",[71,2277,2279],{"id":2278},"chapitres","Chapitres",[2281,2282],"series-chapters-list",{"className":2283},[2284,2285],"mx-auto","max-w-5xl",{"title":126,"searchDepth":196,"depth":196,"links":2287},[2288],{"id":2278,"depth":196,"text":2279},"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":2132,"description":2291},{"loc":2294},"fr\u002Fseries\u002Fempower-and-dynamize-our-vitepress-blog-with-a-laravel-api","Transformez votre blog VitePress en une plateforme dynamique avec une API",[2301,2302,2303],"laravel","vitepress","api","AjkLB8gOXMZAgudegF8LmVWjly_nRao_7y_u2LUCUrQ",[2306,2311,2316,2321,2326,2327,2332,2337],{"contentId":2307,"title":2308,"description":2309,"path":2310,"part":133,"github":2120,"topics":2120},"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":2312,"title":2313,"description":2314,"path":2315,"part":196,"github":2120,"topics":2120},"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":2317,"title":2318,"description":2319,"path":2320,"part":209,"github":2120,"topics":2120},"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":2322,"title":2323,"description":2324,"path":2325,"part":222,"github":2120,"topics":2120},"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":2117,"title":5,"description":2119,"path":2122,"part":234,"github":2120,"topics":2120},{"contentId":2328,"title":2329,"description":2330,"path":2331,"part":241,"github":2120,"topics":2120},"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":2333,"title":2334,"description":2335,"path":2336,"part":272,"github":2120,"topics":2120},"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":2338,"title":2339,"description":2340,"path":2341,"part":305,"github":2120,"topics":2120},"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",1795016704475]