From a984afb7bdeb4a94c13fc78644c67b865f7262b0 Mon Sep 17 00:00:00 2001 From: Joe Ferguson Date: Thu, 8 Apr 2021 16:20:23 -0700 Subject: [PATCH] Adjust WP-CLI docs for our customized `wp-config.php` --- wordpress/variant-cli.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/wordpress/variant-cli.md b/wordpress/variant-cli.md index 6e4d2933b2ba..b27341d01b49 100644 --- a/wordpress/variant-cli.md +++ b/wordpress/variant-cli.md @@ -8,7 +8,12 @@ The simplest way to use it with an existing WordPress container would be somethi $ docker run -it --rm \ --volumes-from some-wordpress \ --network container:some-wordpress \ - wordpress:cli user list + -e WORDPRESS_DB_USER=... \ + -e WORDPRESS_DB_PASSWORD=... \ + # [and other used environment variables] + %%IMAGE%%:cli user list ``` Generally speaking, for WP-CLI to interact with a WordPress install, it needs access to the on-disk files of the WordPress install, and access to the database (and the easiest way to accomplish that such that `wp-config.php` does not require changes is to simply join the networking context of the existing and presumably working WordPress container, but there are many other ways to accomplish that which will be left as an exercise for the reader). + +**NOTE:** Since March 2021, WordPress images use a customized `wp-config.php` that pulls the values directly from the environment variables defined above (see `wp-config-docker.php` in [docker-library/wordpress#572](https://github.com/docker-library/wordpress/pull/572) and [docker-library/wordpress#577](https://github.com/docker-library/wordpress/pull/577)). As a result of reading environment variables directly, the cli container also needs the same set of environment variables to properly evaluate `wp-config.php`.