Change default localhost port to 9412

* Avoid use of the privileged port 80, because it tends to require
  extra rights, but also because it may be in use already in a way
  that's harder to turn off. Ports like 4000 are more often used via
  ad-hoc CLI procesess and presumably easier to turn off. For now
  pick an uncommon port number, to likely not even need to do that.

* Remove the step to create `.env` by setting the root password
  explicitly in docker-compose.yml.

* Remove support for SSL. Even with the new JQUERY_STAGING_FORMAT
  configuration, a site can still only have one canonical name
  in any given environment. One would need two separate installs
  of jquery-wp-docker or some other dynamic complexity, and set
  JQUERY_STAGING_FORMAT to :9412 for HTTP and e.g. :9413 for HTTPS
  to ensure that the canonical redirect goes to the correct destination,
  as well as to create links to other subdomains and pages with that
  same configuration.

  Instead of working on this more, I've removed it for now and
  instead made sure the HTTP version works as good as possible.
  I'm not aware of any HTTPS-specific features or behaviours on
  these sites that would benefit local HTTPS testing. If thre are
  any, we can work on a way to bring this back.

Author: Krinkle

.env.example

@@ -4,8 +4,7 @@ FROM php:8.2-apache
 RUN docker-php-ext-install mysqli && docker-php-ext-enable mysqli
 RUN apt-get update && apt-get upgrade -y
 
-RUN a2enmod ssl && a2enmod rewrite && \
-  mkdir -p /etc/apache2/ssl && \
+RUN a2enmod rewrite && \
   mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
 
 COPY ./WordPress /var/www/html

Dockerfile

@@ -24,47 +24,9 @@ define('SECURE_AUTH_KEY',  'put your unique phrase here');
 // etc.
 ```
 
-4. Copy .env.example to .env and edit the file to define database credentials
+4. Run `docker compose up --build` to start the containers.
 
-```sh
-cp .env.example .env
-```
-
-5. Optionally, add local SSL certs to the `ssl` directory.
-
-   * If you don't have any, you can generate them using [mkcert](https://github.com/FiloSottile/mkcert).
-     Run the following:
-
-     ```sh
-     mkcert -install
-     ```
-
-   * Then, in the `ssl` directory, run:
-     ```sh
-     mkcert \
-     local.jquery.com \
-     local.api.jquery.com \
-     local.blog.jquery.com \
-     local.learn.jquery.com \
-     local.releases.jquery.com \
-     local.jqueryui.com \
-     local.api.jqueryui.com \
-     local.blog.jqueryui.com \
-     local.jquerymobile.com \
-     local.api.jquerymobile.com \
-     local.blog.jquerymobile.com \
-     local.jquery.org \
-     local.brand.jquery.org \
-     local.contribute.jquery.org \
-     local.meetings.jquery.org
-     ```
-     Wildcards don't work for multi-level subdomains. Add each site to the list of domains.
-
-   * Rename the created certs to `cert.pem` and `cert-key.pem`.
-
-6. Run `docker compose up --build` to start the containers.
-
-7. Import the database from a production WordPress instance.
+5. Import the database from a production WordPress instance.
 
 ```sh
 # You need SSH admin access to this production server
@@ -82,7 +44,7 @@ scp wp-05.ops.jquery.net:~/wordpress.sql .
 docker exec -i jquerydb mysql -u root -proot < wordpress.sql
 ```
 
-8. Visit http://local.api.jquery.com, or https://local.api.jquery.com if you created certs.
+6. Visit http://local.api.jquery.com:9412.
 
 ## Updating
 
@@ -93,13 +55,39 @@ docker compose down
 docker compose up --build -d
 ```
 
-## Notes
+## Troubleshooting
+
+### Ports
+
+If you already use port 9412 on your host, you can create a `.env` file in this directory and set the following environment variable with a port number of your own choosing:
+
+```
+JQUERY_WP_HTTP_PORT=8080
+```
+
+Note that the MySQL port (JQUERY_WP_MYSQL_PORT=9414) is only exposed for debugging purposes, e.g. to allow you to connect to it from a GUI or some other tool. The webserver container connects to the MySQL container directly and does not use this port.
+
+### DNS
 
