You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: original-en/authentication.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -55,7 +55,7 @@ Want to get started fast? Install a [Laravel application starter kit](/docs/{{ve
55
55
56
56
By default, Laravel includes an `App\Models\User`[Eloquent model](/docs/{{version}}/eloquent) in your `app/Models` directory. This model may be used with the default Eloquent authentication driver.
57
57
58
-
If your application is not using Eloquent, you may use the `database` authentication provider which uses the Laravel query builder. If your application is using MongoDB, check out MongoDB's official [Laravel user authentication documentation](https://www.mongodb.com/docs/drivers/php/laravel-mongodb/current/user-authentication/).
58
+
If your application is not using Eloquent, you may use the `database` authentication provider which uses the Laravel query builder. If your application is using MongoDB, check out MongoDB's official [Laravel user authentication documentation](https://www.mongodb.com/docs/drivers/php/laravel-mongodb/current/user-authentication/).
59
59
60
60
When building the database schema for the `App\Models\User` model, make sure the password column is at least 60 characters in length. Of course, the `users` table migration that is included in new Laravel applications already creates a column that exceeds this length.
Copy file name to clipboardExpand all lines: original-en/localization.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -207,7 +207,7 @@ If your placeholder contains all capital letters, or only has its first letter c
207
207
<aname="object-replacement-formatting"></a>
208
208
#### Object Replacement Formatting
209
209
210
-
If you attempt to provide an object as a translation placeholder, the object's `__toString` method will be invoked. The [`__toString`](https://www.php.net/manual/en/language.oop5.magic.php#object.tostring) method is one of PHP's built-in "magic methods". However, sometimes you may not have control over the `__toString` method of a given class, such as when the class that you are interacting with belongs to a third-party library.
210
+
If you attempt to provide an object as a translation placeholder, the object's `__toString` method will be invoked. The [__toString](https://www.php.net/manual/en/language.oop5.magic.php#object.tostring) method is one of PHP's built-in "magic methods". However, sometimes you may not have control over the `__toString` method of a given class, such as when the class that you are interacting with belongs to a third-party library.
211
211
212
212
In these cases, Laravel allows you to register a custom formatting handler for that particular type of object. To accomplish this, you should invoke the translator's `stringable` method. The `stringable` method accepts a closure, which should type-hint the type of object that it is responsible for formatting. Typically, the `stringable` method should be invoked within the `boot` method of your application's `AppServiceProvider` class:
@@ -380,7 +383,7 @@ public function content(): Content
380
383
```
381
384
382
385
> [!NOTE]
383
-
> You may wish to create a `resources/views/emails` directory to house all of your email templates; however, you are free to place them wherever you wish within your `resources/views` directory.
386
+
> You may wish to create a `resources/views/mail` directory to house all of your email templates; however, you are free to place them wherever you wish within your `resources/views` directory.
384
387
385
388
<aname="plain-text-emails"></a>
386
389
#### Plain Text Emails
@@ -502,7 +505,7 @@ class OrderShipped extends Mailable
502
505
}
503
506
```
504
507
505
-
Once the data has been passed to the `with`method, it will automatically be available in your view, so you may access it like you would access any other data in your Blade templates:
508
+
Once the data has been passed via the `with`parameter, it will automatically be available in your view, so you may access it like you would access any other data in your Blade templates:
506
509
507
510
```blade
508
511
<div>
@@ -769,7 +772,7 @@ public function envelope(): Envelope
769
772
}
770
773
```
771
774
772
-
If your application is using the Mailgun driver, you may consult Mailgun's documentation for more information on [tags](https://documentation.mailgun.com/docs/mailgun/user-manual/tracking-messages/#tagging) and [metadata](https://documentation.mailgun.com/docs/mailgun/user-manual/tracking-messages/#attaching-data-to-messages). Likewise, the Postmark documentation may also be consulted for more information on their support for [tags](https://postmarkapp.com/blog/tags-support-for-smtp) and [metadata](https://postmarkapp.com/support/article/1125-custom-metadata-faq).
775
+
If your application is using the Mailgun driver, you may consult Mailgun's documentation for more information on [tags](https://documentation.mailgun.com/docs/mailgun/user-manual/tracking-messages/#tags) and [metadata](https://documentation.mailgun.com/docs/mailgun/user-manual/sending-messages/#attaching-metadata-to-messages). Likewise, the Postmark documentation may also be consulted for more information on their support for [tags](https://postmarkapp.com/blog/tags-support-for-smtp) and [metadata](https://postmarkapp.com/support/article/1125-custom-metadata-faq).
773
776
774
777
If your application is using Amazon SES to send emails, you should use the `metadata` method to attach [SES "tags"](https://docs.aws.amazon.com/ses/latest/APIReference/API_MessageTag.html) to the message.
Sometimes, applications store each user's preferred locale. By implementing the `HasLocalePreference` contract on one or more of your models, you may instruct Laravel to use this stored locale when sending mail:
1152
1155
@@ -1456,7 +1459,7 @@ class LogMessage
1456
1459
<aname="custom-transports"></a>
1457
1460
## Custom Transports
1458
1461
1459
-
Laravel includes a variety of mail transports; however, you may wish to write your own transports to deliver email via other services that Laravel does not support out of the box. To get started, define a class that extends the `Symfony\Component\Mailer\Transport\AbstractTransport` class. Then, implement the `doSend` and `__toString()` methods on your transport:
1462
+
Laravel includes a variety of mail transports; however, you may wish to write your own transports to deliver email via other services that Laravel does not support out of the box. To get started, define a class that extends the `Symfony\Component\Mailer\Transport\AbstractTransport` class. Then, implement the `doSend` and `__toString` methods on your transport:
1460
1463
1461
1464
```php
1462
1465
use MailchimpTransactional\ApiClient;
@@ -1508,14 +1511,19 @@ Once you've defined your custom transport, you may register it via the `extend`
1508
1511
```php
1509
1512
use App\Mail\MailchimpTransport;
1510
1513
use Illuminate\Support\Facades\Mail;
1514
+
use MailchimpTransactional\ApiClient;
1511
1515
1512
1516
/**
1513
1517
* Bootstrap any application services.
1514
1518
*/
1515
1519
public function boot(): void
1516
1520
{
1517
1521
Mail::extend('mailchimp', function (array $config = []) {
1518
-
return new MailchimpTransport(/* ... */);
1522
+
$client = new ApiClient;
1523
+
1524
+
$client->setApiKey($config['key']);
1525
+
1526
+
return new MailchimpTransport($client);
1519
1527
});
1520
1528
}
1521
1529
```
@@ -1525,6 +1533,7 @@ Once your custom transport has been defined and registered, you may create a mai
1525
1533
```php
1526
1534
'mailchimp' => [
1527
1535
'transport' => 'mailchimp',
1536
+
'key' => env('MAILCHIMP_API_KEY'),
1528
1537
// ...
1529
1538
],
1530
1539
```
@@ -1570,7 +1579,7 @@ public function boot(): void
1570
1579
}
1571
1580
```
1572
1581
1573
-
Once your transport has been registered, you may create a mailer definition within your application's config/mail.php configuration file that utilizes the new transport:
1582
+
Once your transport has been registered, you may create a mailer definition within your application's `config/mail.php` configuration file that utilizes the new transport:
Copy file name to clipboardExpand all lines: original-en/prompts.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -864,7 +864,7 @@ $response = spin(
864
864
```
865
865
866
866
> [!WARNING]
867
-
> The `spin` function requires the `pcntl` PHP extension to animate the spinner. When this extension is not available, a static version of the spinner will appear instead.
867
+
> The `spin` function requires the [PCNTL](https://www.php.net/manual/en/book.pcntl.php) PHP extension to animate the spinner. When this extension is not available, a static version of the spinner will appear instead.
Copy file name to clipboardExpand all lines: original-en/queues.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1354,7 +1354,7 @@ class ProcessPodcast implements ShouldQueue
1354
1354
Sometimes, IO blocking processes such as sockets or outgoing HTTP connections may not respect your specified timeout. Therefore, when using these features, you should always attempt to specify a timeout using their APIs as well. For example, when using Guzzle, you should always specify a connection and request timeout value.
1355
1355
1356
1356
> [!WARNING]
1357
-
> The `pcntl` PHP extension must be installed in order to specify job timeouts. In addition, a job's "timeout" value should always be less than its ["retry after"](#job-expiration) value. Otherwise, the job may be re-attempted before it has actually finished executing or timed out.
1357
+
> The [PCNTL](https://www.php.net/manual/en/book.pcntl.php) PHP extension must be installed in order to specify job timeouts. In addition, a job's "timeout" value should always be less than its ["retry after"](#job-expiration) value. Otherwise, the job may be re-attempted before it has actually finished executing or timed out.
0 commit comments