feat: Add documentation for automatic eager loading of relationships in Eloquent

curder · curder · commit 53eb72698fd8 · 2025-08-01T14:45:47.000+08:00
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
@@ -57,6 +57,7 @@ function sidebarProgrammingLanguage()
                 {text: "Vite 静态资源替换", link: "/programming-language/php/laravel/blade/vite"},
                 {text: "pint 代码风格", link: "/programming-language/php/laravel/code-style/pint"},
                 {text: "监听数据库执行", link: "/programming-language/php/laravel/eloquent/monitor-database-statements"},
+                {text: "自动惰性加载关联关系", link: "/programming-language/php/laravel/eloquent/automatically-eager-load-relationships"},
                 {text: "安装指定版本 Laravel", link: "/programming-language/php/laravel/installing-a-specific-version-of-laravel"},
             ]
         },
diff --git a/docs/programming-language/php/laravel/eloquent/automatically-eager-load-relationships.md b/docs/programming-language/php/laravel/eloquent/automatically-eager-load-relationships.md
@@ -0,0 +1,22 @@
+# 自动惰性加载关联关系 {#automatically-eager-load-relationships}
+
+在 Laravel 中，Eloquent ORM 提供了自动惰性加载关联关系的功能。
+
+通过 `Model::automaticallyEagerLoadRelationships()` 开启，这对于减少 N+1 查询问题非常有用。
+
+```php
+// bootstrap/app.php
+
+use Illuminate\Database\Eloquent\Model; // [!code ++]
+
+return Application::configure(basePath: dirname(__DIR__))
+    // ...
+    ->withExceptions(function (Exceptions $exceptions) {
+        //
+    })
+    ->booting(function() { // [!code ++]
+        Model::automaticallyEagerLoadRelationships(); // [!code ++]
+    }) // [!code ++]
+    ->create();
+
+```

Original file line number	Diff line number	Diff line change
`@@ -57,6 +57,7 @@ function sidebarProgrammingLanguage()`
`57`	`57`	`{text: "Vite 静态资源替换", link: "/programming-language/php/laravel/blade/vite"},`
`58`	`58`	`{text: "pint 代码风格", link: "/programming-language/php/laravel/code-style/pint"},`
`59`	`59`	`{text: "监听数据库执行", link: "/programming-language/php/laravel/eloquent/monitor-database-statements"},`
	`60`	`+ {text: "自动惰性加载关联关系", link: "/programming-language/php/laravel/eloquent/automatically-eager-load-relationships"},`
`60`	`61`	`{text: "安装指定版本 Laravel", link: "/programming-language/php/laravel/installing-a-specific-version-of-laravel"},`
`61`	`62`	`]`
`62`	`63`	`},`