راهنمای کامل WP-CLI برای مدیران سرور: ارتقاء مدیریت وردپرس با ترمینال
آیا زمان آن نرسیده که مدیریت سایتهای وردپرسی خود را از حالت سنتی و زمانبر خارج کنید؟ آیا به دنبال ابزاری قدرتمند هستید که کنترل کامل و بیسابقهای بر وردپرس در سطح سرور به شما بدهد؟ WP-CLI، این رابط خط فرمان وردپرس، همان پاسخی است که مدیران سرور، توسعهدهندگان، و هر کسی که با چندین نصب وردپرس سروکار دارد، به آن نیاز دارد. با این راهنمای جامع، نه تنها با WP-CLI آشنا میشوید، بلکه به یک کاربر حرفهای تبدیل خواهید شد که میتواند وظایف پیچیده را در کسری از زمان به اتمام رساند. این مقاله به شما کمک میکند تا توسعههای سفارشی وردپرس خود را سریعتر مدیریت کنید و بهینهسازی سئو را با قدرت بیشتری انجام دهید.
💡 WP-CLI در یک نگاه: نقشه راه شما برای مدیریت حرفهای وردپرس 💡

🎯 هدف: مدیریت سریع و کارآمد وردپرس از طریق خط فرمان.
🛠️ کاربردها:
- ✓ نصب و بهروزرسانی هسته، افزونهها و پوستهها.
- ✓ مدیریت کاربران، پایگاه داده و محتوا.
- ✓ بهینهسازی و رفع اشکال سایت.
- ✓ اتوماسیون وظایف با اسکریپتنویسی.
🚀 مزایا:
- ⚡ سرعت بالا و کارایی بینظیر.
- 🤖 امکان خودکارسازی وظایف تکراری.
- 👨💻 کنترل عمیقتر بر وردپرس.
- 🔍 ابزارهای پیشرفته برای رفع اشکال.
⚠️ نکات کلیدی: نصب آسان، دستورات بصری، ابزاری ضروری برای هر مدیر سرور و توسعهدهنده.
مقدمه: چرا WP-CLI برای مدیران سرور حیاتی است؟

در دنیای پرشتاب مدیریت سرور، زمان طلاست. مدیریت دستی دهها یا حتی صدها سایت وردپرسی میتواند به کابوسی زمانبر تبدیل شود. هر کلیک، هر ورود به پنل مدیریت، و هر انتظار برای بارگذاری صفحه، دقایق ارزشمندی را از شما میگیرد. اینجاست که وردپرس CLI (Command Line Interface) به صحنه میآید تا با سرعت و کارایی بینظیر خود، انقلابیدر نحوه مدیریت وردپرس ایجاد کند. WP-CLI ابزاری قدرتمند است که به شما اجازه میدهد تمام جنبههای نصب وردپرس را مستقیماً از طریق ترمینال سرور خود کنترل کنید. این یعنی خداحافظی با رابط کاربری گرافیکی و خوشآمدگویی به دنیای سرعت و اتوماسیون.
تصور کنید بتوانید در چند ثانیه، هسته دهها سایت را بهروزرسانی کنید، افزونهای مشکلساز را غیرفعال نمایید، یا حتی یک نصب جدید وردپرس را در کمتر از یک دقیقه راهاندازی کنید. این رویا نیست، بلکه واقعیت WP-CLI است. برای مدیران سرور که مسئول پایداری، امنیت و عملکرد سایتهای مشتریان خود هستند، این ابزار نه تنها یک مزیت، بلکه یک ضرورت است. با WP-CLI، شما نه تنها کارهای تکراری را خودکار میکنید، بلکه ابزاری قدرتمند برای رفع اشکال و بهینهسازیهای عمیق در اختیار خواهید داشت که به ندرت در رابط گرافیکی پیدا میشود. این راهنما، شما را با صفر تا صد مدیریت وردپرس با ترمینال آشنا میکند.
WP-CLI چیست و چگونه کار میکند؟

