formatting

laravel · taylorotwell · Apr 8, 2025 · Nov 24, 2024 · Nov 24, 2024 · Nov 24, 2024
commit a346fc89d2a02132676b815b5dd630ccb514f6cf
diff --git a/src/Illuminate/Database/Eloquent/Builder.php b/src/Illuminate/Database/Eloquent/Builder.php
@@ -856,7 +856,7 @@ public function get($columns = ['*'])
 
         $collection = $builder->getModel()->newCollection($models);
 
-        if (Model::isAutoloadingRelationsGlobally()) {
+        if (Model::isAutomaticallyEagerLoadingRelationships()) {
             $collection->withRelationshipAutoloading();
         }
 

diff --git a/src/Illuminate/Database/Eloquent/Collection.php b/src/Illuminate/Database/Eloquent/Collection.php
@@ -251,10 +251,10 @@ public function loadMissing($relations)
     /**
      * Load a relationship path for models of the given type if it is not already eager loaded.
      *
-     * @param  array  $tuples
+     * @param  array<int, <string, class-string>>  $tuples
      * @return void
      */
-    public function loadMissingRelationsViaRelationAndClassTuples(array $tuples)
+    public function loadMissingRelationshipChain(array $tuples)
     {
         [$relation, $class] = array_shift($tuples);
 
@@ -274,7 +274,7 @@ public function loadMissingRelationsViaRelationAndClassTuples(array $tuples)
             $models = $models->collapse();
         }
 
-        (new static($models))->loadMissingRelationsViaRelationAndClassTuples($tuples);
+        (new static($models))->loadMissingRelationshipChain($tuples);
     }
 
     /**
@@ -757,7 +757,7 @@ protected function duplicateComparator($strict)
      */
     public function withRelationshipAutoloading()
     {
-        $callback = fn ($tuples) => $this->loadMissingRelationsViaRelationAndClassTuples($tuples);
+        $callback = fn ($tuples) => $this->loadMissingRelationshipChain($tuples);
 
         foreach ($this as $model) {
             if (! $model->hasRelationAutoloadCallback()) {

diff --git a/src/Illuminate/Database/Eloquent/Model.php b/src/Illuminate/Database/Eloquent/Model.php
@@ -179,11 +179,11 @@ abstract class Model implements Arrayable, ArrayAccess, CanBeEscapedWhenCastToSt
     protected static $modelsShouldPreventLazyLoading = false;
 
     /**
-     * Indicates whether relations should be automatically loaded on all models.
+     * Indicates whether relations should be automatically loaded on all models when they are accessed.
      *
      * @var bool
      */
-    protected static $modelsShouldGlobalAutoloadRelations = false;
+    protected static $modelsShouldAutomaticallyEagerLoadRelationships = false;
 
     /**
      * The callback that is responsible for handling lazy loading violations.
@@ -454,14 +454,14 @@ public static function preventLazyLoading($value = true)
     }
 
     /**
-     * Determine if model relationships should be automatically loaded.
+     * Determine if model relationships should be automatically eager loaded when accessed.
      *
      * @param  bool  $value
      * @return void
      */
-    public static function globalAutoloadRelations($value = true)
+    public static function automaticallyEagerLoadRelationships($value = true)
     {
-        static::$modelsShouldGlobalAutoloadRelations = $value;
+        static::$modelsShouldAutomaticallyEagerLoadRelationships = $value;
     }
 
     /**
@@ -2250,13 +2250,13 @@ public static function preventsLazyLoading()
     }
 
     /**
-     * Determine if relations autoload is enabled.
+     * Determine if relationships are being automatically eager loaded when accessed.
      *
      * @return bool
      */
-    public static function isAutoloadingRelationsGlobally()
+    public static function isAutomaticallyEagerLoadingRelationships()
     {
-        return static::$modelsShouldGlobalAutoloadRelations;
+        return static::$modelsShouldAutomaticallyEagerLoadRelationships;
     }
 
     /**