آموزش نصب وردپرس روی Docker برای محیط توسعه

آیا از دردسرهای تنظیم محیط توسعه محلی برای وردپرس خسته شده‌اید؟ هر بار که پروژه‌ای جدید شروع می‌کنید، سر و کله زدن با PHP، MySQL و Apache یا Nginx می‌تواند زمان‌بر و گیج‌کننده باشد.
خبر خوب این است که با داکر (Docker)، این چالش‌ها به گذشته می‌پیوندند!
در این مقاله جامع، به شما نشان می‌دهیم چگونه وردپرس را به سادگی و کارآمدی روی Docker برای محیط توسعه خود نصب کنید.
این روش نه تنها سرعت را به ارمغان می‌آورد، بلکه پایداری و ایزوله‌سازی پروژه‌های شما را تضمین می‌کند و تجربه‌ای حرفه‌ای در توسعه سفارشی وردپرس فراهم میآورد.
با این راهنما، می‌توانید تمرکز خود را بر روی کدنویسی و ایجاد ارزش قرار دهید، نه پیکربندی بی‌پایان.

چرا وردپرس روی Docker؟ یک نگاه سریع به مزایا

🚀

سرعت و سادگی

راه‌اندازی وردپرس در چند دقیقه، بدون تنظیمات پیچیده.

🔒

ایزوله‌سازی کامل

هر پروژه در محیط خود، بدون تداخل با سایر برنامه‌ها.

🔄

قابلیت حمل

محیط توسعه شما هر جا که Docker باشد، قابل اجراست.

نقشه راه: نصب وردپرس روی داکر برای محیط توسعه

1️⃣

پیش‌نیازها

نصب Docker و Docker Compose.

2️⃣

ایجاد ساختار پروژه

فایل Docker Compose و پوشه‌های لازم.

3️⃣

پیکربندی Docker Compose

تنظیم سرویس‌های وردپرس، MySQL و PhpMyAdmin.

4️⃣

راه‌اندازی و تست

اجرای کانتینرها و نصب وردپرس.

5️⃣

عیب‌یابی رایج

حل مشکلات احتمالی.

گام اول: آماده‌سازی پیش‌نیازها برای نصب وردپرس روی Docker

قبل از اینکه وارد دنیای جذاب داکر و وردپرس شوید، باید مطمئن شوید که ابزارهای لازم را روی سیستم خود نصب کرده‌اید.
داکر یک پلتفرم فوق‌العاده است که به شما امکان می‌دهد برنامه‌ها را در کانتینرهای ایزوله اجرا کنید.
داکر کامپوز (Docker Compose) نیز ابزاری برای تعریف و اجرای برنامه‌های چند کانتینری داکر است.
این دو ابزار، پایه و اساس کار ما برای نصب وردپرس روی داکر خواهند بود.

1.1. نصب Docker Desktop

Docker Desktop یک پکیج جامع برای ویندوز، مک و لینوکس است که شامل داکر انجین، داکر کامپوز، Kubernetes و دیگر ابزارهای مفید می‌شود.
این راحت‌ترین راه برای شروع کار با داکر است.

• برای ویندوز: به وب‌سایت رسمی Docker مراجعه کرده و Docker Desktop for Windows را دانلود کنید.
  نصب آن کاملاً گرافیکی و مانند هر برنامه ویندوز دیگری است.
• برای macOS: Docker Desktop for Mac را از وب‌سایت Docker دریافت کنید.
  پس از دانلود فایل .dmg، آن را باز کرده و Docker را به پوشه Applications خود بکشید.
• برای لینوکس: بسته به توزیع لینوکس خود (Ubuntu, Debian, Fedora, CentOS)، دستورالعمل‌های نصب را از مستندات رسمی Docker دنبال کنید.
  معمولاً شامل افزودن مخازن داکر و نصب از طریق مدیریت بسته است.

پس از نصب، داکر دسکتاپ را اجرا کنید و منتظر بمانید تا آیکون داکر در نوار وظیفه یا منوی سیستم شما سبز شود، که نشان‌دهنده آماده به کار بودن آن است.

1.2. بررسی نصب Docker Compose

