Skip to content

Commit 55cffbf

Browse files
committed
2025-12-08までの原文変更点反映。
1 parent 425ea89 commit 55cffbf

22 files changed

+597
-41
lines changed

original-en/artisan.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,7 @@ php artisan vendor:publish --provider="Laravel\Tinker\TinkerServiceProvider"
8181
```
8282

8383
> [!WARNING]
84-
> The `dispatch` helper function and `dispatch` method on the `Dispatchable` class depends on garbage collection to place the job on the queue. Therefore, when using tinker, you should use `Bus::dispatch` or `Queue::push` to dispatch jobs.
84+
> The `dispatch` helper function and `dispatch` method on the `Dispatchable` class depend on garbage collection to place the job on the queue. Therefore, when using Tinker, you should use `Bus::dispatch` or `Queue::push` to dispatch jobs.
8585
8686
<a name="command-allow-list"></a>
8787
#### Command Allow List
@@ -167,7 +167,7 @@ class SendEmails extends Command
167167
<a name="exit-codes"></a>
168168
#### Exit Codes
169169

170-
If nothing is returned from the `handle` method and the command executes successfully, the command will exit with a `0` exit code, indicating success. However, the `handle` method may optionally return an integer to manually specify command's exit code:
170+
If nothing is returned from the `handle` method and the command executes successfully, the command will exit with a `0` exit code, indicating success. However, the `handle` method may optionally return an integer to manually specify the command's exit code:
171171

172172
```php
173173
$this->error('Something went wrong.');
@@ -186,7 +186,7 @@ $this->fail('Something went wrong.');
186186

187187
Closure-based commands provide an alternative to defining console commands as classes. In the same way that route closures are an alternative to controllers, think of command closures as an alternative to command classes.
188188

