Home

LudicrousDB

LudicrousDB is an advanced database interface for WordPress. It supports replication-aware routing, failover, load balancing, and partitioning, and is based on Automattic's HyperDB drop-in.

LudicrousDB is infrastructure, not a database migration or replication tool. It decides which configured database should receive a query. It does not create databases, move tables, copy rows, or configure MySQL replication.

Start here

• Installation
• Configuration
• Primary and replica databases
• Network topology
• Replication lag
• Partitioning recipes
• Troubleshooting
• Frequently asked questions
• Support and security

Compatibility

The current release requires PHP 7.4 or newer and WordPress 6.4 or newer. Test configuration changes in staging before applying them to production, especially when changing write routing, failover, or multisite partitioning.

Capabilities

• Connect to an arbitrary number of database servers.
• Route queries by table, dataset, callback, and read/write priority.
• Prefer nearby or otherwise advantageous connections.
• Keep reads on a primary after writes when consistency requires it.
• Account for replica lag through application-provided callbacks.

LudicrousDB was originally forked from HyperDB. HyperDB's original contributors include matt, andy, ryan, mdawaffe, vnsavage, and Automattic.