در نسخه‌های جدید Docker Desktop، داکر کامپوز به صورت پیش‌فرض همراه با داکر نصب می‌شود.
برای اطمینان از صحت نصب، یک ترمینال یا Command Prompt را باز کرده و دستورات زیر را اجرا کنید:

docker --version
docker compose version

اگر نسخه‌های Docker و Docker Compose نمایش داده شد، همه چیز آماده است! در غیر این صورت، به مستندات داکر برای نصب دستی داکر کامپوز مراجعه کنید.
این مرحله بسیار حیاتی است زیرا بدون Docker Compose نمی‌توانید به راحتی سرویس‌های چندگانه وردپرس (وب‌سرور، دیتابیس) را مدیریت کنید.

گام دوم: ایجاد ساختار پروژه و فایل Docker Compose

حالا که پیش‌نیازها آماده است، زمان آن رسیده که ساختار پروژه خود را برای وردپرس در داکر ایجاد کنیم.
این ساختار شامل یک پوشه اصلی برای پروژه و فایل docker-compose.yml است که تمامی سرویس‌های مورد نیاز وردپرس را تعریف می‌کند.

2.1. ایجاد پوشه پروژه

یک پوشه جدید برای پروژه وردپرس خود ایجاد کنید. می‌توانید نام آن را هر چیزی که دوست دارید بگذارید، مثلاً my-wordpress-project.

mkdir my-wordpress-project
cd my-wordpress-project

2.2. ایجاد فایل docker-compose.yml

در داخل پوشه my-wordpress-project، یک فایل با نام docker-compose.yml ایجاد کنید.
این فایل مغز متفکر راه‌اندازی وردپرس روی داکر است و تمامی سرویس‌ها و ارتباطات آن‌ها را مشخص می‌کند.

محتوای فایل docker-compose.yml باید دقیقاً مانند کد زیر باشد.
لطفاً به تورفتگی‌ها (indentation) دقت کنید، زیرا در فایل‌های YAML بسیار مهم هستند.

version: '3.8'

services:
  wordpress:
    image: wordpress:latest
    ports:
      - "8000:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wordpress
      WORDPRESS_DB_PASSWORD: wordpress
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - ./wp-content:/var/www/html/wp-content
    restart: always
    depends_on:
      - db

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wordpress
      MYSQL_PASSWORD: wordpress
    volumes:
      - db_data:/var/lib/mysql
    restart: always

  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    ports:
      - "8080:80"
    environment:
      PMA_HOST: db
      MYSQL_ROOT_PASSWORD: rootpassword
    restart: always
    depends_on:
      - db

volumes:
  db_data:

توضیح فایل docker-compose.yml:

• `wordpress` سرویس:
  • image: wordpress:latest: جدیدترین ایمیج وردپرس را از Docker Hub می‌گیرد.
  • ports: "8000:80": پورت 8000 سیستم شما را به پورت 80 کانتینر وردپرس نگاشت می‌کند. شما می‌توانید این پورت را تغییر دهید.
  • environment: متغیرهای محیطی برای اتصال وردپرس به دیتابیس.
  • volumes: ./wp-content:/var/www/html/wp-content: این خط بسیار مهم است!
    این یک Volume Mapping ایجاد می‌کند. به این معنی که پوشه wp-content در دایرکتوری فعلی پروژه شما (همان جایی که docker-compose.yml قرار دارد) به پوشه /var/www/html/wp-content داخل کانتینر وردپرس متصل می‌شود.
    این کار باعث می‌شود هر گونه تغییر در پلاگین‌ها، پوسته‌ها و فایل‌های آپلودی شما (که در wp-content قرار دارند) حتی پس از حذف یا بازسازی کانتینر، حفظ شوند.
    بدون این، با هر بار راه‌اندازی مجدد کانتینر، تمام کارهای شما از بین می‌رفت.

    نکته مهم: اطمینان حاصل کنید که پوشه wp-content در کنار فایل docker-compose.yml وجود دارد یا پس از اولین اجرا داکر آن را ایجاد خواهد کرد.

  • depends_on: db: این سرویس به db (دیتابیس) وابسته است و تا زمانی که دیتابیس آماده نشود، راه‌اندازی نمی‌شود.