189-
Even though the `routes/console.php` file does not define HTTP routes, it defines console based entry points (routes) into your application. Within this file, you may define all of your closure-based console commands using the `Artisan::command` method. The `command` method accepts two arguments: the [command signature](#defining-input-expectations) and a closure which receives the command's arguments and options:
189+
Even though the `routes/console.php` file does not define HTTP routes, it defines console-based entry points (routes) into your application. Within this file, you may define all of your closure-based console commands using the `Artisan::command` method. The `command` method accepts two arguments: the [command signature](#defining-input-expectations) and a closure which receives the command's arguments and options:
190190

191191
```php
192192
Artisan::command('mail:send {user}', function (string $user) {
@@ -274,7 +274,7 @@ public function isolatableId(): string
274274
<a name="lock-expiration-time"></a>
275275
#### Lock Expiration Time
276276

277-
By default, isolation locks expire after the command is finished. Or, if the command is interrupted and unable to finish, the lock will expire after one hour. However, you may adjust the lock expiration time by defining a `isolationLockExpiresAt` method on your command:
277+
By default, isolation locks expire after the command is finished. Or, if the command is interrupted and unable to finish, the lock will expire after one hour. However, you may adjust the lock expiration time by defining an `isolationLockExpiresAt` method on your command:
278278

279279
```php
280280
use DateTimeInterface;

original-en/blade.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ Since many JavaScript frameworks also use "curly" braces to indicate a given exp
138138
Hello, @{{ name }}.
139139
```
140140

141-
In this example, the `@` symbol will be removed by Blade; however, `{{ name }}` expression will remain untouched by the Blade engine, allowing it to be rendered by your JavaScript framework.
141+
In this example, the `@` symbol will be removed by Blade; however, the `{{ name }}` expression will remain untouched by the Blade engine, allowing it to be rendered by your JavaScript framework.
142142

143143
The `@` symbol may also be used to escape Blade directives:
144144

@@ -161,7 +161,7 @@ Sometimes you may pass an array to your view with the intention of rendering it
161161
</script>
162162
```
163163
164-
However, instead of manually calling `json_encode`, you may use the `Illuminate\Support\Js::from` method directive. The `from` method accepts the same arguments as PHP's `json_encode` function; however, it will ensure that the resulting JSON has been properly escaped for inclusion within HTML quotes. The `from` method will return a string `JSON.parse` JavaScript statement that will convert the given object or array into a valid JavaScript object:
164+
However, instead of manually calling `json_encode`, you may use the `Illuminate\Support\Js::from` method. The `from` method accepts the same arguments as PHP's `json_encode` function; however, it will ensure that the resulting JSON has been properly escaped for inclusion within HTML quotes. The `from` method will return a string `JSON.parse` JavaScript statement that will convert the given object or array into a valid JavaScript object:
165165
166166
```blade
167167
<script>
@@ -1588,7 +1588,7 @@ Prefix "namespaces" may be provided as the second argument to the `anonymousComp
15881588
Blade::anonymousComponentPath(__DIR__.'/../components', 'dashboard');
15891589
```
15901590

1591-
When a prefix is provided, components within that "namespace" may be rendered by prefixing to the component's namespace to the component name when the component is rendered:
1591+
When a prefix is provided, components within that "namespace" may be rendered by prefixing the component's namespace to the component name when the component is rendered:
15921592

15931593
```blade
15941594
<x-dashboard::panel />

original-en/cache.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -533,7 +533,7 @@ Cache::lock('processing')->forceRelease();
533533
<a name="cache-failover"></a>
534534
## Cache Failover
535535

536-
The `failover` cache driver provides automatic failover functionality when interacting with the cache. If the primary cache store fails for any reason, Laravel will automatically attempt to use the next configured store in the list. This is particularly useful for ensuring high availability in production environments where cache reliability is critical.
536+
The `failover` cache driver provides automatic failover functionality when interacting with the cache. If the primary cache store of the `failover` store fails for any reason, Laravel will automatically attempt to use the next configured store in the list. This is particularly useful for ensuring high availability in production environments where cache reliability is critical.
537537

538538
To configure a failover cache store, specify the `failover` driver and provide an array of store names to attempt in order. By default, Laravel includes an example failover configuration in your application's `config/cache.php` configuration file:
539539

@@ -547,7 +547,7 @@ To configure a failover cache store, specify the `failover` driver and provide a
547547
],
548548
```
549549

550-
Once you have configured a store that uses the `failover` driver, you will probably want to set the failover store as your default cache store in your application's `.env` file:
550+
Once you have configured a store that uses the `failover` driver, you will need to set the failover store as your default cache store in your application's `.env` file to make use of the failover functionality:
551551

552552
```ini
553553
CACHE_STORE=failover

original-en/deployment.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@
1111
- [Caching Events](#caching-events)
1212
- [Caching Routes](#optimizing-route-loading)
1313
- [Caching Views](#optimizing-view-loading)
14+
- [Reloading Services](#reloading-services)
1415
- [Debug Mode](#debug-mode)
1516
- [The Health Route](#the-health-route)
1617
- [Deploying With Laravel Cloud or Forge](#deploying-with-cloud-or-forge)
@@ -168,6 +169,20 @@ php artisan view:cache
168169

169170
This command precompiles all your Blade views so they are not compiled on demand, improving the performance of each request that returns a view.
170171

172+
<a name="reloading-services"></a>
173+
## Reloading Services
174+
175+
> [!NOTE]
176+
> When deploying to [Laravel Cloud](https://cloud.laravel.com), it is not necessary to use the `reload` command, as gracefully reloading of all services is handled automatically.
177+
178+
After deploying a new version of your application, any long-running services such as queue workers, Laravel Reverb, or Laravel Octane should be reloaded / restarted to use the new code. Laravel provides a single `reload` Artisan command that will terminate these services:
179+
180+
```shell
181+
php artisan reload
182+
```
183+
184+
If you are not using [Laravel Cloud](https://cloud.laravel.com), you should manually configure a process monitor that can detect when your reloadable processes exit and automatically restart them.
185+
171186
<a name="debug-mode"></a>
172187
## Debug Mode
173188

original-en/helpers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3227,7 +3227,7 @@ For a thorough discussion of Carbon and its features, please consult the [offici
32273227
<a name="interval-functions"></a>
32283228
#### Interval Functions
32293229

3230-
Laravel also offers `seconds`, `minutes`, `hours`, `days`, and `years` functions that return `CarbonInterval` instances, which extend PHP's [DateInterval](https://www.php.net/manual/en/class.dateinterval.php) class. These functions may be used anywhere that Laravel accepts a `DateInterval` instance:
3230+
Laravel also offers `milliseconds`, `seconds`, `minutes`, `hours`, `days`, `weeks`, `months`, and `years` functions that return `CarbonInterval` instances, which extend PHP's [DateInterval](https://www.php.net/manual/en/class.dateinterval.php) class. These functions may be used anywhere that Laravel accepts a `DateInterval` instance:
32313231

32323232
```php
32333233
use Illuminate\Support\Facades\Cache;

original-en/horizon.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ When using Horizon, all of your queue worker configuration is stored in a single
3737
## Installation
3838

3939
> [!WARNING]
40-
> Laravel Horizon requires that you use [Redis](https://redis.io) to power your queue. Therefore, you should ensure that your queue connection is set to `redis` in your application's `config/queue.php` configuration file.
40+
> Laravel Horizon requires that you use [Redis](https://redis.io) to power your queue. Therefore, you should ensure that your queue connection is set to `redis` in your application's `config/queue.php` configuration file. Horizon is not compatible with Redis Cluster at this time.
4141
4242
You may install Horizon into your project using the Composer package manager:
4343

original-en/mail.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -231,10 +231,10 @@ To accomplish this, you should define a mailer within your application's `mail`
231231
],
232232
```
233233

234-
Once your failover mailer has been defined, you should set this mailer as the default mailer used by your application by specifying its name as the value of the `default` configuration key within your application's `mail` configuration file:
234+
Once you have configured a mailer that uses the `failover` transport, you will need to set the failover mailer as your default mailer in your application's `.env` file to make use of the failover functionality:
235235

236-
```php
237-
'default' => env('MAIL_MAILER', 'failover'),
236+
```ini
237+
MAIL_MAILER=failover
238238
```
239239

240240
<a name="round-robin-configuration"></a>

0 commit comments

Comments
 (0)