Update migrations.md

demn98 · web-flow · commit 761c93b45cef · 2024-12-03T12:46:21.000+03:00
diff --git a/migrations.md b/migrations.md
@@ -24,7 +24,7 @@ Laravel будет использовать имя миграции, чтобы
 
 Если вы хотите указать собственный путь для сгенерированной миграции, вы можете использовать параметр `--path` при выполнении команды `make:migration`. Указанный путь должен быть относительно базового пути вашего приложения.
 
-> [!NOTE]  
+> [!NOTE]
 > Заготовки (stubs) миграции можно настроить с помощью [публикации заготовок](artisan#stub-customization).
 
 <a name="squashing-migrations"></a>
@@ -41,18 +41,16 @@ php artisan schema:dump --prune
 
 В результате выполнения этой команды Laravel запишет дамп базы данных в каталог `database/schema` вашего приложения. Теперь, при запуске миграции базы данных, Laravel сначала выполнит SQL-операторы дампа (если никакие другие миграции не выполнялись). Затем Laravel выполнит все оставшиеся миграции, которые не были включены в дамп схемы БД.
 
-
 Если ваши тесты приложения используют другое подключение к базе данных, чем то, которое вы обычно используете во время локальной разработки, убедитесь, что вы создали файл схемы с использованием этого подключения к базе данных, чтобы ваши тесты могли создать базу данных. Вы можете сделать это после создания файла схемы для базы данных, которую обычно используете во время локальной разработки:
 
 ```shell
 php artisan schema:dump
 php artisan schema:dump --database=testing --prune
 ```
 
-
 Вы должны передать файл схемы базы данных в систему управления версиями, чтобы другие разработчики вашей команды могли быстро воссоздать исходную структуру базы данных вашего приложения.
 
-> [!WARNING]  
+> [!WARNING]
 > Сжатие миграции доступно только для баз данных MariaDB, MySQL, PostgreSQL и SQLite и использует клиент командной строки базы данных.
 
 <a name="migration-structure"></a>
@@ -90,7 +88,7 @@ php artisan schema:dump --database=testing --prune
         {
             Schema::drop('flights');
         }
-    }
+    };
 
 <a name="setting-the-migration-connection"></a>
 #### Указание соединения миграции
@@ -168,7 +166,7 @@ php artisan migrate:rollback
 
 ```shell
 php artisan migrate:rollback --step=5
-````
+```
 
 Вы можете откатить определенную "партию" миграций, указав опцию `batch` команде `rollback`, где значение опции `batch` соответствует значению партии в таблице `migrations` вашего приложения. Например, следующая команда откатит все миграции в партии третьей:
 
@@ -196,7 +194,7 @@ php artisan migrate:reset
 ```shell
 php artisan migrate:refresh
 
-// Обновляем базу данных и запускаем все наполнители базы данных ...
+// Обновляем базу данных и запускаем все наполнители базы данных...
 php artisan migrate:refresh --seed
 ```
 