• `db` سرویس (MySQL):
  • image: mysql:8.0: ایمیج MySQL نسخه 8 را دریافت می‌کند.
  • environment: متغیرهای محیطی برای پیکربندی دیتابیس (نام کاربری، رمز عبور، نام دیتابیس).
  • volumes: db_data:/var/lib/mysql: این یک Named Volume است که داده‌های دیتابیس را روی سیستم هاست شما ذخیره می‌کند.
    این تضمین می‌کند که داده‌های دیتابیس شما حتی پس از حذف یا بازسازی کانتینر db نیز حفظ می‌شوند.
• `phpmyadmin` سرویس:
  • image: phpmyadmin/phpmyadmin: ایمیج PhpMyAdmin را برای مدیریت گرافیکی دیتابیس فراهم می‌کند.
  • ports: "8080:80": PhpMyAdmin روی پورت 8080 سیستم شما قابل دسترسی خواهد بود.
  • PMA_HOST: db: PhpMyAdmin را به سرویس دیتابیس (که نام آن در داکر کامپوز db است) متصل می‌کند.
• `volumes` بخش:
  • db_data:: یک Named Volume به نام db_data تعریف می‌کند تا داکر آن را مدیریت کند.

گام سوم: راه‌اندازی وردپرس با Docker Compose

حالا که فایل docker-compose.yml را آماده کرده‌اید، زمان آن است که وردپرس خود را با چند دستور ساده بالا بیاورید.
این فرآیند کانتینرهای لازم را ساخته و راه‌اندازی می‌کند، از جمله وردپرس، MySQL و PhpMyAdmin.

3.1. اجرای کانتینرها

ترمینال یا Command Prompt خود را باز کرده و به پوشه پروژه my-wordpress-project بروید (همان جایی که فایل docker-compose.yml را ایجاد کردید).
سپس دستور زیر را اجرا کنید:

docker compose up -d

• `docker compose up`: این دستور تمامی سرویس‌های تعریف شده در فایل docker-compose.yml را می‌سازد و راه‌اندازی می‌کند.
• `-d` (detached mode): این گزینه باعث می‌شود کانتینرها در پس‌زمینه اجرا شوند و ترمینال شما آزاد بماند.
  اگر می‌خواهید لاگ‌های کانتینرها را در ترمینال ببینید، می‌توانید -d را حذف کنید.

در اولین اجرا، داکر ایمیج‌های وردپرس، MySQL و PhpMyAdmin را دانلود می‌کند که ممکن است کمی زمان ببرد.
پس از اتمام، کانتینرهای شما اجرا خواهند شد.
می‌توانید با دستور زیر از وضعیت کانتینرها مطلع شوید:

docker compose ps

این دستور لیستی از کانتینرهای در حال اجرا را نمایش می‌دهد.
اگر همه کانتینرها وضعیت Up (به همراه زمان اجرا) را نشان دهند، به این معنی است که همه چیز به درستی کار می‌کند.

3.2. تکمیل نصب وردپرس

حالا که کانتینر وردپرس در حال اجراست، می‌توانید نصب نهایی وردپرس را از طریق مرورگر وب انجام دهید.

• یک مرورگر وب باز کنید و به آدرس http://localhost:8000 بروید.
• صفحه خوش‌آمدگویی وردپرس را مشاهده خواهید کرد.
  زبان مورد نظر خود را انتخاب کرده و روی “ادامه” کلیک کنید.
• در صفحه بعدی، اطلاعات مورد نیاز سایت وردپرسی خود را وارد کنید:
  • عنوان سایت: نام سایت شما (مثلاً “My Docker WordPress”).
  • نام کاربری: نام کاربری ادمین (مثلاً “admin”).
  • رمز عبور: یک رمز عبور قوی انتخاب کنید.
  • ایمیل شما: ایمیل مدیر سایت.
  • قابلیت دیده شدن توسط موتورهای جستجو: برای محیط توسعه، بهتر است این گزینه را فعال کنید تا سایت شما توسط ربات‌های موتورهای جستجو (مثل گوگل) ایندکس نشود.
    البته برای سایت‌های لایو باید این گزینع خاموش باشد.
    برای اطلاعات بیشتر در مورد اهمیت این موارد در سئو، می‌توانید به مقالات ما در دسته سئو مراجعه کنید.
