2025-01-20までの原文変更点反映。

Author: HiroKws

Diff for: original-en/cashier-paddle.md

@@ -558,7 +558,7 @@ Sometimes, you may need to create a checkout session for users that do not need
     use Laravel\Paddle\Checkout;
 
     Route::get('/buy', function (Request $request) {
-        $checkout = Checkout::guest('pri_34567')
+        $checkout = Checkout::guest(['pri_34567'])
             ->returnTo(route('home'));
 
         return view('billing', ['checkout' => $checkout]);

Diff for: original-en/controllers.md

@@ -152,6 +152,9 @@ You may also define controller middleware as closures, which provides a convenie
         ];
     }
 
+> [!WARNING]  
+> Controllers implementing `Illuminate\Routing\Controllers\HasMiddleware` should not extend `Illuminate\Routing\Controller`.
+
 <a name="resource-controllers"></a>
 ## Resource Controllers
 

Diff for: original-en/eloquent.md

@@ -923,10 +923,6 @@ To delete a model, you may call the `delete` method on the model instance:
 
     $flight->delete();
 
-You may call the `truncate` method to delete all of the model's associated database records. The `truncate` operation will also reset any auto-incrementing IDs on the model's associated table:
-
-    Flight::truncate();
-
 <a name="deleting-an-existing-model-by-its-primary-key"></a>
 #### Deleting an Existing Model by its Primary Key
 
@@ -954,6 +950,10 @@ Of course, you may build an Eloquent query to delete all models matching your qu
 
     $deleted = Flight::where('active', 0)->delete();
 
+To delete all models in a table, you should execute a query without adding any conditions:
+
+    $deleted = Flight::query()->delete();
+
 > [!WARNING]  
 > When executing a mass delete statement via Eloquent, the `deleting` and `deleted` model events will not be dispatched for the deleted models. This is because the models are never actually retrieved when executing the delete statement.
 

Diff for: original-en/filesystem.md

@@ -203,7 +203,7 @@ Next, you may include the `read-only` configuration option in one or more of you
 <a name="amazon-s3-compatible-filesystems"></a>
 ### Amazon S3 Compatible Filesystems
 
-By default, your application's `filesystems` configuration file contains a disk configuration for the `s3` disk. In addition to using this disk to interact with Amazon S3, you may use it to interact with any S3 compatible file storage service such as [MinIO](https://github.com/minio/minio) or [DigitalOcean Spaces](https://www.digitalocean.com/products/spaces/).
+By default, your application's `filesystems` configuration file contains a disk configuration for the `s3` disk. In addition to using this disk to interact with [Amazon S3](https://aws.amazon.com/s3/), you may use it to interact with any S3-compatible file storage service such as [MinIO](https://github.com/minio/minio), [DigitalOcean Spaces](https://www.digitalocean.com/products/spaces/), [Akamai / Linode Object Storage](https://www.linode.com/products/object-storage/), [Vultr Object Storage](https://www.vultr.com/products/object-storage/), or [Hetzner Cloud Storage](https://www.hetzner.com/storage/object-storage/).
 
 Typically, after updating the disk's credentials to match the credentials of the service you are planning to use, you only need to update the value of the `endpoint` configuration option. This option's value is typically defined via the `AWS_ENDPOINT` environment variable:
 

Diff for: original-en/pint.md

@@ -55,6 +55,12 @@ If you would like Pint to simply inspect your code for style errors without actu
 ./vendor/bin/pint --test
 ```
 
+If you would like Pint to only modify the files that differ from the provided branch according to Git, you may use the `--diff=[branch]` option. This can be effectively used in your CI environment (like GitHub actions) to save time by only inspecting new or modified files:
+
+```shell
+./vendor/bin/pint --diff=main
+```
+
 If you would like Pint to only modify the files that have uncommitted changes according to Git, you may use the `--dirty` option:
 
 ```shell

Diff for: original-en/queries.md

@@ -1165,15 +1165,6 @@ The query builder's `delete` method may be used to delete records from the table
 
     $deleted = DB::table('users')->where('votes', '>', 100)->delete();
 
-If you wish to truncate an entire table, which will remove all records from the table and reset the auto-incrementing ID to zero, you may use the `truncate` method:
-
-    DB::table('users')->truncate();
-
-<a name="table-truncation-and-postgresql"></a>
-#### Table Truncation and PostgreSQL
-
-When truncating a PostgreSQL database, the `CASCADE` behavior will be applied. This means that all foreign key related records in other tables will be deleted as well.
-
 <a name="pessimistic-locking"></a>
 ## Pessimistic Locking
 
@@ -1191,6 +1182,34 @@ Alternatively, you may use the `lockForUpdate` method. A "for update" lock preve
             ->lockForUpdate()
             ->get();
 
+While not obligatory, it is recommended to wrap pessimistic locks within a [transaction](/docs/{{version}}/database#database-transactions). This ensures that the data retrieved remains unaltered in the database until the entire operation completes. In case of a failure, the transaction will roll back any changes and release the locks automatically:
+
+    DB::transaction(function () {
+        $sender = DB::table('users')
+            ->lockForUpdate()
+            ->find(1);
+
+        $receiver = DB::table('users')
+            ->lockForUpdate();
+            ->find(2);
+
+        if ($sender->balance < 100) {
+            throw new RuntimeException('Balance too low.');
+        }
+        
+        DB::table('users')
+            ->where('id', $sender->id)
+            ->update([
+                'balance' => $sender->balance - 100
+            ]);
+
+        DB::table('users')
+            ->where('id', $receiver->id)
+            ->update([
+                'balance' => $receiver->balance + 100
+            ]);
+    });
+
 <a name="debugging"></a>
 ## Debugging
 

Diff for: original-en/redis.md

@@ -125,7 +125,7 @@ If your application is utilizing a cluster of Redis servers, you should define t
 
 By default, Laravel will use native Redis clustering since the `options.cluster` configuration value is set to `redis`. Redis clustering is a great default option, as it gracefully handles failover.
 
-Laravel also supports client-side sharding. However, client-side sharding does not handle failover; therefore, it is primarily suited for transient cached data that is available from another primary data store.
+Laravel also supports client-side sharding when using Predis. However, client-side sharding does not handle failover; therefore, it is primarily suited for transient cached data that is available from another primary data store.
 
 If you would like to use client-side sharding instead of native Redis clustering, you may remove the `options.cluster` configuration value within your application's `config/database.php` configuration file:
 
@@ -176,7 +176,7 @@ By default, Laravel will use the PhpRedis extension to communicate with Redis. T
         // ...
     ],
 