@@ -217,15 +215,13 @@ php artisan migrate:fresh
 php artisan migrate:fresh --seed
 ```
 
-По умолчанию команда `migrate:fresh` удаляет только таблицы из соединения с базой данных по умолчанию.
-Однако вы можете использовать опцию `--database`, чтобы указать соединение с базой данных, которое следует использовать.
-Имя соединения с базой данных должно соответствовать имени, определенному в [файле конфигурации базы данных](/docs/{{version}}/configuration) вашего приложения:
+По умолчанию команда `migrate:fresh` удаляет только таблицы из соединения с базой данных по умолчанию. Однако вы можете использовать опцию `--database`, чтобы указать соединение с базой данных, которое следует использовать. Имя соединения с базой данных должно соответствовать имени, определенному в [файле конфигурации базы данных](/docs/{{version}}/configuration) вашего приложения:
 
 ```shell
 php artisan migrate:fresh --database=admin
 ```
 
-> [!WARNING] 
+> [!WARNING]
 > Команда `migrate:fresh` удалит все таблицы базы данных независимо от их префикса. Эту команду следует использовать с осторожностью при разработке в базе данных, которая используется совместно с другими приложениями.
 
 <a name="tables"></a>
@@ -299,17 +295,13 @@ php artisan migrate:fresh --database=admin
         // ...
     });
 
-Если вы хотите добавить "комментарий" к таблице базы данных, вы можете вызвать метод `comment` на экземпляре таблицы. Комментарии к таблицам поддерживаются только в MariaDB, MySQL и Postgres:
-
-```php
-Schema::create('calculations', function (Blueprint $table) {
-    $table->comment('Business calculations');
+Если вы хотите добавить "комментарий" к таблице базы данных, вы можете вызвать метод `comment` на экземпляре таблицы. Комментарии к таблицам поддерживаются только в MariaDB, MySQL и PostgreSQL:
 
-    // ...
-});
-```
+    Schema::create('calculations', function (Blueprint $table) {
+        $table->comment('Business calculations');
 
-Этот код позволит вам добавить комментарий "Business calculations" к таблице "calculations" в вашей базе данных. Это может быть полезно для документации и описания цели таблицы.
+        // ...
+    });
 
 <a name="updating-tables"></a>
 ### Обновление таблиц
@@ -555,7 +547,7 @@ Schema::create('calculations', function (Blueprint $table) {
 
     $table->geography('coordinates', subtype: 'point', srid: 4326);
 
-> [!NOTE]  
+> [!NOTE]
 > Поддержка пространственных типов зависит от драйвера вашей базы данных. Пожалуйста, обратитесь к документации вашей базы данных. Если ваше приложение использует базу данных PostgreSQL, вам необходимо установить расширение [PostGIS](https://postgis.net), прежде чем можно будет использовать метод `geography`.
 
 <a name="column-method-geometry"></a>
@@ -565,7 +557,7 @@ Schema::create('calculations', function (Blueprint $table) {
 
     $table->geometry('positions', subtype: 'point', srid: 0);
 
-> [!NOTE]  
+> [!NOTE]
 > Поддержка пространственных типов зависит от драйвера вашей базы данных. Пожалуйста, обратитесь к документации вашей базы данных. Если ваше приложение использует базу данных PostgreSQL, вам необходимо установить расширение [PostGIS](https://postgis.net), прежде чем можно будет использовать метод `geometry`.
 
 <a name="column-method-id"></a>
@@ -683,9 +675,7 @@ Schema::create('calculations', function (Blueprint $table) {
 
 Этот метод аналогичен методу [ulidMorphs](#column-method-ulidMorphs); однако создаваемые столбцы будут "nullable" (допускающими значение null):
 
-```php
-$table->nullableUlidMorphs('taggable');
-```
+    $table->nullableUlidMorphs('taggable');
 
 <a name="column-method-nullableUuidMorphs"></a>
 #### `nullableUuidMorphs()`
@@ -815,9 +805,8 @@ $table->nullableUlidMorphs('taggable');
 
 Метод `tinyText` создаёт эквивалент столбца `TINYTEXT`:
 
-    $table->tinyText('notes');    
+    $table->tinyText('notes');
 
-When utilizing MySQL or MariaDB, you may apply a `binary` character set to the column in order to create a `TINYBLOB` equivalent column:
 При использовании MySQL или MariaDB вы можете применить к столбцу `binary` набор символов, чтобы создать эквивалентный столбец `TINYBLOB`:
 
     $table->tinyText('data')->charset('binary'); // TINYBLOB
@@ -880,11 +869,7 @@ When utilizing MySQL or MariaDB, you may apply a `binary` character set to the c
 
 Метод `ulid` создает столбец, эквивалентный `ULID`:
 
-```php
-$table->ulid('id');
-```
-
-Метод `ulid` создает столбец, эквивалентный `ULID` и присваивает ему имя 'id'.
+    $table->ulid('id');
 
 <a name="column-method-uuid"></a>
 #### `uuid()`
@@ -966,9 +951,9 @@ $table->ulid('id');
                 $table->timestamps();
             });
         }
-    }
+    };
 
-> [!WARNING] 
+> [!WARNING]
 > Поддержка выражений по умолчанию зависит от вашего драйвера базы данных, версии базы данных и типа поля. См. документацию к вашей базе данных.
 
 <a name="column-order"></a>
@@ -987,19 +972,15 @@ $table->ulid('id');
 
 Метод `change` позволяет вам изменять тип и атрибуты существующих колонок. Например, вы можете захотеть увеличить размер колонки типа `string`. Чтобы увидеть метод `change` в действии, давайте увеличим размер колонки `name` с 25 до 50. Для этого мы просто определяем новое состояние колонки и затем вызываем метод `change`:
 
-```php
-Schema::table('users', function (Blueprint $table) {
-    $table->string('name', 50)->change();
-});
-```
+    Schema::table('users', function (Blueprint $table) {
+        $table->string('name', 50)->change();
+    });
 
 При изменении колонки вы должны явно включить все модификаторы, которые вы хотите сохранить в определении колонки - любой пропущенный атрибут будет удален. Например, чтобы сохранить атрибуты `unsigned`, `default` и `comment`, вам нужно вызывать каждый модификатор явно при изменении колонки:
 
-```php
-Schema::table('users', function (Blueprint $table) {
-    $table->integer('votes')->unsigned()->default(1)->comment('мой комментарий')->change();
-});
-```
+    Schema::table('users', function (Blueprint $table) {
+        $table->integer('votes')->unsigned()->default(1)->comment('мой комментарий')->change();
+    });
 
 Метод `change` не меняет индексы столбца. Поэтому вы можете использовать модификаторы индекса, чтобы явно добавлять или удалять индекс при изменении столбца:
 
@@ -1016,11 +997,9 @@ $table->char('postal_code', 10)->unique(false)->change();
 
 Для переименования столбца вы можете использовать метод `renameColumn`, предоставленный строителем схемы:
 
-```php
-Schema::table('users', function (Blueprint $table) {
-    $table->renameColumn('from', 'to');
-});
-```
+    Schema::table('users', function (Blueprint $table) {
+        $table->renameColumn('from', 'to');
+    });
 
 <a name="dropping-columns"></a>
 ### Удаление столбцов
@@ -1089,8 +1068,8 @@ Laravel содержит несколько удобных методов, св
 | `$table->primary(['id', 'parent_id']);`          | Добавить составной ключ.                                           |
 | `$table->unique('email');`                       | Добавить уникальный индекс.                                        |
 | `$table->index('state');`                        | Добавляет простой индекс.                                          |
-| `$table->fulltext('body');`                      | Добавляет полнотекстовый индекс (MariaDB / MySQL / PostgreSQL).    |
-| `$table->fulltext('body')->language('english');` | Добавляет полнотекстовый индекс для указанного языка (PostgreSQL). |
+| `$table->fullText('body');`                      | Добавляет полнотекстовый индекс (MariaDB / MySQL / PostgreSQL).    |
+| `$table->fullText('body')->language('english');` | Добавляет полнотекстовый индекс для указанного языка (PostgreSQL). |
 | `$table->spatialIndex('location');`              | Добавляет пространственный индекс (кроме SQLite).                  |
 
 <a name="renaming-indexes"></a>
@@ -1194,10 +1173,10 @@ Laravel также поддерживает создание ограничен
     Schema::disableForeignKeyConstraints();
 
     Schema::withoutForeignKeyConstraints(function () {
-    // Constraints disabled within this closure...
+        // Constraints disabled within this closure...
     });
 
-> [!WARNING]  
+> [!WARNING]
 > SQLite по умолчанию отключает ограничения внешнего ключа. При использовании SQLite убедитесь, что [включили поддержку внешнего ключа](database#configuration) в вашей конфигурации базы данных, прежде чем пытаться создать их в ваших миграциях.
 
 <a name="events"></a>
@@ -1206,7 +1185,7 @@ Laravel также поддерживает создание ограничен
 Для удобства каждая операция миграции отправляет [событие](/docs/{{version}}/events). Все следующие события расширяют базовый класс `Illuminate\Database\Events\MigrationEvent`:
 
 | Класс                                            | Описание                                           |
-|--------------------------------------------------|----------------------------------------------------|
+| ------------------------------------------------ | -------------------------------------------------- |
 | `Illuminate\Database\Events\MigrationsStarted`   | Вот-вот будет выполнен пакет миграций.             |
 | `Illuminate\Database\Events\MigrationsEnded`     | Завершено выполнение пакета миграций.              |
 | `Illuminate\Database\Events\MigrationStarted`    | Одна миграция вот-вот будет выполнена.             |