• پس از پر کردن اطلاعات، روی دکمه “نصب وردپرس” کلیک کنید.
• تبریک! وردپرس شما با موفقیت روی داکر نصب شد.
  حالا می‌توانید با کلیک بر روی “ورود” به داشبورد مدیریت وردپرس خود وارد شوید.

3.3. دسترسی به PhpMyAdmin

همانطور که در فایل docker-compose.yml تنظیم کردیم، PhpMyAdmin نیز برای مدیریت دیتابیس در دسترس است.
می‌توانید با مراجعه به آدرس http://localhost:8080 به آن دسترسی پیدا کنید.

• نام کاربری: root
• رمز عبور: rootpassword (همان رمزی که در MYSQL_ROOT_PASSWORD در فایل docker-compose.yml تعریف کردیم).

PhpMyAdmin ابزاری عالی برای بررسی ساختار دیتابیس وردپرس، اجرای کوئری‌ها و مدیریت داده‌ها در محیط توسعه است.

گام چهارم: مدیریت پروژه وردپرس در داکر

بعد از نصب وردپرس روی داکر، دانستن نحوه مدیریت کانتینرها برای یک تجربه توسعه روان ضروری است.
این شامل راه‌اندازی مجدد، توقف و حذف کانتینرها می‌شود.

4.1. توقف کانتینرها

وقتی کارتان با پروژه وردپرس تمام شد، می‌توانید کانتینرها را متوقف کنید.
این کار باعث آزاد شدن منابع سیستم می‌شود.
دقت کنید که این کار کانتینرها را حذف نمی‌کند، بلکه فقط آن‌ها را متوقف می‌سازد.

docker compose stop

4.2. راه‌اندازی مجدد کانتینرها

برای راه‌اندازی مجدد کانتینرهای متوقف شده، کافیست دوباره دستور docker compose up -d را اجرا کنید.
اگر تغییراتی در فایل docker-compose.yml ایجاد کرده‌اید، بهتر است از دستور زیر استفاده کنید تا تغییرات اعمال شوند:

docker compose up -d --build

گزینه --build باعث می‌شود که ایمیج‌های سرویس‌ها دوباره ساخته شوند (در صورتی که تغییراتی در Dockerfile یا کانفیگ مربوطه ایجاد کرده باشید).

4.3. حذف کانتینرها و شبکه‌ها

اگر می‌خواهید پروژه وردپرس خود را به طور کامل از داکر حذف کنید (مثلاً برای شروع یک پروژه جدید یا پاکسازی سیستم)، می‌توانید از دستور زیر استفاده کنید:

docker compose down

این دستور کانتینرها، شبکه‌ها و ولوم‌های تعریف شده در فایل docker-compose.yml را حذف می‌کند.
اخطار: با این دستور، داده‌های دیتابیس (که در db_data ذخیره شده‌اند) نیز حذف خواهند شد.
اگر می‌خواهید داده‌های دیتابیس را حفض کنید، باید از docker compose down --remove-orphans بدون حذف ولوم‌ها استفاده کنید.

برای حذف کانتینرها بدون حذف ولوم‌ها:

docker compose down --volumes

نکته مهم: این دستور ولوم‌های Named Volume را حذف می‌کند.
پوشه wp-content که به صورت Path Volume نگاشت شده، روی سیستم شما باقی می‌ماند.

گام پنجم: عیب‌یابی مشکلات رایج در نصب وردپرس روی Docker

مانند هر فرآیند توسعه‌ای، ممکن است در راه‌اندازی وردپرس با داکر با مشکلاتی مواجه شوید.
در این بخش به برخی از رایج‌ترین مسائل و راه‌حل‌های آن‌ها می‌پردازیم.
شناخت این مشکلات به شما کمک می‌کند تا به سرعت از آن‌ها عبور کرده و فرآیند توسعه خود را ادامه دهید.

5.1. مشکل در دسترسی به پورت‌ها (Port Conflicts)

یکی از رایج‌ترین مشکلات، تداخل پورت‌ها است.
اگر برنامه‌های دیگری روی سیستم شما (مانند Apache، Nginx یا حتی سرویس‌های دیگر داکر) از پورت‌های 8000 یا 8080 استفاده می‌کنند، کانتینرهای وردپرس یا PhpMyAdmin نمی‌توانند راه‌اندازی شوند.

