[{"data":1,"prerenderedAt":1670},["ShallowReactive",2],{"navigation":3,"\u002Fgetting-started\u002Fquick-start":173,"\u002Fgetting-started\u002Fquick-start-surround":1665},[4,27,69,103,113,135],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":26},"Getting Started","i-heroicons-star","\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},"Upgrade guide","\u002Fgetting-started\u002Fupgrade-guide","1.getting-started\u002F5.upgrade-guide",false,{"title":28,"icon":29,"path":30,"stem":31,"children":32,"page":26},"Essentials","i-heroicons-shield-check","\u002Fessentials","2.essentials",[33,37,41,45,49,53,57,61,65],{"title":34,"path":35,"stem":36},"Controls","\u002Fessentials\u002Fcontrols","2.essentials\u002F1.controls",{"title":38,"path":39,"stem":40},"Perimeters","\u002Fessentials\u002Fperimeters","2.essentials\u002F2.perimeters",{"title":42,"path":43,"stem":44},"Perimeter classes","\u002Fessentials\u002Fperimeter-classes","2.essentials\u002F3.perimeter-classes",{"title":46,"path":47,"stem":48},"Levels","\u002Fessentials\u002Flevels","2.essentials\u002F4.levels",{"title":50,"path":51,"stem":52},"Boundaries","\u002Fessentials\u002Fboundaries","2.essentials\u002F5.boundaries",{"title":54,"path":55,"stem":56},"Parents","\u002Fessentials\u002Fparents","2.essentials\u002F6.parents",{"title":58,"path":59,"stem":60},"Policies","\u002Fessentials\u002Fpolicies","2.essentials\u002F7.policies",{"title":62,"path":63,"stem":64},"Queries","\u002Fessentials\u002Fqueries","2.essentials\u002F8.queries",{"title":66,"path":67,"stem":68},"Readers","\u002Fessentials\u002Freaders","2.essentials\u002F9.readers",{"title":70,"icon":71,"path":72,"stem":73,"children":74,"page":26},"Search","i-heroicons-magnifying-glass","\u002Fsearch","3.search",[75,79,83,87,91,95,99],{"title":76,"path":77,"stem":78},"Search overview","\u002Fsearch\u002Foverview","3.search\u002F1.overview",{"title":80,"path":81,"stem":82},"Engines","\u002Fsearch\u002Fengines","3.search\u002F2.engines",{"title":84,"path":85,"stem":86},"Keeping the keys fresh","\u002Fsearch\u002Fkeeping-the-keys-fresh","3.search\u002F3.keeping-the-keys-fresh",{"title":88,"path":89,"stem":90},"Exceptions and dates","\u002Fsearch\u002Fexceptions-and-dates","3.search\u002F4.exceptions-and-dates",{"title":92,"path":93,"stem":94},"Searching through a parent","\u002Fsearch\u002Fthrough-a-parent","3.search\u002F5.through-a-parent",{"title":96,"path":97,"stem":98},"Search from the browser","\u002Fsearch\u002Ffrom-the-browser","3.search\u002F6.from-the-browser",{"title":100,"path":101,"stem":102},"Your own search client","\u002Fsearch\u002Fyour-own-client","3.search\u002F7.your-own-client",{"title":104,"icon":105,"path":106,"stem":107,"children":108,"page":26},"Integrations","i-heroicons-puzzle-piece","\u002Fintegrations","4.integrations",[109],{"title":110,"path":111,"stem":112},"laravel-rest-api","\u002Fintegrations\u002Flaravel-rest-api","4.integrations\u002F1.laravel-rest-api",{"title":114,"icon":115,"path":116,"stem":117,"children":118,"page":26},"Testing and Tooling","i-heroicons-wrench-screwdriver","\u002Ftesting-and-tooling","5.testing-and-tooling",[119,123,127,131],{"title":120,"path":121,"stem":122},"Testing","\u002Ftesting-and-tooling\u002Ftesting","5.testing-and-tooling\u002F1.testing",{"title":124,"path":125,"stem":126},"access:check","\u002Ftesting-and-tooling\u002Faccess-check","5.testing-and-tooling\u002F2.access-check",{"title":128,"path":129,"stem":130},"Cache and about","\u002Ftesting-and-tooling\u002Fcache-and-about","5.testing-and-tooling\u002F3.cache-and-about",{"title":132,"path":133,"stem":134},"Generators","\u002Ftesting-and-tooling\u002Fgenerators","5.testing-and-tooling\u002F4.generators",{"title":136,"icon":137,"path":138,"stem":139,"children":140,"page":26},"Digging Deeper","i-heroicons-list-bullet","\u002Fdigging-deeper","6.digging-deeper",[141,145,149,153,157,161,165,169],{"title":142,"path":143,"stem":144},"Abilities","\u002Fdigging-deeper\u002Fabilities","6.digging-deeper\u002F1.abilities",{"title":146,"path":147,"stem":148},"Kept decisions","\u002Fdigging-deeper\u002Fdecisions","6.digging-deeper\u002F2.decisions",{"title":150,"path":151,"stem":152},"Batched decisions","\u002Fdigging-deeper\u002Fbatched-decisions","6.digging-deeper\u002F3.batched-decisions",{"title":154,"path":155,"stem":156},"Row checks","\u002Fdigging-deeper\u002Frow-checks","6.digging-deeper\u002F4.row-checks",{"title":158,"path":159,"stem":160},"Several brands","\u002Fdigging-deeper\u002Fseveral-brands","6.digging-deeper\u002F5.several-brands",{"title":162,"path":163,"stem":164},"Row context","\u002Fdigging-deeper\u002Frow-context","6.digging-deeper\u002F6.row-context",{"title":166,"path":167,"stem":168},"What is public in 1.x","\u002Fdigging-deeper\u002Fpublic-api","6.digging-deeper\u002F7.public-api",{"title":170,"path":171,"stem":172},"Use with AI","\u002Fdigging-deeper\u002Fuse-with-ai","6.digging-deeper\u002F8.use-with-ai",{"id":174,"title":19,"body":175,"description":1657,"extension":1658,"links":1659,"meta":1660,"navigation":338,"path":20,"seo":1661,"sitemap":1662,"stem":21,"updatedAt":1663,"__hash__":1664},"docs\u002F1.getting-started\u002F3.quick-start.md",{"type":176,"value":177,"toc":1650},"minimark",[178,186,208,213,216,281,304,1163,1210,1231,1241,1252,1256,1263,1359,1379,1383,1394,1456,1461,1465,1586,1595,1599,1646],[179,180,181,185],"p",{},[182,183,184],"a",{"href":16},"Install the package"," first.",[179,187,188,189,193,194,197,198,201,202,193,205,207],{},"Take a ",[190,191,192],"code",{},"Post"," model with a ",[190,195,196],{},"client_id"," and an ",[190,199,200],{},"author_id",", and a ",[190,203,204],{},"User",[190,206,196],{},". Three kinds of users read posts: administrators read every post, managers read the posts of their client, authors read their own posts.",[209,210,212],"h2",{"id":211},"_1-declare-who-reaches-which-posts","1. Declare who reaches which posts",[179,214,215],{},"Create one perimeter class per kind of access, and the control of the model:",[217,218,223],"pre",{"className":219,"code":220,"language":221,"meta":222,"style":222},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","php artisan make:perimeter GlobalPerimeter\nphp artisan make:perimeter ClientPerimeter\nphp artisan make:perimeter OwnPerimeter\nphp artisan make:control PostControl\n","bash","",[190,224,225,244,256,268],{"__ignoreMap":222},[226,227,230,234,238,241],"span",{"class":228,"line":229},"line",1,[226,231,233],{"class":232},"sBMFI","php",[226,235,237],{"class":236},"sfazB"," artisan",[226,239,240],{"class":236}," make:perimeter",[226,242,243],{"class":236}," GlobalPerimeter\n",[226,245,247,249,251,253],{"class":228,"line":246},2,[226,248,233],{"class":232},[226,250,237],{"class":236},[226,252,240],{"class":236},[226,254,255],{"class":236}," ClientPerimeter\n",[226,257,259,261,263,265],{"class":228,"line":258},3,[226,260,233],{"class":232},[226,262,237],{"class":236},[226,264,240],{"class":236},[226,266,267],{"class":236}," OwnPerimeter\n",[226,269,271,273,275,278],{"class":228,"line":270},4,[226,272,233],{"class":232},[226,274,237],{"class":236},[226,276,277],{"class":236}," make:control",[226,279,280],{"class":236}," PostControl\n",[179,282,283,284,287,288,291,292,295,296,299,300,303],{},"The ",[182,285,286],{"href":43},"perimeter classes"," land in ",[190,289,290],{},"app\u002FAccess\u002FPerimeters"," and the control in ",[190,293,294],{},"app\u002FAccess\u002FControls",". ",[190,297,298],{},"make:control"," names the model after the control, ",[190,301,302],{},"App\\Models\\Post"," here. Declare the rules of each perimeter in the control:",[217,305,309],{"className":306,"code":307,"filename":308,"language":233,"meta":222,"style":222},"language-php shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","namespace App\\Access\\Controls;\n\nuse App\\Access\\Perimeters\\ClientPerimeter;\nuse App\\Access\\Perimeters\\GlobalPerimeter;\nuse App\\Access\\Perimeters\\OwnPerimeter;\nuse App\\Models\\Post;\nuse App\\Models\\User;\nuse Illuminate\\Database\\Eloquent\\Builder;\nuse Lomkit\\Access\\Ability;\nuse Lomkit\\Access\\Controls\\Control;\nuse Lomkit\\Access\\Perimeters\\Levels;\n\nclass PostControl extends Control\n{\n    protected string $model = Post::class;\n\n    protected function perimeters(): array\n    {\n        return [\n            Levels::of(\n                GlobalPerimeter::new()\n                    ->allowed(fn (User $user, Ability $ability) => $user->can(\"{$ability} all posts\"))\n                    ->unrestricted(),\n                ClientPerimeter::new()\n                    ->allowed(fn (User $user, Ability $ability) => $user->client_id !== null && $user->can(\"{$ability} client posts\"))\n                    ->should(fn (User $user, Post $post) => $post->client_id === $user->client_id)\n                    ->query(function (Builder $query, User $user): void {\n                        $query->where('client_id', $user->client_id);\n                    }),\n                OwnPerimeter::new()\n                    ->allowed(fn (User $user, Ability $ability) => $user->can(\"{$ability} own posts\"))\n                    ->should(fn (User $user, Post $post) => $post->author_id === $user->id)\n                    ->query(function (Builder $query, User $user): void {\n                        $query->where('author_id', $user->id);\n                    }),\n            ),\n        ];\n    }\n}\n","app\u002FAccess\u002FControls\u002FPostControl.php",[190,310,311,334,340,363,384,406,424,441,466,485,507,528,533,549,555,583,588,606,612,622,636,650,721,732,744,816,871,910,945,951,963,1017,1070,1103,1134,1139,1145,1151,1157],{"__ignoreMap":222},[226,312,313,317,320,324,327,329,331],{"class":228,"line":229},[226,314,316],{"class":315},"sbssI","namespace",[226,318,319],{"class":232}," App",[226,321,323],{"class":322},"sMK4o","\\",[226,325,326],{"class":232},"Access",[226,328,323],{"class":322},[226,330,34],{"class":232},[226,332,333],{"class":322},";\n",[226,335,336],{"class":228,"line":246},[226,337,339],{"emptyLinePlaceholder":338},true,"\n",[226,341,342,345,348,350,352,354,356,358,361],{"class":228,"line":258},[226,343,344],{"class":315},"use",[226,346,319],{"class":347},"sTEyZ",[226,349,323],{"class":322},[226,351,326],{"class":347},[226,353,323],{"class":322},[226,355,38],{"class":347},[226,357,323],{"class":322},[226,359,360],{"class":347},"ClientPerimeter",[226,362,333],{"class":322},[226,364,365,367,369,371,373,375,377,379,382],{"class":228,"line":270},[226,366,344],{"class":315},[226,368,319],{"class":347},[226,370,323],{"class":322},[226,372,326],{"class":347},[226,374,323],{"class":322},[226,376,38],{"class":347},[226,378,323],{"class":322},[226,380,381],{"class":347},"GlobalPerimeter",[226,383,333],{"class":322},[226,385,387,389,391,393,395,397,399,401,404],{"class":228,"line":386},5,[226,388,344],{"class":315},[226,390,319],{"class":347},[226,392,323],{"class":322},[226,394,326],{"class":347},[226,396,323],{"class":322},[226,398,38],{"class":347},[226,400,323],{"class":322},[226,402,403],{"class":347},"OwnPerimeter",[226,405,333],{"class":322},[226,407,409,411,413,415,418,420,422],{"class":228,"line":408},6,[226,410,344],{"class":315},[226,412,319],{"class":347},[226,414,323],{"class":322},[226,416,417],{"class":347},"Models",[226,419,323],{"class":322},[226,421,192],{"class":347},[226,423,333],{"class":322},[226,425,427,429,431,433,435,437,439],{"class":228,"line":426},7,[226,428,344],{"class":315},[226,430,319],{"class":347},[226,432,323],{"class":322},[226,434,417],{"class":347},[226,436,323],{"class":322},[226,438,204],{"class":347},[226,440,333],{"class":322},[226,442,444,446,449,451,454,456,459,461,464],{"class":228,"line":443},8,[226,445,344],{"class":315},[226,447,448],{"class":347}," Illuminate",[226,450,323],{"class":322},[226,452,453],{"class":347},"Database",[226,455,323],{"class":322},[226,457,458],{"class":347},"Eloquent",[226,460,323],{"class":322},[226,462,463],{"class":347},"Builder",[226,465,333],{"class":322},[226,467,469,471,474,476,478,480,483],{"class":228,"line":468},9,[226,470,344],{"class":315},[226,472,473],{"class":347}," Lomkit",[226,475,323],{"class":322},[226,477,326],{"class":347},[226,479,323],{"class":322},[226,481,482],{"class":347},"Ability",[226,484,333],{"class":322},[226,486,488,490,492,494,496,498,500,502,505],{"class":228,"line":487},10,[226,489,344],{"class":315},[226,491,473],{"class":347},[226,493,323],{"class":322},[226,495,326],{"class":347},[226,497,323],{"class":322},[226,499,34],{"class":347},[226,501,323],{"class":322},[226,503,504],{"class":347},"Control",[226,506,333],{"class":322},[226,508,510,512,514,516,518,520,522,524,526],{"class":228,"line":509},11,[226,511,344],{"class":315},[226,513,473],{"class":347},[226,515,323],{"class":322},[226,517,326],{"class":347},[226,519,323],{"class":322},[226,521,38],{"class":347},[226,523,323],{"class":322},[226,525,46],{"class":347},[226,527,333],{"class":322},[226,529,531],{"class":228,"line":530},12,[226,532,339],{"emptyLinePlaceholder":338},[226,534,536,540,543,546],{"class":228,"line":535},13,[226,537,539],{"class":538},"spNyl","class",[226,541,542],{"class":232}," PostControl",[226,544,545],{"class":538}," extends",[226,547,548],{"class":232}," Control\n",[226,550,552],{"class":228,"line":551},14,[226,553,554],{"class":322},"{\n",[226,556,558,561,564,567,570,573,576,579,581],{"class":228,"line":557},15,[226,559,560],{"class":538},"    protected",[226,562,563],{"class":315}," string",[226,565,566],{"class":322}," $",[226,568,569],{"class":347},"model ",[226,571,572],{"class":322},"=",[226,574,575],{"class":232}," Post",[226,577,578],{"class":322},"::",[226,580,539],{"class":315},[226,582,333],{"class":322},[226,584,586],{"class":228,"line":585},16,[226,587,339],{"emptyLinePlaceholder":338},[226,589,591,593,596,600,603],{"class":228,"line":590},17,[226,592,560],{"class":538},[226,594,595],{"class":538}," function",[226,597,599],{"class":598},"s2Zo4"," perimeters",[226,601,602],{"class":322},"():",[226,604,605],{"class":315}," array\n",[226,607,609],{"class":228,"line":608},18,[226,610,611],{"class":322},"    {\n",[226,613,615,619],{"class":228,"line":614},19,[226,616,618],{"class":617},"s7zQu","        return",[226,620,621],{"class":322}," [\n",[226,623,625,628,630,633],{"class":228,"line":624},20,[226,626,627],{"class":232},"            Levels",[226,629,578],{"class":322},[226,631,632],{"class":598},"of",[226,634,635],{"class":322},"(\n",[226,637,639,642,644,647],{"class":228,"line":638},21,[226,640,641],{"class":232},"                GlobalPerimeter",[226,643,578],{"class":322},[226,645,646],{"class":598},"new",[226,648,649],{"class":322},"()\n",[226,651,653,656,659,662,665,668,670,672,675,678,681,683,686,689,692,694,696,699,702,704,707,709,712,715,718],{"class":228,"line":652},22,[226,654,655],{"class":322},"                    ->",[226,657,658],{"class":598},"allowed",[226,660,661],{"class":322},"(",[226,663,664],{"class":538},"fn",[226,666,667],{"class":322}," (",[226,669,204],{"class":232},[226,671,566],{"class":322},[226,673,674],{"class":347},"user",[226,676,677],{"class":322},",",[226,679,680],{"class":232}," Ability",[226,682,566],{"class":322},[226,684,685],{"class":347},"ability",[226,687,688],{"class":322},")",[226,690,691],{"class":322}," =>",[226,693,566],{"class":322},[226,695,674],{"class":347},[226,697,698],{"class":322},"->",[226,700,701],{"class":598},"can",[226,703,661],{"class":322},[226,705,706],{"class":322},"\"{$",[226,708,685],{"class":347},[226,710,711],{"class":322},"}",[226,713,714],{"class":236}," all posts",[226,716,717],{"class":322},"\"",[226,719,720],{"class":322},"))\n",[226,722,724,726,729],{"class":228,"line":723},23,[226,725,655],{"class":322},[226,727,728],{"class":598},"unrestricted",[226,730,731],{"class":322},"(),\n",[226,733,735,738,740,742],{"class":228,"line":734},24,[226,736,737],{"class":232},"                ClientPerimeter",[226,739,578],{"class":322},[226,741,646],{"class":598},[226,743,649],{"class":322},[226,745,747,749,751,753,755,757,759,761,763,765,767,769,771,773,775,777,779,781,784,787,790,793,795,797,799,801,803,805,807,809,812,814],{"class":228,"line":746},25,[226,748,655],{"class":322},[226,750,658],{"class":598},[226,752,661],{"class":322},[226,754,664],{"class":538},[226,756,667],{"class":322},[226,758,204],{"class":232},[226,760,566],{"class":322},[226,762,674],{"class":347},[226,764,677],{"class":322},[226,766,680],{"class":232},[226,768,566],{"class":322},[226,770,685],{"class":347},[226,772,688],{"class":322},[226,774,691],{"class":322},[226,776,566],{"class":322},[226,778,674],{"class":347},[226,780,698],{"class":322},[226,782,783],{"class":347},"client_id ",[226,785,786],{"class":322},"!==",[226,788,789],{"class":322}," null",[226,791,792],{"class":322}," &&",[226,794,566],{"class":322},[226,796,674],{"class":347},[226,798,698],{"class":322},[226,800,701],{"class":598},[226,802,661],{"class":322},[226,804,706],{"class":322},[226,806,685],{"class":347},[226,808,711],{"class":322},[226,810,811],{"class":236}," client posts",[226,813,717],{"class":322},[226,815,720],{"class":322},[226,817,819,821,824,826,828,830,832,834,836,838,840,842,845,847,849,851,853,855,857,860,862,864,866,868],{"class":228,"line":818},26,[226,820,655],{"class":322},[226,822,823],{"class":598},"should",[226,825,661],{"class":322},[226,827,664],{"class":538},[226,829,667],{"class":322},[226,831,204],{"class":232},[226,833,566],{"class":322},[226,835,674],{"class":347},[226,837,677],{"class":322},[226,839,575],{"class":232},[226,841,566],{"class":322},[226,843,844],{"class":347},"post",[226,846,688],{"class":322},[226,848,691],{"class":322},[226,850,566],{"class":322},[226,852,844],{"class":347},[226,854,698],{"class":322},[226,856,783],{"class":347},[226,858,859],{"class":322},"===",[226,861,566],{"class":322},[226,863,674],{"class":347},[226,865,698],{"class":322},[226,867,196],{"class":347},[226,869,870],{"class":322},")\n",[226,872,874,876,879,881,884,886,888,890,892,894,897,899,901,904,907],{"class":228,"line":873},27,[226,875,655],{"class":322},[226,877,878],{"class":598},"query",[226,880,661],{"class":322},[226,882,883],{"class":538},"function",[226,885,667],{"class":322},[226,887,463],{"class":232},[226,889,566],{"class":322},[226,891,878],{"class":347},[226,893,677],{"class":322},[226,895,896],{"class":232}," User",[226,898,566],{"class":322},[226,900,674],{"class":347},[226,902,903],{"class":322},"):",[226,905,906],{"class":315}," void",[226,908,909],{"class":322}," {\n",[226,911,913,916,918,920,923,925,928,930,932,934,936,938,940,942],{"class":228,"line":912},28,[226,914,915],{"class":322},"                        $",[226,917,878],{"class":347},[226,919,698],{"class":322},[226,921,922],{"class":598},"where",[226,924,661],{"class":322},[226,926,927],{"class":322},"'",[226,929,196],{"class":236},[226,931,927],{"class":322},[226,933,677],{"class":322},[226,935,566],{"class":322},[226,937,674],{"class":347},[226,939,698],{"class":322},[226,941,196],{"class":347},[226,943,944],{"class":322},");\n",[226,946,948],{"class":228,"line":947},29,[226,949,950],{"class":322},"                    }),\n",[226,952,954,957,959,961],{"class":228,"line":953},30,[226,955,956],{"class":232},"                OwnPerimeter",[226,958,578],{"class":322},[226,960,646],{"class":598},[226,962,649],{"class":322},[226,964,966,968,970,972,974,976,978,980,982,984,986,988,990,992,994,996,998,1000,1002,1004,1006,1008,1010,1013,1015],{"class":228,"line":965},31,[226,967,655],{"class":322},[226,969,658],{"class":598},[226,971,661],{"class":322},[226,973,664],{"class":538},[226,975,667],{"class":322},[226,977,204],{"class":232},[226,979,566],{"class":322},[226,981,674],{"class":347},[226,983,677],{"class":322},[226,985,680],{"class":232},[226,987,566],{"class":322},[226,989,685],{"class":347},[226,991,688],{"class":322},[226,993,691],{"class":322},[226,995,566],{"class":322},[226,997,674],{"class":347},[226,999,698],{"class":322},[226,1001,701],{"class":598},[226,1003,661],{"class":322},[226,1005,706],{"class":322},[226,1007,685],{"class":347},[226,1009,711],{"class":322},[226,1011,1012],{"class":236}," own posts",[226,1014,717],{"class":322},[226,1016,720],{"class":322},[226,1018,1020,1022,1024,1026,1028,1030,1032,1034,1036,1038,1040,1042,1044,1046,1048,1050,1052,1054,1057,1059,1061,1063,1065,1068],{"class":228,"line":1019},32,[226,1021,655],{"class":322},[226,1023,823],{"class":598},[226,1025,661],{"class":322},[226,1027,664],{"class":538},[226,1029,667],{"class":322},[226,1031,204],{"class":232},[226,1033,566],{"class":322},[226,1035,674],{"class":347},[226,1037,677],{"class":322},[226,1039,575],{"class":232},[226,1041,566],{"class":322},[226,1043,844],{"class":347},[226,1045,688],{"class":322},[226,1047,691],{"class":322},[226,1049,566],{"class":322},[226,1051,844],{"class":347},[226,1053,698],{"class":322},[226,1055,1056],{"class":347},"author_id ",[226,1058,859],{"class":322},[226,1060,566],{"class":322},[226,1062,674],{"class":347},[226,1064,698],{"class":322},[226,1066,1067],{"class":347},"id",[226,1069,870],{"class":322},[226,1071,1073,1075,1077,1079,1081,1083,1085,1087,1089,1091,1093,1095,1097,1099,1101],{"class":228,"line":1072},33,[226,1074,655],{"class":322},[226,1076,878],{"class":598},[226,1078,661],{"class":322},[226,1080,883],{"class":538},[226,1082,667],{"class":322},[226,1084,463],{"class":232},[226,1086,566],{"class":322},[226,1088,878],{"class":347},[226,1090,677],{"class":322},[226,1092,896],{"class":232},[226,1094,566],{"class":322},[226,1096,674],{"class":347},[226,1098,903],{"class":322},[226,1100,906],{"class":315},[226,1102,909],{"class":322},[226,1104,1106,1108,1110,1112,1114,1116,1118,1120,1122,1124,1126,1128,1130,1132],{"class":228,"line":1105},34,[226,1107,915],{"class":322},[226,1109,878],{"class":347},[226,1111,698],{"class":322},[226,1113,922],{"class":598},[226,1115,661],{"class":322},[226,1117,927],{"class":322},[226,1119,200],{"class":236},[226,1121,927],{"class":322},[226,1123,677],{"class":322},[226,1125,566],{"class":322},[226,1127,674],{"class":347},[226,1129,698],{"class":322},[226,1131,1067],{"class":347},[226,1133,944],{"class":322},[226,1135,1137],{"class":228,"line":1136},35,[226,1138,950],{"class":322},[226,1140,1142],{"class":228,"line":1141},36,[226,1143,1144],{"class":322},"            ),\n",[226,1146,1148],{"class":228,"line":1147},37,[226,1149,1150],{"class":322},"        ];\n",[226,1152,1154],{"class":228,"line":1153},38,[226,1155,1156],{"class":322},"    }\n",[226,1158,1160],{"class":228,"line":1159},39,[226,1161,1162],{"class":322},"}\n",[1164,1165,1166,1189,1195,1204],"ul",{},[1167,1168,1169,1172,1173,1176,1177,1180,1181,1184,1185,1188],"li",{},[190,1170,1171],{},"allowed()"," is the permission: whether the perimeter applies to the user for an ability. ",[190,1174,1175],{},"view client posts"," or ",[190,1178,1179],{},"update own posts"," are permission names of your application, checked here with ",[190,1182,1183],{},"$user->can()",": define them with ",[190,1186,1187],{},"Gate::define()"," or a permission package. Any boolean check works.",[1167,1190,1191,1194],{},[190,1192,1193],{},"query()"," gives the rows of the perimeter in SQL, for the lists.",[1167,1196,1197,1200,1201,1203],{},[190,1198,1199],{},"should()"," checks one row in memory, for the policy. It must describe the same rows as ",[190,1202,1193],{},". It is kept here because users create posts through these perimeters, and a post about to be created can only be judged in memory. It also saves one query per check.",[1167,1205,1206,1209],{},[190,1207,1208],{},"unrestricted()"," reaches every post, for the administrators.",[179,1211,1212,1213,1216,1217,1220,1221,1224,1225,1227,1228,1230],{},"The three perimeters form a ",[190,1214,1215],{},"Levels::of()"," group, widest first: for each ability, only the highest level that the user reaches applies. A manager who also holds ",[190,1218,1219],{},"view own posts"," reaches the client level for ",[190,1222,1223],{},"view",", and the own level is not evaluated. See ",[182,1226,38],{"href":39}," and ",[182,1229,46],{"href":47},".",[179,1232,1233,1234,1236,1237,1240],{},"The client perimeter refuses a user without a client in ",[190,1235,1171],{},", so a ",[190,1238,1239],{},"null"," client never matches the posts without a client.",[1242,1243,1244],"note",{},[179,1245,1246,1248,1249,1230],{},[190,1247,381],{}," reaches the posts of every client. When clients are tenants, keep each user inside theirs with a ",[182,1250,1251],{"href":51},"boundary",[209,1253,1255],{"id":1254},"_2-link-the-model","2. Link the model",[179,1257,1258,1259,1262],{},"Add the ",[190,1260,1261],{},"HasControl"," trait to the model:",[217,1264,1267],{"className":306,"code":1265,"filename":1266,"language":233,"meta":222,"style":222},"namespace App\\Models;\n\nuse Illuminate\\Database\\Eloquent\\Model;\nuse Lomkit\\Access\\Controls\\HasControl;\n\nclass Post extends Model\n{\n    use HasControl;\n}\n","app\u002FModels\u002FPost.php",[190,1268,1269,1281,1285,1306,1326,1330,1341,1345,1355],{"__ignoreMap":222},[226,1270,1271,1273,1275,1277,1279],{"class":228,"line":229},[226,1272,316],{"class":315},[226,1274,319],{"class":232},[226,1276,323],{"class":322},[226,1278,417],{"class":232},[226,1280,333],{"class":322},[226,1282,1283],{"class":228,"line":246},[226,1284,339],{"emptyLinePlaceholder":338},[226,1286,1287,1289,1291,1293,1295,1297,1299,1301,1304],{"class":228,"line":258},[226,1288,344],{"class":315},[226,1290,448],{"class":347},[226,1292,323],{"class":322},[226,1294,453],{"class":347},[226,1296,323],{"class":322},[226,1298,458],{"class":347},[226,1300,323],{"class":322},[226,1302,1303],{"class":347},"Model",[226,1305,333],{"class":322},[226,1307,1308,1310,1312,1314,1316,1318,1320,1322,1324],{"class":228,"line":270},[226,1309,344],{"class":315},[226,1311,473],{"class":347},[226,1313,323],{"class":322},[226,1315,326],{"class":347},[226,1317,323],{"class":322},[226,1319,34],{"class":347},[226,1321,323],{"class":322},[226,1323,1261],{"class":347},[226,1325,333],{"class":322},[226,1327,1328],{"class":228,"line":386},[226,1329,339],{"emptyLinePlaceholder":338},[226,1331,1332,1334,1336,1338],{"class":228,"line":408},[226,1333,539],{"class":538},[226,1335,575],{"class":232},[226,1337,545],{"class":538},[226,1339,1340],{"class":232}," Model\n",[226,1342,1343],{"class":228,"line":426},[226,1344,554],{"class":322},[226,1346,1347,1350,1353],{"class":228,"line":443},[226,1348,1349],{"class":315},"    use",[226,1351,1352],{"class":347}," HasControl",[226,1354,333],{"class":322},[226,1356,1357],{"class":228,"line":468},[226,1358,1162],{"class":322},[179,1360,1361,1362,1365,1366,1368,1369,1372,1373,1376,1377,1230],{},"The package finds ",[190,1363,1364],{},"PostControl"," in ",[190,1367,294],{}," through its ",[190,1370,1371],{},"$model"," property. A control kept in another directory is named on the model with ",[190,1374,1375],{},"#[ControlledBy(PostControl::class)]",". See ",[182,1378,34],{"href":35},[209,1380,1382],{"id":1381},"_3-register-the-policies","3. Register the policies",[179,1384,1385,1386,1389,1390,1393],{},"Call ",[190,1387,1388],{},"Access::registerPolicies()"," in the ",[190,1391,1392],{},"boot()"," method of a service provider:",[217,1395,1398],{"className":306,"code":1396,"filename":1397,"language":233,"meta":222,"style":222},"use Lomkit\\Access\\Access;\n\npublic function boot(): void\n{\n    Access::registerPolicies();\n}\n","app\u002FProviders\u002FAppServiceProvider.php",[190,1399,1400,1416,1420,1435,1439,1452],{"__ignoreMap":222},[226,1401,1402,1404,1406,1408,1410,1412,1414],{"class":228,"line":229},[226,1403,344],{"class":315},[226,1405,473],{"class":347},[226,1407,323],{"class":322},[226,1409,326],{"class":347},[226,1411,323],{"class":322},[226,1413,326],{"class":347},[226,1415,333],{"class":322},[226,1417,1418],{"class":228,"line":246},[226,1419,339],{"emptyLinePlaceholder":338},[226,1421,1422,1425,1427,1430,1432],{"class":228,"line":258},[226,1423,1424],{"class":538},"public",[226,1426,595],{"class":538},[226,1428,1429],{"class":598}," boot",[226,1431,602],{"class":322},[226,1433,1434],{"class":315}," void\n",[226,1436,1437],{"class":228,"line":270},[226,1438,554],{"class":322},[226,1440,1441,1444,1446,1449],{"class":228,"line":386},[226,1442,1443],{"class":232},"    Access",[226,1445,578],{"class":322},[226,1447,1448],{"class":598},"registerPolicies",[226,1450,1451],{"class":322},"();\n",[226,1453,1454],{"class":228,"line":408},[226,1455,1162],{"class":322},[179,1457,1458,1459,1230],{},"Every controlled model that has no policy of its own now gets one, built on its control. See ",[182,1460,58],{"href":59},[209,1462,1464],{"id":1463},"_4-use-it","4. Use it",[217,1466,1468],{"className":306,"code":1467,"language":233,"meta":222,"style":222},"Post::query()->controlled()->paginate();         \u002F\u002F the posts the signed-in user may view\nPost::query()->controlled('update')->paginate(); \u002F\u002F the posts the signed-in user may update\nPost::controlledFor($user)->get();               \u002F\u002F for a named user, in jobs and commands\n\n$user->can('update', $post);                     \u002F\u002F the policy, from the same perimeters\n",[190,1469,1470,1496,1527,1551,1555],{"__ignoreMap":222},[226,1471,1472,1474,1476,1478,1481,1484,1486,1489,1492],{"class":228,"line":229},[226,1473,192],{"class":232},[226,1475,578],{"class":322},[226,1477,878],{"class":598},[226,1479,1480],{"class":322},"()->",[226,1482,1483],{"class":598},"controlled",[226,1485,1480],{"class":322},[226,1487,1488],{"class":598},"paginate",[226,1490,1491],{"class":322},"();",[226,1493,1495],{"class":1494},"sHwdD","         \u002F\u002F the posts the signed-in user may view\n",[226,1497,1498,1500,1502,1504,1506,1508,1510,1512,1515,1517,1520,1522,1524],{"class":228,"line":246},[226,1499,192],{"class":232},[226,1501,578],{"class":322},[226,1503,878],{"class":598},[226,1505,1480],{"class":322},[226,1507,1483],{"class":598},[226,1509,661],{"class":322},[226,1511,927],{"class":322},[226,1513,1514],{"class":236},"update",[226,1516,927],{"class":322},[226,1518,1519],{"class":322},")->",[226,1521,1488],{"class":598},[226,1523,1491],{"class":322},[226,1525,1526],{"class":1494}," \u002F\u002F the posts the signed-in user may update\n",[226,1528,1529,1531,1533,1536,1539,1541,1543,1546,1548],{"class":228,"line":258},[226,1530,192],{"class":232},[226,1532,578],{"class":322},[226,1534,1535],{"class":598},"controlledFor",[226,1537,1538],{"class":322},"($",[226,1540,674],{"class":347},[226,1542,1519],{"class":322},[226,1544,1545],{"class":598},"get",[226,1547,1491],{"class":322},[226,1549,1550],{"class":1494},"               \u002F\u002F for a named user, in jobs and commands\n",[226,1552,1553],{"class":228,"line":270},[226,1554,339],{"emptyLinePlaceholder":338},[226,1556,1557,1560,1562,1564,1566,1568,1570,1572,1574,1576,1578,1580,1583],{"class":228,"line":386},[226,1558,1559],{"class":322},"$",[226,1561,674],{"class":347},[226,1563,698],{"class":322},[226,1565,701],{"class":598},[226,1567,661],{"class":322},[226,1569,927],{"class":322},[226,1571,1514],{"class":236},[226,1573,927],{"class":322},[226,1575,677],{"class":322},[226,1577,566],{"class":322},[226,1579,844],{"class":347},[226,1581,1582],{"class":322},");",[226,1584,1585],{"class":1494},"                     \u002F\u002F the policy, from the same perimeters\n",[179,1587,1588,1589,1592,1593,1230],{},"A query is controlled only when it says so: ",[190,1590,1591],{},"Post::query()->get()"," still reads every row. A controlled query without a signed-in user returns no row. See ",[182,1594,62],{"href":63},[209,1596,1598],{"id":1597},"next-steps","Next steps",[1164,1600,1601,1619,1637],{},[1167,1602,1603,1607,1608,1611,1612,1615,1616,1618],{},[1604,1605,1606],"strong",{},"Search."," With Laravel Scout, give each perimeter that restricts rows its search keys and use ",[190,1609,1610],{},"ControlledSearchable"," on the model: ",[190,1613,1614],{},"Post::search('budget')->controlled()"," then keeps the posts the user may view. The ",[182,1617,70],{"href":77}," section covers the keys, the engines and the reindexing.",[1167,1620,1621,1624,1625,1628,1629,1632,1633,1636],{},[1604,1622,1623],{},"Testing."," Run ",[190,1626,1627],{},"php artisan access:check"," in CI, and prove in your tests that the policy, the queries and the search agree with the assertions of ",[190,1630,1631],{},"InteractsWithAccess",". The ",[182,1634,1635],{"href":121},"Testing and tooling"," section covers both.",[1167,1638,1639,1642,1643,1645],{},[1604,1640,1641],{},"Essentials."," Read ",[182,1644,34],{"href":35}," and the pages that follow, in order.",[1647,1648,1649],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":222,"searchDepth":229,"depth":246,"links":1651},[1652,1653,1654,1655,1656],{"id":211,"depth":246,"text":212},{"id":1254,"depth":246,"text":1255},{"id":1381,"depth":246,"text":1382},{"id":1463,"depth":246,"text":1464},{"id":1597,"depth":246,"text":1598},"Control your first model in four steps, from the perimeter classes to the policy and the controlled queries.","md",null,{},{"title":19,"description":1657},{"loc":20,"lastmod":1663},"2026-11-21T15:24:08+01:00","TqdEogNYJbAv-fEIW3y-HuoqkfyhMaI0KH-SHCM3ejI",[1666,1668],{"title":15,"path":16,"stem":17,"description":1667,"children":-1},"Requirements of Laravel Access Control 1.x and how to install it with Composer.",{"title":23,"path":24,"stem":25,"description":1669,"children":-1},"Move an application from Laravel Access Control 0.x to 1.0, area by area, with a link to the page that explains each new way.",1795277180204]