Open
Description
This issue proposes adding a new troubleshooting section and a corresponding example to the Blueprints documentation to address an issue found by @jonathanbossenger and solved by @bgrgicak when he was running WP-CLI commands on mounted WordPress Playground sites.
Problem
Users attempting to run wp-cli commands (e.g., wp plugin list) on a WordPress Playground instance that uses --mount-before-install often encounter an "Error establishing a database connection." It occurs because the SQLite database integration plugin, which Playground typically loads internally, isn't persisted in the mounted directory.
Proposed Changes
Add a new subsection to /blueprints/troubleshoot-and-debug
and a new example to /blueprints/examples
:
- Section Title: WP-CLI: Error Establishing a Database Connection on Mounted Sites: Explain the problem and provide the Blueprint solution (installing, copying
db.php
, and activating thesqlite-database-integration plugin
). Include a full Blueprint example and CLI command to demonstrate. - Section Title: Running WP-CLI on Mounted Sites: A concise Blueprint example showing the steps to enable
wp-cli
on mounted sites, with a link to the detailed explanation in the troubleshooting section.