WP-CLI (WordPress Command Line Interface) در واقع یک ابزار خط فرمان است که به شما امکان میدهد با نصب وردپرس خود بدون نیاز به مرورگر وب تعامل داشته باشید. به جای پیمایش در داشبورد وردپرس، میتوانید دستورات خاصی را در ترمینال سرور خود تایپ کنید تا وظایف مختلفی را انجام دهید. این ابزار از زبان برنامهنویسی PHP استفاده میکند، همان زبانی که وردپرس بر پایه آن بنا شده است، و از این رو توانایی ارتباط مستقیم با هسته وردپرس، پایگاه داده، افزونهها و پوستهها را دارد. این ارتباط مستقیم به WP-CLI اجازه میدهد تا عملیات را با سرعت بسیار بالا و بدون سربار رابط گرافیکی انجام دهد.
نحوه کار WP-CLI بسیار ساده و در عین حال قدرتمند است. پس از نصب بر روی سرور، شما به یک پوشه که یک نصب وردپرس در آن قرار دارد، میروید (یا مسیر آن را به WP-CLI معرفی میکنید) و سپس دستورات خود را اجرا میکنید. به عنوان مثال، برای مشاهده لیست افزونهها، به جای رفتن به بخش افزونهها در داشبورد، کافی است دستور wp plugin list را وارد کنید. این ابزار نه تنها برای وظایف روزمره مناسب است، بلکه برای عملیات پیچیدهتر مانند بهینهسازی پایگاه داده، یافتن و جایگزینی مقادیر در پایگاه داده، یا حتی تست اسکریپتها و افزونهها در محیطهای مختلف بسیار کارآمد است.
چرا WP-CLI برای مدیران سرور ضروری است؟
WP-CLI فراتر از یک ابزار کمکی است؛ این یک بخش جداییناپذیر از جعبهابزار هر مدیر سرور مدرن است. دلایل متعددی وجود دارد که این ابزار را برای افرادی که مسئولیت نگهداری و مدیریت سرورهای وردپرسی را بر عهده دارند، حیاتی میسازد.
✓ افزایش بهرهوری و سرعت
یکی از بزرگترین مزایای WP-CLI، سرعت و کارایی آن است. انجام عملیات گروهی، مانند بهروزرسانی 20 سایت وردپرسی، با WP-CLI در عرض چند دقیقه قابل انجام است، در حالی که همین کار از طریق رابط کاربری گرافیکی ممکن است ساعتها به طول بینجامد. این به مدیران سرور اجازه میدهد تا منابع خود را بر روی وظایف مهمتر متمرکز کنند و زمان کمتری را صرف کارهای تکراری و دستی نمایند. با این ابزار میتوان به سادگی و بدون دردسر سایتهای بسیاری را نگهداری کرد و زمان بیشتری را به حل مشکلات پیچیدهتر اختصاص داد.
✓ اتوماسیون وظایف
WP-CLI قابلیت یکپارچهسازی با اسکریپتهای شل (Shell Scripts) را دارد. این بدان معناست که شما میتوانید مجموعهای از دستورات را در یک اسکریپت بنویسید و آنها را به صورت خودکار در زمانهای مشخص (با استفاده از Cron Jobs) اجرا کنید. این ویژگی برای اتوماسیون کارهایی مانند بهروزرسانیهای شبانه، بکآپگیریهای منظم، یا پاکسازی کش سایتها بسیار ارزشمند است. برای مثال، میتوانید اسکریپتی بنویسید که هر شب به صورت خودکار تمام افزونهها و هسته وردپرس را در سرور شما بهروزرسانی کند. این سطح از اتوماسیون وردپرس، خطای انسانی را به حداقل میرساند و پایداری سیستمها را افزایش میدهد.
✓ عیبیابی و رفع اشکال پیشرفته
گاهی اوقات یک سایت وردپرسی به دلیل یک افزونه یا پوسته خراب از کار میافتد و دسترسی به پنل مدیریت آن غیرممکن میشود. در چنین شرایطی، WP-CLI ناجی شما خواهد بود. میتوانید از طریق ترمینال وارد سرور شده و با استفاده از دستورات WP-CLI، افزونه مشکلساز را غیرفعال کرده یا به پوسته پیشفرض بازگردید، حتی بدون اینکه وارد محیط گرافیکی شوید. این ابزار به شما امکان میدهد تا لاگها را بررسی کنید، گزینههای پایگاه داده را تغییر دهید، و مشکلات را از ریشه حل کنید، که در مواقع بحرانی ارزش بینهایتی دارد. در سال 2024، بیش از 43% از وبسایتهای جهان از وردپرس استفاده میکنند و قابلیتهای رفع اشکال WP-CLI برای این حجم عظیم از وبسایتها ضروری است.
✓ بهبود امنیت
با اتوماسیون بهروزرسانیها و نصب سریع وصلههای امنیتی، WP-CLI به طور مستقیم به افزایش امنیت سایتهای وردپرسی کمک میکند. مدیران سرور میتوانند اسکریپتهایی را تنظیم کنند تا به محض انتشار بهروزرسانیهای امنیتی وردپرس، به سرعت آنها را در تمام سایتهای خود اعمال کنند. علاوه بر این، ابزارهای مدیریت کاربران در WP-CLI به شما اجازه میدهد تا کاربران مشکوک را شناسایی و حذف کنید یا رمز عبور آنها را تغییر دهید، که همگی به استحکام امنیت وردپرس کمک شایانی میکنند. این کار باعث میشود سایت شما در برابر حملات کمتر آسیبپذیر باشد.
شروع کار با WP-CLI: نصب و راهاندازی اولیه
نصب WP-CLI یک فرآیند ساده است که نیاز به دسترسی به سرور از طریق SSH و داشتن PHP نسخه 5.6 یا بالاتر دارد. در ادامه به صورت گام به گام مراحل نصب را شرح میدهیم.
گام ۱: پیشنیازها
- دسترسی SSH: شما باید به سرور خود از طریق SSH دسترسی داشته باشید.
- PHP: PHP 5.6 یا بالاتر (توصیه میشود PHP 7.4 یا 8.x) باید روی سرور نصب باشد.
- Composer (اختیاری اما توصیه شده): Composer ابزاری برای مدیریت وابستگیهای PHP است که میتواند در آینده به نصب افزونههای WP-CLI کمک کند.
گام ۲: دانلود و نصب WP-CLI
برای دانلود فایل اجرایی WP-CLI، از دستور curl استفاده کنید.
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
پس از دانلود، باید فایل را قابل اجرا کنید:
chmod +x wp-cli.phar
سپس آن را به یک مسیر عمومی در PATH سرور خود منتقل کنید تا بتوانید از هر جایی آن را اجرا کنید. معمولاً /usr/local/bin/ یک گزینه مناسب است:
sudo mv wp-cli.phar /usr/local/bin/wp
گام ۳: تأیید نصب
برای اطمینان از نصب صحیح، دستور زیر را اجرا کنید:
wp --info
اگر نصب با موفقیت انجام شده باشد، اطلاعاتی در مورد نسخه WP-CLI، PHP و سرور شما نمایش داده خواهد شد.
دستورات اصلی WP-CLI برای مدیریت روزمره
WP-CLI شامل صدها دستور مختلف است که هر یک وظیفه خاصی را انجام میدهند. در اینجا به برخی از پرکاربردترین دستورات WP-CLI که برای مدیران سرور بسیار مفید هستند، اشاره میکنیم.
۱. مدیریت هسته وردپرس (wp core)
این مجموعه دستورات برای نصب، بهروزرسانی و مدیریت هسته وردپرس به کار میروند.
- نصب وردپرس:
wp core download - تنظیمات دیتابیس:
wp config create --dbname=... --dbuser=... - نصب وردپرس با دیتابیس:
wp core install --url=... --title=... --admin_user=... --admin_password=... --admin_email=... - بهروزرسانی هسته:
wp core update - بررسی وضعیت هسته:
wp core verify-checksums(برای بررسی فایلهای اصلی وردپرس)
۲. مدیریت افزونهها و پوستهها (wp plugin / wp theme)
این دستورات برای مدیریت افزونهها و پوستههای وردپرس، از نصب تا فعال/غیرفعالسازی، استفاده میشوند.
- لیست افزونهها:
wp plugin list - نصب افزونه:
wp plugin install yoast-seo --activate - غیرفعال کردن افزونه:
wp plugin deactivate problematic-plugin - حذف افزونه:
wp plugin delete spam-plugin - بهروزرسانی همه افزونهها:
wp plugin update --all - لیست پوستهها:
wp theme list - فعال کردن پوسته:
wp theme activate twentytwentyfour
۳. مدیریت کاربران (wp user)
با این دستورات میتوانید کاربران وردپرس را اضافه، حذف یا ویرایش کنید.
- لیست کاربران:
wp user list - افزودن کاربر جدید:
wp user create newuser newuser@example.com --role=author - تغییر رمز عبور:
wp user update admin --user_pass="new-secure-password"
۴. عملیات پایگاه داده (wp db)
این دستورات برای تعامل مستقیم با پایگاه داده وردپرس طراحی شدهاند.
- بهینهسازی پایگاه داده:
wp db optimize - ترمیم پایگاه داده:
wp db repair - ایجاد پشتیبان:
wp db export backup.sql - جستجو و جایگزینی در دیتابیس:
wp search-replace 'old-domain.com' 'new-domain.com'(بسیار مهم برای تغییر دامنه سایت)
تکنیکهای پیشرفته WP-CLI برای مدیران سرور
برای مدیران سرور که به دنبال حداکثر کارایی و کنترل هستند، بهینهسازی وردپرس با CLI فراتر از دستورات اولیه میرود. این بخش به تکنیکهایی میپردازد که شما را به یک متخصص واقعی WP-CLI تبدیل میکند.
۱. کار با چندین نمونه وردپرس
مدیران سرور اغلب مجبورند چندین نصب وردپرس را مدیریت کنند. WP-CLI این کار را آسانتر میکند. شما میتوانید با استفاده از گزینه --path= به WP-CLI بگویید که روی کدام دایرکتوری وردپرس عملیات را انجام دهد.
wp --path=/var/www/site1/ public_html plugin update --all
این دستور تمام افزونههای سایت ۱ را بهروزرسانی میکند. برای مدیریت تعداد زیادی سایت، میتوانید یک اسکریپت شل بنویسید که روی تمام پوشههای وردپرس در سرور شما تکرار شود و دستورات WP-CLI را برای هر یک اجرا کند. این یک روش عالی برای مدیریت چند سایت وردپرسی به صورت همزمان است.
۲. اتوماسیون وظایف با Cron Jobs
Cron Jobs یک ابزار قدرتمند در سیستمهای لینوکسی است که به شما اجازه میدهد دستورات را در زمانهای مشخص به صورت خودکار اجرا کنید. ترکیب WP-CLI با Cron Jobs امکان اتوماسیون وردپرس را به سطح جدیدی میبرد.
# هر روز ساعت 3 صبح، تمام افزونهها را در این مسیر بهروزرسانی کن
0 3 * * * cd /var/www/mysite/public_html && /usr/local/bin/wp plugin update --all --allow-root >> /var/log/wp-cli-update.log 2>&1
توجه داشته باشید که استفاده از --allow-root در محیطهای تولیدی توصیه نمیشود و فقط باید در شرایط خاص و با آگاهی کامل از ریسکها استفاده شود. بهتر است از کاربرانی با حداقل دسترسی لازم برای اجرای Cron Jobs استفاده کنید.
۳. اشکالزدایی و بهینهسازی عملکرد
WP-CLI ابزارهایی برای تشخیص مشکلات عملکردی و اشکالزدایی ارائه میدهد.
- مدیریت کش:
wp cache flush(پاک کردن کش وردپرس) - فعال/غیرفعال کردن حالت اشکالزدایی:
wp config set WP_DEBUG true --type=constant - بررسی رویدادهای Cron وردپرس:
wp cron event list(برای اشکالزدایی وظایف زمانبندی شده)
۴. افزایش امنیت با WP-CLI
WP-CLI میتواند به شما در اعمال تنظیمات امنیتی کلیدی کمک کند.
- تغییر پیشوند جداول دیتابیس:
wp db prefix newprefix_(یک اقدام امنیتی مهم) - بهروزرسانی امنیتی: همواره از
wp core update --minor --forceبرای اعمال سریع وصلههای امنیتی استفاده کنید. - مدیریت کلیدهای امنیتی:
wp config shuffle-salts(برای بازتولید کلیدهای امنیتی وردپرس و افزایش امنیت). این کار امنیت را با تغییر کلیدهای رمزنگاری وردپرس بهبود میبخشد و باعث میشود جلسات فعلی کاربران باطل شود.
عیبیابی مشکلات رایج WP-CLI
حتی با قدرتمندترین ابزارها، ممکن است با مشکلاتی مواجه شوید. در اینجا به برخی از رایجترین مسائل و راهحلهای آنها در WP-CLI میپردازیم.
۱. خطای “wp: command not found”
این خطا معمولاً به این معنی است که فایل اجرایی WP-CLI (یعنی wp) در مسیرهای سیستم شما یافت نمیشود.
- راهحل: اطمینان حاصل کنید که فایل
wpبه/usr/local/bin/یا هر مسیر دیگری که در متغیر محیطیPATHشما قرار دارد، منتقل شده و دارای مجوزهای اجرایی (chmod +x) است.
۲. مشکلات مربوط به مجوزها (Permissions)
گاهی اوقات WP-CLI نمیتواند فایلها را بنویسد یا بخواند، که منجر به خطاهای دسترسی میشود.
- راهحل: اطمینان حاصل کنید که کاربر SSH که با آن WP-CLI را اجرا میکنید، دارای مجوزهای کافی برای دسترسی به فایلها و پوشههای وردپرس است. معمولاً این کاربر باید همان کاربری باشد که وبسرور (مثل Nginx یا Apache) با آن اجرا میشود. میتوانید از دستور
chownبرای تنظیم مالکیت صحیح استفاده کنید.
۳. خطاهای کمبود حافظه (Memory Limit)
برخی از عملیات WP-CLI (مثلاً جستجو و جایگزینی در یک دیتابیس بزرگ) ممکن است به حافظه زیادی نیاز داشته باشند و منجر به خطای “Allowed memory size of X bytes exhausted” شوند.
- راهحل: میتوانید با اضافه کردن
--skip-themesو--skip-pluginsیا افزایش موقتmemory_limitدر فایلphp.iniیا با استفاده از پارامترWP_CLI_PHP_ARGSحافظه اختصاص داده شده به PHP را افزایش دهید.WP_CLI_PHP_ARGS="-d memory_limit=512M" wp search-replace ...
۴. ناسازگاری نسخه PHP
WP-CLI نیاز به نسخه خاصی از PHP برای اجرا دارد و اگر سرور شما از نسخههای قدیمیتر یا ناسازگار استفاده کند، ممکن است با خطا مواجه شوید.
- راهحل: اطمینان حاصل کنید که نسخه PHP پیشفرض سیستم یا نسخهای که WP-CLI از آن استفاده میکند، با وردپرس شما سازگار است (PHP 7.4 به بالا توصیه میشود). در سرورهایی با چندین نسخه PHP، ممکن است لازم باشد مسیر کامل PHP را مشخص کنید، مثلاً:
/usr/bin/php7.4 /usr/local/bin/wp ...
جدول راهنمای سریع دستورات پرکاربرد WP-CLI
| دستور WP-CLI | کاربرد |
|---|---|
wp core update |
بهروزرسانی هسته وردپرس به آخرین نسخه |
wp plugin update --all |
بهروزرسانی تمام افزونههای نصب شده |
wp plugin deactivate <plugin-slug> |
غیرفعال کردن یک افزونه خاص |
wp user list |
نمایش لیست تمام کاربران وردپرس |
wp db optimize |
بهینهسازی پایگاه داده وردپرس |
wp search-replace 'old-url' 'new-url' --dry-run |
جستجو و جایگزینی در دیتابیس (با گزینه آزمایشی) |
wp cache flush |
پاک کردن کش وردپرس |
wp option update blogname 'نام جدید سایت' |
تغییر عنوان سایت |
سوالات متداول (FAQ) درباره WP-CLI
آیا استفاده از WP-CLI امن است؟
بله، WP-CLI یک ابزار کاملاً امن است، البته به شرطی که با دقت و آگاهی استفاده شود. از آنجایی که دستورات WP-CLI مستقیماً بر روی فایلها و پایگاه داده وردپرس عمل میکنند، خطاهای سهوی میتوانند عواقب جدی داشته باشند. همیشه توصیه میشود قبل از اجرای دستورات مخرب یا روی سرور اصلی، از سایت خود یک نسخه پشتیبان تهیه کنید. همچنین، برای امنیت بیشتر، از اجرای دستورات با کاربر root خودداری کنید و از کاربرانی با حداقل دسترسی لازم استفاده کنید.
آیا میتوان WP-CLI را بر روی هاستهای اشتراکی استفاده کرد؟
این بستگی به سیاست و تنظیمات هاستینگ شما دارد. برخی از ارائهدهندگان هاست اشتراکی دسترسی SSH را فراهم میکنند و WP-CLI را از پیش نصب کردهاند یا امکان نصب آن را به کاربران میدهند. اما برخی دیگر ممکن است این امکان را محدود کرده باشند. بهترین راه این است که با پشتیبانی هاستینگ خود تماس بگیرید و از آنها بپرسید که آیا WP-CLI پشتیبانی میشود یا خیر. معمولاً در سرویسهای VPS و سرورهای اختصاصی، امکان استفاده از WP-CLI به طور کامل وجود دارد.
چگونه میتوانم بفهمم که کدام دستورات WP-CLI موجود هستند؟
شما میتوانید با تایپ کردن wp help لیست تمام دستورات اصلی را مشاهده کنید. برای دریافت اطلاعات بیشتر درباره یک دستور خاص، مانند wp plugin، کافی است wp help plugin را وارد کنید. این به شما زیرمجموعهای از دستورات و گزینههای موجود برای آن فرمان را نشان میدهد. مستندات رسمی WP-CLI نیز منبع بسیار خوبی برای یافتن تمام دستورات و نحوه استفاده از آنها است.
آیا WP-CLI جایگزین پنل مدیریت وردپرس میشود؟
خیر، WP-CLI قرار نیست به طور کامل جایگزین پنل مدیریت وردپرس شود. بلکه، این دو ابزار مکمل یکدیگر هستند. پنل مدیریت وردپرس برای کارهای روزمره مانند نوشتن محتوا، تنظیمات عمومی و مدیریت دیداری مناسب است. WP-CLI اما برای وظایف سرورمحور، اتوماسیون، عیبیابی عمیق و انجام عملیات گروهی بسیار کارآمدتر است. مدیران سرور از WP-CLI برای افزایش بهرهوری و کنترل بیشتر استفاده میکنند، در حالی که نویسندگان محتوا و کاربران عادی همچنان از رابط کاربری گرافیکی بهره میبرند.
نتیجهگیری: با WP-CLI قدرت در دستان شماست
همانطور که مشاهده کردید، WP-CLI یک ابزار بینظیر برای هر مدیر سرور، توسعهدهنده یا هر فردی است که به دنبال مدیریت کارآمد وردپرس است. این ابزار نه تنها سرعت و بهرهوری شما را به طرز چشمگیری افزایش میدهد، بلکه امکان اتوماسیون وظایف، عیبیابی پیشرفته و افزایش امنیت را نیز فراهم میآورد. با WP-CLI، شما از محدودیتهای رابط گرافیکی رها میشوید و به دنیایی از کنترل و قدرت مطلق بر روی نصبهای وردپرسی خود قدم میگذارید.
یادگیری WP-CLI یک سرمایهگذاری هوشمندانه در زمان و مهارتهای شماست که نتایج آن را در هر پروژه وردپرسی مشاهده خواهید کرد. از بهروزرسانیهای سریع و ایمن گرفته تا حل مشکلات پیچیده در عرض چند ثانیه، WP-CLI ابزاری است که هیچ مدیر سروری نباید آن را نادیده بگیرد. شروع به کاوش در دنیای WP-CLI کنید و خودتان شاهد تغییرات شگرفی در نحوه مدیریت سرور وردپرس خود باشید. این مسیر نه تنها کارایی شما را بالا میبرد، بلکه به شما اطمینان و اعتماد به نفس بیشتری در مدیریت سیستمهای پیچیده وردپرسی خواهد بخشید.
به یاد داشته باشید که تمرین و تجربه کلید تسلط بر WP-CLI است. با شروع از دستورات پایه و سپس پیشرفت به سمت تکنیکهای پیشرفته، به زودی به یک استاد وردپرس CLI تبدیل خواهید شد.