Jose Jimenez
Jose Jimenez
Software Architect & Developer
> >

Boosting Database Efficiency in Laravel: Master/Slave Setup and Replicated Reporting

Published in Database, Laravel, PHP on Oct 30, 2023

Configuring Read and Write Database in Laravel

When developing a Laravel application, configuring the database for read and write operations is crucial for maintaining performance and ensuring smooth transaction processing. In this article, we will explain how to set up a master/slave configuration for your database in Laravel and also discuss the benefits of adding a separate replicated database for reporting needs.

Configuring Master/Slave Setup

To configure the master/slave setup in Laravel, you need to make changes in the database.php configuration file, example here

This configuration allows you to designate a single database server as the master for write operations and multiple database servers as slaves for read operations. By separating the read and write connections, you can improve performance and distribute the workload efficiently.

Forcing Write Connection

In certain scenarios, it is crucial to ensure that all transactions are executed on the master database to prevent any lag. For example, payment transactions should not be delayed due to replication between master and slave databases. Laravel provides methods to force the write connection. Here are some examples:

1// In models
4// On \DB facade

Alternatively, you can use the following syntax, consistent for both models and the DB facade:


This syntax not only forces the write connection but also allows you to perform reads explicitly, which is not provided by Laravel out of the box:


By utilizing these methods, you gain more control over your database connections and ensure critical transactions are executed without any lag.

Sticky Option - Ensuring Consistency in Connections

In addition to configuring the master/slave setup, Laravel provides a sticky flag in the database.php configuration file to ensure that subsequent queries use the same connection. The sticky option is set to true to enable it. You can follow configuration settings here.

By setting the sticky flag to true, Laravel ensures that subsequent queries initiated within the same request will use the same database connection. This can be useful when you want to maintain data consistency and perform related operations on the same database connection.

Note: The "sticky" option should be used judiciously and only when there is a specific requirement to maintain the same connection for multiple related queries. Overusing the "sticky" option can lead to connection congestion and performance issues.

Separate Replicated Database for Reporting

In addition to configuring the master/slave setup, it is advisable to set up a separate replicated database specifically for reporting needs. Generating large reports or performing heavy read operations on the main database can impact performance. By using a separate database, you can ensure that reporting operations do not affect the functioning of your application.

To configure the separate database, add a new connection in the database.php file. For example, you can add a connection named mysql_reports. Here's an example of how to configure it:

1'mysql_reports' => [
2 'driver' => 'mysql',
3 'host' => env('DB_REPORTS_HOST', 'localhost'),
4 'database' => env('DB_REPORTS_DATABASE', 'reports'),
5 'username' => env('DB_REPORTS_USERNAME', 'root'),
6 'password' => env('DB_REPORTS_PASSWORD', ''),
7 'charset' => 'utf8mb4',
8 'collation' => 'utf8mb4_unicode_ci',
9 'prefix' => '',
10 'strict' => true,

With this new connection set up, you can simply switch to the mysql_reports connection during your reporting needs. Here's how:


By utilizing a separate replicated database for reporting, you can ensure efficient reporting operations without putting unnecessary strain on your main database.


Configuring the database for read and write operations is a crucial aspect of Laravel development. By setting up a master/slave configuration, forcing the write connection for critical transactions, and utilizing a separate replicated database for reporting, you can ensure optimal performance and maintain smooth transaction processing in your Laravel application.

Remember to carefully consider the requirements of your application and choose the appropriate database configuration to meet your needs. By following the guidelines provided in this article, you can enhance the performance and scalability of your Laravel application.

I hope this article helps you understand the importance of configuring your database for read and write operations in Laravel. Happy coding!