-In addition to the default configuration options, PhpRedis supports the following additional connection parameters: `name`, `persistent`, `persistent_id`, `prefix`, `read_timeout`, `retry_interval`, `timeout`, and `context`. You may add any of these options to your Redis server configuration in the `config/database.php` configuration file:
+In addition to the default configuration options, PhpRedis supports the following additional connection parameters: `name`, `persistent`, `persistent_id`, `prefix`, `read_timeout`, `retry_interval`, `max_retries`, `backoff_algorithm`, `backoff_base`, `backoff_cap`, `timeout`, and `context`. You may add any of these options to your Redis server configuration in the `config/database.php` configuration file:
 
     'default' => [
         'url' => env('REDIS_URL'),

Diff for: original-en/validation.md

@@ -1226,16 +1226,30 @@ The example above will apply the `RFCValidation` and `DNSCheckValidation` valida
 
 <div class="content-list" markdown="1">
 
-- `rfc`: `RFCValidation`
-- `strict`: `NoRFCWarningsValidation`
-- `dns`: `DNSCheckValidation`
-- `spoof`: `SpoofCheckValidation`
-- `filter`: `FilterEmailValidation`
-- `filter_unicode`: `FilterEmailValidation::unicode()`
+- `rfc`: `RFCValidation` - Validate the email address according to RFC 5322.
+- `strict`: `NoRFCWarningsValidation` - Validate the email according to RFC 5322, rejecting trailing periods or multiple consecutive periods.
+- `dns`: `DNSCheckValidation` - Ensure the email address's domain has a valid MX record.
+- `spoof`: `SpoofCheckValidation` - Ensure the email address does not contain homograph or deceptive Unicode characters.
+- `filter`: `FilterEmailValidation` - Ensure the email address is valid according to PHP's `filter_var` function.
+- `filter_unicode`: `FilterEmailValidation::unicode()` - Ensure the email address is valid according to PHP's `filter_var` function, allowing some Unicode characters.
 
 </div>
 
-The `filter` validator, which uses PHP's `filter_var` function, ships with Laravel and was Laravel's default email validation behavior prior to Laravel version 5.8.
+For convenience, email validation rules may be built using the fluent rule builder:
+
+```php
+use Illuminate\Validation\Rule;
+
+$request->validate([
+    'email' => [
+        'required',
+        Rule::email()
+            ->rfcCompliant(strict: false)
+            ->validateMxRecord()
+            ->preventSpoofing()
+    ],
+]);
+```
 
 > [!WARNING]  
 > The `dns` and `spoof` validators require the PHP `intl` extension.

Diff for: translation-ja/cashier-paddle.md

@@ -558,7 +558,7 @@ Sometimes, you may need to create a checkout session for users that do not need
     use Laravel\Paddle\Checkout;
 
     Route::get('/buy', function (Request $request) {
-        $checkout = Checkout::guest('pri_34567')
+        $checkout = Checkout::guest(['pri_34567'])
             ->returnTo(route('home'));
 
         return view('billing', ['checkout' => $checkout]);

Diff for: translation-ja/controllers.md

@@ -152,6 +152,9 @@ php artisan make:controller ProvisionServer --invokable
         ];
     }
 
+> [!WARNING]
+> `Illuminate\Routing\Controllers\HasMiddleware'を実装するコントローラは、`Illuminate\Routing\Controller`を継承してはいけません。
+
 <a name="resource-controllers"></a>
 ## リソースコントローラ
 

Diff for: translation-ja/eloquent.md

@@ -923,10 +923,6 @@ Eloquentの`upsert`メソッドを使用すると、単一で極小の操作で
 
     $flight->delete();
 
-モデルに関連しているすべてのデータベースレコードを削除するには、`truncate`メソッドを呼びだせます。`truncate`操作は、モデルの関連テーブルの自動増分IDをリセットします。
-
-    Flight::truncate();
-
 <a name="deleting-an-existing-model-by-its-primary-key"></a>
 #### 主キーによる既存のモデルの削除
 
@@ -954,6 +950,10 @@ Eloquentの`upsert`メソッドを使用すると、単一で極小の操作で
 
     $deleted = Flight::where('active', 0)->delete();
 
+テーブル内のすべてのモデルを削除するには、条件を追加せずにクエリを実行する必要があります。
+
+    $deleted = Flight::query()->delete();
+
 > [!WARNING]
 > Eloquentを介して一括削除ステートメントを実行すると、削除されたモデルに対して`deleting`および`deleted`モデルイベントがディスパッチされません。これは、deleteステートメントの実行時にモデルが実際には取得されないためです。
 

Diff for: translation-ja/filesystem.md

@@ -203,7 +203,7 @@ composer require league/flysystem-read-only "^3.0"
 <a name="amazon-s3-compatible-filesystems"></a>
 ### Amazon S3互換ファイルシステム
 
-アプリケーションの`filesystems`設定ファイルはデフォルトで、`s3`ディスクのディスク設定を含んでいます。このディスクはAmazon S3の操作に加え、[MinIO](https://github.com/minio/minio)や[DigitalOcean Spaces](https://www.digitalocean.com/products/spaces/)など、S3と互換性のあるファイルストレージサービスの操作にも使用できます。
+アプリケーションの`filesystems`設定ファイルには、デフォルトで`s3`のディスク設定がしてあります。このディスクを使用して[Amazon S3](https://aws.amazon.com/s3/)を操作するだけでなく、[MinIO](https://github.com/minio/minio)、[DigitalOcean Spaces](https://www.digitalocean.com/products/spaces/)、[Akamai/Linode Object Storage](https://www.linode.com/products/object-storage/)、[Vultr Object Storage](https://www.vultr.com/products/object-storage/)、[Hetzner Cloud Storage](https://www.hetzner.com/storage/object-storage/)など、S3互換のファイルストレージサービスを操作することもできます。
 
 通常、ディスクの認証情報を使用予定のサービス認証情報へ合わせて更新した後に、`endpoint`設定オプションの値を更新するだけで済みます。このオプションの値は通常、`AWS_ENDPOINT`環境変数で定義されています。
 

Diff for: translation-ja/pint.md

@@ -55,6 +55,12 @@ Pintは更新した全ファイルの完全なリストを表示します。Pint
 ./vendor/bin/pint --test
 ```
 
+Gitで指定したブランチと比較して、異なるファイルのみをPintで修正したい場合は、`--diff=[branch]`オプションを使用します。これはCI環境（GitHub actionsなど）で効果的に使用でき、新規または変更されたファイルのみを調べることで時間を節約できます。
+
+```shell
+./vendor/bin/pint --diff=main
+```
+
 もし、Gitへコミットされていない変更のあるファイルだけをPintに修正させたい場合は、`--dirty` オプションを使用します。
 
 ```shell

Diff for: translation-ja/queries.md

@@ -1165,15 +1165,6 @@ JSONカラムを更新する場合は、JSONオブジェクトの適切なキー
 
     $deleted = DB::table('users')->where('votes', '>', 100)->delete();
 
-テーブル全体を切り捨てて、テーブルからすべてのレコードを削除し、自動増分IDをゼロにリセットする場合は、`truncate`メソッドを使用します。
-
-    DB::table('users')->truncate();
-
-<a name="table-truncation-and-postgresql"></a>
-#### テーブルのトランケーションとPostgreSQL
-
-PostgreSQLデータベースを切り捨てる場合、`CASCADE`動作が適用されます。これは、他のテーブルのすべての外部キー関連レコードも削除されることを意味します。
-
 <a name="pessimistic-locking"></a>
 ## 悲観的ロック
 
@@ -1191,6 +1182,34 @@ PostgreSQLデータベースを切り捨てる場合、`CASCADE`動作が適用
             ->lockForUpdate()
             ->get();
 
+義務ではありませんが、悲観的ロックは[トランザクション](/docs/{{version}}/database#database-transactions)の中へラップすることを推奨します。これにより、操作全体が完了するまで、取得したデータがデータベース内で変更されないことが保証されます。失敗した場合、トランザクションは変更をロールバックし、ロックを自動的に解放します。
+
+    DB::transaction(function () {
+        $sender = DB::table('users')
+            ->lockForUpdate()
+            ->find(1);
+
+        $receiver = DB::table('users')
+            ->lockForUpdate();
+            ->find(2);
+
+        if ($sender->balance < 100) {
+            throw new RuntimeException('Balance too low.');
+        }
+
+        DB::table('users')
+            ->where('id', $sender->id)
+            ->update([
+                'balance' => $sender->balance - 100
+            ]);
+
+        DB::table('users')
+            ->where('id', $receiver->id)
+            ->update([
+                'balance' => $receiver->balance + 100
+            ]);
+    });
+
 <a name="debugging"></a>
 ## デバッグ
 

Diff for: translation-ja/redis.md

@@ -125,7 +125,7 @@ RedisクライアントはRedisサーバへ接続するとき、デフォルト
 
 `options.cluster`の設定値が`redis`に設定されているため、Laravelはデフォルトで、ネイティブのRedisクラスタリングを使用します。Redisクラスタリングは丁寧にフェイルオーバーを処理するので、素晴らしいデフォルトオプションです。
 
-Laravelはクライアントサイドシャーディングもサポートしています。しかし、クライアントサイドシャーディングはフェイルオーバーを処理しません。そのため、主に別のプライマリデータストアから利用可能な一時的なキャッシュデータに適しています。
+Predisを使用する場合、Laravelはクライアントサイドシャーディングもサポートしています。しかし、クライアントサイドシャーディングはフェイルオーバーを処理しません。そのため、主に別のプライマリデータストアから利用可能な一時的なキャッシュデータに適しています。
 
 ネイティブのRedisクラスタリングではなく、クライアントサイドのシャーディングを使用したい場合は、アプリケーションの`config/database.php`設定ファイル内の`options.cluster`設定値を削除してください。
 
@@ -176,7 +176,7 @@ Laravelはクライアントサイドシャーディングもサポートして
         // ...
     ],
 
-デフォルトの設定オプションに加えて、PhpRedisは`name`、`persistent`、`persistent_id`、`prefix`、`read_timeout`、`retry_interval`、`timeout`、`context`の追加接続パラメータをサポートしています。これらのオプションは、`config/database.php`設定ファイルのRedisサーバ設定へ追加してください。
+デフォルトの設定オプションに加えて、PhpRedisは`name`、`persistent`、`persistent_id`、`prefix`、`read_timeout`、`retry_interval`、`max_retries`、`backoff_algorithm`、`backoff_base`、`backoff_cap`,`timeout`、`context`の追加接続パラメータをサポートしています。これらのオプションは、`config/database.php`設定ファイルのRedisサーバ設定へ追加してください。
 
     'default' => [
         'url' => env('REDIS_URL'),

Diff for: translation-ja/validation.md

@@ -1226,16 +1226,30 @@ distinctはデフォルトで緩い比較を使用します。厳密な比較を
 
 <div class="content-list" markdown="1">
 
-- `rfc`: `RFCValidation`
-- `strict`: `NoRFCWarningsValidation`
-- `dns`: `DNSCheckValidation`
-- `spoof`: `SpoofCheckValidation`
-- `filter`: `FilterEmailValidation`
-- `filter_unicode`: `FilterEmailValidation::unicode()`
+- `rfc`: `RFCValidation` - RFC 5322に従い、メールアドレスをバリデーションする。
+- `strict`: `NoRFCWarningsValidation` - RFC 5322に従い、メールアドレスをバリデーションするが、末尾のピリオドや連続するピリオドは拒絶する。
+- `dns`: `DNSCheckValidation` - メールアドレスのドメインに、有効なMXレコードがあることを確認する。
+- `spoof`: `SpoofCheckValidation` - メールアドレスにホモグラフや偽のUnicode文字が含まれていないことを確認する。
+- `filter`: `FilterEmailValidation` - PHPの`filter_var`関数に従い、メールアドレスが有効であることを確認する。
+- `filter_unicode`: `FilterEmailValidation::unicode()` - メールアドレスがPHPのfilter_var関数に従い、メールアドレスが有効であることを確認し、一部のUnicode文字を許可します。
 
 </div>
 
-PHPの`filter_var`関数を使用する`filter`バリデータは、Laravelに付属しており、Laravelバージョン5.8より前のLaravelのデフォルトの電子メールバリデーション動作でした。
+使い勝手が良いように、メールバリデーションルールは、fluentルールビルダを使って作成できます。
+
+```php
+use Illuminate\Validation\Rule;
+
+$request->validate([
+    'email' => [
+        'required',
+        Rule::email()
+            ->rfcCompliant(strict: false)
+            ->validateMxRecord()
+            ->preventSpoofing()
+    ],
+]);
+```
 
 > [!WARNING]
 > `dns`および`spoof`バリデータには、PHPの`intl`拡張が必要です。