From cf8518bef751776efee1dcaed0fc65aa9f708467 Mon Sep 17 00:00:00 2001 From: peaklabs-dev <122374094+peaklabs-dev@users.noreply.github.com> Date: Thu, 4 Dec 2025 19:10:19 +0100 Subject: [PATCH 1/3] docs: update cache and queues failover setup --- cache.md | 4 ++-- queues.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/cache.md b/cache.md index c6de8be83c..5b8daf6a3a 100644 --- a/cache.md +++ b/cache.md @@ -533,7 +533,7 @@ Cache::lock('processing')->forceRelease(); ## Cache Failover -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. +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. 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: @@ -547,7 +547,7 @@ To configure a failover cache store, specify the `failover` driver and provide a ], ``` -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: +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: ```ini CACHE_STORE=failover diff --git a/queues.md b/queues.md index f54125d59e..0093adf5da 100644 --- a/queues.md +++ b/queues.md @@ -1529,7 +1529,7 @@ $user->notify($invoicePaid); ### Queue Failover -The `failover` queue driver provides automatic failover functionality when pushing jobs to the queue. If the primary queue connection fails for any reason, Laravel will automatically attempt to push the job to the next configured connection in the list. This is particularly useful for ensuring high availability in production environments where queue reliability is critical. +The `failover` queue driver provides automatic failover functionality when pushing jobs to the queue. If the primary queue connection of the `failover` store fails for any reason, Laravel will automatically attempt to push the job to the next configured connection in the list. This is particularly useful for ensuring high availability in production environments where queue reliability is critical. To configure a failover queue connection, specify the `failover` driver and provide an array of connection names to attempt in order. By default, Laravel includes an example failover configuration in your application's `config/queue.php` configuration file: @@ -1544,7 +1544,7 @@ To configure a failover queue connection, specify the `failover` driver and prov ], ``` -Once you have configured a connection that uses the `failover` driver, you will probably want to set the failover connection as your default queue connection in your application's `.env` file: +Once you have configured a connection that uses the `failover` driver, you will need to set the failover connection as your default queue connection in your application's `.env` file to make use of the failover functionality: ```ini QUEUE_CONNECTION=failover From fa2371b828757b48e1cd50f78427f2b1051e5560 Mon Sep 17 00:00:00 2001 From: peaklabs-dev <122374094+peaklabs-dev@users.noreply.github.com> Date: Thu, 4 Dec 2025 19:10:36 +0100 Subject: [PATCH 2/3] docs: improve mail failover docs --- mail.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/mail.md b/mail.md index 083171c0f7..5c992c0b23 100644 --- a/mail.md +++ b/mail.md @@ -231,10 +231,10 @@ To accomplish this, you should define a mailer within your application's `mail` ], ``` -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: +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: -```php -'default' => env('MAIL_MAILER', 'failover'), +```ini +MAIL_MAILER=failover ``` From 7e5f780e1fa2db6b8a17557fb90d3e10e32798d3 Mon Sep 17 00:00:00 2001 From: Taylor Otwell Date: Thu, 4 Dec 2025 10:44:05 -0800 Subject: [PATCH 3/3] Update queues.md --- queues.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/queues.md b/queues.md index 0093adf5da..940e4502da 100644 --- a/queues.md +++ b/queues.md @@ -1529,7 +1529,7 @@ $user->notify($invoicePaid); ### Queue Failover -The `failover` queue driver provides automatic failover functionality when pushing jobs to the queue. If the primary queue connection of the `failover` store fails for any reason, Laravel will automatically attempt to push the job to the next configured connection in the list. This is particularly useful for ensuring high availability in production environments where queue reliability is critical. +The `failover` queue driver provides automatic failover functionality when pushing jobs to the queue. If the primary queue connection of the `failover` configuration fails for any reason, Laravel will automatically attempt to push the job to the next configured connection in the list. This is particularly useful for ensuring high availability in production environments where queue reliability is critical. To configure a failover queue connection, specify the `failover` driver and provide an array of connection names to attempt in order. By default, Laravel includes an example failover configuration in your application's `config/queue.php` configuration file: