[{"data":1,"prerenderedAt":701},["ShallowReactive",2],{"navigation":3,"\u002Fupgrade\u002Ffrom-3-0":197,"\u002Fupgrade\u002Ffrom-3-0-surround":696},[4,27,49,99,149,169,183],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":26},"Getting Started","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,14,18,22],{"title":11,"path":12,"stem":13},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":15,"path":16,"stem":17},"Installation","\u002Fgetting-started\u002Finstallation","1.getting-started\u002F2.installation",{"title":19,"path":20,"stem":21},"Quick Start","\u002Fgetting-started\u002Fquick-start","1.getting-started\u002F3.quick-start",{"title":23,"path":24,"stem":25},"Existing Application","\u002Fgetting-started\u002Fexisting-application","1.getting-started\u002F4.existing-application",false,{"title":28,"icon":29,"path":30,"stem":31,"children":32,"page":26},"Concepts","i-lucide-layers","\u002Fconcepts","2.concepts",[33,37,41,45],{"title":34,"path":35,"stem":36},"Layers","\u002Fconcepts\u002Flayers","2.concepts\u002F1.layers",{"title":38,"path":39,"stem":40},"Buckets","\u002Fconcepts\u002Fbuckets","2.concepts\u002F2.buckets",{"title":42,"path":43,"stem":44},"Boundaries","\u002Fconcepts\u002Fboundaries","2.concepts\u002F3.boundaries",{"title":46,"path":47,"stem":48},"Service Providers","\u002Fconcepts\u002Fservice-providers","2.concepts\u002F4.service-providers",{"title":50,"icon":51,"path":52,"stem":53,"children":54,"page":26},"Guides","i-lucide-book-marked","\u002Fguides","3.guides",[55,59,63,67,71,75,79,83,87,91,95],{"title":56,"path":57,"stem":58},"Add a Domain","\u002Fguides\u002Fadd-a-domain","3.guides\u002F01.add-a-domain",{"title":60,"path":61,"stem":62},"Share Code Between Layers","\u002Fguides\u002Fshare-code-between-layers","3.guides\u002F02.share-code-between-layers",{"title":64,"path":65,"stem":66},"Routes","\u002Fguides\u002Froutes","3.guides\u002F03.routes",{"title":68,"path":69,"stem":70},"Views and Components","\u002Fguides\u002Fviews-and-components","3.guides\u002F04.views-and-components",{"title":72,"path":73,"stem":74},"Seeders","\u002Fguides\u002Fseeders","3.guides\u002F05.seeders",{"title":76,"path":77,"stem":78},"Configuration","\u002Fguides\u002Fconfiguration","3.guides\u002F06.configuration",{"title":80,"path":81,"stem":82},"Events","\u002Fguides\u002Fevents","3.guides\u002F07.events",{"title":84,"path":85,"stem":86},"Tests and CI","\u002Fguides\u002Ftesting-and-ci","3.guides\u002F08.testing-and-ci",{"title":88,"path":89,"stem":90},"Production","\u002Fguides\u002Fproduction","3.guides\u002F09.production",{"title":92,"path":93,"stem":94},"Remove a Layer","\u002Fguides\u002Fremoving-a-layer","3.guides\u002F10.removing-a-layer",{"title":96,"path":97,"stem":98},"Multi-tenancy","\u002Fguides\u002Fmulti-tenancy","3.guides\u002F11.multi-tenancy",{"title":100,"icon":101,"path":102,"stem":103,"children":104,"page":26},"Commands","i-lucide-terminal","\u002Fcommands","4.commands",[105,109,113,117,121,125,129,133,137,141,145],{"title":106,"path":107,"stem":108},"Overview","\u002Fcommands\u002Foverview","4.commands\u002F01.overview",{"title":110,"path":111,"stem":112},"osdd:start","\u002Fcommands\u002Fosdd-start","4.commands\u002F02.osdd-start",{"title":114,"path":115,"stem":116},"osdd:layer","\u002Fcommands\u002Fosdd-layer","4.commands\u002F03.osdd-layer",{"title":118,"path":119,"stem":120},"osdd:list","\u002Fcommands\u002Fosdd-list","4.commands\u002F04.osdd-list",{"title":122,"path":123,"stem":124},"osdd:check","\u002Fcommands\u002Fosdd-check","4.commands\u002F05.osdd-check",{"title":126,"path":127,"stem":128},"osdd:graph","\u002Fcommands\u002Fosdd-graph","4.commands\u002F06.osdd-graph",{"title":130,"path":131,"stem":132},"osdd:seed","\u002Fcommands\u002Fosdd-seed","4.commands\u002F07.osdd-seed",{"title":134,"path":135,"stem":136},"osdd:phpunit","\u002Fcommands\u002Fosdd-phpunit","4.commands\u002F08.osdd-phpunit",{"title":138,"path":139,"stem":140},"osdd:remove","\u002Fcommands\u002Fosdd-remove","4.commands\u002F09.osdd-remove",{"title":142,"path":143,"stem":144},"osdd:cache","\u002Fcommands\u002Fosdd-cache","4.commands\u002F10.osdd-cache",{"title":146,"path":147,"stem":148},"Generators","\u002Fcommands\u002Fmake-commands","4.commands\u002F11.make-commands",{"title":150,"icon":151,"path":152,"stem":153,"children":154,"page":26},"API Reference","i-lucide-book-open","\u002Fapi-reference","5.api-reference",[155,159,162,166],{"title":156,"path":157,"stem":158},"LayerServiceProvider","\u002Fapi-reference\u002Flayer-service-provider","5.api-reference\u002F1.layer-service-provider",{"title":34,"path":160,"stem":161},"\u002Fapi-reference\u002Flayers","5.api-reference\u002F2.layers",{"title":163,"path":164,"stem":165},"SeederRegistry","\u002Fapi-reference\u002Fseeder-registry","5.api-reference\u002F3.seeder-registry",{"title":76,"path":167,"stem":168},"\u002Fapi-reference\u002Fconfiguration","5.api-reference\u002F4.configuration",{"title":170,"icon":171,"path":172,"stem":173,"children":174,"page":26},"Integrations","i-lucide-puzzle","\u002Fintegrations","6.integrations",[175,179],{"title":176,"path":177,"stem":178},"Use with AI","\u002Fintegrations\u002Flaravel-boost","6.integrations\u002F1.laravel-boost",{"title":180,"path":181,"stem":182},"Tinker and IDE Helper","\u002Fintegrations\u002Ftinker-and-ide-helper","6.integrations\u002F2.tinker-and-ide-helper",{"title":184,"icon":185,"path":186,"stem":187,"children":188,"page":26},"Upgrade","i-lucide-arrow-up-circle","\u002Fupgrade","7.upgrade",[189,193],{"title":190,"path":191,"stem":192},"Upgrade from 3.0","\u002Fupgrade\u002Ffrom-3-0","7.upgrade\u002F1.from-3-0",{"title":194,"path":195,"stem":196},"Upgrade from 2.x","\u002Fupgrade\u002Ffrom-2x","7.upgrade\u002F2.from-2x",{"id":198,"title":190,"body":199,"description":688,"extension":689,"links":690,"meta":691,"navigation":451,"path":191,"seo":692,"sitemap":693,"stem":192,"__hash__":695},"docs\u002F7.upgrade\u002F1.from-3-0.md",{"type":200,"value":201,"toc":669},"minimark",[202,207,216,221,239,249,260,266,273,308,314,357,371,379,401,414,469,479,506,523,529,556,565,595,604,611,619,635,638,644,665],[203,204,206],"h2",{"id":205},"upgrading-to-31-from-30","Upgrading to 3.1 from 3.0",[208,209,210,211,215],"p",{},"Check the points below after ",[212,213,214],"code",{},"composer update lomkit\u002Flaravel-osdd",".",[217,218,220],"h3",{"id":219},"discovered-listeners-run-in-a-stable-order","Discovered listeners run in a stable order",[208,222,223,224,227,228,231,232,231,235,238],{},"The listeners discovered in the layers now run by layer name, then class name, then method name (byte order), instead of the order the file system listed them in, which differed between machines. Listeners registered while the providers boot (",[212,225,226],{},"Event::listen()"," in a ",[212,229,230],{},"boot()",", ",[212,233,234],{},"$listen",[212,236,237],{},"app\u002FListeners",") still run first.",[208,240,241,242,244,245,215],{},"If two discovered listeners of the same event only worked in one order, make that order explicit: one listener that calls the steps in order, a follow-up event, or both registered by hand, in order, in one provider's ",[212,243,230],{}," (discovery skips a listener already registered there). See ",[246,247,80],"a",{"href":248},"\u002Fguides\u002Fevents#order",[208,250,251,252,255,256,259],{},"With a cached event list, the new order applies from the next ",[212,253,254],{},"php artisan event:cache"," (or ",[212,257,258],{},"optimize","), and the cached file is now the same on every machine.",[217,261,263,265],{"id":262},"osddlist-health",[212,264,118],{}," health",[208,267,268,269,272],{},"A layer whose provider does not extend ",[212,270,271],{},"Lomkit\\Osdd\\LayerServiceProvider",", such as a Horizon or Telescope provider, and a layer without a provider are now healthy: the Health row no longer reports \"provider does not extend LayerServiceProvider\", and the Providers row marks such a class \"(not a LayerServiceProvider)\".",[208,274,275,276,231,279,282,283,231,286,289,290,293,294,296,297,299,300,302,303,215],{},"In ",[212,277,278],{},"osdd:list --json",[212,280,281],{},"health.provider_extends_layer_service_provider"," keeps its name and its ",[212,284,285],{},"true",[212,287,288],{},"false"," or ",[212,291,292],{},"null"," value, but a layer without a provider now gives ",[212,295,292],{}," instead of ",[212,298,288],{},". The flag is information, not a problem: a script that fails on ",[212,301,288],{}," should stop checking it. See ",[246,304,306],{"href":305},"\u002Fcommands\u002Fosdd-list#providers",[212,307,118],{},[217,309,311,312],{"id":310},"generators-write-only-into-a-layerserviceprovider","Generators write only into a ",[212,313,156],{},[208,315,316,317,231,320,231,323,231,326,231,329,231,332,335,336,339,340,343,344,346,347,349,350,353,354,356],{},"The generators that wire the layer provider (",[212,318,319],{},"osdd:migration",[212,321,322],{},"osdd:seeder",[212,324,325],{},"osdd:config",[212,327,328],{},"osdd:view",[212,330,331],{},"osdd:component",[212,333,334],{},"osdd:command"," and the ",[212,337,338],{},"osdd:*-table"," commands) wrote into the first provider of ",[212,341,342],{},"extra.laravel.providers"," found on disk, whatever its class, and a call that only ",[212,345,156],{}," has then failed at boot. They now write into the first listed provider that extends ",[212,348,156],{},", else into ",[212,351,352],{},"src\u002FProviders\u002F{Package}ServiceProvider.php"," when it does. With no such provider they change no file and print the line to add. The provider of a layer that is not installed yet counts only when its class extends ",[212,355,271],{}," directly.",[208,358,359,360,362,363,366,367,215],{},"If a generator now prints the line instead of editing your provider, make that provider extend ",[212,361,271],{},", or create one with ",[212,364,365],{},"osdd:provider",". See ",[246,368,370],{"href":369},"\u002Fcommands\u002Fmake-commands#generators-that-wire-the-provider","Generators that wire the provider",[217,372,374,376,377],{"id":373},"osddprovider-writes-a-layerserviceprovider",[212,375,365],{}," writes a ",[212,378,156],{},[208,380,381,383,384,386,387,390,391,393,394,397,398,215],{},[212,382,365],{}," now writes a class that extends ",[212,385,271],{},", with empty ",[212,388,389],{},"register()"," and ",[212,392,230],{}," methods, instead of Laravel's provider extending ",[212,395,396],{},"Illuminate\\Support\\ServiceProvider",". It no longer reads a published ",[212,399,400],{},"stubs\u002Fprovider.stub",[208,402,403,404,406,407,409,410,413],{},"A provider that 3.0's ",[212,405,365],{}," wrote can be changed to extend ",[212,408,156],{},", which only adds protected helpers to ",[212,411,412],{},"ServiceProvider","; the generators can then wire it:",[415,416,421],"pre",{"className":417,"code":418,"language":419,"meta":420,"style":420},"language-diff shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","-use Illuminate\\Support\\ServiceProvider;\n+use Lomkit\\Osdd\\LayerServiceProvider;\n\n-class OrderEventsServiceProvider extends ServiceProvider\n+class OrderEventsServiceProvider extends LayerServiceProvider\n","diff","",[212,422,423,436,446,453,461],{"__ignoreMap":420},[424,425,428,432],"span",{"class":426,"line":427},"line",1,[424,429,431],{"class":430},"sMK4o","-",[424,433,435],{"class":434},"swJcz","use Illuminate\\Support\\ServiceProvider;\n",[424,437,439,442],{"class":426,"line":438},2,[424,440,441],{"class":430},"+",[424,443,445],{"class":444},"sfazB","use Lomkit\\Osdd\\LayerServiceProvider;\n",[424,447,449],{"class":426,"line":448},3,[424,450,452],{"emptyLinePlaceholder":451},true,"\n",[424,454,456,458],{"class":426,"line":455},4,[424,457,431],{"class":430},[424,459,460],{"class":434},"class OrderEventsServiceProvider extends ServiceProvider\n",[424,462,464,466],{"class":426,"line":463},5,[424,465,441],{"class":430},[424,467,468],{"class":444},"class OrderEventsServiceProvider extends LayerServiceProvider\n",[217,470,472,474,475,478],{"id":471},"osddphpunit-reads-phpunitxml-as-phpunit-does",[212,473,134],{}," reads ",[212,476,477],{},"phpunit.xml"," as PHPUnit does",[208,480,481,483,484,487,488,231,491,494,495,498,499,335,502,505],{},[212,482,134],{}," no longer adds a layer source directory that a ",[212,485,486],{},"\u003Csource>\u003Cinclude>"," entry already covers: a glob (",[212,489,490],{},"functional\u002F*\u002Fsrc",[212,492,493],{},"functional\u002F**\u002Fsrc","), the same path written another way (",[212,496,497],{},".\u002Ffunctional\u002Forders\u002Fsrc\u002F",") or a parent folder, when that entry has no ",[212,500,501],{},"prefix",[212,503,504],{},".php"," suffix. The duplicates an earlier run added next to such entries can be removed: they are not added back.",[208,507,508,511,512,514,515,517,518,215],{},[212,509,510],{},"--prune"," no longer removes glob entries, and removes a literal entry only when it resolves to no folder. If ",[212,513,510],{}," removed glob entries from your ",[212,516,477],{},", add them back. See ",[246,519,521],{"href":520},"\u002Fcommands\u002Fosdd-phpunit#entries-that-already-cover-a-layer",[212,522,134],{},[217,524,526,528],{"id":525},"osddphpunit-no-longer-writes-the-migrations-exclusions",[212,527,134],{}," no longer writes the migrations exclusions",[208,530,531,533,534,537,538,541,542,231,545,548,549,552,553,555],{},[212,532,134],{}," no longer adds ",[212,535,536],{},"\u003Cbucket>\u002F*\u002Fdatabase\u002Fmigrations"," under ",[212,539,540],{},"\u003Csource>\u003Cexclude>"," (",[212,543,544],{},"functional\u002F*\u002Fdatabase\u002Fmigrations",[212,546,547],{},"technical\u002F*\u002Fdatabase\u002Fmigrations","). It writes one test suite and one source include per layer, the layer's source directory (",[212,550,551],{},"src","), which holds no migrations: the exclusion removed no file. The exclusions already in your ",[212,554,477],{}," are left as they are.",[208,557,558,559,561,562,564],{},"If every ",[212,560,486],{}," entry is a layer ",[212,563,551],{},", you can delete those lines:",[415,566,568],{"className":417,"code":567,"filename":477,"language":419,"meta":420,"style":420}," \u003Cexclude>\n-    \u003Cdirectory suffix=\".php\">functional\u002F*\u002Fdatabase\u002Fmigrations\u003C\u002Fdirectory>\n-    \u003Cdirectory suffix=\".php\">technical\u002F*\u002Fdatabase\u002Fmigrations\u003C\u002Fdirectory>\n \u003C\u002Fexclude>\n",[212,569,570,576,583,590],{"__ignoreMap":420},[424,571,572],{"class":426,"line":427},[424,573,575],{"class":574},"sTEyZ"," \u003Cexclude>\n",[424,577,578,580],{"class":426,"line":438},[424,579,431],{"class":430},[424,581,582],{"class":434},"    \u003Cdirectory suffix=\".php\">functional\u002F*\u002Fdatabase\u002Fmigrations\u003C\u002Fdirectory>\n",[424,584,585,587],{"class":426,"line":448},[424,586,431],{"class":430},[424,588,589],{"class":434},"    \u003Cdirectory suffix=\".php\">technical\u002F*\u002Fdatabase\u002Fmigrations\u003C\u002Fdirectory>\n",[424,591,592],{"class":426,"line":455},[424,593,594],{"class":574}," \u003C\u002Fexclude>\n",[208,596,597,598,601,602,215],{},"If you include a whole bucket (",[212,599,600],{},"\u003Cdirectory>functional\u003C\u002Fdirectory>","), keep them, or switch to ",[212,603,490],{},[208,605,606,607,610],{},"The source includes it adds no longer carry ",[212,608,609],{},"suffix=\".php\"",", which is PHPUnit's default. The entries already in the file are left as they are.",[217,612,614,616,617],{"id":613},"osddphpunit-keeps-the-formatting-of-phpunitxml",[212,615,134],{}," keeps the formatting of ",[212,618,477],{},[208,620,621,622,624,625,628,629,631,632,634],{},"The first run no longer reformats ",[212,623,477],{}," (2-space indentation, the attributes of ",[212,626,627],{},"\u003Cphpunit>"," on one line): an added entry takes the indentation of its neighbours, a removed one leaves no blank line, and the rest of the file is unchanged. ",[212,630,138],{}," writes ",[212,633,477],{}," the same way.",[208,636,637],{},"A file an earlier run reformatted keeps its current layout: restore yours from version control if you want it back.",[217,639,641,643],{"id":640},"osddphpunit-prints-only-its-changes",[212,642,134],{}," prints only its changes",[208,645,646,648,649,652,653,656,657,660,661,664],{},[212,647,134],{}," no longer prints a ",[212,650,651],{},"SKIPPED"," line for each layer whose test suite is already present. It prints the entries it adds or removes, or ",[212,654,655],{},"phpunit.xml is already up to date."," when nothing changes. The layers without a ",[212,658,659],{},"tests\u002F"," directory are named with ",[212,662,663],{},"-v"," only.",[666,667,668],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":420,"searchDepth":427,"depth":438,"links":670},[671],{"id":205,"depth":438,"text":206,"children":672},[673,674,676,678,680,682,684,686],{"id":219,"depth":448,"text":220},{"id":262,"depth":448,"text":675},"osdd:list health",{"id":310,"depth":448,"text":677},"Generators write only into a LayerServiceProvider",{"id":373,"depth":448,"text":679},"osdd:provider writes a LayerServiceProvider",{"id":471,"depth":448,"text":681},"osdd:phpunit reads phpunit.xml as PHPUnit does",{"id":525,"depth":448,"text":683},"osdd:phpunit no longer writes the migrations exclusions",{"id":613,"depth":448,"text":685},"osdd:phpunit keeps the formatting of phpunit.xml",{"id":640,"depth":448,"text":687},"osdd:phpunit prints only its changes","Move a Laravel OSDD 3.0 project to 3.1.","md",null,{},{"title":190,"description":688},{"loc":191,"lastmod":694},"2026-11-13T19:11:11+01:00","-Kkj8KbuDAaWcekWoPFtGfDEAGbPkajhXJWaIMlpDxI",[697,699],{"title":180,"path":181,"stem":182,"description":698,"children":-1},"Use short class names in Tinker, and let IDE Helper find the models of every layer. Nothing to configure.",{"title":194,"path":195,"stem":196,"description":700,"children":-1},"Move a Laravel OSDD 2.x project to 3.0, step by step.",1794593526528]