Hướng Dẫn Docker Hóa WordPress Cực Đơn Giản Cho Người Mới Bắt Đầu

Lê Lân

13/06/2025

Hướng Dẫn Triển Khai WordPress Với Docker và WP-CLI: Tối Ưu Hiệu Suất và Quản Lý Dễ Dàng

Mở Đầu

Việc thiết lập môi trường WordPress truyền thống thường mất nhiều thời gian và dễ gặp trục trặc do sự khác biệt giữa các hệ thống. Docker và WP-CLI mang đến giải pháp chuẩn hóa, nhanh chóng và linh hoạt cho việc phát triển web.

Trong bài viết này, chúng ta sẽ cùng tìm hiểu cách xây dựng môi trường WordPress dựa trên Docker, tích hợp WP-CLI để quản lý hiệu quả, cũng như hướng dẫn cách cài đặt, cấu hình chi tiết từ thư mục dự án, tệp cấu hình đến vận hành các container. Giúp bạn dễ dàng triển khai, phát triển và mở rộng dự án WordPress theo chuẩn hiện đại.

1. Lợi Ích Khi Docker Hóa WordPress

1.1 Tính Di Động Cao

Docker giúp bạn dễ dàng chuyển đổi môi trường WordPress giữa các máy mà không phải lo ngại về cấu hình hay sự khác biệt phần mềm.

1.2 Đảm Bảo Tính Nhất Quán

Không còn câu nói “trên máy tôi chạy tốt” nữa! Mọi môi trường đều được chuẩn hóa giúp phát triển và vận hành ổn định.

1.3 Triển Khai Nhanh Chóng

Có thể khởi động hoặc tạm dừng container chỉ với một vài lệnh, tiết kiệm thời gian cấu hình thủ công phức tạp.

1.4 Dễ Dàng Mở Rộng

Bạn có thể dễ dàng thêm hoặc bớt các dịch vụ khi cần, giúp WordPress vận hành linh hoạt hơn theo nhu cầu thực tế.

Bạn đang tìm một giải pháp giúp tiết kiệm thời gian và đơn giản hóa quá trình phát triển WordPress? Docker chính là câu trả lời!

2. Tích Hợp WP-CLI – Quản Lý WordPress Từ Dòng Lệnh

WP-CLI giúp bạn quản lý WordPress trực tiếp từ terminal một cách tiện lợi và tự động:

Cài đặt, cập nhật, cấu hình WordPress nhanh chóng

Thực hiện các tác vụ tự động hóa như backup, quản lý plugin/theme

Kết hợp sử dụng trong container để tối ưu quy trình vận hành

Bạn chỉ cần truy cập container rồi thực thi lệnh WP-CLI, tiết kiệm rất nhiều công sức và thời gian so với thao tác qua giao diện web.

3. Cấu Trúc Thư Mục Dự Án WordPress Với Docker

project/
│-- config/
│-- db/
│-- html/
│-- .gitignore
│-- docker-compose.yml
│-- Dockerfile

3.1 Mô tả các thư mục và tệp tin

Thư mục/Tệp	Mô tả
config/	Chứa các tệp cấu hình như php.ini
db/	Lưu dữ liệu cơ sở dữ liệu MySQL (thư mục trống ban đầu)
html/	Chứa mã nguồn WordPress (download và đổi tên thành html)
.gitignore	Liệt kê các tệp/thư mục không đưa lên Git
docker-compose.yml	Định nghĩa container và mối quan hệ của chúng
Dockerfile	Định nghĩa cách xây dựng môi trường web server

Đảm bảo đặt đúng tên folder html chứa mã nguồn WordPress để Docker có thể mount đúng.

4. Chi Tiết Các Tệp Cấu Hình

4.1 File config/php.ini mẫu

post_max_size = 128M
upload_max_filesize = 128M
serialize_precision = 6
memory_limit = 128M
max_execution_time = 300

4.2 Nội dung tập tin .gitignore

db/

Giúp không đưa dữ liệu database lên Git, tránh xung đột và bảo mật.

5. Cấu Hình Docker Compose

Tệp docker-compose.yml định nghĩa 2 service chính: webapp và database.

services:
  webapp:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: your-project-name
    expose:
      - 80
    ports:
      - 1000:80
    depends_on:
      - database
    working_dir: /var/www/html
    volumes:
      - ./html:/var/www/html
      - ./config/php.ini:/etc/php/8.2/apache2/conf.d/99-local.ini
    environment:
      MYSQL_HOST: database
      MYSQL_USER: admin
      MYSQL_PASSWORD: admin

  database:
    container_name: MySQL-8
    restart: always
    image: mysql:8
    volumes:
      - ./db:/var/lib/mysql
    expose:
      - 3306
    environment:
      MYSQL_ROOT_PASSWORD: admin
      MYSQL_USER: admin
      MYSQL_PASSWORD: admin
      MYSQL_DATABASE: your-project-name