راه‌حل:

• تغییر پورت در docker-compose.yml:
  ساده‌ترین راه‌حل، تغییر پورت‌های میزبانی (سمت چپ :) در فایل docker-compose.yml است.
  مثلاً برای وردپرس می‌توانید "8001:80" و برای PhpMyAdmin "8081:80" را تنظیم کنید.
  سپس docker compose up -d --build را اجرا کنید.
• پیدا کردن برنامه در حال استفاده از پورت:
  در ویندوز می‌توانید از netstat -ano | findstr :8000 و در لینوکس/مک از lsof -i :8000 برای شناسایی فرآیندهای درگیر استفاده کنید.

5.2. خطای اتصال به دیتابیس (Error Establishing a Database Connection)

این خطای رایج وردپرس معمولاً به معنای این است که کانتینر وردپرس نمی‌تواند به کانتینر MySQL متصل شود.

راه‌حل:

• بررسی لاگ‌های کانتینر MySQL:
  با دستور docker compose logs db لاگ‌های سرویس دیتابیس را بررسی کنید.
  ممکن است مشکل از رمز عبور اشتباه، نام دیتابیس یا کاربر باشد.
• اطمینان از تطابق متغیرهای محیطی:
  مطمئن شوید که متغیرهای WORDPRESS_DB_USER، WORDPRESS_DB_PASSWORD و WORDPRESS_DB_NAME در سرویس وردپرس، دقیقاً با MYSQL_USER، MYSQL_PASSWORD و MYSQL_DATABASE در سرویس db مطابقت دارند.
• بررسی WORDPRESS_DB_HOST:
  این مقدار باید db باشد، زیرا نام سرویس دیتابیس در فایل docker-compose.yml، db است.

5.3. مشکلات در Volume Mapping

اگر پلاگین‌ها، پوسته‌ها یا فایل‌های آپلودی شما پس از راه‌اندازی مجدد کانتینرها از بین می‌روند، احتمالاً مشکل از Volume Mapping است.

راه‌حل:

• بررسی مسیرها:
  مطمئن شوید که مسیر نسبی ./wp-content در فایل docker-compose.yml، به درستی به پوشه wp-content در همان دایرکتوری docker-compose.yml اشاره می‌کند.
• Permissions (مجوزها):
  گاهی اوقات مشکلات مجوز دسترسی به فایل‌ها می‌تواند مانع از نوشتن وردپرس در پوشه wp-content شود.
  اگر از لینوکس یا مک استفاده می‌کنید، ممکن است نیاز باشد مجوزهای پوشه wp-content را تنظیم کنید (مثلاً با sudo chown -R $USER:$USER wp-content).

سوالات متداول (FAQ) در مورد نصب وردپرس روی Docker

docker compose exec db bash

mysqldump -u wordpress -pwordpress wordpress > /path/to/backup.sql
(رمز عبور و نام دیتابیس را متناسب با تنظیمات خود تغییر دهید)

نتیجه‌گیری: قدرت و انعطاف‌پذیری نصب وردپرس روی Docker

در این مقاله، ما به صورت گام به گام نصب وردپرس روی Docker برای محیط توسعه را با تمامی جزئیات و نکات کلیدی بررسی کردیم.
از آماده‌سازی پیش‌نیازها گرفته تا پیکربندی فایل docker-compose.yml و در نهایت راه‌اندازی و مدیریت کانتینرها، تلاش شد تا یک راهنمای کامل و قابل اعتماد ارائه شود.

استفاده از داکر نه تنها فرآیند توسعه وردپرس را ساده‌تر و سریع‌تر می‌کند، بلکه با فراهم آوردن محیط‌های ایزوله، قابلیت حمل بالا و مدیریت آسان وابستگی‌ها، کیفیت کار شما را به طور چشمگیری افزایش می‌دهد.
این روش به شما کمک می‌کند تا روی خلاقیت و توسعه قابلیت‌های سایت خود تمرکز کنید، بدون اینکه نگران پیچیدگی‌های پیکربندی زیرساخت باشید.
امیدواریم این راهنما به شما در تسلط بر این ابزار قدرتمند یاری رسانده باشد و بتوانید با اطمینان خاطر از آن در پروژه‌های آینده خود استفاده کنید.