[compare] [9.x] 62afb8d...11c91dd

docs/blade.md

@@ -10,7 +10,7 @@
     - [Циклы](#loops)
     - [Переменная Loop](#the-loop-variable)
     - [Условные классы](#conditional-classes)
-    - [Отмеченные / Выделенные элементы интерфейса](#checked-and-selected)
+    - [Отмеченные / Выделенные / Отключенные элементы интерфейса](#checked-and-selected)
     - [Подключение дочерних шаблонов](#including-subviews)
     - [Директива `@once`](#the-once-directive)
     - [Необработанный PHP](#raw-php)
@@ -434,7 +434,7 @@ Hello, @{{ name }}.
 ```
 
 <a name="checked-and-selected"></a>
-### Отмеченные / Выделенные элементы интерфейса
+### Отмеченные / Выделенные / Отключенные элементы интерфейса
 
 Для удобства вы можете использовать директиву `@checked`, чтобы указать, должен ли быть «отмечен» HTML-флажок. Эта директива выведет `checked`, если переданное условие является истинным:
 
@@ -457,6 +457,12 @@ Hello, @{{ name }}.
 </select>
 ```
 
+Аналогично, директива `@disabled` может использоваться для указания, следует ли «заблокировать» указанный элемент:
+
+```blade
+<button type="submit" @disabled($errors->isNotEmpty())>Submit</button>
+```
+
 <a name="including-subviews"></a>
 ### Подключение дочерних шаблонов
 
@@ -1254,6 +1260,8 @@ php artisan make:component Alert --inline
 </li>
 ```
 
+> {note} Директива `@aware` не может получить доступ к родительским данным, если они не переданы родительскому компоненту явным образом через атрибуты HTML. Значения по умолчанию `@props`, которые не переданы явно родительскому компоненту, не могут быть доступны директиве `@aware`.
+
 <a name="dynamic-components"></a>
 ### Динамические компоненты
 

docs/cashier-paddle.md

@@ -73,7 +73,9 @@ During local and staging development, you should [register a Paddle Sandbox acco
 
 When using the Paddle Sandbox environment, you should set the `PADDLE_SANDBOX` environment variable to `true` within your application's `.env` file:
 
+```ini
 PADDLE_SANDBOX=true
+```
 
 After you have finished developing your application you may [apply for a Paddle vendor account](https://paddle.com). Before your application is placed into production, Paddle will need to approve your application's domain.
 
@@ -483,12 +485,12 @@ These defaults will be used for every action in Cashier that generates a [pay li
 <a name="creating-subscriptions"></a>
 ### Creating Subscriptions
 
-To create a subscription, first retrieve an instance of your billable model, which typically will be an instance of `App\Models\User`. Once you have retrieved the model instance, you may use the `newSubscription` method to create the model's subscription pay link:
+To create a subscription, first retrieve an instance of your billable model from your database, which typically will be an instance of `App\Models\User`. Once you have retrieved the model instance, you may use the `newSubscription` method to create the model's subscription pay link:
 
     use Illuminate\Http\Request;
 
     Route::get('/user/subscribe', function (Request $request) {
-        $payLink = $user->newSubscription('default', $premium = 12345)
+        $payLink = $request->user()->newSubscription('default', $premium = 12345)
             ->returnTo(route('home'))
             ->create();
 

docs/eloquent-mutators.md

@@ -412,7 +412,7 @@ protected function address(): Attribute
 
 > {note} Перечисляемые типы доступны только в [PHP 8.1+](https://www.php.net/manual/ru/language.enumerations.php).
 
-Eloquent также позволяет вам преобразовывать значения ваших атрибутов в перечисления PHP. Для этого вы можете указать атрибут, который вы хотите типизировать, и соответствующий класс перечисления в массиве `$casts` вашей модели:
+Eloquent также позволяет вам преобразовывать значения ваших атрибутов в [типизированные перечисления](https://www.php.net/manual/ru/language.enumerations.backed.php) PHP. Для этого вы можете указать атрибут, который вы хотите типизировать, и соответствующий класс перечисления в массиве `$casts` вашей модели:
 
     use App\Enums\ServerStatus;
 

docs/eloquent-serialization.md

@@ -143,7 +143,7 @@
         protected function isAdmin(): Attribute
         {
             return new Attribute(
-                get: fn () => 'yes';
+                get: fn () => 'yes',
             );
         }
     }

docs/eloquent.md

@@ -618,7 +618,7 @@ Eloquent также предлагает поддержку расширенны
 
 Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` для проверки внутреннего состояния модели и определения того, как изменились ее атрибуты с момента первоначального извлечения модели.
 
-Метод `isDirty` определяет, были ли изменены какие-либо атрибуты модели с момента получения модели. Вы можете передать конкретное имя атрибута методу `isDirty`, чтобы определить, является ли конкретный атрибут «грязным». Метод `isClean` определяет, остался ли атрибут неизменным с момента получения модели. Этот метод также принимает необязательный аргумент атрибута:
+Метод `isDirty` определяет, были ли изменены какие-либо атрибуты модели с момента получения модели. Вы можете передать конкретное имя атрибута или массив атрибутов методу `isDirty`, чтобы определить, является ли какой-либо из атрибутов «грязным». Метод `isClean` определяет, остался ли атрибут неизменным с момента получения модели. Этот метод также принимает необязательный аргумент атрибута:
 
     use App\Models\User;
 
@@ -633,10 +633,12 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
     $user->isDirty(); // true
     $user->isDirty('title'); // true
     $user->isDirty('first_name'); // false
+    $user->isDirty(['first_name', 'title']); // true
 
     $user->isClean(); // false
     $user->isClean('title'); // false
     $user->isClean('first_name'); // true
+    $user->isClean(['first_name', 'title']); // false
 
     $user->save();
 
@@ -657,7 +659,9 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
 
     $user->wasChanged(); // true
     $user->wasChanged('title'); // true
+    $user->wasChanged(['title', 'slug']); // true
     $user->wasChanged('first_name'); // false
+    $user->wasChanged(['first_name', 'title']); // true
 
 Метод `getOriginal` возвращает массив, содержащий исходные атрибуты модели, независимо от каких-либо изменений в модели с момента ее получения. При необходимости вы можете передать конкретное имя атрибута, чтобы получить исходное значение определенного атрибута:
 

docs/helpers.md

@@ -101,6 +101,7 @@ Laravel содержит множество глобальных «вспомо
 - [Str::contains](#method-str-contains)
 - [Str::containsAll](#method-str-contains-all)
 - [Str::endsWith](#method-ends-with)
+- [Str::excerpt](#method-excerpt)
 - [Str::finish](#method-str-finish)
 - [Str::headline](#method-str-headline)
 - [Str::is](#method-str-is)
@@ -166,6 +167,7 @@ Laravel содержит множество глобальных «вспомо
 - [containsAll](#method-fluent-str-contains-all)
 - [dirname](#method-fluent-str-dirname)
 - [endsWith](#method-fluent-str-ends-with)
+- [excerpt](#method-fluent-str-excerpt)
 - [exactly](#method-fluent-str-exactly)
 - [explode](#method-fluent-str-explode)
 - [finish](#method-fluent-str-finish)
@@ -1274,6 +1276,32 @@ Laravel содержит множество глобальных «вспомо
 
     // false
 
+<a name="method-excerpt"></a>
+#### `Str::excerpt()`
+
+Метод `Str::excerpt` извлекает отрывок из переданной строки, который соответствует первому экземпляру фразы в этой строке:
+
+    use Illuminate\Support\Str;
+
+    $excerpt = Str::excerpt('This is my name', 'my', [
+        'radius' => 3
+    ]);
+
+    // '...is my na...'
+
+Параметр `radius`, который по умолчанию равен `100`, позволяет вам определить количество символов, которые должны присутствовать с каждой стороны усеченной строки.
+
+Кроме того, вы можете использовать параметр `omission`, чтобы определить строку, которая будет добавлена к усеченной строке:
+
+    use Illuminate\Support\Str;
+
+    $excerpt = Str::excerpt('This is my name', 'name', [
+        'radius' => 3,
+        'omission' => '(...) '
+    ]);
+
+    // '(...) my name'
+
 <a name="method-str-finish"></a>
 #### `Str::finish()`
 
@@ -2027,6 +2055,32 @@ Str::wordCount('Hello, world!'); // 2
 
     // '/foo'
 
+<a name="method-fluent-str-excerpt"></a>
+#### `excerpt`
+
+Метод `excerpt` извлекает отрывок из переданной строки, который соответствует первому экземпляру фразы в этой строке:
+
+    use Illuminate\Support\Str;
+
+    $excerpt = Str::of('This is my name')->excerpt('my', [
+        'radius' => 3
+    ]);
+
+    // '...is my na...'
+
+Параметр `radius`, который по умолчанию равен `100`, позволяет вам определить количество символов, которые должны присутствовать с каждой стороны усеченной строки.
+
+Кроме того, вы можете использовать параметр `omission`, чтобы определить строку, которая будет добавлена к усеченной строке:
+
+    use Illuminate\Support\Str;
+
+    $excerpt = Str::of('This is my name')->excerpt('name', [
+        'radius' => 3,
+        'omission' => '(...) '
+    ]);
+
+    // '(...) my name'
+
 <a name="method-fluent-str-ends-with"></a>
 #### `endsWith`
 

docs/queries.md

@@ -789,7 +789,7 @@ where exists (
 
     $users = DB::table('users')
                     ->when($role, function ($query, $role) {
-                        return $query->where('role_id', $role);
+                        $query->where('role_id', $role);
                     })
                     ->get();
 
@@ -801,9 +801,9 @@ where exists (
 
     $users = DB::table('users')
                     ->when($sortByVotes, function ($query, $sortByVotes) {
-                        return $query->orderBy('votes');
+                        $query->orderBy('votes');
                     }, function ($query) {
-                        return $query->orderBy('name');
+                        $query->orderBy('name');
                     })
                     ->get();
 

docs/queues.md

@@ -1628,7 +1628,9 @@ sudo supervisorctl start laravel-worker:*
 <a name="dealing-with-failed-jobs"></a>
 ## Разбор неудачных заданий
 
-Иногда ваши задания в очереди терпят неудачу. Не волнуйтесь, не всегда все идет по плану! Laravel включает удобный способ [указать максимальное количество попыток выполнения задания](#max-job-attempts-and-timeout). После того, как задание превысит это количество попыток, оно будет вставлено в таблицу базы данных `failed_jobs`. Конечно, нам нужно будет создать эту таблицу, если она еще не существует. Чтобы создать миграцию для таблицы `failed_jobs`, вы можете использовать команду `queue:failed-table`:
+Иногда ваши задания в очереди терпят неудачу. Не волнуйтесь, не всегда все идет по плану! Laravel включает удобный способ [указать максимальное количество попыток выполнения задания](#max-job-attempts-and-timeout). После того, как асинхронное задание превысит это количество попыток, оно будет вставлено в таблицу базы данных `failed_jobs`. [Синхронно отправленные задания](#synchronous-dispatching), которые завершились сбоем, не сохраняются в этой таблице, и их исключения немедленно обрабатываются приложением.
+
+Миграция для создания таблицы `failed_jobs` обычно уже присутствует в новых приложениях Laravel. Однако, если ваше приложение не содержит миграции для этой таблицы, вы можете использовать команду `queue:failed-table` для ее создания:
 
 ```shell
 php artisan queue:failed-table

docs/releases.md

@@ -135,7 +135,7 @@ public function address(): Attribute
 
 _Автор: [Mohamed Said](https://github.com/themsaid)_.
 
-Eloquent также позволяет вам преобразовывать значения ваших атрибутов в перечисления PHP. Для этого вы можете указать атрибут, который вы хотите типизировать, и соответствующий класс перечисления в массиве `$casts` вашей модели:
+Eloquent также позволяет вам преобразовывать значения ваших атрибутов в [типизированные перечисления](https://www.php.net/manual/ru/language.enumerations.backed.php) PHP. Для этого вы можете указать атрибут, который вы хотите типизировать, и соответствующий класс перечисления в массиве `$casts` вашей модели:
 
     use App\Enums\ServerStatus;
 

docs/sail.md

@@ -230,7 +230,7 @@ sail yarn
 По умолчанию конфигурационный файл `filesystems` вашего приложения уже содержит конфигурацию для диска `s3`. Помимо использования этого диска для взаимодействия с Amazon S3, вы можете использовать его для взаимодействия с любой S3-совместимой службой хранения файлов, такой как MinIO, путем простого изменения соответствующих переменных окружения, которые управляют его конфигурацией. Например, при использовании MinIO, конфигурация переменной окружения файловой системы должна быть определена следующим образом:
 
 ```ini
-FILESYSTEM_DRIVER=s3
+FILESYSTEM_DISK=s3
 AWS_ACCESS_KEY_ID=sail
 AWS_SECRET_ACCESS_KEY=password
 AWS_DEFAULT_REGION=us-east-1

docs/upgrade.md

@@ -114,6 +114,10 @@ PHP начинает переходить к требованию определ
 
     public function storagePath($path = '');
 
+Точно так же метод `langPath` класса `Illuminate\Foundation\Application` был обновлен, чтобы принимать аргумент `$path`:
+
+    public function langPath($path = '');
+
 #### Метод `ignore` обработчика исключений
 
 **Вероятность воздействия: низкая**