Update eloquent.md

demn98 · web-flow · commit 0fde22cfc91e · 2024-11-29T16:46:22.000+03:00
diff --git a/eloquent.md b/eloquent.md
@@ -16,28 +16,25 @@ Laravel содержит [ORM-библиотеку](https://ru.wikipedia.org/wik
 
 Если вы новичок в Laravel, не стесняйтесь присоединиться к [Laravel Bootcamp](https://bootcamp.laravel.com). Laravel Bootcamp поможет вам создать свое первое приложение Laravel с использованием Eloquent. Это отличный способ получить обзор всего, что предлагают Laravel и Eloquent.
 
-
 <a name="generating-model-classes"></a>
 ## Генерация классов модели
 
 Модели расширяют класс `Illuminate\Database\Eloquent\Model`. Чтобы сгенерировать новую модель Eloquent, используйте [Artisan](artisan)-команду `make:model`. Эта команда поместит новый класс модели в каталог `app/Models` вашего приложения:
 
-
 ```shell
 php artisan make:model Flight
 ```
 
 При создании модели вы можете сгенерировать [миграцию БД](/docs/{{version}}/migrations), используя параметр `--migration` или `-m`:
 
-
 ```shell
 php artisan make:model Flight --migration
 ```
 
 При создании модели вы можете также создавать другие различные типы классов, например фабрики, наполнители (seeders), политики, контроллеры и запросы форм. Кроме того, эти параметры можно комбинировать для создания сразу нескольких классов:
 
 ```shell
-# Создать модель и класс FlightFactory ...
+# Создать модель и класс FlightFactory...
 php artisan make:model Flight --factory
 php artisan make:model Flight -f
 
@@ -90,7 +87,7 @@ php artisan model:show Flight
 
     class Flight extends Model
     {
-       // ...
+        // ...
     }
 
 <a name="table-names"></a>
@@ -171,14 +168,12 @@ Eloquent также предполагает, что в соответствую
 Eloquent требует, чтобы каждая модель имела по крайней мере один однозначно идентифицирующий «ID», который может служить ее первичным ключом. «Составные» первичные ключи не поддерживаются моделями Eloquent. Однако вы можете добавить дополнительные многоколоночные уникальные индексы к таблицам базы данных в дополнение к однозначно определяющему (уникальному) первичному ключу таблицы.
 
 <a name="uuid-and-ulid-keys"></a>
-
 ### UUID и ULID ключи
 
 Вместо использования автоинкрементных целых чисел в качестве первичных ключей вашей модели Eloquent вы можете выбрать использование UUID. UUID - это уникальные буквенно-цифровые идентификаторы длиной 36 символов.
 
 Если вы хотите, чтобы модель использовала ключ UUID вместо автоинкрементного целочисленного ключа, вы можете использовать трейт `Illuminate\Database\Eloquent\Concerns\HasUuids` в модели. Конечно же, убедитесь, что у модели есть [столбец первичного ключа, эквивалентный UUID](/docs/{{version}}/migrations#column-method-uuid)::
 
-
     use Illuminate\Database\Eloquent\Concerns\HasUuids;
     use Illuminate\Database\Eloquent\Model;
 
@@ -193,7 +188,6 @@ Eloquent требует, чтобы каждая модель имела по к
 
     $article->id; // "8f8e8478-9035-4d23-b9a7-62f4d2612ce5"
 
-
 По умолчанию трейт `HasUuids` генерирует ["упорядоченные" UUID](/docs/{{version}}/strings#method-str-ordered-uuid) для ваших моделей. Эти UUID более эффективны для индексированного хранения в базе данных, поскольку их можно лексикографически сортировать.
 
 Вы можете переопределить процесс генерации UUID для определенной модели, определив метод `newUniqueId` в модели. Кроме того, вы можете указать, какие столбцы должны получать UUID, определив метод `uniqueIds` в модели:
@@ -351,7 +345,6 @@ public function boot(): void
 }
 ```
 
-
 Также вы можете указать Laravel генерировать исключение при попытке назначения неподлежащего назначению атрибута, вызвав метод `preventSilentlyDiscardingAttributes`. Это может помочь предотвратить неожиданные ошибки во время локальной разработки, когда попытаетесь присвоить значение, который не был добавлен в массив `fillable` модели:
 
 ```php
@@ -565,24 +558,23 @@ Eloquent также предлагает поддержку расширенны
 
     use App\Models\Flight;
 
-    // Получить модель по ее первичному ключу ...
+    // Получить модель по ее первичному ключу...
     $flight = Flight::find(1);
 
-    // Получить первую модель, соответствующую условиям запроса ...
+    // Получить первую модель, соответствующую условиям запроса...
     $flight = Flight::where('active', 1)->first();
 
-    // Альтернатива извлечению первой модели, соответствующей условиям запроса ...
-    $flight = App\Models\Flight::firstWhere('active', 1);
+    // Альтернатива извлечению первой модели, соответствующей условиям запроса...
+    $flight = Flight::firstWhere('active', 1);
 
  По желанию можно выполнить какое-либо другое действие, если результаты не найдены. Методы `findOr` и `firstOr` вернут один экземпляр модели или, если результаты не найдены, выполнят переданное замыкание. Значение, возвращенное замыканием, будет считаться результатом метода:
 
-
     $flight = Flight::findOr(1, function () {
         // ...
     });
 
     $flight = Flight::where('legs', '>', 3)->firstOr(function () {
-            // ...
+        // ...
     });
 
 <a name="not-found-exceptions"></a>
@@ -611,7 +603,7 @@ Eloquent также предлагает поддержку расширенны
 
     use App\Models\Flight;
 
-    // Получить рейс по `name` или создать его, если его не существует ...
+    // Получить рейс по `name` или создать его, если его не существует...
     $flight = Flight::firstOrCreate([
         'name' => 'London to Paris'
     ]);
@@ -666,7 +658,7 @@ Eloquent также предлагает поддержку расширенны
          */
         public function store(Request $request): RedirectResponse
         {
-            // Валидация запроса ...
+            // Валидация запроса...
 
             $flight = new Flight;
 
@@ -787,7 +779,7 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
     $user->name; // Jack
 
     $user->getOriginal('name'); // John
-    $user->getOriginal(); // Массив исходных атрибутов ...
+    $user->getOriginal(); // Массив исходных атрибутов...
 
 <a name="mass-assignment"></a>
 ### Массовое присвоение
@@ -873,7 +865,6 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
         Model::preventSilentlyDiscardingAttributes($this->app->isLocal());
     }
 
-
 <a name="upserts"></a>
 ### Обновления-вставки
 
@@ -884,7 +875,7 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
         ['departure' => 'Chicago', 'destination' => 'New York', 'price' => 150]
     ], uniqueBy: ['departure', 'destination'], update: ['price']);
 
-> [!WARNING]  
+> [!WARNING]
 > Все базы данных, кроме SQL Server, требуют, чтобы столбцы второго аргумента метода `upsert` имели "primary" или "unique" индекс. Кроме того, драйверы базы данных MariaDB и MySQL игнорируют второй аргумент метода `upsert` и всегда используют "primary" и "unique" индексы таблицы для обнаружения существующих записей.
 
 <a name="deleting-models"></a>
@@ -955,7 +946,7 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
 Вам также следует добавить столбец `deleted_at` в таблицу БД. [Построитель схемы](/docs/{{version}}/migrations) Laravel содержит метод для создания этого столбца:
 
     use Illuminate\Database\Schema\Blueprint;
-    use Illuminate\Facades\Schema;
+    use Illuminate\Support\Facades\Schema;
 
     Schema::table('flights', function (Blueprint $table) {
         $table->softDeletes();
@@ -982,7 +973,7 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
 
 Вы также можете использовать метод `restore` в запросе для восстановления нескольких моделей. Опять же, как и другие «массовые» операции, это не вызовет никаких событий модели для восстанавливаемых моделей:
 
-    App\Models\Flight::withTrashed()
+    Flight::withTrashed()
             ->where('airline_id', 1)
             ->restore();
 
@@ -1036,7 +1027,7 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
     <?php
 
     namespace App\Models;
-    
+
     use Illuminate\Database\Eloquent\Builder;
     use Illuminate\Database\Eloquent\Model;
     use Illuminate\Database\Eloquent\Prunable;
@@ -1076,7 +1067,6 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
         '--model' => [Address::class, Flight::class],
     ])->daily();
 
-
 Если вы хотите исключить обрезку определенных моделей при обрезке всех других обнаруженных моделей, вы можете использовать опцию `--except`:
 
     Schedule::command('model:prune', [
@@ -1177,7 +1167,7 @@ php artisan make:scope AncientScope
 
     <?php
 
-    namespace App\Models\Scopes
+    namespace App\Models\Scopes;
 
     use Illuminate\Database\Eloquent\Builder;
     use Illuminate\Database\Eloquent\Model;
@@ -1219,9 +1209,9 @@ php artisan make:scope AncientScope
 
     <?php
 
-    use App\Models\Scopes\AncientScope;
+    namespace App\Models;
 
-    use App\Scopes\AncientScope;
+    use App\Models\Scopes\AncientScope;
     use Illuminate\Database\Eloquent\Model;
 
     class User extends Model
@@ -1279,10 +1269,10 @@ Eloquent также позволяет вам определять глобал
 
 Если вы хотите удалить несколько или даже все глобальные диапазоны запроса, вы можете использовать метод `withoutGlobalScopes`:
 
-    // Игнорировать все глобальные диапазоны ...
+    // Игнорировать все глобальные диапазоны...
     User::withoutGlobalScopes()->get();
 
-    // Игнорировать некоторые глобальные диапазоны ...
+    // Игнорировать некоторые глобальные диапазоны...
     User::withoutGlobalScopes([
         FirstScope::class, SecondScope::class
     ])->get();
@@ -1358,7 +1348,7 @@ Eloquent также позволяет вам определять глобал
          */
         public function scopeOfType(Builder $query, string $type): void
         {
-            return $query->where('type', $type);
+            $query->where('type', $type);
         }
     }
 
@@ -1532,7 +1522,6 @@ php artisan make:observer UserObserver --model=User
         //
     }
 
-
 Или же, вы можете вручную зарегистрировать наблюдателя, вызвав метод `observe` модели, которую вы хотите наблюдать. Вы можете зарегистрировать наблюдателей в методе `boot` класса `AppServiceProvider` вашего приложения:
 
     use App\Models\User;
@@ -1561,7 +1550,7 @@ php artisan make:observer UserObserver --model=User
     use App\Models\User;
     use Illuminate\Contracts\Events\ShouldHandleEventsAfterCommit;
 
-    class UserObserver
+    class UserObserver implements ShouldHandleEventsAfterCommit
     {
         /**
          * Обработать событие «created» модели User.
@@ -1596,7 +1585,6 @@ php artisan make:observer UserObserver --model=User
 
     $user->saveQuietly();
 
-
 Вы также можете "обновить", "удалить", "мягко удалить", "восстановить" и "реплицировать" заданную модель без отправки каких-либо событий:
 
     $user->deleteQuietly();
