docker-php-fpm-apache-phpmyadmin-mariadb

Docker environment with WordPress, PHP-FPM, Apache, phpMyAdmin and MariaDB

Use it to develop your plugin or to have a LAMP stack to test some code.

Feel free to use as you wish.

Setup

1. Clone the repository on your local machine or WSL.

2. Generate self-signed SSL certificates with mkcert.

   1. Run: docker run -ti --rm -v "$(pwd):/certs" alpine/mkcert -cert-file /certs/wordpress.local.pem -key-file /certs/wordpress.local.key.pem wordpress.local localhost 127.0.0.1 ::1
      1. Filename for the key must be wordpress.local.key.pem.
      2. Filename for the cert must be wordpress.local.pem.
      3. Otherwise, you'll need to change the 000-default.conf.

3. Trust the certificate in the host machine.

   1. On Mac,
      1. Press Cmd + Space and type Keychain Access, then hit Enter to open it.
      2. Drag and drop the .pem certificate file into the Keychain Access window.
      3. Double click the dropped file and trust it with "Always Trust".
   2. On Windows, double click the certificate file and install it.

4. Move the generated .pem to the path /.docker/wordpress/apache/certs

5. Run docker compose up --build -d

6. Lastly, you'll need to add 127.0.0.1 wordpress.local to your operating system's hosts file. See this tutorial to learn how to access them for Linux and Windows. Usually its sudo nano /etc/hosts.

   1. In Windows, add the two following lines. For Linux, just the first one:

      127.0.0.1 wordpress.local
      ::1 wordpress.local
      

7. Open wordpress.local in your browser.

8. Open localhost:8080 to access phpMyAdmin in your browser.

Command to run in wp-plugins for both host user and Docker be allowed to edit the files/folders:

sudo chgrp -R www-data wp-plugins/
sudo find wp-plugins/ -type d -exec chmod 0775 {} \;
sudo find wp-plugins/ -type f -exec chmod 0775 {} \;

About the folders

• mariadb - stores the mariadb data. So, you can run docker compose down and the database will still be safe here. You may delete /mariadb/data/* manually to reset the database.
• /wordpress - stores settings for the WP service.
• /wp-logs - stores the Apache logs from the WP service.
• /wp-plugins - it's where you put your plugins. Also, any plugins installed from WordPress will be present here.
• /wp-themes - it's where you put your themes. Themes intalled from WordPress will be present here too.

Reference

• ./.docker/wordpress/php/php.ini: https://github.com/php/php-src/blob/master/php.ini-development

Docker images used

• https://hub.docker.com/_/wordpress
• https://hub.docker.com/_/mariadb
• https://hub.docker.com/_/phpmyadmin