
ساخت محیط آزمایشی وردپرس با Docker و WP-CLI؛ تست امن قالب و افزونهها
بهروزرسانی یک افزونه، تغییر قالب یا نصب یک قابلیت جدید ممکن است ظاهر و عملکرد سایت وردپرسی را تغییر دهد. گاهی یک تغییر کوچک با افزونه دیگری تداخل پیدا میکند و مشکلاتی به وجود میآورد که تشخیص آنها در سایت فعال دشوار است. راهکار حرفهای، آزمایش تغییرات در یک محیط جداگانه پیش از انتشار آنهاست.
در این آموزش یاد میگیرید چگونه با Docker یک محیط آزمایشی وردپرس بسازید و با کمک WP-CLI، مدیریت و بررسی آن را سادهتر کنید.
محیط آزمایشی وردپرس (Staging) چیست؟
محیط Staging یک نسخه جداگانه از وبسایت است که برای آزمایش تغییرات و بررسی عملکرد سایت استفاده میشود. این محیط میتواند از نظر قالب، افزونهها، تنظیمات و محتوای اولیه شبیه سایت اصلی باشد؛ اما تغییراتی که در آن انجام میدهید، نباید مستقیماً روی وبسایت فعال اثر بگذارند.
برای مثال، فرض کنید یک افزونه فروشگاهی را به نسخه جدید ارتقا دادهاید. بهجای اینکه ابتدا آن را روی سایت اصلی بهروزرسانی کنید، میتوانید نسخهای آزمایشی از سایت بسازید و عملکرد بخشهای مهم را در آن بررسی کنید.
تفاوت محیط Local، Development، Staging و Production
این اصطلاحات به محیطهای مختلف توسعه و اجرای نرمافزار اشاره دارند:
| نوع محیط | کاربرد اصلی | مخاطب |
|---|---|---|
| Local | اجرای سایت روی رایانه شخصی | مدیر و توسعهدهنده |
| Development | توسعه و آزمایش قابلیتهای جدید | برنامهنویس |
| Staging | بررسی نهایی پیش از انتشار | مدیر سایت و تیم فنی |
| Production | نسخه اصلی و فعال وبسایت | کاربران واقعی |
محیط آزمایشی باید تا حد امکان به شرایط سایت اصلی نزدیک باشد؛ زیرا اگر نسخه آزمایشی تفاوت زیادی با سایت واقعی داشته باشد، ممکن است نتیجه آزمایشها قابل اعتماد نباشد.
چرا باید قبل از تغییرات مهم، سایت وردپرسی را آزمایش کنیم؟
بسیاری از مشکلات وردپرس بعد از نصب افزونه، تغییر قالب یا بهروزرسانی نسخه PHP و هسته وردپرس ظاهر میشوند.
محیط آزمایشی به شما کمک میکند این مشکلات را پیش از انتشار تغییرات شناسایی کنید.
مهمترین مزایای استفاده از Staging عبارتاند از:
- کاهش ریسک بهروزرسانی: میتوانید نسخه جدید افزونهها و قالبها را قبل از نصب روی سایت اصلی بررسی کنید.
- تشخیص تداخل افزونهها: اگر دو افزونه با یکدیگر ناسازگار باشند، احتمال شناسایی مشکل در محیط آزمایشی بیشتر است.
- بررسی تغییرات ظاهری: قبل از انتشار قالب یا طراحی جدید، صفحات مختلف را مشاهده کنید.
- آزمایش کدهای اختصاصی: تغییرات PHP، CSS و JavaScript را بدون دستکاری نسخه فعال بررسی کنید.
- بررسی عملکرد سایت: میتوانید سرعت، خطاهای احتمالی و رفتار قابلیتهای جدید را ارزیابی کنید.
نکته مهم این است که Staging جایگزین نسخه پشتیبان نیست. حتی محیط آزمایشی هم ممکن است دچار مشکل شود؛ بنابراین برای اطلاعات مهم همیشه نسخه پشتیبان جداگانه داشته باشید.
Docker چیست و چه کمکی به ساخت محیط آزمایشی وردپرس میکند؟
Docker بستری برای اجرای برنامهها در محیطهای مستقل و قابل مدیریت فراهم میکند. در این فناوری، برنامه و وابستگیهای موردنیاز آن داخل Container اجرا میشوند.
برای راهاندازی وردپرس معمولاً به چند بخش نیاز داریم:
- فایلهای وردپرس و سرویس وب
- پایگاه داده MySQL یا MariaDB
- فضای ذخیرهسازی اطلاعات
- در صورت نیاز، ابزارهایی مانند WP-CLI
Docker کمک میکند این اجزا را بدون نصب و تنظیم دستی تمام سرویسها روی سیستمعامل، در قالب یک پروژه مدیریت کنید.
Docker Compose چه کاربردی دارد؟
Docker Compose ابزاری برای تعریف و اجرای چند سرویس مرتبط با یکدیگر است. بهجای اجرای جداگانه دستورهای متعدد، میتوانید سرویسها و ارتباط آنها را در یک فایل با نام compose.yaml تعریف کنید.
برای مثال، میتوان سرویس وردپرس و پایگاه داده را در یک پروژه قرار داد و هر دو را با یک دستور اجرا کرد.
مستندات رسمی Docker نیز نمونهای برای اجرای وردپرس و MySQL با Compose ارائه میکند.
پیشنیازهای ساخت محیط آزمایشی وردپرس
قبل از شروع، ابزارهای زیر را آماده کنید:
| ابزار | کاربرد |
|---|---|
| Docker Desktop یا Docker Engine | اجرای Containerها |
| Docker Compose | مدیریت سرویسهای پروژه |
| WP-CLI | مدیریت وردپرس از خط فرمان |
| ویرایشگر متن | ساخت فایل تنظیمات Compose |
| فضای ذخیرهسازی کافی | نگهداری فایلها و پایگاه داده |
اگر از ویندوز استفاده میکنید، Docker Desktop یکی از گزینههای مناسب برای شروع است. پس از نصب، برنامه را اجرا کنید و مطمئن شوید سرویس Docker فعال است.
برای بررسی نصب Docker، ترمینال یا PowerShell را باز کنید و دستور زیر را اجرا کنید:
docker --version
برای بررسی Docker Compose نیز از این دستور استفاده کنید:
docker compose version
اگر شماره نسخه نمایش داده شود، ابزار مربوطه در دسترس است.
آموزش ساخت محیط آزمایشی وردپرس با Docker
در این بخش یک نصب آزمایشی و مستقل از وردپرس ایجاد میکنیم. این نمونه ابتدا یک وردپرس تازه راهاندازی میکند؛ بنابراین هنوز کپی سایت اصلی شما نیست. در بخش بعدی درباره انتقال اطلاعات نسخه اصلی توضیح میدهیم.
مرحله اول: ساخت پوشه پروژه
یک پوشه جدید با نام زیر ایجاد کنید:
wordpress-staging
این پوشه محل نگهداری فایل تنظیمات پروژه Docker خواهد بود.
در ویندوز میتوانید از File Explorer استفاده کنید یا پوشه را با دستور زیر در PowerShell بسازید:
mkdir wordpress-staging
cd wordpress-staging
مرحله دوم: ساخت فایل Compose
داخل پوشه پروژه، فایلی با نام compose.yaml ایجاد کنید.
سپس محتوای زیر را در آن قرار دهید:
services:
db:
image: mysql:8.0
restart: unless-stopped
environment:
MYSQL_DATABASE: wordpress
MYSQL_USER: wpuser
MYSQL_PASSWORD: change_this_password
MYSQL_ROOT_PASSWORD: change_root_password
volumes:
- db_data:/var/lib/mysql
wordpress:
image: wordpress:php8.3-apache
restart: unless-stopped
depends_on:
- db
ports:
- "127.0.0.1:8080:80"
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_USER: wpuser
WORDPRESS_DB_PASSWORD: change_this_password
WORDPRESS_DB_NAME: wordpress
WORDPRESS_CONFIG_EXTRA: |
define('WP_ENVIRONMENT_TYPE', 'staging');
define('DISABLE_WP_CRON', true);
volumes:
- wordpress_data:/var/www/html
volumes:
db_data:
wordpress_data:
چند نکته درباره این فایل:
- سرویس db پایگاه داده سایت را اجرا میکند.
- سرویس wordpress فایلهای وردپرس را اجرا میکند.
- پورت ۸۰۸۰ برای دسترسی محلی به محیط آزمایشی استفاده شده است.
- اطلاعات پایگاه داده در Volume ذخیره میشوند تا با توقف Container از بین نروند.
- مقدار WP_ENVIRONMENT_TYPE محیط را بهعنوان Staging مشخص میکند.
- مقدار DISABLE_WP_CRON اجرای خودکار WP-Cron را غیرفعال میکند.
عبارتهای change_this_password و change_root_password فقط مقادیر نمونه هستند. قبل از اجرا، آنها را با رمزهای قوی و اختصاصی جایگزین کنید. این فایل را در مخزن عمومی قرار ندهید.
مرحله سوم: اجرای سرویسها
در همان پوشهای که فایل compose.yaml قرار دارد، دستور زیر را اجرا کنید:
docker compose up -d
Docker سرویسهای موردنیاز را دریافت و اجرا میکند.
برای مشاهده وضعیت Containerها، دستور زیر را وارد کنید:
docker compose ps
اگر سرویسها اجرا شده باشند، وضعیت آنها در خروجی نمایش داده میشود.
مرحله چهارم: نصب وردپرس
مرورگر را باز کنید و آدرس زیر را وارد کنید:
http://localhost:8080
صفحه نصب وردپرس نمایش داده میشود. زبان، عنوان سایت، نام کاربری و رمز عبور مدیر را انتخاب کنید و نصب را کامل کنید.
اکنون یک نسخه مستقل از وردپرس در محیط Docker دارید که میتوانید افزونهها و قالبها را در آن آزمایش کنید.
WP-CLI چیست و چرا در محیط آزمایشی مفید است؟
WP-CLI ابزار خط فرمان رسمی وردپرس است که امکان مدیریت بسیاری از بخشهای سایت را بدون ورود به پیشخوان فراهم میکند.
با این ابزار میتوانید افزونه نصب کنید، قالب را تغییر دهید، نسخه وردپرس را بررسی کنید، اطلاعات پایگاه داده را مدیریت کنید و عملیات متعددی را بهصورت دستوری انجام دهید.
برای مثال، اگر WP-CLI در محیط شما نصب و در دسترس باشد، دستور زیر نسخه وردپرس را نمایش میدهد:
wp core version
برای مشاهده افزونههای نصبشده نیز میتوانید از این دستور استفاده کنید:
wp plugin list
توجه: نمونه Docker بالا فقط سرویس وردپرس و پایگاه داده را تعریف میکند. ابزار WP-CLI باید جداگانه نصب شود یا یک سرویس مستقل دارای WP-CLI به پروژه اضافه شود. بنابراین، دستورات این بخش را در محیطی اجرا کنید که فرمان wp در آن نصب و قابل دسترسی باشد.
دستورهای کاربردی WP-CLI برای آزمایش سایت
| دستور | کاربرد |
|---|---|
| wp core version | نمایش نسخه وردپرس |
| wp plugin list | نمایش افزونهها |
| wp theme list | نمایش قالبها |
| wp plugin update –all | بهروزرسانی افزونهها |
| wp theme update –all | بهروزرسانی قالبها |
| wp cache flush | پاکسازی کش وردپرس |
| wp db export backup.sql | خروجی گرفتن از پایگاه داده |
پیش از اجرای دستورهای بهروزرسانی یا تغییر اطلاعات، مطمئن شوید در مسیر نصب نسخه آزمایشی قرار دارید، نه سایت اصلی.
چگونه نسخه واقعی سایت را به محیط Staging منتقل کنیم؟
یک وردپرس تازه نصبشده برای آزمایش اولیه مناسب است؛ اما اگر میخواهید عملکرد سایت واقعی خود را بررسی کنید، باید نسخهای از فایلها و پایگاه داده آن را به محیط آزمایشی منتقل کنید.
این فرایند معمولاً شامل مراحل زیر است:
۱. تهیه نسخه پشتیبان از سایت اصلی
ابتدا از پایگاه داده و فایلهای وردپرس نسخه پشتیبان تهیه کنید. پوشه wp-content بهخصوص برای انتقال افزونهها، قالبها و فایلهای بارگذاریشده اهمیت دارد.
۲. انتقال فایلها و پایگاه داده
فایلهای موردنیاز را به محیط آزمایشی منتقل و پایگاه داده را در دیتابیس مستقل آن وارد کنید.
هرگز پایگاه داده محیط آزمایشی را به دیتابیس سایت اصلی متصل نکنید.
۳. اصلاح آدرس سایت
اگر دامنه اصلی و آدرس محیط آزمایشی متفاوت باشند، باید آدرسهای ذخیرهشده در پایگاه داده بررسی و در صورت نیاز اصلاح شوند.
WP-CLI دستور search-replace را برای این کار ارائه میکند.
ابتدا یک آزمایش بدون اعمال تغییر انجام دهید:
wp search-replace \
'https://example.com' \
'http://localhost:8080' \
--all-tables \
--dry-run
در این مثال، example.com را با دامنه اصلی خود جایگزین کنید.
گزینه –dry-run باعث میشود نتیجه احتمالی بررسی شود، بدون اینکه تغییر واقعی در پایگاه داده اعمال شود.
اگر نتیجه بررسی درست بود، میتوانید دستور را بدون –dry-run اجرا کنید؛ البته فقط در پایگاه داده نسخه آزمایشی و پس از تهیه نسخه پشتیبان.
این دستور از قابلیتهای WP-CLI است و برای مدیریت دادههای سریالشده وردپرس طراحی شده است؛ بااینحال، پیش از استفاده از آن باید دامنههای فرعی، آدرسهای اختصاصی و تنظیمات افزونهها را نیز بررسی کنید.
نکات امنیتی مهم برای محیط آزمایشی وردپرس
Staging اگر بهدرستی مدیریت نشود، ممکن است مشکلاتی برای سایت اصلی ایجاد کند. به همین دلیل، صرفاً جدا بودن پوشه یا آدرس کافی نیست.
جلوگیری از ایندکس شدن نسخه آزمایشی
نسخه آزمایشی نباید بهعنوان یک سایت عمومی در نتایج جستوجو نمایش داده شود.
در وردپرس میتوانید از بخش «تنظیمات ← خواندن» گزینه «از موتورهای جستوجو درخواست کن تا محتوای سایت را بررسی نکنند» را فعال کنید.
در WP-CLI نیز دستور زیر برای غیرفعال کردن درخواست ایندکس در تنظیمات وردپرس وجود دارد:
wp option update blog_public 0
اما یک نکته مهم وجود دارد: این تنظیم بهتنهایی دسترسی کاربران و رباتها به سایت را مسدود نمیکند و تضمینی برای جلوگیری از ایندکس نیست.
روش مطمئنتر، محدود کردن دسترسی محیط آزمایشی با احراز هویت، فایروال یا شبکه خصوصی است. در صورت استفاده از رمز عبور، آن را در اختیار افراد غیرمجاز قرار ندهید.
جلوگیری از ارسال ایمیلهای واقعی
ممکن است نسخه آزمایشی هنگام ثبت سفارش، بازیابی رمز عبور یا انجام عملیات افزونهها ایمیل ارسال کند.
اگر از اطلاعات واقعی سایت کپی گرفتهاید، این موضوع اهمیت بیشتری دارد.
برای جلوگیری از ارسال ناخواسته ایمیل، میتوانید از سرویسهای دریافت و نمایش ایمیل آزمایشی استفاده کنید تا پیامها فقط در محیط تست ذخیره شوند.
جلوگیری از اجرای عملیات واقعی
افزونههای فروشگاهی، سیستمهای عضویت و ابزارهای زمانبندی ممکن است در نسخه آزمایشی نیز عملیات خودکار انجام دهند.
برای مثال، ممکن است اعلانها ارسال شوند یا یک وظیفه زمانبندیشده اجرا شود.
در محیط آزمایشی، درگاه پرداخت واقعی، سرویس پیامکی واقعی و اتصالهای خارجی حساس را غیرفعال یا با اطلاعات آزمایشی جایگزین کنید.
همچنین اگر WP-Cron را غیرفعال کردهاید، مطمئن شوید زمانبند خارجی یا Cron سرور نیز بهصورت جداگانه رویدادهای نسخه آزمایشی را اجرا نمیکند.
تعیین نوع محیط در وردپرس
وردپرس از ثابت WP_ENVIRONMENT_TYPE برای تشخیص نوع محیط استفاده میکند.
مقادیر مجاز آن عبارتاند از:
localdevelopmentstagingproduction
برای نسخه آزمایشی مقدار staging مناسب است. این تنظیم به وردپرس و افزونههایی که از آن پشتیبانی میکنند کمک میکند رفتار متناسب با محیط اجرا را انتخاب کنند.
چگونه تغییرات آزمایششده را به سایت اصلی منتقل کنیم؟
پس از اطمینان از عملکرد صحیح تغییرات، نوبت انتشار آنهاست.
اما انتقال کامل پایگاه داده نسخه آزمایشی به سایت اصلی همیشه تصمیم درستی نیست؛ بهخصوص برای فروشگاههایی که در فاصله زمانی آزمایش، سفارشها و اطلاعات مشتریان جدیدی ثبت کردهاند.
روش مناسب به نوع تغییر بستگی دارد:
| نوع تغییر | روش پیشنهادی انتقال |
|---|---|
| تغییر CSS و ظاهر | انتقال فایلهای تغییرکرده |
| افزونه جدید | نصب نسخه تأییدشده روی سایت اصلی |
| قالب جدید | انتقال و آزمایش قالب در سایت اصلی |
| تغییر کد اختصاصی | انتشار کنترلشده کد پس از پشتیبانگیری |
| تغییر ساختار پایگاه داده | بررسی دقیق و برنامهریزی انتقال داده |
پس از انتقال، صفحات مهم سایت اصلی را دوباره بررسی کنید؛ از جمله صفحه اصلی، فرمها، ورود کاربران، جستوجو، صفحات فروش و فرایند پرداخت.
خطاهای رایج هنگام ساخت محیط Staging با Docker
خطای اشغال بودن پورت ۸۰۸۰
اگر برنامه دیگری از پورت ۸۰۸۰ استفاده کند، ممکن است Docker نتواند سرویس وردپرس را اجرا کند.
میتوانید در فایل Compose پورت را تغییر دهید؛ برای مثال:
ports:
- "127.0.0.1:8081:80"
در این حالت آدرس دسترسی به سایت به http://localhost:8081 تغییر میکند.
اتصال ناموفق به پایگاه داده
اگر وردپرس نتواند به MySQL متصل شود، ابتدا مقادیر نام دیتابیس، نام کاربری و رمز عبور را بررسی کنید.
همچنین وضعیت سرویس پایگاه داده را با این دستور مشاهده کنید:
docker compose ps
خطای دسترسی به فایلها
اگر وردپرس نتواند فایلها را ذخیره یا بهروزرسانی کند، ممکن است مشکل از مجوزهای فایل یا مالکیت پوشهها باشد.
از تغییر تصادفی مجوزها خودداری کنید و ابتدا گزارشهای Container را بررسی کنید:
docker compose logs wordpress
از بین رفتن اطلاعات پس از حذف Container
حذف Container با حذف Volume یکسان نیست؛ اما اگر Volumeهای ذخیرهسازی را نیز حذف کنید، اطلاعات سایت ممکن است از بین بروند.
دستور زیر را با احتیاط بسیار زیاد اجرا کنید:
docker compose down -v
گزینه -v Volumeهای تعریفشده پروژه را نیز حذف میکند. اگر اطلاعات مهمی دارید، پیش از اجرای آن نسخه پشتیبان تهیه کنید.
آیا ساخت محیط آزمایشی با Docker برای همه مناسب است؟
Docker برای مدیران سایت و توسعهدهندگانی که میخواهند محیطی قابل کنترل و مستقل داشته باشند، گزینه قدرتمندی است؛ اما برای همه کاربران ضروری نیست.
اگر فقط قصد دارید یک افزونه را پیش از بهروزرسانی بررسی کنید، ممکن است سرویس Staging ارائهشده توسط شرکت هاستینگ یا ابزارهای محلی سادهتر، نیاز شما را برطرف کند.
در مقابل، اگر چند پروژه وردپرسی دارید، با توسعهدهندگان همکاری میکنید یا مرتباً قالبها و افزونههای مختلف را آزمایش میکنید، Docker و WP-CLI میتوانند روند کار را منظمتر و قابل تکرارتر کنند.
پرسشهای متداول درباره محیط آزمایشی وردپرس
آیا Staging همان نسخه پشتیبان وردپرس است؟
خیر. نسخه پشتیبان برای بازیابی اطلاعات در شرایط اضطراری تهیه میشود؛ اما محیط Staging برای آزمایش تغییرات و بررسی عملکرد سایت کاربرد دارد. این دو ابزار مکمل یکدیگر هستند.
آیا میتوان محیط آزمایشی را روی رایانه شخصی اجرا کرد؟
بله. با استفاده از Docker Desktop یا Docker Engine میتوانید یک محیط وردپرسی مستقل روی رایانه خود اجرا کنید.
آیا سایت آزمایشی باید در گوگل ایندکس شود؟
خیر. نسخه آزمایشی معمولاً برای استفاده داخلی است و نباید مانند سایت اصلی در نتایج جستوجو نمایش داده شود. بهتر است دسترسی آن با احراز هویت یا محدودیت شبکه محافظت شود و تنظیمات جلوگیری از ایندکس نیز فعال باشند.
آیا Docker برای نصب وردپرس ضروری است؟
خیر. Docker یکی از روشهای اجرای محیط توسعه و آزمایش است. میتوانید از سرویسهای Staging هاستینگ یا ابزارهای محلی دیگر نیز استفاده کنید.
آیا میتوان افزونهها را با WP-CLI بهروزرسانی کرد؟
بله. WP-CLI امکان نصب، فعالسازی و بهروزرسانی افزونهها را فراهم میکند. بااینحال، بهتر است ابتدا تغییرات را در محیط آزمایشی بررسی کنید.
آیا میتوان کل پایگاه داده Staging را روی سایت اصلی جایگزین کرد؟
از نظر فنی امکانپذیر است، اما همیشه توصیه نمیشود. این کار ممکن است اطلاعات جدید سایت اصلی مانند سفارشها، کاربران و دیدگاهها را از بین ببرد. روش انتقال باید بر اساس نوع تغییر و ساختار سایت انتخاب شود.
قبل از انتشار تغییرات، یک بار آنها را آزمایش کنید
ساخت محیط آزمایشی وردپرس به کمک Docker و WP-CLI روشی کاربردی برای مدیریت حرفهایتر سایت است. با این روش میتوانید تغییرات مهم را در یک محیط مستقل بررسی کنید و احتمال بروز مشکلات در نسخه اصلی را کاهش دهید.
اگر تازه کار با وردپرس را شروع کردهاید، لازم نیست از همان ابتدا تمام قابلیتهای Docker را یاد بگیرید. ابتدا یک پروژه ساده بسازید، نصب وردپرس را آزمایش کنید و سپس به سراغ انتقال نسخه آزمایشی سایت واقعی بروید.
در پاور ورد میتوانید آموزشهای تخصصی وردپرس را دنبال کنید و با شناخت بهتر ابزارهای فنی، سایت خود را با اطمینان بیشتری مدیریت کنید.