Cấu hình này giúp thiết lập đầy đủ để webapp giao tiếp với MySQL qua network nội bộ. Bạn có thể thay đổi port hoặc tên container tùy mục đích.

6. Dockerfile – Xây Dựng Môi Trường Web Server

FROM ubuntu:20.04

LABEL name="Prazol Rupakheti"
ENV DEBIAN_FRONTEND=noninteractive

RUN apt-get update && \
    apt-get install -y --no-install-recommends apt-utils && \
    apt-get -y install wget zip unzip curl gnupg nano cron && \
    apt-get install lsb-release ca-certificates apt-transport-https software-properties-common -y

# Cài Node.js, PM2, Apache và PHP 8
RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && \
    apt-get install -y nodejs && \
    npm install -g npm@latest pm2 sass

RUN add-apt-repository ppa:ondrej/php -y && \
    apt-get -y install php8.2 apache2 libapache2-mod-php8.2 php8.2-cli php8.2-mysql php8.2-zip php8.2-gd \
    php8.2-mbstring php8.2-curl php8.2-xml php8.2-bcmath php8.2-imagick php8.2-intl mysql-client && \
    a2enmod rewrite headers expires

# Cài phpMyAdmin
RUN wget -q https://files.phpmyadmin.net/phpMyAdmin/5.2.1/phpMyAdmin-5.2.1-english.zip && \
    unzip -q phpMyAdmin-5.2.1-english.zip && \
    mv phpMyAdmin-5.2.1-english /opt/phpMyAdmin && \
    rm phpMyAdmin-5.2.1-english.zip

# Cài Composer
RUN wget -q https://getcomposer.org/download/latest-stable/composer.phar && \
    chmod +x composer.phar && \
    mv composer.phar /usr/local/bin/composer

# Cài WP-CLI
RUN curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar && \
    chmod +x wp-cli.phar && \
    mv wp-cli.phar /usr/local/bin/wp

# Cấu hình Apache
COPY config/000-default.conf /etc/apache2/sites-available
COPY config/phpmyadmin.conf /etc/apache2/conf-enabled
COPY config/99-local.ini /etc/php/8.2/apache2/conf.d/

EXPOSE 80
CMD apachectl -D FOREGROUND

Lưu ý:

Apache được cấu hình với module rewrite giúp URL thân thiện.

WP-CLI và Composer đã sẵn sàng sử dụng trong container.

Bao gồm phpMyAdmin để quản lý database dễ dàng.

7. Cấu Hình File WordPress wp-config.php

File html/wp-config.php cần chỉnh sửa các tham số kết nối database:

define('DB_NAME', 'your-project-name');
define('DB_USER', 'admin');
define('DB_PASSWORD', 'admin');
define('DB_HOST', 'database');

Điều này nhằm kết nối WordPress với MySQL chạy trong container database theo tên mạng nội bộ.

8. Cài Đặt Docker và Khởi Chạy Container

8.1 Cài Docker

Windows & macOS: Tải và cài đặt Docker Desktop tại https://www.docker.com/products/docker-desktop/

Linux:

sudo apt update
sudo apt install -y docker.io docker-compose
sudo systemctl start docker
sudo systemctl enable docker

8.2 Khởi chạy container

Tại thư mục dự án, chạy:

docker-compose up -d

Flag -d giúp chạy trong nền, không chiếm terminal.

9. Kiểm Tra Trạng Thái Container

Dùng lệnh:

docker ps

Bạn sẽ thấy 2 container đang chạy:

Web Server (Apache + PHP)

MySQL Database

10. Sử Dụng WP-CLI Trong Container

Truy cập shell container:

docker exec -it your-project-name bash

Kiểm tra phiên bản WordPress:

wp core version

WP-CLI giúp bạn dễ dàng thực thi các lệnh quản lý mà không cần vào giao diện quản trị web.

11. Truy Cập WordPress và phpMyAdmin

Truy cập WordPress qua trình duyệt: http://localhost:1000

Quản lý database với phpMyAdmin: http://localhost:1000/phpmyadmin

Nhớ làm theo hướng dẫn cài đặt WordPress trên trình duyệt để hoàn tất bước cuối.

Kết Luận

Bạn vừa hoàn tất việc thiết lập một môi trường WordPress hiện đại bằng Docker kết hợp với WP-CLI, giúp quá trình phát triển, kiểm thử và triển khai nhanh chóng, ổn định và dễ bảo trì hơn.

Việc sử dụng container hóa không chỉ nâng cao tính đồng nhất môi trường mà còn tạo nền tảng mở rộng bền vững cho dự án của bạn. Hãy thử vận dụng ngay hôm nay để nâng cao năng suất công việc!

Tham Khảo

Docker Official Documentation

WP-CLI – Command Line Interface for WordPress

Docker Compose File Reference

phpMyAdmin Official

Prazol Rupakheti, Building WordPress Dev Environments with Docker (2023)

June 15, 2024