Subscribe
@@ -1006,7 +1026,7 @@ Cashier also emit events dedicated to the type of the received webhook. In addit
You can also override the default, built-in webhook route by defining the `CASHIER_WEBHOOK` environment variable in your application's `.env` file. This value should be the full URL to your webhook route and needs to match the URL set in your Paddle control panel:
-```bash
+```ini
CASHIER_WEBHOOK=https://example.com/my-paddle-webhook-url
```
@@ -1035,7 +1055,7 @@ If you would like to make a one-time charge against a customer, you may use the
After generating the pay link, you may use Cashier's provided `paddle-button` Blade component to allow the user to initiate the Paddle widget and complete the charge:
-```html
+```blade
Buy
@@ -1049,7 +1069,7 @@ The `charge` method accepts an array as its third argument, allowing you to pass
Charges happen in the currency specified in the `cashier.currency` configuration option. By default, this is set to USD. You may override the default currency by defining the `CASHIER_CURRENCY` environment variable in your application's `.env` file:
-```bash
+```ini
CASHIER_CURRENCY=EUR
```
@@ -1075,7 +1095,7 @@ If you would like to make a one-time charge against a specific product configure
Then, you may provide the pay link to the `paddle-button` component to allow the user to initialize the Paddle widget:
-```html
+```blade
Buy
@@ -1151,7 +1171,9 @@ You may use the `lastPayment` and `nextPayment` methods to retrieve and display
Both of these methods will return an instance of `Laravel\Paddle\Payment`; however, `nextPayment` will return `null` when the billing cycle has ended (such as when a subscription has been cancelled):
- Next payment: {{ $nextPayment->amount() }} due on {{ $nextPayment->date()->format('d/m/Y') }}
+```blade
+Next payment: {{ $nextPayment->amount() }} due on {{ $nextPayment->date()->format('d/m/Y') }}
+```
## Handling Failed Payments
diff --git a/docs/collections.md b/docs/collections.md
index ca5b98b..6cca782 100644
--- a/docs/collections.md
+++ b/docs/collections.md
@@ -166,6 +166,7 @@
- [random](#method-random)
- [range](#method-range)
- [reduce](#method-reduce)
+- [reduceMany](#method-reduce-many)
- [reduceSpread](#method-reduce-spread)
- [reject](#method-reject)
- [replace](#method-replace)
@@ -288,13 +289,15 @@
Этот метод особенно полезен в [шаблонах](views.md) при работе с сеткой, такой как [Bootstrap](https://getbootstrap.com/docs/4.1/layout/grid/). Например, представьте, что у вас есть коллекция моделей [Eloquent](eloquent.md), которые вы хотите отобразить в сетке:
- @foreach ($products->chunk(3) as $chunk)
-
- @foreach ($chunk as $product)
-
{{ $product->name }}
- @endforeach
-
- @endforeach
+```blade
+@foreach ($products->chunk(3) as $chunk)
+
+ @foreach ($chunk as $product)
+
{{ $product->name }}
+ @endforeach
+
+@endforeach
+```
#### `chunkWhile()`
@@ -1817,13 +1820,29 @@
// 4264
+
+#### `reduceMany()`
+
+Метод `reduceMany` сокращает коллекцию до массива значений, передавая результаты каждой итерации следующей итерации. Этот метод подобен методу `reduce`; однако он может принимать несколько начальных значений:
+
+ [$creditsRemaining, $batch] = Image::where('status', 'unprocessed')
+ ->get()
+ ->reduceMany(function ($creditsRemaining, $batch, $image) {
+ if ($creditsRemaining >= $image->creditsRequired()) {
+ $batch->push($image);
+
+ $creditsRemaining -= $image->creditsRequired();
+ }
+
+ return [$creditsRemaining, $batch];
+ }, $creditsAvailable, collect());
+
#### `reduceSpread()`
Метод `reduceSpread` сокращает коллекцию до массива значений, передавая результаты каждой итерации в следующую итерацию. Этот метод похож на метод `reduce`; однако он может принимать несколько начальных значений:
-```php
-[$creditsRemaining, $batch] = Image::where('status', 'unprocessed')
+ [$creditsRemaining, $batch] = Image::where('status', 'unprocessed')
->get()
->reduceSpread(function ($creditsRemaining, $batch, $image) {
if ($creditsRemaining >= $image->creditsRequired()) {
@@ -1834,7 +1853,6 @@
return [$creditsRemaining, $batch];
}, $creditsAvailable, collect());
-```
#### `reject()`
diff --git a/docs/configuration.md b/docs/configuration.md
index c266239..2160419 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -58,7 +58,9 @@ null | (null) null
Если вам нужно определить переменную окружения со значением, содержащим пробелы, то вы можете сделать это, заключив значение в двойные кавычки:
- APP_NAME="My Application"
+```ini
+APP_NAME="My Application"
+```
### Получение конфигурации окружения
@@ -127,26 +129,36 @@ null | (null) null
Чтобы включить режим обслуживания, выполните команду `down` Artisan:
- php artisan down
+```shell
+php artisan down
+```
Если вы хотите, чтобы HTTP-заголовок `Refresh` отправлялся со всеми ответами режима обслуживания, то вы можете указать параметр `refresh` при вызове команды `down`. Заголовок `Refresh` проинструктирует браузер автоматически обновлять страницу через указанное количество секунд:
- php artisan down --refresh=15
+```shell
+php artisan down --refresh=15
+```
Вы также можете передать команде `down` параметр `retry`, значение которого будет установлено в заголовке `Retry-After` HTTP, хотя браузеры обычно игнорируют этот заголовок:
- php artisan down --retry=60
+```shell
+php artisan down --retry=60
+```
#### Обход режима обслуживания
Находясь в режиме обслуживания, вы можете использовать параметр `secret`, чтобы указать токен для обхода режима обслуживания:
- php artisan down --secret="1630542a-246b-4b66-afa1-dd72a4c43515"
+```shell
+php artisan down --secret="1630542a-246b-4b66-afa1-dd72a4c43515"
+```
После перевода приложения в режим обслуживания, вы можете перейти по URL-адресу приложения, с учетом этого токена, и Laravel выдаст вашему браузеру файл куки для обхода режима обслуживания:
- https://example.com/1630542a-246b-4b66-afa1-dd72a4c43515
+```shell
+https://example.com/1630542a-246b-4b66-afa1-dd72a4c43515
+```
При доступе к этому скрытому маршруту вы будете перенаправлены на маршрут `/` приложения. Как только куки будет отправлен вашему браузеру, вы сможете просматривать приложение в обычном режиме, как если бы оно не находилось в режиме обслуживания.
@@ -159,21 +171,27 @@ null | (null) null
По этой причине Laravel позволяет в самом начале цикла запроса отобразить шаблон режима обслуживания. Этот шаблон отображается перед загрузкой любых зависимостей вашего приложения. Вы можете выполнить предварительный рендеринг шаблона по вашему выбору, используя параметр `render` команды `down`:
- php artisan down --render="errors::503"
+```shell
+php artisan down --render="errors::503"
+```
#### Перенаправление запросов режима обслуживания
В режиме обслуживания Laravel будет отображать шаблон режима обслуживания для всех URL-адресов приложения, к которым пользователь попытается получить доступ. Если хотите, то вы можете указать Laravel перенаправлять все запросы на определенный URL. Это может быть выполнено с помощью параметра `redirect`. Например, вы можете перенаправить все запросы на URI `/`:
- php artisan down --redirect=/
+```shell
+php artisan down --redirect=/
+```
#### Отключение режима обслуживания
Чтобы отключить режим обслуживания, используйте команду `up`:
- php artisan up
+```shell
+php artisan up
+```
> {tip} Вы можете определить свой шаблон режима обслуживания в `resources/views/errors/503.blade.php`.
diff --git a/docs/contracts.md b/docs/contracts.md
index 1a91cd8..e649d6a 100644
--- a/docs/contracts.md
+++ b/docs/contracts.md
@@ -11,7 +11,7 @@
«Контракты» Laravel – это набор интерфейсов, которые определяют основные службы фреймворка. Например, контракт `Illuminate\Contracts\Queue\Queue` определяет методы, необходимые для постановки заданий в очередь, а контракт `Illuminate\Contracts\Mail\Mailer` – для отправки электронной почты.
-Каждый контракт имеет соответствующую реализацию, предусмотренную структурой. Например, Laravel предлагает реализацию очереди с множеством драйверов и реализацию почтовой программы, которая работает на [SwiftMailer](https://swiftmailer.symfony.com/).
+Каждый контракт имеет соответствующую реализацию, предусмотренную структурой. Например, Laravel предлагает реализацию очереди с множеством драйверов и реализацию почтовой программы, которая работает на [Symfony Mailer](https://symfony.com/doc/6.0/mailer.html).
Все контракты Laravel находятся в [их собственном репозитории](https://github.com/illuminate/contracts) GitHub. Это обеспечивает быстрый доступ к списку всех доступных контрактов, а также единый, отдельный пакет, который используется разработчиками пакетов, взаимодействующих со службами Laravel.
diff --git a/docs/controllers.md b/docs/controllers.md
index 6c9b3cb..fb2c202 100644
--- a/docs/controllers.md
+++ b/docs/controllers.md
@@ -94,7 +94,9 @@
Вы можете сгенерировать вызываемый контроллер, используя параметр `--invokable` команды `make:controller` Artisan:
- php artisan make:controller ProvisionServer --invokable
+```shell
+php artisan make:controller ProvisionServer --invokable
+```
> {tip} Заготовки контроллера можно настроить с помощью [публикации заготовок](artisan.md#stub-customization).
@@ -135,7 +137,9 @@
Благодаря такому распространенному варианту использования, маршрутизация ресурсов Laravel присвоит типичные маршруты создания, чтения, обновления и удаления («CRUD») контроллеру с помощью одной строки кода. Для начала мы можем использовать параметр `--resource` команды `make:controller` Artisan, чтобы быстро создать контроллер для обработки этих действий:
- php artisan make:controller PhotoController --resource
+```shell
+php artisan make:controller PhotoController --resource
+```
Эта команда поместит новый класс контроллера в каталог `app/Http/Controllers` вашего приложения. Контроллер будет содержать метод для каждого из доступных действий с ресурсами. Затем, вы можете зарегистрировать маршрут ресурса, который указывает на контроллер:
@@ -184,14 +188,18 @@ DELETE | `/photos/{photo}` | destroy | photos.destroy
Если вы используете [привязку модели к маршруту](routing.md#route-model-binding) и хотите, чтобы методы контроллера ресурса содержали типизацию экземпляра модели, вы можете использовать параметр `--model` при создании контроллера:
- php artisan make:controller PhotoController --model=Photo --resource
+```shell
+php artisan make:controller PhotoController --model=Photo --resource
+```
#### Генерация запросов формы
Вы можете указать флаг `--requests` при создании ресурсного контроллера, чтобы указать Artisan о попутном создании [классов запросов](validation.md#form-request-validation) для методов `store` и `update` контроллера:
- php artisan make:controller PhotoController --model=Photo --resource --requests
+```shell
+php artisan make:controller PhotoController --model=Photo --resource --requests
+```
### Частичные ресурсные маршруты
@@ -229,7 +237,9 @@ DELETE | `/photos/{photo}` | destroy | photos.destroy
Чтобы быстро сгенерировать ресурсный API-контроллер, который не включает методы `create` или `edit`, используйте переключатель `--api` при выполнении команды `make:controller`:
- php artisan make:controller PhotoController --api
+```shell
+php artisan make:controller PhotoController --api
+```
### Вложенные ресурсы
diff --git a/docs/csrf.md b/docs/csrf.md
index fcd04da..c6c81be 100644
--- a/docs/csrf.md
+++ b/docs/csrf.md
@@ -18,13 +18,15 @@
Без защиты от CSRF вредоносный веб-сайт может создать HTML-форму, которая указывает на маршрут вашего приложения `/user/email` и отправляет собственный адрес электронной почты злоумышленника:
-
+```blade
+
-
+
+```
Если вредоносный веб-сайт автоматически отправляет форму при загрузке страницы, злоумышленнику нужно только подтолкнуть ничего не подозревающего пользователя вашего приложения посетить свой веб-сайт, и его адрес электронной почты будет изменен в вашем приложении.
@@ -49,12 +51,14 @@ Laravel автоматически генерирует «токен» CSRF дл
Каждый раз, когда вы создаете HTML-форму запросов «POST» «PUT», «PATCH» или «DELETE» в своем приложении, вы должны включать в форму скрытое поле `_token`, чтобы посредник защиты от CSRF смог выполнить проверку запроса. Для удобства вы можете использовать директиву `@csrf` Blade для создания скрытого поля ввода, содержащего этот токен:
-
+
+
+
+```
[Посредник](middleware.md) `App\Http\Middleware\VerifyCsrfToken`, который по умолчанию стоит в группе посредников `web`, автоматически проверяет соответствие токена во входном запросе и токен, хранящийся в сессии. Когда эти два токена совпадают, мы знаем, что запрос инициирует аутентифицированный пользователь.
@@ -97,15 +101,19 @@ Laravel автоматически генерирует «токен» CSRF дл
В дополнение к проверке токена CSRF в качестве параметра POST-запроса посредник `App\Http\Middleware\VerifyCsrfToken` также проверяет заголовок запроса `X-CSRF-TOKEN`. Вы можете, например, сохранить токен в HTML-теге `meta`:
-
+```blade
+
+```
Затем, вы можете указать библиотеке, такой как jQuery, автоматически добавлять токен во все заголовки запросов. Это обеспечивает простую и удобную защиту от CSRF для ваших приложений с использованием устаревшей технологии JavaScript на основе AJAX:
- $.ajaxSetup({
- headers: {
- 'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
- }
- });
+```js
+$.ajaxSetup({
+ headers: {
+ 'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
+ }
+});
+```
## Токен X-XSRF
diff --git a/docs/database-testing.md b/docs/database-testing.md
index 2376da6..72ea085 100644
--- a/docs/database-testing.md
+++ b/docs/database-testing.md
@@ -55,6 +55,10 @@ Laravel предлагает множество полезных инструм
}
}
+Трейт `Illuminate\Foundation\Testing\RefreshDatabase` не мигрирует вашу базу данных, если ваша схема обновлена. Вместо этого он будет выполнять тест только в транзакции базы данных. Следовательно, любые записи, добавленные в базу данных тестом, не использующими этот трейт, могут по-прежнему существовать в базе данных.
+
+Если вы хотите полностью сбросить базу данных с помощью миграции, то вы можете вместо этого использовать трейт `Illuminate\Foundation\Testing\DatabaseMigrations`. Однако использование трейта `DatabaseMigrations` значительно медленнее, чем использование трейта `RefreshDatabase`.
+
## Определение фабрик моделей
@@ -100,7 +104,9 @@ Laravel предлагает множество полезных инструм
Чтобы сгенерировать новую фабрику, используйте команду `make:factory` [Artisan](artisan.md):
- php artisan make:factory PostFactory
+```shell
+php artisan make:factory PostFactory
+```
Эта команда поместит новый класс фабрики в каталог `database/factories` вашего приложения.
diff --git a/docs/database.md b/docs/database.md
index 4354236..1e04bfe 100644
--- a/docs/database.md
+++ b/docs/database.md
@@ -16,7 +16,6 @@
-- MariaDB 10.2+ ([Политика версий](https://mariadb.org/about/#maintenance-policy))
- MySQL 5.7+ ([Политика версий](https://en.wikipedia.org/wiki/MySQL#Release_history))
- PostgreSQL 9.6+ ([Политика версий](https://www.postgresql.org/support/versioning/))
- SQLite 3.8.8+
@@ -36,12 +35,16 @@
Базы данных SQLite содержатся в одном файле вашей файловой системы. Вы можете создать новую базу данных SQLite, используя команду `touch` в консоли: `touch database/database.sqlite`. После создания базы данных вы можете легко настроить переменные окружения так, чтобы они указывали на эту базу данных, указав абсолютный путь к базе данных в переменной `DB_DATABASE` окружения:
- DB_CONNECTION=sqlite
- DB_DATABASE=/absolute/path/to/database.sqlite
+```ini
+DB_CONNECTION=sqlite
+DB_DATABASE=/absolute/path/to/database.sqlite
+```
Чтобы включить ограничения внешнего ключа для соединений SQLite, установите переменную `DB_FOREIGN_KEYS` окружения в `true`:
- DB_FOREIGN_KEYS=true
+```ini
+DB_FOREIGN_KEYS=true
+```
#### Конфигурация Microsoft SQL Server
@@ -313,8 +316,12 @@ driver://username:password@host:port/database?options
Если вы хотите подключиться к своей базе данных с помощью интерфейса командной строки, то вы можете использовать команду `db` Artisan:
- php artisan db
+```shell
+php artisan db
+```
При необходимости, вы можете указать имя соединения для подключения к базе данных, не являющееся соединением по умолчанию:
- php artisan db mysql
+```shell
+php artisan db mysql
+```
diff --git a/docs/deployment.md b/docs/deployment.md
index ae20a7a..238294d 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -24,13 +24,15 @@
-- PHP >= 7.3
+- PHP >= 8.0
- Расширение PHP BCMath
- Расширение PHP Ctype
+- Расширение PHP DOM
- Расширение PHP Fileinfo
- Расширение PHP JSON
- Расширение PHP Mbstring
- Расширение PHP OpenSSL
+- Расширение PHP PCRE
- Расширение PHP PDO
- Расширение PHP Tokenizer
- Расширение PHP XML
@@ -47,38 +49,40 @@
Убедитесь, что, как и в конфигурации ниже, ваш веб-сервер направляет все запросы в файл `public/index.php` вашего приложения. Вы никогда не должны пытаться переместить файл `index.php` в корень вашего проекта, поскольку обслуживание приложения из корня проекта откроет доступ ко многим конфиденциальным файлам конфигурации из общедоступной сети Интернет:
- server {
- listen 80;
- listen [::]:80;
- server_name example.com;
- root /srv/example.com/public;
+```nginx
+server {
+ listen 80;
+ listen [::]:80;
+ server_name example.com;
+ root /srv/example.com/public;
- add_header X-Frame-Options "SAMEORIGIN";
- add_header X-Content-Type-Options "nosniff";
+ add_header X-Frame-Options "SAMEORIGIN";
+ add_header X-Content-Type-Options "nosniff";
- index index.php;
+ index index.php;
- charset utf-8;
+ charset utf-8;
- location / {
- try_files $uri $uri/ /index.php?$query_string;
- }
+ location / {
+ try_files $uri $uri/ /index.php?$query_string;
+ }
- location = /favicon.ico { access_log off; log_not_found off; }
- location = /robots.txt { access_log off; log_not_found off; }
+ location = /favicon.ico { access_log off; log_not_found off; }
+ location = /robots.txt { access_log off; log_not_found off; }
- error_page 404 /index.php;
+ error_page 404 /index.php;
- location ~ \.php$ {
- fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
- fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
- include fastcgi_params;
- }
+ location ~ \.php$ {
+ fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
+ fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
+ include fastcgi_params;
+ }
- location ~ /\.(?!well-known).* {
- deny all;
- }
+ location ~ /\.(?!well-known).* {
+ deny all;
}
+}
+```
## Оптимизация
@@ -88,7 +92,9 @@
При развертывании в эксплуатационном окружении, убедитесь, что вы оптимизировали файл автозагрузчика классов Composer, чтобы он мог быстро найти нужный файл для загрузки конкретного класса:
- composer install --optimize-autoloader --no-dev
+```shell
+composer install --optimize-autoloader --no-dev
+```
> {tip} Помимо оптимизации автозагрузчика, вы всегда должны обязательно включать файл `composer.lock` в репозиторий системы управления версиями вашего проекта. Зависимости вашего проекта могут быть установлены намного быстрее, если присутствует файл `composer.lock`.
@@ -97,7 +103,9 @@
При развертывании вашего приложения в эксплуатационном окружении, вы должны убедиться, что вы выполнили команду `config:cache` Artisan в процессе развертывания:
- php artisan config:cache
+```shell
+php artisan config:cache
+```
Эта команда объединит все файлы конфигурации Laravel в один кешированный файл, что значительно сократит количество обращений, которые фреймворк должен совершить к файловой системе при загрузке значений вашей конфигурации.
@@ -108,7 +116,9 @@
Если вы создаете большое приложение с множеством маршрутов, вам следует убедиться, что вы выполнили команду `route:cache` Artisan в процессе развертывания:
- php artisan route:cache
+```shell
+php artisan route:cache
+```
Эта команда сокращает регистрации всех маршрутов до одного вызова метода в кешированном файле, повышая производительность при регистрации сотен маршрутов.
@@ -117,7 +127,9 @@
При развертывании вашего приложения в эксплуатационном окружении, вы должны убедиться, что вы выполнили команду `view:cache` Artisan в процессе развертывания:
- php artisan view:cache
+```shell
+php artisan view:cache
+```
Эта команда предварительно скомпилирует все ваши шаблоны Blade, чтобы они не компилировались во время запроса, повышая производительность каждого запроса, возвращающего шаблоном.
diff --git a/docs/documentation.md b/docs/documentation.md
index b580731..3d59305 100644
--- a/docs/documentation.md
+++ b/docs/documentation.md
@@ -89,4 +89,4 @@
- [Socialite](/docs/{{version}}/socialite)
- [Telescope](/docs/{{version}}/telescope)
- [Valet](/docs/{{version}}/valet)
-- [API Documentation](/api/8.x)
+- [API Documentation](/api/master)
diff --git a/docs/dusk.md b/docs/dusk.md
index 40666d6..86d19a7 100644
--- a/docs/dusk.md
+++ b/docs/dusk.md
@@ -58,13 +58,17 @@
Для начала установите [Google Chrome](https://www.google.com/chrome) и добавьте в зависимость `laravel/dusk` с помощью менеджера пакетов Composer в свой проект:
- composer require --dev laravel/dusk
+```shell
+composer require --dev laravel/dusk
+```
> {note} Если вы вручную регистрируете поставщика `DuskServiceProvider`, то вам **никогда** не следует регистрировать его в рабочем окружении, так как это может привести к тому, что случайные пользователи смогут пройти аутентификацию в вашем приложении.
После установки пакета Dusk выполните команду `dusk:install` Artisan. Команда `dusk:install` создаст каталог `tests/Browser` и пример теста Dusk:
- php artisan dusk:install
+```shell
+php artisan dusk:install
+```
Затем установите переменную окружения `APP_URL` в файле `.env` вашего приложения. Это значение должно соответствовать URL-адресу, который вы используете для доступа к вашему приложению в браузере.
@@ -75,17 +79,19 @@
Если вы хотите установить версию ChromeDriver, отличную от той, которая включена в Laravel Dusk, то вы можете использовать команду `dusk:chrome-driver`:
- # Установить последнюю версию ChromeDriver для вашей ОС ...
- php artisan dusk:chrome-driver
+```shell
+# Установить последнюю версию ChromeDriver для вашей ОС ...
+php artisan dusk:chrome-driver
- # Установить конкретную версию ChromeDriver для вашей ОС ...
- php artisan dusk:chrome-driver 86
+# Установить конкретную версию ChromeDriver для вашей ОС ...
+php artisan dusk:chrome-driver 86
- # Установить конкретную версию ChromeDriver для всех поддерживаемых ОС ...
- php artisan dusk:chrome-driver --all
+# Установить конкретную версию ChromeDriver для всех поддерживаемых ОС ...
+php artisan dusk:chrome-driver --all
- # Установить версию ChromeDriver, которая соответствует обнаруженной версии Chrome / Chromium для вашей ОС ...
- php artisan dusk:chrome-driver --detect
+# Установить версию ChromeDriver, которая соответствует обнаруженной версии Chrome / Chromium для вашей ОС ...
+php artisan dusk:chrome-driver --detect
+```
> {note} Dusk требует, чтобы файлы `chromedriver` были доступны для выполнения. Если у вас возникли проблемы с запуском Dusk, то вы должны убедиться, что файлы доступны для выполнения, используя следующую команду: `chmod -R 0755 vendor/laravel/dusk/bin/`.
@@ -129,7 +135,9 @@
Чтобы сгенерировать тест Dusk, используйте команду `dusk:make` Artisan. Сгенерированный тест будет помещен в каталог `tests/Browser`:
- php artisan dusk:make LoginTest
+```shell
+php artisan dusk:make LoginTest
+```
### Миграции базы данных
@@ -157,15 +165,21 @@
Чтобы запустить браузерные тесты, выполните команду `dusk` Artisan:
- php artisan dusk
+```shell
+php artisan dusk
+```
Если при последнем запуске команды `dusk` у вас были ошибки тестирования, то вы можете сэкономить время, повторно запустив сначала неудачные тесты с помощью команды `dusk:fails`:
- php artisan dusk:fails
+```shell
+php artisan dusk:fails
+```
Команда `dusk` принимает любой аргумент, который обычно принимается тестером PHPUnit, например, позволяет вам запускать тесты только для указанной [группы](https://phpunit.de/manual/current/en/appendixes.annotations.html#appendixes.annotations.group):
- php artisan dusk --group=foo
+```shell
+php artisan dusk --group=foo
+```
> {tip} Если вы используете [Laravel Sail](sail.md) для управления своей локальной средой разработки, обратитесь к документации Sail по [настройке и запуску тестов Dusk](sail.md#laravel-dusk).
@@ -1802,69 +1816,73 @@ Dusk даже позволяет вам делать утверждения о
Чтобы запустить тесты Dusk на [Travis CI](https://travis-ci.org), используйте следующую конфигурацию `.travis.yml`. Поскольку Travis CI не является графической средой, то нам нужно будет предпринять некоторые дополнительные шаги, чтобы запустить браузер Chrome. Кроме того, мы будем использовать `php artisan serve` для запуска встроенного веб-сервера PHP:
- language: php
+```yaml
+language: php
- php:
- - 7.3
+php:
+ - 7.3
- addons:
- chrome: stable
+addons:
+ chrome: stable
- install:
- - cp .env.testing .env
- - travis_retry composer install --no-interaction --prefer-dist
- - php artisan key:generate
- - php artisan dusk:chrome-driver
+install:
+ - cp .env.testing .env
+ - travis_retry composer install --no-interaction --prefer-dist
+ - php artisan key:generate
+ - php artisan dusk:chrome-driver
- before_script:
- - google-chrome-stable --headless --disable-gpu --remote-debugging-port=9222 http://localhost &
- - php artisan serve --no-reload &
+before_script:
+ - google-chrome-stable --headless --disable-gpu --remote-debugging-port=9222 http://localhost &
+ - php artisan serve --no-reload &
- script:
- - php artisan dusk
+script:
+ - php artisan dusk
+```
### GitHub Actions
Если вы используете [Github Actions](https://github.com/features/actions) для запуска тестов Dusk, то вы можете использовать следующий конфигурационный файл в качестве отправной точки. Как и в случае с TravisCI, мы будем использовать команду `php artisan serve` для запуска встроенного веб-сервера PHP:
- name: CI
- on: [push]
- jobs:
-
- dusk-php:
- runs-on: ubuntu-latest
- steps:
- - uses: actions/checkout@v2
- - name: Prepare The Environment
- run: cp .env.example .env
- - name: Create Database
- run: |
- sudo systemctl start mysql
- mysql --user="root" --password="root" -e "CREATE DATABASE 'my-database' character set UTF8mb4 collate utf8mb4_bin;"
- - name: Install Composer Dependencies
- run: composer install --no-progress --prefer-dist --optimize-autoloader
- - name: Generate Application Key
- run: php artisan key:generate
- - name: Upgrade Chrome Driver
- run: php artisan dusk:chrome-driver `/opt/google/chrome/chrome --version | cut -d " " -f3 | cut -d "." -f1`
- - name: Start Chrome Driver
- run: ./vendor/laravel/dusk/bin/chromedriver-linux &
- - name: Run Laravel Server
- run: php artisan serve --no-reload &
- - name: Run Dusk Tests
- env:
- APP_URL: "http://127.0.0.1:8000"
- run: php artisan dusk
- - name: Upload Screenshots
- if: failure()
- uses: actions/upload-artifact@v2
- with:
- name: screenshots
- path: tests/Browser/screenshots
- - name: Upload Console Logs
- if: failure()
- uses: actions/upload-artifact@v2
- with:
- name: console
- path: tests/Browser/console
+```yaml
+name: CI
+on: [push]
+jobs:
+
+ dusk-php:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v2
+ - name: Prepare The Environment
+ run: cp .env.example .env
+ - name: Create Database
+ run: |
+ sudo systemctl start mysql
+ mysql --user="root" --password="root" -e "CREATE DATABASE 'my-database' character set UTF8mb4 collate utf8mb4_bin;"
+ - name: Install Composer Dependencies
+ run: composer install --no-progress --prefer-dist --optimize-autoloader
+ - name: Generate Application Key
+ run: php artisan key:generate
+ - name: Upgrade Chrome Driver
+ run: php artisan dusk:chrome-driver `/opt/google/chrome/chrome --version | cut -d " " -f3 | cut -d "." -f1`
+ - name: Start Chrome Driver
+ run: ./vendor/laravel/dusk/bin/chromedriver-linux &
+ - name: Run Laravel Server
+ run: php artisan serve --no-reload &
+ - name: Run Dusk Tests
+ env:
+ APP_URL: "http://127.0.0.1:8000"
+ run: php artisan dusk
+ - name: Upload Screenshots
+ if: failure()
+ uses: actions/upload-artifact@v2
+ with:
+ name: screenshots
+ path: tests/Browser/screenshots
+ - name: Upload Console Logs
+ if: failure()
+ uses: actions/upload-artifact@v2
+ with:
+ name: console
+ path: tests/Browser/console
+```
diff --git a/docs/eloquent-mutators.md b/docs/eloquent-mutators.md
index 6e3b8c5..cf0721f 100644
--- a/docs/eloquent-mutators.md
+++ b/docs/eloquent-mutators.md
@@ -28,30 +28,34 @@
### Определение аксессора
-Аксессор преобразует значение атрибута экземпляра Eloquent при обращении к нему. Чтобы определить метод доступа, создайте метод `get{Attribute}Attribute` в вашей модели, где `{Attribute}` – это имя столбца, к которому вы хотите получить доступ, в «верхнем» регистре.
+Аксессор преобразует значение атрибута экземпляра Eloquent при обращении к нему. Чтобы определить метод доступа, создайте в модели защищенный метод для представления доступного атрибута. Это имя метода должно соответствовать атрибуту модели / столбца базы данных в «верблюжьем регистре» , когда это применимо.
-В этом примере мы определим аксессор для атрибута `first_name`. Аксессор будет автоматически вызван Eloquent при попытке получить значение атрибута `first_name`:
+В этом примере мы определим аксессор для атрибута `first_name`. Аксессор будет автоматически вызван Eloquent при попытке получить значение атрибута `first_name`. Все методы атрибутов (аксессоры / мутаторы) должны возвращать тип `Illuminate\Database\Eloquent\Casts\Attribute`:
ucfirst($value),
+ );
}
}
+Все методы доступа возвращают экземпляр `Attribute`, который определяет, как будет осуществляться доступ к атрибуту и, при необходимости, изменяться. В этом примере мы только определяем, как будет осуществляться доступ к атрибуту. Для этого мы передаем аргумент `get` конструктору класса `Attribute`.
+
Как видите, исходное значение столбца передается аксессору, что позволяет вам манипулировать и возвращать значение. Чтобы получить доступ к значению аксессора, вы можете просто получить доступ к атрибуту `first_name` экземпляра модели:
use App\Models\User;
@@ -60,48 +64,93 @@
$firstName = $user->first_name;
-Вы не ограничены взаимодействием с одним атрибутом в вашем аксессоре. Вы также можете использовать аксессор для возврата новых вычисленных значений из существующих атрибутов:
+> {tip} Если вы хотите, чтобы эти вычисленные значения были добавлены к представлениям массива / JSON вашей модели, [вам нужно будет добавить их](eloquent-serialization.md#appending-values-to-json).
- /**
- * Получить полное имя пользователя.
- *
- * @return string
- */
- public function getFullNameAttribute()
- {
- return "{$this->first_name} {$this->last_name}";
- }
+
+#### Построение объекта-значения из нескольких атрибутов
+
+Иногда аксессору может потребоваться преобразовать несколько атрибутов модели в один «объект-значение». Для этого ваше замыкание `get` может принимать второй аргумент `$attributes`, который будет автоматически передан замыканию и будет содержать массив всех текущих атрибутов модели:
+
+```php
+use App\Support\Address;
+use Illuminate\Database\Eloquent\Casts\Attribute;
+
+/**
+ * Взаимодействие с адресом пользователя.
+ *
+ * @return \Illuminate\Database\Eloquent\Casts\Attribute
+ */
+public function address(): Attribute
+{
+ return new Attribute(
+ get: fn ($value, $attributes) => new Address(
+ $attributes['address_line_one'],
+ $attributes['address_line_two'],
+ ),
+ );
+}
+```
+
+При возврате объектов-значений из аксессоров любые изменения, внесенные в объект-значение, будут автоматически синхронизированы с моделью перед ее сохранением. Это возможно, потому что Eloquent сохраняет экземпляры, возвращаемые аксессорами, поэтому он может возвращать один и тот же экземпляр каждый раз, когда вызывается аксессор:
-> {tip} Если вы хотите, чтобы эти вычисленные значения были добавлены к представлениям массива / JSON вашей модели, [вам нужно будет добавить их](eloquent-serialization.md#appending-values-to-json).
+ use App\Models\User;
+
+ $user = User::find(1);
+
+ $user->address->lineOne = 'Updated Address Line 1 Value';
+ $user->address->lineTwo = 'Updated Address Line 2 Value';
+
+ $user->save();
+
+Если вы хотите избежать кэширования объектов в атрибутах, то вы можете вызвать метод `withoutObjectCaching` при определении атрибута:
+
+```php
+/**
+ * Взаимодействие с адресом пользователя.
+ *
+ * @return \Illuminate\Database\Eloquent\Casts\Attribute
+ */
+public function address(): Attribute
+{
+ return (new Attribute(
+ get: fn ($value, $attributes) => new Address(
+ $attributes['address_line_one'],
+ $attributes['address_line_two'],
+ ),
+ ))->withoutObjectCaching();
+}
+```
### Определение мутатора
-Мутатор преобразует значение атрибута в момент их присвоения экземпляру Eloquent. Чтобы определить мутатор, определите метод `set{Attribute}Attribute` в вашей модели, где `{Attribute}` – это имя столбца, к которому вы хотите получить доступ, в «верхнем» регистре.
-
-Определим мутатор для атрибута `first_name`. Этот мутатор будет автоматически вызываться, когда мы попытаемся присвоить значение атрибута `first_name` модели:
+Мутатор преобразует значение атрибута в момент их присвоения экземпляру Eloquent. Чтобы определить мутатор, вы можете указать аргумент `set` при определении вашего атрибута. Определим мутатор для атрибута `first_name`. Этот мутатор будет автоматически вызываться, когда мы попытаемся присвоить значение атрибута `first_name` модели:
attributes['first_name'] = strtolower($value);
+ return new Attribute(
+ get: fn ($value) => ucfirst($value),
+ set: fn ($value) => strtolower($value),
+ );
}
}
-Мутатор получит значение, заданное для атрибута, что позволит вам манипулировать этим значением и устанавливать желаемое значение во внутреннем свойстве `$attributes` модели Eloquent. Чтобы использовать наш мутатор, нам нужно только установить атрибут `first_name` для модели Eloquent:
+Замыкание мутатора получит значение, которое устанавливается для атрибута, позволяя вам манипулировать значением и возвращать измененное значение. Чтобы использовать наш мутатор, нам нужно только установить атрибут `first_name` для модели Eloquent:
use App\Models\User;
@@ -109,7 +158,36 @@
$user->first_name = 'Sally';
-В этом примере метод `setFirstNameAttribute` будет вызываться со значением `Sally`. Затем, мутатор применит к имени функцию `strtolower` и установит полученное значение во внутреннем массиве `$attributes`.
+В этом примере замыкание `set` будет вызвано со значением `Sally`. Затем мутатор применит к имени функцию `strtolower` и установит полученное значение во внутреннем массиве `$attributes` модели.
+
+
+#### Преобразование нескольких атрибутов
+
+Иногда мутатору может потребоваться установить несколько атрибутов модели. Для этого вы можете вернуть массив из замыкания `set`. Каждый ключ в массиве должен соответствовать атрибуту / столбцу базы данных, связанному с моделью:
+
+```php
+use App\Support\Address;
+use Illuminate\Database\Eloquent\Casts\Attribute;
+
+/**
+ * Взаимодействие с адресом пользователя.
+ *
+ * @return \Illuminate\Database\Eloquent\Casts\Attribute
+ */
+protected function address(): Attribute
+{
+ return new Attribute(
+ get: fn ($value, $attributes) => new Address(
+ $attributes['address_line_one'],
+ $attributes['address_line_two'],
+ ),
+ set: fn (Address $value) => [
+ 'address_line_one' => $value->lineOne,
+ 'address_line_two' => $value->lineTwo,
+ ],
+ );
+}
+```
## Приведение атрибутов к типам
diff --git a/docs/eloquent-resources.md b/docs/eloquent-resources.md
index de4dbb6..e9a5c57 100644
--- a/docs/eloquent-resources.md
+++ b/docs/eloquent-resources.md
@@ -24,7 +24,9 @@
Ресурсы расширяют класс `Illuminate\Http\Resources\Json\JsonResource`. Чтобы сгенерировать новый ресурс, используйте команду `make:resource` [Artisan](artisan.md). Эта команда поместит новый класс ресурса в каталог `app/Http/Resources` вашего приложения:
- php artisan make:resource UserResource
+```shell
+php artisan make:resource UserResource
+```
#### Генерация коллекций ресурса
@@ -33,9 +35,11 @@
Чтобы сгенерировать новую коллекцию ресурса, вы должны использовать флаг `--collection` при создании ресурса. Или включение слова `Collection` в имя ресурса укажет Laravel, что он должен создать коллекцию ресурса. Коллекции ресурса расширяют класс `Illuminate\Http\Resources\Json\ResourceCollection`:
- php artisan make:resource User --collection
+```shell
+php artisan make:resource User --collection
- php artisan make:resource UserCollection
+php artisan make:resource UserCollection
+```
## Обзор концепции
@@ -95,7 +99,9 @@
Обратите внимание, что это не позволит добавить пользовательские метаданные, которые могут потребоваться при возвращении с вашей коллекцией. Если вы хотите получить больший контроль над ответом коллекции ресурса, то вы можете создать выделенный ресурс для представления коллекции:
- php artisan make:resource UserCollection
+```shell
+php artisan make:resource UserCollection
+```
После создания класса коллекции ресурса, вы можете легко определить любые метаданные, которые должны быть включены в ответ:
@@ -308,20 +314,22 @@
По умолчанию, ваш самый верхний ресурс будет заключен в ключ `data`, когда ответ ресурса преобразуется в JSON. Так, например, типичный ответ коллекции ресурса выглядит следующим образом:
- {
- "data": [
- {
- "id": 1,
- "name": "Eladio Schroeder Sr.",
- "email": "therese28@example.com",
- },
- {
- "id": 2,
- "name": "Liliana Mayert",
- "email": "evandervort@example.com",
- }
- ]
- }
+```json
+{
+ "data": [
+ {
+ "id": 1,
+ "name": "Eladio Schroeder Sr.",
+ "email": "therese28@example.com",
+ },
+ {
+ "id": 2,
+ "name": "Liliana Mayert",
+ "email": "evandervort@example.com",
+ }
+ ]
+}
+```
Если вы хотите использовать собственный ключ вместо `data`, вы можете определить свойство `$wrap` в классе ресурса:
@@ -407,35 +415,37 @@
При возврате разбитых на страницы коллекций через ответ ресурса, Laravel обернет ваши данные ресурса в ключ `data`, даже если был вызван метод `withoutWrapping`. Это потому, что разбитые на страницы ответы всегда содержат ключи `meta` и `links` с информацией о состоянии постраничной разбивки:
- {
- "data": [
- {
- "id": 1,
- "name": "Eladio Schroeder Sr.",
- "email": "therese28@example.com",
- },
- {
- "id": 2,
- "name": "Liliana Mayert",
- "email": "evandervort@example.com",
- }
- ],
- "links":{
- "first": "http://example.com/pagination?page=1",
- "last": "http://example.com/pagination?page=1",
- "prev": null,
- "next": null
+```json
+{
+ "data": [
+ {
+ "id": 1,
+ "name": "Eladio Schroeder Sr.",
+ "email": "therese28@example.com",
},
- "meta":{
- "current_page": 1,
- "from": 1,
- "last_page": 1,
- "path": "http://example.com/pagination",
- "per_page": 15,
- "to": 10,
- "total": 10
+ {
+ "id": 2,
+ "name": "Liliana Mayert",
+ "email": "evandervort@example.com",
}
+ ],
+ "links":{
+ "first": "http://example.com/pagination?page=1",
+ "last": "http://example.com/pagination?page=1",
+ "prev": null,
+ "next": null
+ },
+ "meta":{
+ "current_page": 1,
+ "from": 1,
+ "last_page": 1,
+ "path": "http://example.com/pagination",
+ "per_page": 15,
+ "to": 10,
+ "total": 10
}
+}
+```
### Постраничная разбивка
@@ -451,35 +461,37 @@
Ответы с постраничной разбивкой всегда содержат ключи `meta` и `links` с информацией о состоянии пагинатора:
- {
- "data": [
- {
- "id": 1,
- "name": "Eladio Schroeder Sr.",
- "email": "therese28@example.com",
- },
- {
- "id": 2,
- "name": "Liliana Mayert",
- "email": "evandervort@example.com",
- }
- ],
- "links":{
- "first": "http://example.com/pagination?page=1",
- "last": "http://example.com/pagination?page=1",
- "prev": null,
- "next": null
+```json
+{
+ "data": [
+ {
+ "id": 1,
+ "name": "Eladio Schroeder Sr.",
+ "email": "therese28@example.com",
},
- "meta":{
- "current_page": 1,
- "from": 1,
- "last_page": 1,
- "path": "http://example.com/pagination",
- "per_page": 15,
- "to": 10,
- "total": 10
+ {
+ "id": 2,
+ "name": "Liliana Mayert",
+ "email": "evandervort@example.com",
}
+ ],
+ "links":{
+ "first": "http://example.com/pagination?page=1",
+ "last": "http://example.com/pagination?page=1",
+ "prev": null,
+ "next": null
+ },
+ "meta":{
+ "current_page": 1,
+ "from": 1,
+ "last_page": 1,
+ "path": "http://example.com/pagination",
+ "per_page": 15,
+ "to": 10,
+ "total": 10
}
+}
+```
### Условные атрибуты
diff --git a/docs/eloquent-serialization.md b/docs/eloquent-serialization.md
index 58b0350..937e4b1 100644
--- a/docs/eloquent-serialization.md
+++ b/docs/eloquent-serialization.md
@@ -130,6 +130,7 @@
namespace App\Models;
+ use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\Model;
class User extends Model
@@ -137,11 +138,13 @@
/**
* Определить, является ли пользователь администратором.
*
- * @return bool
+ * @return \Illuminate\Database\Eloquent\Casts\Attribute
*/
- public function getIsAdminAttribute()
+ protected function isAdmin(): Attribute
{
- return $this->attributes['admin'] === 'yes';
+ return new Attribute(
+ get: fn () => 'yes';
+ );
}
}
diff --git a/docs/eloquent.md b/docs/eloquent.md
index 100895e..2d61f1c 100644
--- a/docs/eloquent.md
+++ b/docs/eloquent.md
@@ -11,7 +11,7 @@
- [Получение моделей](#retrieving-models)
- [Коллекции](#collections)
- [Разбиение результатов](#chunking-results)
- - [Отложенная потоковая передача результатов](#streaming-results-lazily)
+ - [Разбиение результатов с отложенными коллекциями](#chunking-using-lazy-collections)
- [Курсоры](#cursors)
- [Расширенные подзапросы](#advanced-subqueries)
- [Извлечение отдельных моделей](#retrieving-single-models)
@@ -48,15 +48,19 @@ Laravel содержит библиотеку Eloquent ORM (объектно-р
Модели расширяют класс `Illuminate\Database\Eloquent\Model`. Чтобы сгенерировать новую модель Eloquent, используйте команду `make:model` [Artisan](artisan.md). Эта команда поместит новый класс модели в каталог `app/Models` вашего приложения:
- php artisan make:model Flight
+```shell
+php artisan make:model Flight
+```
При создании модели вы можете сгенерировать [миграцию БД](migrations.md), используя параметр `--migration` или `-m`:
- php artisan make:model Flight --migration
+```shell
+php artisan make:model Flight --migration
+```
При создании модели вы можете попутно генерировать различные типы классов, например фабрики, наполнители, политики авторизации, контроллеры и запросы форм. Кроме того, эти параметры можно комбинировать для создания сразу нескольких классов:
-```bash
+```shell
# Создать модель и класс FlightFactory ...
php artisan make:model Flight --factory
php artisan make:model Flight -f
@@ -367,8 +371,8 @@ Flight::where('departed', true)
}, $column = 'id');
```
-
-### Отложенная потоковая передача результатов
+
+### Разбиение результатов с отложенными коллекциями
Метод `lazy` работает аналогично [методу `chunk`](#chunking-results) в том смысле, что он выполняет запрос по частям. Однако вместо передачи каждого фрагмента непосредственно в замыкание, метод `lazy()` возвращает экземпляр [`LazyCollection`](collections.md#lazy-collections) одноуровневых моделей Eloquent, что позволяет вам взаимодействовать с результатами как с единым потоком:
@@ -954,7 +958,9 @@ Eloquent содержит методы `isDirty`, `isClean` и `wasChanged` дл
Вы можете сымитировать свой запрос очистки, выполнив команду `model:prune` с флагом `--pretend`. При имитации команда `model:prune` просто сообщит, сколько записей будет удалено, если команда действительно будет запущена:
- php artisan model:prune --pretend
+```shell
+php artisan model:prune --pretend
+```
> {note} Программно удаляемые модели будут удалены (`forceDelete`) без возможности восстановления, если они соответствуют запросу сокращения.
@@ -1325,7 +1331,9 @@ Eloquent также позволяет вам определять глобал
Если прослушивается множество событий в модели, то можно использовать наблюдателей, чтобы сгруппировать пользовательских слушателей в одном классе. Классы наблюдателей имеют имена методов, созвучные событиям Eloquent, которые необходимо прослушивать. Каждый из этих методов получает затронутую модель в качестве единственного аргумента. Чтобы сгенерировать нового наблюдателя, используйте команду `make:observer` [Artisan](artisan.md):
- php artisan make:observer UserObserver --model=User
+```shell
+php artisan make:observer UserObserver --model=User
+```
Эта команда поместит новый класс наблюдателя в каталог `app/Observers` вашего приложения. Если этот каталог не существует в вашем приложении, то Laravel предварительно создаст его. Созданный наблюдатель может выглядеть следующим образом:
@@ -1397,6 +1405,20 @@ Eloquent также позволяет вам определять глобал
User::observe(UserObserver::class);
}
+Кроме того, вы можете перечислить своих наблюдателей в свойстве `$observers` класса `App\Providers\EventServiceProvider` вашего приложения:
+
+ use App\Models\User;
+ use App\Observers\UserObserver;
+
+ /**
+ * Наблюдатели моделей вашего приложения.
+ *
+ * @var array
+ */
+ protected $observers = [
+ User::class => [UserObserver::class],
+ ];
+
> {tip} Наблюдатель может прослушивать дополнительные события, такие как `saving` и `retrieved`. Эти события описаны в документации [событий](#events).
diff --git a/docs/envoy.md b/docs/envoy.md
index f7091df..f826728 100644
--- a/docs/envoy.md
+++ b/docs/envoy.md
@@ -27,11 +27,15 @@
Для начала установите Envoy с помощью менеджера пакетов Composer в свой проект:
- composer require laravel/envoy --dev
+```shell
+composer require laravel/envoy --dev
+```
После установки исполняемый файл Envoy будет доступен в каталоге вашего приложения `vendor/bin`:
- php vendor/bin/envoy
+```shell
+php vendor/bin/envoy
+```
## Написание задач
@@ -43,7 +47,7 @@
Все ваши задачи Envoy должны быть определены в файле `Envoy.blade.php` в корне вашего приложения. Например:
-```bash
+```blade
@servers(['web' => ['user@192.168.1.1'], 'workers' => ['user@192.168.1.2']])
@task('restart-queues', ['on' => 'workers'])
@@ -59,7 +63,7 @@
Вы можете принудительно запустить сценарий на вашем локальном компьютере, указав IP-адрес сервера как `127.0.0.1`:
-```bash
+```blade
@servers(['localhost' => '127.0.0.1'])
```
@@ -68,7 +72,7 @@
Используя директиву `@import`, вы можете импортировать другие файлы Envoy для добавления дополнительных историй и задач. После того, как файлы были импортированы, вы можете выполнять задачи, содержащиеся в них, как если бы они были определены в вашем собственном файле Envoy:
-```bash
+```blade
@import('vendor/package/Envoy.blade.php')
```
@@ -77,7 +81,7 @@
Envoy позволяет легко запускать задачу на нескольких серверах. Во-первых, добавьте необходимые серверы в объявление `@servers`. Каждому серверу должно быть присвоено уникальное имя. После определения дополнительных серверов, вы можете использовать каждый из них в массиве задачи `on`:
-```bash
+```blade
@servers(['web-1' => '192.168.1.1', 'web-2' => '192.168.1.2'])
@task('deploy', ['on' => ['web-1', 'web-2']])
@@ -92,7 +96,7 @@ Envoy позволяет легко запускать задачу на нес
По умолчанию задачи будут выполняться на каждом сервере поочередно. Другими словами, задача должна завершится на первом сервере, прежде чем будет выполнена на втором. Если вы хотите запустить задачу на нескольких серверах параллельно, то добавьте параметр `parallel` в определение задачи:
-```bash
+```blade
@servers(['web-1' => '192.168.1.1', 'web-2' => '192.168.1.2'])
@task('deploy', ['on' => ['web-1', 'web-2'], 'parallel' => true])
@@ -115,7 +119,7 @@ Envoy позволяет легко запускать задачу на нес
Если вам нужны другие файлы PHP перед выполнением вашей задачи, то вы можете использовать директиву `@include` в верхней части вашего файла `Envoy.blade.php`:
-```bash
+```blade
@include('vendor/autoload.php')
@task('restart-queues')
@@ -128,11 +132,13 @@ Envoy позволяет легко запускать задачу на нес
При необходимости вы можете передать аргументы задачам Envoy, указав их в командной строке при вызове Envoy:
- php vendor/bin/envoy run deploy --branch=master
+```shell
+php vendor/bin/envoy run deploy --branch=master
+```
Вы можете получить доступ к параметрам ваших задач, используя [синтаксис «вывода» Blade](blade.md#displaying-data). Вы также можете определять операторы `if` и циклы Blade в своих задачах. Например, давайте проверим наличие переменной `$branch` перед выполнением команды `git pull`:
-```bash
+```blade
@servers(['web' => ['user@192.168.1.1']])
@task('deploy', ['on' => 'web'])
@@ -151,7 +157,7 @@ Envoy позволяет легко запускать задачу на нес
Истории группируют набор задач под одним удобным названием. Например, вы можете сгруппировать запуск задач `update-code` и `install-dependencies`, перечислив их имена в определении истории `deploy`:
-```bash
+```blade
@servers(['web' => ['user@192.168.1.1']])
@story('deploy')
@@ -172,7 +178,9 @@ Envoy позволяет легко запускать задачу на нес
После написания история, вы можете запустить ее так же, как вы запускаете отдельную задачу:
- php vendor/bin/envoy run deploy
+```shell
+php vendor/bin/envoy run deploy
+```
### Хуки
@@ -186,7 +194,7 @@ Envoy позволяет легко запускать задачу на нес
Перед выполнением каждой задачи будут выполняться все хуки `@before`, зарегистрированные в вашем сценарии Envoy. Хуки `@before` получат имя задачи, которая будет выполняться:
-```php
+```blade
@before
if ($task === 'deploy') {
// ...
@@ -199,7 +207,7 @@ Envoy позволяет легко запускать задачу на нес
После выполнения каждой задачи будут выполняться все хуки `@after`, зарегистрированные в вашем сценарии Envoy. Хуки `@after` получат имя запущенной задачи:
-```php
+```blade
@after
if ($task === 'deploy') {
// ...
@@ -212,7 +220,7 @@ Envoy позволяет легко запускать задачу на нес
После каждого сбоя задачи (выход с кодом состояния больше `0`) будут выполняться все хуки `@error`, зарегистрированные в вашем сценарии Envoy. Хуки `@error` получат имя запущенной задачи:
-```php
+```blade
@error
if ($task === 'deploy') {
// ...
@@ -225,7 +233,7 @@ Envoy позволяет легко запускать задачу на нес
Если все задачи выполнены без ошибок, то все хуки `@success`, зарегистрированные в вашем сценарии Envoy, будут выполнены:
-```bash
+```blade
@success
// ...
@endsuccess
@@ -236,7 +244,7 @@ Envoy позволяет легко запускать задачу на нес
После выполнения всех задач (независимо от статуса выхода) будут выполнены все хуки `@finished`. Хуки `@finished` получат код состояния завершенной задачи, который может быть `null` или `integer`, большим или равным `0`:
-```bash
+```blade
@finished
if ($exitCode > 0) {
// В одной из задач произошли ошибки ...
@@ -249,14 +257,16 @@ Envoy позволяет легко запускать задачу на нес
Чтобы запустить задачу или историю, которая определена в файле `Envoy.blade.php` вашего приложения, выполните команду `run` Envoy, передав имя задачи или истории, которую вы хотите выполнить. Envoy выполнит задачу и отобразит вывод с ваших удаленных серверов во время выполнения задачи:
- php vendor/bin/envoy run deploy
+```shell
+php vendor/bin/envoy run deploy
+```
### Подтверждение выполнения задачи
Если вы хотите получить запрос на подтверждение перед запуском конкретной задачи на своих серверах, вам следует добавить параметр `confirm` в директиву определения задачи. Этот параметр особенно полезен для деструктивных операций:
-```bash
+```blade
@task('deploy', ['on' => 'web', 'confirm' => true])
cd /home/user/example.com
git pull origin {{ $branch }}
@@ -274,39 +284,49 @@ Envoy поддерживает отправку уведомлений в [Slack
Вы должны передать полный WebHook URL в качестве первого аргумента директивы `@slack`. Вторым аргументом, передаваемым директиве `@slack`, должно быть имя канала `#channel` или имя пользователя `@user`:
- @finished
- @slack('webhook-url', '#bots')
- @endfinished
+```blade
+@finished
+ @slack('webhook-url', '#bots')
+@endfinished
+```
По умолчанию уведомления Envoy отправляют сообщение в канал уведомлений с описанием выполненной задачи. Однако вы можете назначить свое сообщение, передав третий аргумент директиве `@slack`:
- @finished
- @slack('webhook-url', '#bots', 'Hello, Slack.')
- @endfinished
+```blade
+@finished
+ @slack('webhook-url', '#bots', 'Hello, Slack.')
+@endfinished
+```
### Discord
Envoy также поддерживает отправку уведомлений в [Discord](https://discord.com) после выполнения каждой задачи. Директива `@discord` принимает WebHook URL и сообщение. Вы можете получить WebHook URL, создав «Webhook» в настройках сервера и выбрав канал, на который WebHook должен публиковать сообщения. Вы должны передать полный WebHook URL в директиву `@discord`:
- @finished
- @discord('discord-webhook-url')
- @endfinished
+```blade
+@finished
+ @discord('discord-webhook-url')
+@endfinished
+```
### Telegram
Envoy также поддерживает отправку уведомлений в [Telegram](https://telegram.org) после выполнения каждой задачи. Директива `@telegram` принимает идентификатор бота Telegram и идентификатор чата. Вы можете получить свой идентификатор бота, создав нового бота в [BotFather](https://t.me/botfather). Вы можете получить действительный идентификатор чата, используя [`@username_to_id_bot`](https://t.me/username_to_id_bot). Вы должны передать полный идентификатор бота и идентификатор чата в директиву `@telegram`:
- @finished
- @telegram('bot-id','chat-id')
- @endfinished
+```blade
+@finished
+ @telegram('bot-id','chat-id')
+@endfinished
+```
### Microsoft Teams
Envoy также поддерживает отправку уведомлений в [Microsoft Teams](https://www.microsoft.com/en-us/microsoft-teams) после выполнения каждой задачи. Директива `@microsoftTeams` принимает веб-хук Teams (обязательно), сообщение, цвет темы (по типу сообщения: успешно, информация, предупреждение, ошибка) и массив параметров. Вы можете получить веб-хук Teams, создав новый [входящий веб-хук](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook). В Teams API есть множество других атрибутов для настройки сообщения, например заголовок, сводка и разделы. Дополнительную информацию можно найти в [документации Microsoft Teams](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using?tabs=cURL#example-of-connector-message). Вы должны передать полный URL-адрес веб-хука в директиву `@microsoftTeams`:
- @finished
- @microsoftTeams('webhook-url')
- @endfinished
+```blade
+@finished
+ @microsoftTeams('webhook-url')
+@endfinished
+```
diff --git a/docs/errors.md b/docs/errors.md
index d09fdd0..0d0d32c 100644
--- a/docs/errors.md
+++ b/docs/errors.md
@@ -258,4 +258,11 @@ Laravel позволяет легко отображать пользовате
Вы можете опубликовать стандартные шаблоны страниц ошибок Laravel с помощью команды `vendor:publish` Artisan. После публикации шаблонов вы можете настроить их по своему вкусу:
- php artisan vendor:publish --tag=laravel-errors
+```shell
+php artisan vendor:publish --tag=laravel-errors
+```
+
+
+#### Резервные страницы ошибок HTTP
+
+Вы также можете определить «резервную» страницу ошибок для каждой серии кодов состояния HTTP. Эта страница будет отображаться, если нет соответствующей страницы для текущего кода состояния HTTP. Для этого определите шаблон `4xx.blade.php` и шаблон `5xx.blade.php` в каталоге `resources/views/errors` вашего приложения.
diff --git a/docs/events.md b/docs/events.md
index 926c241..03c6687 100644
--- a/docs/events.md
+++ b/docs/events.md
@@ -49,13 +49,17 @@
Конечно, вручную создавать файлы для каждого события и слушателя сложно. Вместо этого добавьте необходимые события и их слушатели в поставщике `App\Providers\EventServiceProvider`, затем, используйте команду `event:generate` [Artisan](artisan.md). Эта команда сгенерирует любые события или слушатели, перечисленные в поставщике `EventServiceProvider`, но которые еще не существуют:
- php artisan event:generate
+```shell
+php artisan event:generate
+```
В качестве альтернативы вы можете использовать команды `make:event` и `make:listener` Artisan для генерации отдельных событий и слушателей:
- php artisan make:event PodcastProcessed
+```shell
+php artisan make:event PodcastProcessed
- php artisan make:listener SendPodcastNotification --event=PodcastProcessed
+php artisan make:listener SendPodcastNotification --event=PodcastProcessed
+```
### Явная регистрация событий
@@ -137,7 +141,7 @@
Вместо того, чтобы вручную регистрировать события и слушателей в массиве `$listen` поставщика `EventServiceProvider`, вы можете включить автоматическое обнаружение событий. Когда обнаружение событий включено, Laravel автоматически найдет и зарегистрирует ваши события и слушатели, сканируя каталог `Listeners` вашего приложения. Кроме того, любые явно определенные события, перечисленные в `EventServiceProvider`, по-прежнему будут зарегистрированы.
-Laravel находит слушателей событий, сканируя классы слушателей с помощью рефлексии PHP. Когда Laravel находит какой-либо метод класса слушателя, который начинается с `handle`, Laravel зарегистрирует эти методы как слушатели событий для события, тип которого указан в сигнатуре метода:
+Laravel находит слушателей событий, сканируя классы слушателей с помощью рефлексии PHP. Когда Laravel находит какой-либо метод класса слушателя, который начинается с `handle` или `__invoke`, Laravel зарегистрирует эти методы как слушатели событий для события, тип которого указан в сигнатуре метода:
use App\Events\PodcastProcessed;
diff --git a/docs/filesystem.md b/docs/filesystem.md
index 5a9aa56..3d8977b 100644
--- a/docs/filesystem.md
+++ b/docs/filesystem.md
@@ -6,7 +6,6 @@
- [Публичный диск](#the-public-disk)
- [Предварительная подготовка драйверов](#driver-prerequisites)
- [Файловые системы, совместимые с Amazon S3](#amazon-s3-compatible-filesystems)
- - [Кеширование](#caching)
- [Доступ к экземплярам дисков](#obtaining-disk-instances)
- [Диски по запросу](#on-demand-disks)
- [Получение файлов](#retrieving-files)
@@ -52,7 +51,9 @@ Laravel обеспечивает мощную абстракцию файлов
Чтобы создать символическую ссылку, вы можете использовать команду `storage:link` Artisan:
- php artisan storage:link
+```shell
+php artisan storage:link
+```
После того, как была создана символическая ссылка, вы можете создавать URL-адреса для сохраненных файлов, используя помощник `asset`:
@@ -73,12 +74,8 @@ Laravel обеспечивает мощную абстракцию файлов
Перед использованием драйверов S3 или SFTP вам необходимо установить соответствующий пакет с помощью менеджера пакетов Composer:
-- Amazon S3: `composer require --with-all-dependencies league/flysystem-aws-s3-v3 "^1.0"`
-- SFTP: `composer require league/flysystem-sftp "~1.0"`
-
-Кроме того, вы можете установить декоратор CachedAdapter для повышения производительности:
-
-- CachedAdapter: `composer require league/flysystem-cached-adapter "~1.0"`
+- Amazon S3: `composer require --with-all-dependencies league/flysystem-aws-s3-v3 "^3.0"`
+- SFTP: `composer require league/flysystem-sftp-v3 "^3.0"`
#### Конфигурирование драйвера S3
@@ -136,23 +133,6 @@ Laravel обеспечивает мощную абстракцию файлов
'endpoint' => env('AWS_ENDPOINT', 'https://minio:9000'),
-
-### Кеширование
-
-Чтобы включить кеширование для конкретного диска, вы можете добавить директиву `cache` в параметры конфигурации этого диска. Параметр `cache` должен быть массивом параметров кеширования, содержащим имя `disk`, время `expire` в секундах и `prefix` кеша:
-
- 's3' => [
- 'driver' => 's3',
-
- // Other Disk Options...
-
- 'cache' => [
- 'store' => 'memcached',
- 'expire' => 600,
- 'prefix' => 'cache-prefix',
- ],
- ],
-
## Доступ к экземплярам дисков
@@ -550,7 +530,9 @@ $disk->put('image.jpg', $content);
Чтобы определить собственную файловую систему, вам понадобится адаптер Flysystem. Давайте добавим в наш проект адаптер Dropbox, поддерживаемый сообществом:
- composer require spatie/flysystem-dropbox
+```shell
+composer require spatie/flysystem-dropbox
+```
Затем вы можете зарегистрировать драйвер в методе `boot` одного из [поставщиков служб](providers.md) вашего приложения. Для этого вы должны использовать метод `extend` фасада `Storage`:
@@ -558,6 +540,7 @@ $disk->put('image.jpg', $content);
namespace App\Providers;
+ use Illuminate\Filesystem\FilesystemAdapter;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\ServiceProvider;
use League\Flysystem\Filesystem;
@@ -584,15 +567,19 @@ $disk->put('image.jpg', $content);
public function boot()
{
Storage::extend('dropbox', function ($app, $config) {
- $client = new DropboxClient(
+ $adapter = new DropboxAdapter(new DropboxClient(
$config['authorization_token']
- );
+ ););
- return new Filesystem(new DropboxAdapter($client));
+ return new FilesystemAdapter(
+ new Filesystem($adapter, $config),
+ $adapter,
+ $config
+ );
});
}
}
-Первый аргумент метода `extend` – это имя драйвера, а второй – замыкание, которое получает переменные `$app` и `$config`. Замыкание должно возвращать экземпляр `League\Flysystem\Filesystem`. Переменная `$config` содержит значения, определенные в `config/filesystems.php` для указанного диска.
+Первый аргумент метода `extend` – это имя драйвера, а второй – замыкание, которое получает переменные `$app` и `$config`. Замыкание должно возвращать экземпляр `Illuminate\Filesystem\FilesystemAdapter`. Переменная `$config` содержит значения, определенные в `config/filesystems.php` для указанного диска.
После того, как вы создали и зарегистрировали расширение поставщика службы, вы можете использовать драйвер `dropbox` в вашем файле конфигурации `config/filesystems.php`.
diff --git a/docs/fortify.md b/docs/fortify.md
index 35a6552..6dbb738 100644
--- a/docs/fortify.md
+++ b/docs/fortify.md
@@ -70,13 +70,13 @@ Laravel Sanctum занимается только управлением ток
Для начала установите Fortify с помощью менеджера пакетов Composer в свой проект:
-```nothing
+```shell
composer require laravel/fortify
```
Затем, опубликуйте ресурсы Fortify с помощью команды `vendor:publish`:
-```bash
+```shell
php artisan vendor:publish --provider="Laravel\Fortify\FortifyServiceProvider"
```
@@ -84,7 +84,7 @@ php artisan vendor:publish --provider="Laravel\Fortify\FortifyServiceProvider"
Затем, вы должны применить миграции вашей базу данных:
-```bash
+```shell
php artisan migrate
```
@@ -459,7 +459,7 @@ Fortify позаботится об определении маршрута `/re
Если запрос на сброс пароля был успешным, то Fortify перенаправит пользователя обратно на маршрут `/login`, чтобы пользователь мог войти со своим новым паролем. Кроме того, будет установлена переменная сессии `status`, чтобы вы могли отобразить успешный статус сброса пароля на экране входа в систему:
-```html
+```blade
@if (session('status'))
{{ session('status') }}
@@ -514,7 +514,7 @@ Fortify позаботится об определении маршрута, к
Если запрос на повторную отправку электронного письма со ссылкой для подтверждения был успешным, Fortify перенаправит пользователя обратно на конечную точку `/email/verify` с переменной сессии `status`, что позволит вам отобразить информационное сообщение для пользователя, информирующее его о том, что операция была выполнена. успешно. Если запрос был запросом XHR, будет возвращен `202` HTTP-ответ.
-```html
+```blade
@if (session('status') == 'verification-link-sent')
Вам отправлена новая ссылка для подтверждения адреса электронной почты!
diff --git a/docs/hashing.md b/docs/hashing.md
index 13790b3..0fc3c8d 100644
--- a/docs/hashing.md
+++ b/docs/hashing.md
@@ -19,8 +19,6 @@ Bcrypt – отличный выбор для хеширования парол
Драйвер хеширования по умолчанию для вашего приложения настраивается в файле конфигурации `config/hashing.php`. В настоящее время существует несколько поддерживаемых драйверов: [Bcrypt](https://en.wikipedia.org/wiki/Bcrypt) и [Argon2](https://en.wikipedia.org/wiki/Argon2) (вариации Argon2i и Argon2id).
-> {note} Для драйвера Argon2i требуется PHP 7.2.0 или выше, а для драйвера Argon2id требуется PHP 7.3.0 или выше.
-
## Основы использования
diff --git a/docs/helpers.md b/docs/helpers.md
index 6d6951d..ee3f661 100644
--- a/docs/helpers.md
+++ b/docs/helpers.md
@@ -133,6 +133,7 @@ Laravel содержит множество глобальных «вспомо
- [Str::substr](#method-str-substr)
- [Str::substrCount](#method-str-substrcount)
- [Str::substrReplace](#method-str-substrreplace)
+- [Str::swap](#method-str-swap)
- [Str::title](#method-title-case)
- [Str::toHtmlString](#method-str-to-html-string)
- [Str::ucfirst](#method-str-ucfirst)
@@ -140,6 +141,7 @@ Laravel содержит множество глобальных «вспомо
- [Str::uuid](#method-str-uuid)
- [Str::wordCount](#method-str-word-count)
- [Str::words](#method-str-words)
+- [str](#method-str)
- [trans](#method-trans)
- [trans_choice](#method-trans-choice)
@@ -203,6 +205,7 @@ Laravel содержит множество глобальных «вспомо
- [studly](#method-fluent-str-studly)
- [substr](#method-fluent-str-substr)
- [substrReplace](#method-fluent-str-substrreplace)
+- [swap](#method-fluent-str-swap)
- [tap](#method-fluent-str-tap)
- [test](#method-fluent-str-test)
- [title](#method-fluent-str-title)
@@ -236,6 +239,7 @@ Laravel содержит множество глобальных «вспомо
- [route](#method-route)
- [secure_asset](#method-secure-asset)
- [secure_url](#method-secure-url)
+- [to_route](#method-to-route)
- [url](#method-url)
@@ -1724,6 +1728,20 @@ Laravel содержит множество глобальных «вспомо
$result = Str::substrReplace('1300', ':', 2, 0);
// 13:00
+
+#### `Str::swap()`
+
+Метод `Str::swap` заменяет несколько значений в переданной строке, используя функцию `strtr` PHP:
+
+ use Illuminate\Support\Str;
+
+ $string = Str::swap([
+ 'Tacos' => 'Burritos',
+ 'great' => 'fantastic',
+ ], 'Tacos are great!');
+
+ // Burritos are fantastic!
+
#### `Str::title()`
@@ -1797,6 +1815,21 @@ Str::wordCount('Hello, world!'); // 2
// Perfectly balanced, as >>>
+
+#### `str()`
+
+Функция `str` возвращает новый экземпляр `Illuminate\Support\Stringable` переданной строки. Эта функция эквивалентна методу `Str::of`:
+
+ $string = str('Taylor')->append(' Otwell');
+
+ // 'Taylor Otwell'
+
+Если для функции `str` не указан аргумент, то функция возвращает экземпляр `Illuminate\Support\Str`:
+
+ $snake = str()->snake('FooBar');
+
+ // 'foo_bar'
+
#### `trans()`
@@ -2570,6 +2603,21 @@ If no matches are found, an empty collection will be returned.
// The Laravel Framework
+
+#### `swap`
+
+Метод `swap` заменяет несколько значений в переданной строке, используя функцию `strtr` PHP:
+
+ use Illuminate\Support\Str;
+
+ $string = Str::of('Tacos are great!')
+ ->swap([
+ 'Tacos' => 'Burritos',
+ 'great' => 'fantastic',
+ ]);
+
+ // Burritos are fantastic!
+
#### `tap`
@@ -2903,6 +2951,17 @@ Str::of('Hello, world!')->wordCount(); // 2
$url = secure_url('user/profile', [1]);
+
+#### `to_route()`
+
+Функция `to_route` генерирует [HTTP-ответ перенаправления](responses.md#redirects) на [именованный маршрут](routing.md#named-routes):
+
+ return to_route('users.show', ['user' => 1]);
+
+При необходимости вы можете передать код состояния HTTP, который должен быть назначен перенаправлению, и любые дополнительные заголовки ответа в качестве третьего и четвертого аргументов метода `to_route`, соответственно:
+
+ return to_route('users.show', ['user' => 1], 302, ['X-Framework' => 'Laravel']);
+
#### `url()`
@@ -3296,7 +3355,7 @@ Str::of('Hello, world!')->wordCount(); // 2
Функция `retry` пытается выполнить переданное замыкание, пока не будет достигнут указанный лимит попыток. Если замыкание не выбросит исключение, то будет возвращено его значение. Если замыкание выбросит исключение, то замыкание будет автоматически повторено. Если максимальное количество попыток превышено, будет выброшено исключение:
return retry(5, function () {
- // Attempt 5 times while resting 100ms in between attempts...
+ // Попытаться выполнить 5 раз с перерывом 100 мс между попытками ...
}, 100);
Если вы хотите указать количество миллисекунд между попытками, то вы можете передать замыкание в качестве третьего аргумента функции `retry`:
@@ -3307,7 +3366,12 @@ Str::of('Hello, world!')->wordCount(); // 2
return $attempt * 100;
});
-
+Для удобства вы можете предоставить массив в качестве первого аргумента функции `retry`. Этот массив будет использоваться для определения количества миллисекунд ожидания между последующими попытками:
+
+ return retry([100, 200] function () {
+ // Ждем 100 мс при первой попытке, 200 мс при второй попытке ...
+ });
+
Для задания определенных условий выполнения попытки, вы можете передать замыкание в качестве четвертого аргумента функции `retry`:
return retry(5, function () {
diff --git a/docs/homestead.md b/docs/homestead.md
index 69b3df1..7913811 100644
--- a/docs/homestead.md
+++ b/docs/homestead.md
@@ -147,23 +147,27 @@ Homestead работает в любой системе: Windows, macOS или L
Вы можете установить Homestead, клонировав репозиторий Homestead на свой хост-компьютер. Рассмотрите возможность клонирования репозитория в папку `Homestead` вашего «домашнего» каталога, поскольку виртуальная машина Homestead будет служить хостом для всех ваших приложений Laravel. В этой документации мы будем называть этот каталог вашим «каталогом Homestead»:
-```bash
+```shell
git clone https://github.com/laravel/homestead.git ~/Homestead
```
После клонирования репозитория Laravel Homestead вы должны проверить ветку `release`. Эта ветка всегда содержит последний стабильный релиз Homestead:
- cd ~/Homestead
+```shell
+cd ~/Homestead
- git checkout release
+git checkout release
+```
Затем выполните команду `bash init.sh` из каталога Homestead, чтобы создать конфигурационный файл `Homestead.yaml`. Файл `Homestead.yaml` – это то место, где вы настраиваете все параметры установки Homestead. Этот файл будет размещен в каталоге Homestead:
- // macOS / Linux...
- bash init.sh
+```shell
+# macOS / Linux...
+bash init.sh
- // Windows...
- init.bat
+# Windows...
+init.bat
+```
### Конфигурирование Homestead
@@ -204,31 +208,37 @@ folders:
Чтобы задействовать [NFS](https://www.vagrantup.com/docs/synced-folders/nfs.html), вы можете добавить параметр `type` при сопоставлении папок:
- folders:
- - map: ~/code/project1
- to: /home/vagrant/project1
- type: "nfs"
+```yaml
+folders:
+ - map: ~/code/project1
+ to: /home/vagrant/project1
+ type: "nfs"
+```
> {note} При использовании NFS в Windows вам следует рассмотреть возможность установки плагина [vagrant-winnfsd](https://github.com/winnfsd/vagrant-winnfsd). Этот плагин будет поддерживать корректные разрешения пользователя / группы для файлов и каталогов виртуальной машины Homestead.
Вы также можете передать любые параметры, поддерживаемые [синхронизируемыми папками](https://www.vagrantup.com/docs/synced-folders/basic_usage.html) Vagrant, указав их под параметром `options`:
- folders:
- - map: ~/code/project1
- to: /home/vagrant/project1
- type: "rsync"
- options:
- rsync__args: ["--verbose", "--archive", "--delete", "-zz"]
- rsync__exclude: ["node_modules"]
+```yaml
+folders:
+ - map: ~/code/project1
+ to: /home/vagrant/project1
+ type: "rsync"
+ options:
+ rsync__args: ["--verbose", "--archive", "--delete", "-zz"]
+ rsync__exclude: ["node_modules"]
+```
### Конфигурирование сайтов Nginx
Не знакомы с Nginx? Без проблем. Параметр `sites` вашего файла `Homestead.yaml` позволяет вам легко сопоставить «домен» с папкой в окружении Homestead. Пример конфигурации сайта содержится в файле `Homestead.yaml`. Опять же, вы можете добавить столько сайтов в окружение Homestead, сколько необходимо. Homestead может служить удобной виртуализированной средой для каждого приложения Laravel, над которым вы работаете:
- sites:
- - map: homestead.test
- to: /home/vagrant/project1/public
+```yaml
+sites:
+ - map: homestead.test
+ to: /home/vagrant/project1/public
+```
Если вы измените параметр `sites` после подготовки виртуальной машины Homestead, то вы должны выполнить команду `vagrant reload --provision` в своем терминале, чтобы обновить конфигурацию Nginx на виртуальной машине.
@@ -245,7 +255,7 @@ Homestead публикует имена хостов, используя `mDNS`
Убедитесь, что в списке указан IP-адрес, указанный в вашем файле `Homestead.yaml`. После того, как вы добавили домен в свой файл `hosts` и запустили окно Vagrant, вы сможете получить доступ к сайту через свой веб-браузер:
-```bash
+```shell
http://homestead.test
```
@@ -278,17 +288,19 @@ services:
Для начала установите Homestead с помощью менеджера пакетов Composer в свой проект:
-```bash
+```shell
composer require laravel/homestead --dev
```
Как только Homestead будет установлен, вызовите команду `make` Homestead, чтобы сгенерировать файлы `Vagrantfile` и `Homestead.yaml` для вашего проекта. Эти файлы будут помещены в корень вашего проекта. Команда `make` автоматически настроит параметры `sites` и `folder` в файле `Homestead.yaml`:
- // macOS / Linux...
- php vendor/bin/homestead make
+```shell
+# macOS / Linux...
+php vendor/bin/homestead make
- // Windows...
- vendor\\bin\\homestead make
+# Windows...
+vendor\\bin\\homestead make
+```
Запустите команду `vagrant up` в терминале и перейдите по адресу `http://homestead.test` в вашем браузере. Помните, что вам также нужно будет добавить запись в файле `/etc/hosts` для домена `homestead.test` или любого другого необходимого домена, если вы не используете автоматическое [разрешение имени хоста](#hostname-resolution).
@@ -297,41 +309,43 @@ composer require laravel/homestead --dev
Дополнительное программное обеспечение устанавливается с помощью параметра `features` в вашем файле `Homestead.yaml`. Большую часть ПО можно включить или отключить с помощью логического значения, но существует ПО, позволяющее использовать несколько параметров конфигурации:
- features:
- - blackfire:
- server_id: "server_id"
- server_token: "server_value"
- client_id: "client_id"
- client_token: "client_value"
- - cassandra: true
- - chronograf: true
- - couchdb: true
- - crystal: true
- - docker: true
- - elasticsearch:
- version: 7.9.0
- - eventstore: true
- version: 21.2.0
- - gearman: true
- - golang: true
- - grafana: true
- - influxdb: true
- - mariadb: true
- - meilisearch: true
- - minio: true
- - mongodb: true
- - neo4j: true
- - ohmyzsh: true
- - openresty: true
- - pm2: true
- - python: true
- - r-base: true
- - rabbitmq: true
- - rvm: true
- - solr: true
- - timescaledb: true
- - trader: true
- - webdriver: true
+```yaml
+features:
+ - blackfire:
+ server_id: "server_id"
+ server_token: "server_value"
+ client_id: "client_id"
+ client_token: "client_value"
+ - cassandra: true
+ - chronograf: true
+ - couchdb: true
+ - crystal: true
+ - docker: true
+ - elasticsearch:
+ version: 7.9.0
+ - eventstore: true
+ version: 21.2.0
+ - gearman: true
+ - golang: true
+ - grafana: true
+ - influxdb: true
+ - mariadb: true
+ - meilisearch: true
+ - minio: true
+ - mongodb: true
+ - neo4j: true
+ - ohmyzsh: true
+ - openresty: true
+ - pm2: true
+ - python: true
+ - r-base: true
+ - rabbitmq: true
+ - rvm: true
+ - solr: true
+ - timescaledb: true
+ - trader: true
+ - webdriver: true
+```
#### Elasticsearch
@@ -360,8 +374,10 @@ composer require laravel/homestead --dev
Вы можете добавить псевдонимы Bash для своей виртуальной машины Homestead, изменив файл `aliases` в каталоге Homestead:
- alias c='clear'
- alias ..='cd ..'
+```shell
+alias c='clear'
+alias ..='cd ..'
+```
После обновления файла `aliases` вы должны повторно подготовить виртуальную машину Homestead с помощью команды `vagrant reload --provision`. Это обеспечит доступность ваших новых псевдонимов на машине.
@@ -370,35 +386,47 @@ composer require laravel/homestead --dev
Перед обновлением Homestead, убедитесь, что вы уничтожили текущую виртуальную машину, выполнив следующую команду в каталоге Homestead:
- vagrant destroy
+```shell
+vagrant destroy
+```
Затем вам нужно обновить исходный код Homestead. Если вы клонировали репозиторий, то вы можете выполнить следующие команды в том месте, где вы изначально клонировали репозиторий:
- git fetch
+```shell
+git fetch
- git pull origin release
+git pull origin release
+```
С помощью этих команд будет подтянут последний код Homestead из репозитория GitHub, извлечены последние теги и будет выполнена проверка последнего релиза по тегам. Вы можете найти последнюю стабильную версию релиза Homestead на [странице GitHub](https://github.com/laravel/homestead/releases).
Если вы установили Homestead в свой проект с помощью Composer, то необходимо убедиться, что ваш файл `composer.json` содержит запись `"laravel/homestead": "^12"` с последующим обновлением ваших зависимостей:
- composer update
+```shell
+composer update
+```
Затем вы должны обновить образ Vagrant с помощью команды:
- vagrant box update
+```shell
+vagrant box update
+```
После обновления образа Vagrant вы должны запустить команду `bash init.sh` из каталога Homestead, чтобы обновить дополнительные файлы конфигурации Homestead. При этом вас спросят, хотите ли вы перезаписать существующие файлы `Homestead.yaml`, `after.sh` и `aliases`:
- // macOS / Linux...
- bash init.sh
+```shell
+# macOS / Linux...
+bash init.sh
- // Windows...
- init.bat
+# Windows...
+init.bat
+```
Наконец, вам нужно будет пересоздать вашу виртуальную машину Homestead, чтобы использовать последнюю установку Vagrant:
- vagrant up
+```shell
+vagrant up
+```
## Повседневное использование
@@ -413,11 +441,13 @@ composer require laravel/homestead --dev
После того, как ваша среда Homestead подготовлена и запущена, вы можете добавить дополнительные сайты Nginx для других ваших проектов Laravel. Вы можете запускать столько проектов Laravel, сколько хотите, в одном окружении Homestead. Чтобы добавить дополнительный сайт, добавьте его в свой файл `Homestead.yaml`.
- sites:
- - map: homestead.test
- to: /home/vagrant/project1/public
- - map: another.test
- to: /home/vagrant/project2/public
+```yaml
+sites:
+ - map: homestead.test
+ to: /home/vagrant/project1/public
+ - map: another.test
+ to: /home/vagrant/project2/public
+```
> {note} Перед добавлением сайта убедитесь, что вы настроили [сопоставление папок](#configuring-shared-folders) для каталога проекта.
@@ -447,23 +477,27 @@ sites:
Вы можете добавить дополнительные значения параметра `fastcgi_param` Nginx на свой сайт с помощью директивы сайта `params`:
- sites:
- - map: homestead.test
- to: /home/vagrant/project1/public
- params:
- - key: FOO
- value: BAR
+```yaml
+sites:
+ - map: homestead.test
+ to: /home/vagrant/project1/public
+ params:
+ - key: FOO
+ value: BAR
+```
### Переменные окружения
Вы можете определить глобальные переменные окружения, добавив их в свой файл `Homestead.yaml`:
- variables:
- - key: APP_ENV
- value: local
- - key: FOO
- value: bar
+```yaml
+variables:
+ - key: APP_ENV
+ value: local
+ - key: FOO
+ value: bar
+```
После обновления файла `Homestead.yaml` не забудьте повторно подготовить машину, выполнив команду `vagrant reload --provision`. Это обновит конфигурацию PHP-FPM для всех установленных версий PHP, а также обновит окружение для пользователя `vagrant`.
@@ -484,12 +518,14 @@ sites:
По желанию можно перенаправить дополнительные порты в образе Vagrant, указав конфигурационную запись `ports` в вашем файле `Homestead.yaml`. После обновления файла `Homestead.yaml` не забудьте повторно подготовить машину, выполнив команду `vagrant reload --provision`:
- ports:
- - send: 50000
- to: 5000
- - send: 7777
- to: 777
- protocol: udp
+```yaml
+ports:
+ - send: 50000
+ to: 5000
+ - send: 7777
+ to: 777
+ protocol: udp
+```
Ниже приведен список дополнительных портов служб Homestead в образе Vagrant, которые можно сопоставить со своей хост-машины:
@@ -510,32 +546,38 @@ sites:
В Homestead 6 появилась поддержка запуска нескольких версий PHP на одной виртуальной машине. Вы можете указать, какую версию PHP использовать для конкретного сайта в файле `Homestead.yaml`. Доступные версии PHP: «5.6», «7.0», «7.1», «7.2», «7.3», «7.4», «8.0» (по умолчанию) и «8.1»:
- sites:
- - map: homestead.test
- to: /home/vagrant/project1/public
- php: "7.1"
+```yaml
+sites:
+ - map: homestead.test
+ to: /home/vagrant/project1/public
+ php: "7.1"
+```
[На виртуальной машине Homestead](#connecting-via-ssh) вы можете использовать любую из поддерживаемых версий PHP через интерфейс командной строки:
- php5.6 artisan list
- php7.0 artisan list
- php7.1 artisan list
- php7.2 artisan list
- php7.3 artisan list
- php7.4 artisan list
- php8.0 artisan list
- php8.1 artisan list
+```shell
+php5.6 artisan list
+php7.0 artisan list
+php7.1 artisan list
+php7.2 artisan list
+php7.3 artisan list
+php7.4 artisan list
+php8.0 artisan list
+php8.1 artisan list
+```
Вы можете изменить версию PHP, используемую по умолчанию в CLI, выполнив следующие команды на своей виртуальной машине Homestead:
- php56
- php70
- php71
- php72
- php73
- php74
- php80
- php81
+```shell
+php56
+php70
+php71
+php72
+php73
+php74
+php80
+php81
+```
### Подключение к базам данных
@@ -574,12 +616,14 @@ sites:
[MailHog](https://github.com/mailhog/MailHog) позволяет вам перехватывать исходящую электронную почту без отправки ее получателям. Для начала обновите файл `.env` вашего приложения, чтобы использовать следующие настройки почты:
- MAIL_MAILER=smtp
- MAIL_HOST=localhost
- MAIL_PORT=1025
- MAIL_USERNAME=null
- MAIL_PASSWORD=null
- MAIL_ENCRYPTION=null
+```ini
+MAIL_MAILER=smtp
+MAIL_HOST=localhost
+MAIL_PORT=1025
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+```
После этой настройки вы можете получить доступ к панели управления MailHog по адресу `http://localhost:8025`.
@@ -606,7 +650,7 @@ sites:
Наконец, убедитесь, что в вашем файле `.env` прописаны следующие параметры:
-```bash
+```ini
AWS_ACCESS_KEY_ID=homestead
AWS_SECRET_ACCESS_KEY=secretkey
AWS_DEFAULT_REGION=us-east-1
@@ -644,11 +688,15 @@ features:
Чтобы решить эту проблему, Homestead содержит собственную команду `share`. Для начала [подключитесь к вашей виртуальной машине](#connecting-via-ssh) через `vagrant ssh` и выполните команду `share homestead.test`. Эта команда предоставит общий доступ к сайту `homestead.test` из вашего конфигурационного файла `Homestead.yaml`. Вы можете заменить `homestead.test` на любой из других сконфигурированных вами сайтов:
- share homestead.test
+```shell
+share homestead.test
+```
После выполнения команды вы увидите экран Ngrok, который содержит журнал активности и общедоступные URL-адреса для вашего сайта. Если вы хотите указать регион, поддомен или другой параметр во время выполнения Ngrok, то вы можете добавить их в команду `share`:
- share homestead.test -region=eu -subdomain=laravel
+```shell
+share homestead.test -region=eu -subdomain=laravel
+```
> {note} Помните, что Vagrant по своей сути небезопасен, и вы открываете свою виртуальную машину для доступа в Интернет, выполняя команду `share`.
@@ -737,10 +785,12 @@ networks:
Настраивая Homestead, Ubuntu может спросить вас, хотите ли вы сохранить исходную конфигурацию пакета или перезаписать ее новым файлом конфигурации. Чтобы избежать этого, вы должны использовать следующую команду при установке пакетов, чтобы избежать перезаписи любой конфигурации, ранее созданной Homestead:
- sudo apt-get -y \
- -o Dpkg::Options::="--force-confdef" \
- -o Dpkg::Options::="--force-confold" \
- install package-name
+```shell
+sudo apt-get -y \
+ -o Dpkg::Options::="--force-confdef" \
+ -o Dpkg::Options::="--force-confold" \
+ install package-name
+```
### Пользовательские настройки
diff --git a/docs/horizon.md b/docs/horizon.md
index c21e8a3..3ef43be 100644
--- a/docs/horizon.md
+++ b/docs/horizon.md
@@ -32,11 +32,15 @@
Для начала установите Horizon с помощью менеджера пакетов Composer в свой проект:
- composer require laravel/horizon
+```shell
+composer require laravel/horizon
+```
После установки Horizon опубликуйте его ресурсы с помощью команды `horizon:install` Artisan:
- php artisan horizon:install
+```shell
+php artisan horizon:install
+```
### Конфигурирование
@@ -143,44 +147,58 @@
При обновлении до новой основной версии Horizon важно внимательно изучить [руководство по обновлению](https://github.com/laravel/horizon/blob/master/UPGRADE.md). Кроме того, при обновлении до любой новой версии Horizon вам следует повторно опубликовать веб-активы Horizon:
- php artisan horizon:publish
+```shell
+php artisan horizon:publish
+```
Чтобы поддерживать веб-активы в актуальном состоянии и избежать проблем при будущих обновлениях, вы можете добавить команду `horizon:publish` в блок `post-update-cmd` раздела `scripts` в файле `composer.json` вашего приложения:
- {
- "scripts": {
- "post-update-cmd": [
- "@php artisan horizon:publish --ansi"
- ]
- }
+```json
+{
+ "scripts": {
+ "post-update-cmd": [
+ "@php artisan horizon:publish --ansi"
+ ]
}
+}
+```
## Запуск Horizon
После того, как вы настроили своих диспетчеров и обработчиков процессов в конфигурационном файле `config/horizon.php` вашего приложения, то вы можете запустить Horizon, используя команду `horizon` Artisan. Эта единая команда запустит все сконфигурированные обработчики процессов для текущего окружения:
- php artisan horizon
+```shell
+php artisan horizon
+```
Вы можете приостановить процесс Horizon и дать ему указание продолжить обработку заданий, используя команды `horizon:pause` и `horizon:continue` Artisan:
- php artisan horizon:pause
+```shell
+php artisan horizon:pause
- php artisan horizon:continue
+php artisan horizon:continue
+```
Вы также можете приостановить и продолжить конкретные [диспетчеры](#supervisors) Horizon, используя команды `horizon:pause-supervisor` и `horizon:continue-supervisor` Artisan:
- php artisan horizon:pause-supervisor supervisor-1
+```shell
+php artisan horizon:pause-supervisor supervisor-1
- php artisan horizon:continue-supervisor supervisor-1
+php artisan horizon:continue-supervisor supervisor-1
+```
Вы можете проверить текущий статус процесса Horizon, используя команду `horizon:status` Artisan:
- php artisan horizon:status
+```shell
+php artisan horizon:status
+```
Вы можете корректно завершить процесс Horizon, используя команду `horizon:terminate` Artisan. Любые задания, которые в настоящее время обрабатываются, будут выполнены, а затем Horizon остановит свой процесс:
- php artisan horizon:terminate
+```shell
+php artisan horizon:terminate
+```
### Развертывание Horizon
@@ -189,14 +207,18 @@
Во время процесса развертывания вашего приложения вы должны дать команду Horizon завершить процесс, чтобы он был перезапущен вашим монитором процессов и получил изменения вашего кода:
- php artisan horizon:terminate
+```shell
+php artisan horizon:terminate
+```
#### Установка Supervisor
Supervisor – это монитор процесса для операционной системы Linux, который автоматически перезапустит ваш процесс `horizon`, если он перестанет выполняться. Чтобы установить Supervisor в Ubuntu, вы можете использовать следующую команду. Если вы не используете Ubuntu, то вы, вероятно, можете установить Supervisor с помощью диспетчера пакетов вашей операционной системы:
- sudo apt-get install supervisor
+```shell
+sudo apt-get install supervisor
+```
> {tip} Если настройка Supervisor сама по себе кажется утомительной, рассмотрите возможность использования [Laravel Forge](https://forge.laravel.com), который автоматически установит и настроит Supervisor для ваших проектов Laravel.
@@ -205,15 +227,17 @@ Supervisor – это монитор процесса для операцион
Конфигурационные файлы Supervisor обычно хранятся в каталоге `/etc/supervisor/conf.d` вашего сервера. В этом каталоге вы можете создать любое количество файлов конфигурации, которые инструктируют диспетчера процессов, как следует контролировать ваши процессы. Например, давайте создадим файл `horizon.conf`, который запускает и отслеживает процесс `horizon`:
- [program:horizon]
- process_name=%(program_name)s
- command=php /home/forge/example.com/artisan horizon
- autostart=true
- autorestart=true
- user=forge
- redirect_stderr=true
- stdout_logfile=/home/forge/example.com/horizon.log
- stopwaitsecs=3600
+```ini
+[program:horizon]
+process_name=%(program_name)s
+command=php /home/forge/example.com/artisan horizon
+autostart=true
+autorestart=true
+user=forge
+redirect_stderr=true
+stdout_logfile=/home/forge/example.com/horizon.log
+stopwaitsecs=3600
+```
> {note} Вы должны убедиться, что значение `stopwaitsecs` больше, чем количество секунд, потребляемых вашим самым продолжительным выполняемым заданием. В противном случае Supervisor может убить задание до того, как оно завершит обработку.
@@ -222,11 +246,13 @@ Supervisor – это монитор процесса для операцион
После создания файла конфигурации вы можете обновить конфигурацию Supervisor и запустить отслеживаемые процессы, используя следующие команды:
- sudo supervisorctl reread
+```shell
+sudo supervisorctl reread
- sudo supervisorctl update
+sudo supervisorctl update
- sudo supervisorctl start horizon
+sudo supervisorctl start horizon
+```
> {tip} Для получения дополнительной информации о запуске Supervisor обратитесь к [документации Supervisor](http://supervisord.org/index.html).
@@ -358,15 +384,21 @@ Horizon содержит панель показателей, которая п
Если вы хотите удалить невыполненное задание, то вы можете использовать команду `horizon:forget`. Команда `horizon:forget` принимает идентификатор (ID или UUID) неудачного задания в качестве своего единственного аргумента:
- php artisan horizon:forget 5
+```shell
+php artisan horizon:forget 5
+```
## Очистка заданий из очередей
Если вы хотите удалить все задания из очереди по умолчанию вашего приложения, то вы можете сделать это с помощью команды `horizon:clear` Artisan:
- php artisan horizon:clear
+```shell
+php artisan horizon:clear
+```
Вы можете передать параметр `queue` для удаления заданий из конкретной очереди:
- php artisan horizon:clear --queue=emails
+```shell
+php artisan horizon:clear --queue=emails
+```
diff --git a/docs/http-client.md b/docs/http-client.md
index f1a5379..4f45aa3 100644
--- a/docs/http-client.md
+++ b/docs/http-client.md
@@ -23,7 +23,9 @@ Laravel предлагает минимальный и выразительны
Вы должны убедиться, что пакет Guzzle включен в зависимости вашего приложения. По умолчанию Laravel автоматически включает эту зависимость. Однако, если вы ранее удалили пакет, то вы можете установить его снова через Composer:
- composer require guzzlehttp/guzzle
+```shell
+composer require guzzlehttp/guzzle
+```
## Выполнение запросов
@@ -166,6 +168,10 @@ Laravel предлагает минимальный и выразительны
Если указанный тайм-аут превышен, то будет выброшено исключение `Illuminate\Http\Client\ConnectionException`.
+Вы можете указать максимальное количество секунд ожидания при попытке подключения к серверу с помощью метода `connectTimeout`:
+
+ $response = Http::connectTimeout(3)->get(...);
+
### Повторные попытки
@@ -179,7 +185,9 @@ Laravel предлагает минимальный и выразительны
return $exception instanceof ConnectionException;
})->post(...);
-Если все запросы окажутся неуспешными, то будет выброшено исключение `Illuminate\Http\Client\RequestException`.
+Если все запросы окажутся неуспешными, то будет выброшено исключение `Illuminate\Http\Client\RequestException`. Если вы хотите отключить это поведение, вы можете указать аргумент `throw` со значением `false`. Если отключено, то последний ответ, полученный клиентом, будет возвращен после всех повторных попыток:
+
+ $response = Http::retry(3, 100, throw: false)->post(...);
### Обработка ошибок
@@ -315,8 +323,6 @@ $response = Http::github()->get('/');
$response = Http::post(...);
-> {note} При фальсификации запросов посредник HTTP-клиента не выполняется. Вы должны определить ожидания для фиктивных ответов, как если бы этот посредник работал правильно.
-
#### Фальсификация конкретных URL
diff --git a/docs/img/releases-1.png b/docs/img/releases-1.png
new file mode 100644
index 0000000..e25e058
Binary files /dev/null and b/docs/img/releases-1.png differ
diff --git a/docs/img/releases-2.png b/docs/img/releases-2.png
new file mode 100644
index 0000000..3ba8ec1
Binary files /dev/null and b/docs/img/releases-2.png differ
diff --git a/docs/img/releases-3.png b/docs/img/releases-3.png
new file mode 100644
index 0000000..1a2c3ef
Binary files /dev/null and b/docs/img/releases-3.png differ
diff --git a/docs/img/releases-4.png b/docs/img/releases-4.png
new file mode 100644
index 0000000..9099682
Binary files /dev/null and b/docs/img/releases-4.png differ
diff --git a/docs/img/releases-5.gif b/docs/img/releases-5.gif
new file mode 100644
index 0000000..676e102
Binary files /dev/null and b/docs/img/releases-5.gif differ
diff --git a/docs/installation.md b/docs/installation.md
index 2e3b7b8..810bf2c 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -61,7 +61,7 @@ Laravel Sail – это легкий интерфейс командной ст
Если вы разрабатываете на Mac и [Docker Desktop](https://www.docker.com/products/docker-desktop) уже установлен, то вы можете использовать простую команду терминала для создания нового проекта Laravel. Например, чтобы создать новое приложение Laravel в каталоге с именем `example-app`, вы можете запустить следующую команду в своем терминале:
-```nothing
+```shell
curl -s https://laravel.build/example-app | bash
```
@@ -69,7 +69,7 @@ curl -s https://laravel.build/example-app | bash
После создания проекта вы можете перейти в каталог приложения и запустить Laravel Sail. Laravel Sail предлагает простой интерфейс командной строки для взаимодействия с конфигурацией Docker по умолчанию в Laravel:
-```nothing
+```shell
cd example-app
./vendor/bin/sail up
@@ -90,7 +90,7 @@ cd example-app
Теперь вы готовы создать свой первый проект Laravel. Запустите [Терминал Windows](https://www.microsoft.com/ru-ru/p/windows-terminal/9n0dx20hk701?rtc=1&activetab=pivot:overviewtab) и начните новый сеанс терминала для вашей операционной системы WSL2 Linux. Затем вы можете использовать простую команду терминала для создания нового проекта Laravel. Например, чтобы создать новое приложение Laravel в каталоге с именем `example-app`, вы можете запустить следующую команду в своем терминале:
-```nothing
+```shell
curl -s https://laravel.build/example-app | bash
```
@@ -98,7 +98,7 @@ curl -s https://laravel.build/example-app | bash
После создания проекта вы можете перейти в каталог приложения и запустить Laravel Sail. Laravel Sail предлагает простой интерфейс командной строки для взаимодействия с конфигурацией Docker по умолчанию в Laravel:
-```nothing
+```shell
cd example-app
./vendor/bin/sail up
@@ -121,7 +121,7 @@ cd example-app
Если вы разрабатываете в Linux и [Docker Compose](https://docs.docker.com/compose/install/) уже установлен, то вы можете использовать простую команду терминала для создания нового проекта Laravel. Например, чтобы создать новое приложение Laravel в каталоге с именем `example-app`, вы можете запустить следующую команду в своем терминале:
-```nothing
+```shell
curl -s https://laravel.build/example-app | bash
```
@@ -129,7 +129,7 @@ curl -s https://laravel.build/example-app | bash
После создания проекта вы можете перейти в каталог приложения и запустить Laravel Sail. Laravel Sail предлагает простой интерфейс командной строки для взаимодействия с конфигурацией Docker по умолчанию в Laravel:
-```nothing
+```shell
cd example-app
./vendor/bin/sail up
@@ -146,29 +146,37 @@ cd example-app
При создании нового приложения Laravel через Sail вы можете использовать строковую переменную запроса `with`, чтобы выбрать, какие службы должны быть настроены в файле `docker-compose.yml` вашего нового приложения. Доступны следующие службы `mysql`, `pgsql`, `mariadb`, `redis`, `memcached`, `meilisearch`, `minio`,`selenium` и `mailhog`:
-```nothing
+```shell
curl -s "https://laravel.build/example-app?with=mysql,redis" | bash
```
Если вы не укажете желаемые службы, то будет сконфигурирован стек по умолчанию из `mysql`, `redis`, `meilisearch`, `mailhog` и `selenium`.
+Вы можете указать Sail установить [Devcontainer](sail.md#using-devcontainers) по умолчанию, добавив параметр `devcontainer` к URL-адресу:
+
+```shell
+curl -s "https://laravel.build/example-app?with=mysql,redis&devcontainer" | bash
+```
+
### Установка через Composer
Если на вашем компьютере уже установлены PHP и Composer, то вы можете создать новый проект Laravel напрямую с помощью Composer. После того, как приложение было создано, вы можете запустить локальный сервер разработки Laravel с помощью команды `serve` Artisan CLI:
- composer create-project laravel/laravel example-app
+```shell
+composer create-project laravel/laravel example-app
- cd example-app
+cd example-app
- php artisan serve
+php artisan serve
+```
#### Установщик Laravel
В качестве альтернативы, вы можете использовать установщик Laravel, включив его в глобальную зависимость Composer:
-```nothing
+```shell
composer global require laravel/installer
laravel new example-app
@@ -190,31 +198,31 @@ php artisan serve
Для удобства установщик Laravel также может создать репозиторий Git для вашего нового проекта. Чтобы указать, что вы хотите создать репозиторий Git, передайте флаг `--git` при создании нового проекта:
-```bash
+```shell
laravel new example-app --git
```
Эта команда инициализирует новый репозиторий Git для вашего проекта и автоматически зафиксирует базовый каркас Laravel. Флаг `--git` предполагает, что вы правильно установили и настроили Git. Можно также использовать параметр `--branch`, чтобы задать имя ответвления:
-```bash
+```shell
laravel new example-app --git --branch="main"
```
Вместо использования флага `--git` вы можете использовать параметр `--github`, чтобы создать репозиторий Git и, соответствующий ему, частный репозиторий на GitHub:
-```bash
+```shell
laravel new example-app --github
```
Созданный репозиторий будет доступен по адресу `https://github.com/
/example-app`. Параметр `--github` предполагает, что вы правильно установили [GitHub CLI](https://cli.github.com) и прошли аутентификацию с помощью интерфейса командной строки. Кроме того, у вас должен быть установлен и правильно настроен [git](https://git-scm.com/). При необходимости вы можете передать [дополнительные параметры и флаги](https://cli.github.com/manual/gh_repo_create), поддерживаемые GitHub CLI:
-```bash
+```shell
laravel new example-app --github="--public"
```
Можно использовать параметр `--organization` для создания репозитория под определенной организацией GitHub:
-```bash
+```shell
laravel new example-app --github="--public" --organization="laravel"
```
diff --git a/docs/localization.md b/docs/localization.md
index 3b67185..a0422ed 100644
--- a/docs/localization.md
+++ b/docs/localization.md
@@ -103,7 +103,7 @@ Laravel предлагает два способа управления стро
По этой причине Laravel предлагает определение строк перевода с использованием переводимой строки в качестве ключа «по умолчанию». Файлы перевода, которые используют строки перевода в качестве ключей, хранятся как файлы JSON в каталоге `resources/lang`. Например, если ваше приложение имеет испанский перевод, то вы должны создать файл `resources/lang/es.json`:
-```js
+```json
{
"I love programming.": "Me encanta programar."
}
@@ -157,7 +157,7 @@ Laravel предлагает два способа управления стро
Конечно, множественное число также поддерживается при использовании [строк перевода в качестве ключей](#using-translation-strings-as-keys):
-```js
+```json
{
"There is one apple|There are many apples": "Hay una manzana|Hay muchas manzanas"
}
diff --git a/docs/mail.md b/docs/mail.md
index 28be6eb..d74d102 100644
--- a/docs/mail.md
+++ b/docs/mail.md
@@ -11,7 +11,7 @@
- [Данные шаблона](#view-data)
- [Вложения](#attachments)
- [Встраиваемые вложения](#inline-attachments)
- - [Настройка сообщения SwiftMailer](#customizing-the-swiftmailer-message)
+ - [Настройка сообщения Symfony](#customizing-the-symfony-message)
- [Отправления с разметкой Markdown](#markdown-mailables)
- [Генерация отправлений с разметкой Markdown](#generating-markdown-mailables)
- [Написание сообщений с разметкой Markdown](#writing-markdown-messages)
@@ -24,11 +24,13 @@
- [Тестирование отправлений](#testing-mailables)
- [Почта и локальная разработка](#mail-and-local-development)
- [События](#events)
+- [Пользовательские драйвера](#custom-transports)
+ - [Дополнительные драйвера Symfony](#additional-symfony-transports)
@foreach ($users as $user)
{{ $user->name }}
@@ -228,7 +228,9 @@ select * from users where id > 15 order by id asc limit 15;
Пагинатор отображает навигационные ссылки, которые содержат номер текущей страницы, а также ссылки для трех страниц до и после текущей страницы. Используя метод `onEachSide`, вы можете контролировать количество дополнительных ссылок, отображаемых с каждой стороны от текущей страницы в среднем блоке ссылок, созданных пагинатором:
- {{ $users->onEachSide(5)->links() }}
+```blade
+{{ $users->onEachSide(5)->links() }}
+```
### Преобразование результатов в JSON
@@ -270,14 +272,18 @@ JSON из пагинатора будет включать метаинформ
По умолчанию сгенерированные шаблоны для отображения навигационных ссылок, совместимы со структурой [фреймворка Tailwind CSS](https://tailwindcss.com). Однако, если вы не используете Tailwind, вы можете определять свои собственные шаблоны для отображения этих ссылок. При вызове метода `links` в экземпляре пагинатора вы можете передать имя шаблона в качестве первого аргумента метода:
- {{ $paginator->links('view.name') }}
+```blade
+{{ $paginator->links('view.name') }}
- // Передача дополнительных данных в шаблон ...
- {{ $paginator->links('view.name', ['foo' => 'bar']) }}
+// Передача дополнительных данных в шаблон ...
+{{ $paginator->links('view.name', ['foo' => 'bar']) }}
+```
Однако, самый простой способ отредактировать шаблоны постраничной навигации – это экспортировать их в каталог `resources/views/vendor` с помощью команды `vendor:publish`:
- php artisan vendor:publish --tag=laravel-pagination
+```shell
+php artisan vendor:publish --tag=laravel-pagination
+```
Эта команда поместит шаблоны в каталог `resources/views/vendor/pagination` вашего приложения. Файл `tailwind.blade.php` в этом каталоге соответствует шаблону постраничной навигации по умолчанию. Вы можете отредактировать этот файл для изменения HTML-кода навигации.
@@ -309,7 +315,7 @@ JSON из пагинатора будет включать метаинформ
### Использование Bootstrap
-Laravel содержит шаблоны постраничной навигации, созданные с использованием [Bootstrap CSS](https://getbootstrap.com/). Чтобы использовать эти шаблоны вместо шаблонов Tailwind по умолчанию, вы можете вызвать метод пагинатора `useBootstrap` в методе `boot` поставщика `App\Providers\AppServiceProvider`:
+Laravel содержит шаблоны постраничной навигации, созданные с использованием [Bootstrap CSS](https://getbootstrap.com/). Чтобы использовать эти шаблоны вместо шаблонов Tailwind по умолчанию, вы можете вызвать метод пагинатора `useBootstrapFour` или `useBootstrapFive` в методе `boot` поставщика `App\Providers\AppServiceProvider`:
use Illuminate\Pagination\Paginator;
@@ -320,7 +326,8 @@ Laravel содержит шаблоны постраничной навигац
*/
public function boot()
{
- Paginator::useBootstrap();
+ Paginator::useBootstrapFive();
+ Paginator::useBootstrapFour();
}
diff --git a/docs/passport.md b/docs/passport.md
index d6c7c6e..aaa7c86 100644
--- a/docs/passport.md
+++ b/docs/passport.md
@@ -62,15 +62,21 @@ However, if you are attempting to authenticate a single-page application, mobile
To get started, install Passport via the Composer package manager:
- composer require laravel/passport
+```shell
+composer require laravel/passport
+```
Passport's [service provider](/docs/{{version}}/providers) registers its own database migration directory, so you should migrate your database after installing the package. The Passport migrations will create the tables your application needs to store OAuth2 clients and access tokens:
- php artisan migrate
+```shell
+php artisan migrate
+```
Next, you should execute the `passport:install` Artisan command. This command will create the encryption keys needed to generate secure access tokens. In addition, the command will create "personal access" and "password grant" clients which will be used to generate access tokens:
- php artisan passport:install
+```shell
+php artisan passport:install
+```
> {tip} If you would like to use UUIDs as the primary key value of the Passport `Client` model instead of auto-incrementing integers, please install Passport using [the `uuids` option](#client-uuids).
@@ -145,14 +151,18 @@ Finally, in your application's `config/auth.php` configuration file, you should
You may also run the `passport:install` command with the `--uuids` option present. This option will instruct Passport that you would like to use UUIDs instead of auto-incrementing integers as the Passport `Client` model's primary key values. After running the `passport:install` command with the `--uuids` option, you will be given additional instructions regarding disabling Passport's default migrations:
- php artisan passport:install --uuids
+```shell
+php artisan passport:install --uuids
+```
### Deploying Passport
When deploying Passport to your application's servers for the first time, you will likely need to run the `passport:keys` command. This command generates the encryption keys Passport needs in order to generate access tokens. The generated keys are not typically kept in source control:
- php artisan passport:keys
+```shell
+php artisan passport:keys
+```
If necessary, you may define the path where Passport's keys should be loaded from. You may use the `Passport::loadKeysFrom` method to accomplish this. Typically, this method should be called from the `boot` method of your application's `App\Providers\AuthServiceProvider` class:
@@ -175,11 +185,13 @@ If necessary, you may define the path where Passport's keys should be loaded fro
Alternatively, you may publish Passport's configuration file using the `vendor:publish` Artisan command:
- php artisan vendor:publish --tag=passport-config
+```shell
+php artisan vendor:publish --tag=passport-config
+```
After the configuration file has been published, you may load your application's encryption keys by defining them as environment variables:
-```bash
+```ini
PASSPORT_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----
-----END RSA PRIVATE KEY-----"
@@ -194,7 +206,9 @@ PASSPORT_PUBLIC_KEY="-----BEGIN PUBLIC KEY-----
If you are not going to use Passport's default migrations, you should call the `Passport::ignoreMigrations` method in the `register` method of your `App\Providers\AppServiceProvider` class. You may export the default migrations using the `vendor:publish` Artisan command:
- php artisan vendor:publish --tag=passport-migrations
+```shell
+php artisan vendor:publish --tag=passport-migrations
+```
+
+ Server Error
+
-_Автор: [Taylor Otwell](https://github.com/taylorotwell), вдохновленный [Spatie](https://spatie.be)_.
+ Whoops! Something went wrong!
+
+```
-В предыдущих релизах Laravel функционал режима обслуживания `php artisan down` можно было обойти с помощью «разрешенного списка» IP-адресов, имеющим доступ к приложению. Эта функция была удалена в пользу более простого токен-решения.
+Однако, начиная с Laravel 9.x, вы можете указать имя слота, используя удобный, более короткий синтаксис:
-Находясь в режиме обслуживания, вы можете использовать параметр `secret`, чтобы указать токен обхода режима обслуживания:
+```xml
+
+ Server Error
+
+```
- php artisan down --secret="1630542a-246b-4b66-afa1-dd72a4c43515"
+
+ @foreach ($product->versions as $version)
+
+ {{ $version }}
+
+ @endforeach
+
+```
-По этой причине Laravel позволяет предварительно визуализировать шаблон режима обслуживания, который будет возвращен в самом начале цикла запроса. Этот шаблон отображается перед загрузкой любых зависимостей вашего приложения. Вы можете выполнить предварительный рендеринг шаблона по вашему выбору, используя параметр `render` команды `down`:
+
+
-Кроме того, анонимные слушатели событий теперь могут быть помечены как доступные для очереди с помощью функции `Illuminate\Events\queueable`:
+
+
- Event::listen(queueable(function (PodcastProcessed $event) {
- //
- })->onConnection('redis')->onQueue('podcasts')->delay(now()->addSeconds(10)));
+
+
-При тестировании вам может иногда потребоваться изменить время, возвращаемое такими помощниками, как `now` или `Illuminate\Support\Carbon::now()`. Базовый класс тестирования функций Laravel теперь включает помощников, которые позволяют вам управлять текущим временем:
+Вы можете использовать параметр `--min`, чтобы определить минимальный порог покрытия тестами вашего приложения. Набор тестов завершится ошибкой, если этот порог не будет достигнут:
- public function testTimeCanBeManipulated()
- {
- // Путешествие в будущее ...
- $this->travel(5)->milliseconds();
- $this->travel(5)->seconds();
- $this->travel(5)->minutes();
- $this->travel(5)->hours();
- $this->travel(5)->days();
- $this->travel(5)->weeks();
- $this->travel(5)->years();
-
- // Путешествие в прошлое ...
- $this->travel(-5)->hours();
-
- // Путешествие в определенное время ...
- $this->travelTo(now()->subHours(6));
-
- // Вернуться в настоящее время ...
- $this->travelBack();
- }
+```shell
+php artisan test --coverage --min=80.3
+```
-
+
-_Автор: [Taylor Otwell](https://github.com/taylorotwell)_.
+
+
+
+Control + C , чтобы остановить их выполнение. Или, если контейнеры работают в фоновом режиме, вы можете использовать команду `down`:
-```bash
+```shell
sail stop
```
@@ -116,7 +124,7 @@ sail stop
**При чтении документации Laravel вы часто увидите ссылки на команды Composer, Artisan и Node / NPM, которые не ссылаются на Sail**. В этих примерах предполагается, что эти инструменты установлены на вашем локальном компьютере. Если вы используете Sail для своей локальной среды разработки Laravel, то вам следует выполнить эти команды с помощью Sail:
-```bash
+```shell
# Локальный запуск команд Artisan ...
php artisan queue:work
@@ -129,7 +137,7 @@ sail artisan queue:work
Команды PHP могут быть выполнены с помощью команды `php`. Конечно, эти команды будут выполняться с использованием версии PHP вашего приложения. Чтобы узнать больше о версиях PHP, доступных для Laravel Sail, обратитесь к разделу [Выбор версии PHP](#sail-php-versions):
-```bash
+```shell
sail php --version
sail php script.php
@@ -140,7 +148,7 @@ sail php script.php
Команды Composer могут быть выполнены с помощью команды `composer`. Контейнер приложения Laravel Sail содержит Composer 2.x:
-```nothing
+```shell
sail composer require laravel/sanctum
```
@@ -151,7 +159,7 @@ sail composer require laravel/sanctum
Вы можете установить зависимости приложения, перейдя в каталог приложения и выполнив следующую команду. Эта команда использует небольшой контейнер Docker, содержащий PHP и Composer, для установки зависимостей приложения:
-```nothing
+```shell
docker run --rm \
-u "$(id -u):$(id -g)" \
-v $(pwd):/var/www/html \
@@ -167,7 +175,7 @@ docker run --rm \
Команды Artisan могут быть выполнены с помощью команды `artisan`:
-```bash
+```shell
sail artisan queue:work
```
@@ -176,7 +184,7 @@ sail artisan queue:work
Команды Node могут быть выполнены с помощью команды `node`, в то время как команды NPM могут быть выполнены с помощью команды `npm`:
-```nothing
+```shell
sail node --version
sail npm run prod
@@ -184,7 +192,7 @@ sail npm run prod
Если вы хотите, то можете использовать Yarn вместо NPM:
-```nothing
+```shell
sail yarn
```
@@ -236,13 +244,17 @@ AWS_USE_PATH_STYLE_ENDPOINT=true
Laravel provides amazing testing support out of the box, and you may use Sail's `test` command to run your applications [feature and unit tests](testing.md). Any CLI options that are accepted by PHPUnit may also be passed to the `test` command:
- sail test
+```shell
+sail test
- sail test --group orders
+sail test --group orders
+```
The Sail `test` command is equivalent to running the `test` Artisan command:
- sail artisan test
+```shell
+sail artisan test
+```
` должно быть именем контейнера, который обслуживает ваше приложение, и чаще всего заканчиваться на `_laravel.test_1`:
-```bash
+```shell
docker inspect -f {{range.NetworkSettings.Networks}}{{.Gateway}}{{end}}
```
@@ -413,7 +435,7 @@ SAIL_XDEBUG_CONFIG="client_host="
Команда `sail debug` может быть использована для запуска сеанса отладки при запуске команды Artisan:
-```bash
+```shell
# Запустить команды Artisan без Xdebug ...
sail artisan migrate
@@ -435,12 +457,12 @@ sail debug migrate
Поскольку Sail – это просто Docker, то вы можете настроить почти все в нем. Чтобы опубликовать Docker-файлы Sail, вы можете выполнить команду `sail:publish`:
-```bash
+```shell
sail artisan sail:publish
```
После запуска этой команды файлы Docker и другие конфигурационные файлы, используемые Laravel Sail, будут помещены в каталог `docker` корневого каталога вашего приложения. После настройки Sail вы можете изменить имя образа для контейнера приложения в файле `docker-compose.yml` вашего приложения. После этого пересоберите контейнеры вашего приложения с помощью команды `build`. Присвоение уникального имени образу приложения особенно важно, если вы используете Sail для разработки нескольких приложений Laravel на одном компьютере:
-```bash
+```shell
sail build --no-cache
```
diff --git a/docs/sanctum.md b/docs/sanctum.md
index 964e6e3..15ca5aa 100644
--- a/docs/sanctum.md
+++ b/docs/sanctum.md
@@ -56,15 +56,21 @@ Sanctum будет пытаться аутентифицироваться с п
Для начала установите Sanctum с помощью менеджера пакетов Composer в свой проект:
- composer require laravel/sanctum
+```shell
+composer require laravel/sanctum
+```
Затем, вы должны опубликовать файлы конфигурации и миграции Sanctum с помощью команды `vendor:publish` Artisan. Файл конфигурации `sanctum` будет помещен в каталог `config` вашего приложения:
- php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"
+```shell
+php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"
+```
Наконец, вы должны запустить миграцию базы данных. Sanctum создаст одну таблицу базы данных, в которой будут храниться токены API:
- php artisan migrate
+```shell
+php artisan migrate
+```
Затем, если вы планируете использовать Sanctum для аутентификации SPA, то вам следует добавить посредника Sanctum в вашу группу посредников `api` в файле `app/Http/Kernel.php`:
@@ -260,7 +266,9 @@ Sanctum также обеспечивает простой метод аутен
Кроме того, вы должны задействовать параметр `withCredentials` в глобальном экземпляре `axios` вашего приложения. Обычно это нужно делать в вашем файле `resources/js/bootstrap.js`. Если вы на клиентской стороне не используете Axios для выполнения HTTP-запросов, то вам следует выполнить аналогичную настройку своего HTTP-клиента:
- axios.defaults.withCredentials = true;
+```js
+axios.defaults.withCredentials = true;
+```
Наконец, вы должны убедиться, что конфигурация домена cookie сессии вашего приложения поддерживает любой поддомен вашего корневого домена. Вы можете сделать это, добавив к домену префикс `.` в конфигурационном файле `config/session.php` вашего приложения:
@@ -274,9 +282,11 @@ Sanctum также обеспечивает простой метод аутен
Для аутентификации вашего SPA страница «входа» вашего SPA должна сначала сделать запрос к конечной точке `/sanctum/csrf-cookie` для инициализации защиты от CSRF для приложения:
- axios.get('/sanctum/csrf-cookie').then(response => {
- // Login...
- });
+```js
+axios.get('/sanctum/csrf-cookie').then(response => {
+ // Login...
+});
+```
Во время этого запроса Laravel установит cookie `XSRF-TOKEN`, содержащий текущий токен CSRF. Этот токен следует передавать в заголовке `X-XSRF-TOKEN` при последующих запросах, что некоторые клиентские библиотеки HTTP, такие как Axios и Angular HttpClient, будут делать автоматически за вас. Если ваша HTTP-библиотека JavaScript не задает автоматически значение, то вам нужно будет вручную установить заголовок `X-XSRF-TOKEN`, чтобы он соответствовал значению `XSRF-TOKEN` cookie, установленному этим маршрутом.
@@ -311,28 +321,30 @@ Sanctum также обеспечивает простой метод аутен
Затем, чтобы запросы авторизации Pusher были успешными, вам нужно будет предоставить определение `authorizer` Pusher при инициализации [Laravel Echo](broadcasting.md#client-side-installation). Это позволит вашему приложению настроить Pusher для использования экземпляра `axios`, [ориентированного на междоменные запросы](#cors-and-cookies):
- window.Echo = new Echo({
- broadcaster: "pusher",
- cluster: process.env.MIX_PUSHER_APP_CLUSTER,
- encrypted: true,
- key: process.env.MIX_PUSHER_APP_KEY,
- authorizer: (channel, options) => {
- return {
- authorize: (socketId, callback) => {
- axios.post('/api/broadcasting/auth', {
- socket_id: socketId,
- channel_name: channel.name
- })
- .then(response => {
- callback(false, response.data);
- })
- .catch(error => {
- callback(true, error);
- });
- }
- };
- },
- })
+```js
+window.Echo = new Echo({
+ broadcaster: "pusher",
+ cluster: process.env.MIX_PUSHER_APP_CLUSTER,
+ encrypted: true,
+ key: process.env.MIX_PUSHER_APP_KEY,
+ authorizer: (channel, options) => {
+ return {
+ authorize: (socketId, callback) => {
+ axios.post('/api/broadcasting/auth', {
+ socket_id: socketId,
+ channel_name: channel.name
+ })
+ .then(response => {
+ callback(false, response.data);
+ })
+ .catch(error => {
+ callback(true, error);
+ });
+ }
+ };
+ },
+})
+```
HTML ', 'text/html')
+ ->addPart('Plain Text', 'text/plain');
+
+ // Laravel 9.x...
+ $message
+ ->from('taylor@laravel.com')
+ ->to('example@example.org')
+ ->subject('Order Shipped')
+ ->html('HTML ')
+ ->text('Plain Text');
+
+#### Генерация идентификаторов сообщений
+
+SwiftMailer предлагал возможность определить собственный домен для включения в сгенерированные идентификаторы сообщений с помощью параметра конфигурации `mime.idgenerator.idright`. Это не поддерживается в Symfony Mailer. Вместо этого Symfony Mailer автоматически сгенерирует идентификатор сообщения на основе отправителя.
+
+#### Принудительное переподключение
+
+Больше невозможно принудительно переподключиться к транспорту (например, когда почтовая программа работает через процесс-демон). Вместо этого Symfony Mailer попытается автоматически переподключиться к транспорту и выдаст исключение, если переподключение не удастся.
+
+#### Параметры потока SMTP
+
+Определение параметров потока для транспорта SMTP больше не поддерживается. Вместо этого вы должны определить соответствующие параметры непосредственно в конфигурации, если они поддерживаются. Например, чтобы отключить одноранговую проверку TLS:
+
+ 'smtp' => [
+ // Laravel 8.x...
+ 'stream' => [
+ 'ssl' => [
+ 'verify_peer' => false,
+ ],
+ ],
-.test`:
- cd ~/Sites
+```shell
+cd ~/Sites
- valet park
+valet park
+```
That's all there is to it. Now, any application you create within your "parked" directory will automatically be served using the `http://.test` convention. So, if your parked directory contains a directory named "laravel", the application within that directory will be accessible at `http://laravel.test`. In addition, Valet automatically allows you to access the site using wildcard subdomains (`http://foo.laravel.test`).
@@ -142,38 +156,50 @@ That's all there is to it. Now, any application you create within your "parked"
The `link` command can also be used to serve your Laravel applications. This command is useful if you want to serve a single site in a directory and not the entire directory:
- cd ~/Sites/laravel
+```shell
+cd ~/Sites/laravel
- valet link
+valet link
+```
Once an application has been linked to Valet using the `link` command, you may access the application using its directory name. So, the site that was linked in the example above may be accessed at `http://laravel.test`. In addition, Valet automatically allows you to access the site using wildcard sub-domains (`http://foo.laravel.test`).
If you would like to serve the application at a different hostname, you may pass the hostname to the `link` command. For example, you may run the following command to make an application available at `http://application.test`:
- cd ~/Sites/laravel
+```shell
+cd ~/Sites/laravel
- valet link application
+valet link application
+```
You may execute the `links` command to display a list of all of your linked directories:
- valet links
+```shell
+valet links
+```
The `unlink` command may be used to destroy the symbolic link for a site:
- cd ~/Sites/laravel
+```shell
+cd ~/Sites/laravel
- valet unlink
+valet unlink
+```
Создание поста блога
@@ -209,12 +208,15 @@ Laravel содержит удобные правила валидации, пр
Вы можете использовать директиву [`@error` Blade](blade.md#validation-errors), чтобы быстро определить, существуют ли сообщения об ошибках валидации для конкретного атрибута, включая сообщения об ошибках в именованной коллекции ошибок. В директиве `@error` вы можете вывести содержимое переменной `$message` для отображения сообщения об ошибке:
-```html
+```blade
Post Title
-{{ $message }}
@@ -223,7 +225,7 @@ Laravel содержит удобные правила валидации, пр
Если вы используете [именованные коллекции ошибок](#named-error-bags), то вы можете передать имя коллекции в качестве второго аргумента директивы `@error`:
-```html
+```blade