-You do not need to configure your `/etc/hosts` file for `local.*` because `jquery.com`'s DNS handles this for you. However, if you plan to work offline, you can use the following rules:
+You do not need to configure your `/etc/hosts` file to define `local.jquery.com`, because we have defined these domains in the production DNS for jquery.com as alias for localhost. However, if you plan to work offline, you can add the following rules:
 
 ```
-127.0.0.1 local.jquery.com local.api.jquery.com local.blog.jquery.com local.releases.jquery.com local.learn.jquery.com local.plugins.jquery.com
-127.0.0.1 local.jqueryui.com local.api.jqueryui.com local.blog.jqueryui.com
-127.0.0.1 local.jquerymobile.com local.api.jquerymobile.com local.blog.jquerymobile.com
-127.0.0.1 local.jquery.org local.brand.jquery.org local.contribute.jquery.org local.events.jquery.org local.meetings.jquery.org
+127.0.0.1 local.jquery.com
+127.0.0.1 local.api.jquery.com
+127.0.0.1 local.blog.jquery.com
+127.0.0.1 local.learn.jquery.com
+127.0.0.1 local.releases.jquery.com
+
+127.0.0.1 local.jqueryui.com
+127.0.0.1 local.api.jqueryui.com
+127.0.0.1 local.blog.jqueryui.com
+
+127.0.0.1 local.jquerymobile.com
+127.0.0.1 local.api.jquerymobile.com
+127.0.0.1 local.blog.jquerymobile.com
+
+127.0.0.1 local.jquery.org
+127.0.0.1 local.brand.jquery.org
+127.0.0.1 local.contribute.jquery.org
+127.0.0.1 local.meetings.jquery.org
 ```

README.md

@@ -12,20 +12,3 @@ ServerName local.jquery.com
 		Allow from all
 	</Directory>
 </VirtualHost>
-
-# <VirtualHost *:443>
-# 	SSLEngine on
-# 	SSLCertificateFile /etc/apache2/ssl/cert.pem
-# 	SSLCertificateKeyFile /etc/apache2/ssl/cert-key.pem
-#
-# 	ServerName local.jquery.com
-# 	ServerAlias *.jquery.com *.jqueryui.com *.jquery.org *.jquerymobile.com
-# 	DocumentRoot /var/www/html
-# 	php_value memory_limit 1024M
-# 	<Directory /var/www/html>
-# 		Options All
-# 		AllowOverride All
-# 		Order allow,deny
-# 		Allow from all
-# 	</Directory>
-# </VirtualHost>

apache/000-default.conf

@@ -7,35 +7,31 @@ services:
       context: .
       dockerfile: Dockerfile
     container_name: jquerysite
-    env_file:
-      - .env
     environment:
       - WORDPRESS_DB_HOST=jquerydb:3306
       - WORDPRESS_DB_USER=root
-      - WORDPRESS_DB_PASSWORD=$MYSQL_ROOT_PASSWORD
+      - WORDPRESS_DB_PASSWORD=root
     volumes:
       - ./jquery-wp-content:/var/www/html/wp-content
       - ./uploads:/var/www/html/wp-content/uploads:rw
       - ./wp-config.php:/var/www/html/wp-config.php
-      - ./ssl:/etc/apache2/ssl
       - ./apache/.htaccess:/var/www/html/.htaccess
       - ./apache/000-default.conf:/etc/apache2/sites-available/000-default.conf
     ports:
-      - "80:80"
-      - "443:443"
+      - "${JQUERY_WP_HTTP_PORT:-9412}:80"
     networks:
       - jquerynet
 
   jquerydb:
     image: mariadb:10.11
     container_name: jquerydb
     restart: unless-stopped
-    env_file:
-      - .env
+    environment:
+      - MYSQL_ROOT_PASSWORD=root
     volumes:
       - jquerydbdata:/var/lib/mysql
     ports:
-      - "3306:3306"
+      - "${JQUERY_WP_MYSQL_PORT:-9414}:3306"
     networks:
       - jquerynet
 

docker-compose.yml

@@ -8,10 +8,9 @@
  */
 
 define( 'JQUERY_STAGING', true );
-define( 'JQUERY_STAGING_PREFIX', 'local.' );
-$live_site = preg_replace( '/:\d+$/', '', strtolower( $_SERVER['HTTP_HOST'] ?? 'jquery.com' ) );
-$live_site = strtr( $live_site, [ JQUERY_STAGING_PREFIX => '' ] );
-define( 'JQUERY_LIVE_SITE', $live_site );
+define( 'JQUERY_STAGING_FORMAT', 'local.%s:9412' );
+require_once __DIR__ . '/wp-content/sites.php' ;
+define( 'JQUERY_LIVE_SITE', jquery_site_extract( $_SERVER['HTTP_HOST'] ?? 'jquery.com' ) );
 
 // WordPress debugging mode (enables PHP E_NOTICE and WordPress notices)
 define( 'WP_DEBUG', (bool) JQUERY_STAGING );