如何在Docker环境中安装WordPress基础主题？求underscores.me部署方案

Hey there! I’ve set up and worked with underscores.me themes in Docker environments plenty of times, so let me share the practical steps and tips to get yours up and running without headaches:

Core Docker Setup First #

Start with a solid docker-compose.yml configuration that properly mounts your local WordPress files (including your underscores theme) into the container. Here’s a minimal, working example:

version: '3.8'
services:
  db:
    image: mysql:8.0
    volumes:
      - db_data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: your_root_password
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress_password

  wordpress:
    depends_on:
      - db
    image: wordpress:latest
    volumes:
      # Mount your local wp-content directory to the container
      - ./wp-content:/var/www/html/wp-content
    ports:
      - "8000:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress_password
      WORDPRESS_DB_NAME: wordpress
    # Optional: Match container user to your local user to avoid permission issues
    user: "${UID}:${GID}"

Properly Mount Your underscores.me Theme #

1. Download your custom underscores theme from underscores.me (fill in your theme name, slug, etc.) and unzip it into your local wp-content/themes directory.
2. Double-check that the theme folder name matches what’s in your wp-content/themes directory—this is crucial for WordPress to detect it.

Fix Permission Headaches (Common Pitfall!) #

Docker containers run WordPress as the www-data user by default, which can cause permission errors when your local user owns the theme files. Two easy fixes:

• Option 1: Add the user: "${UID}:${GID}" line to your WordPress service in docker-compose.yml (like in the example above). This makes the container use your local user’s UID/GID, so file permissions stay in sync.
• Option 2: If you skip the above, adjust local permissions manually:

  chown -R www-data:www-data ./wp-content/themes/your-underscores-theme-slug
  

Activate the Theme #

Once your containers are up (docker-compose up -d):

1. Visit http://localhost:8000/wp-admin and log into your WordPress dashboard.
2. Go to Appearance > Themes—you should see your underscores theme listed. Click "Activate".
3. If the theme doesn’t show up:
   • Verify your volume mount in docker-compose.yml points to the correct local wp-content directory.
   • Check that the theme folder has the right permissions (no read errors).

Development & Debugging Tips #

• Use WP-CLI for quick actions: Skip the dashboard and activate the theme via the command line:

  docker exec -it your-wordpress-container-name wp theme activate your-theme-slug
  

  (Replace your-wordpress-container-name with the name from docker-compose ps)
• Enable debug mode: Add this to your local wp-config.php (mounted into the container) to catch theme-related errors:

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', true);
  

• Live reloading: For CSS/JS development, use tools like BrowserSync alongside Docker—just point it to localhost:8000 and watch your theme’s assets folder for changes.

Quick Troubleshooting #

• If the theme looks broken after activation: Double-check that underscores’ default files (like style.css, index.php) are intact—don’t delete core theme files unless you know what you’re doing.
• Database connection issues: Make sure the WORDPRESS_DB_* environment variables in docker-compose.yml match the MySQL service’s settings.

内容的提问来源于stack exchange，提问作者klewis