استفاده از WP-CLI برای مدیریت سایت وردپرس

WP-CLI ابزار خط فرمانی برای توسعه و مدیریت وردپرس است که به شما امکان می‌دهد بسیاری از عملیات روی سایت وردپرس خود را بدون نیاز به ورود به داشبورد انجام دهید.

استفاده از WP-CLI سرعت کار شما را افزایش می‌دهد و با امکان اسکریپت‌نویسی در Bash می‌توانید کارهای تکراری و زمان‌بر را خودکار کنید.

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

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

در این بخش، جدیدترین نسخه WP-CLI را روی سرور خود نصب خواهید کرد. این ابزار به صورت یک فایل Phar ارائه می‌شود که بسته‌بندی اپلیکیشن‌های PHP برای سهولت توزیع است.

می‌توانید فایل Phar WP-CLI را با دستور curl دانلود کنید:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

بعد از دانلود فایل، با دستور زیر بررسی کنید که فایل به درستی کار می‌کند:

php wp-cli.phar --info

خروجی مشابه زیر دریافت خواهید کرد:

OS: Linux
(...)
PHP binary: /usr/bin/php

برای اجرایی کردن فایل، دستور زیر را اجرا کنید:

chmod +x wp-cli.phar

اکنون می‌توانید فایل wp-cli.phar را مستقیم اجرا کنید. برای دسترسی در هر دایرکتوری فایل را به /usr/local/bin/ منتقل کنید و نام آن را به wp تغییر دهید:

sudo mv wp-cli.phar /usr/local/bin/wp

با این کار، دستور wp را از هر محل می‌توانید اجرا کنید:

wp --info

در این مرحله WP-CLI را نصب کردید. روش‌های نصب دیگری هم در مستندات وجود دارد.

مدیریت افزونه‌ها با WP-CLI

نصب و مدیریت افزونه‌ها از طریق رابط کاربری دشوار و زمان‌بر است. WP-CLI این کار را سریع‌تر و ساده‌تر می‌کند.

ابتدا به دایرکتوری نصب وردپرس خود بروید:

cd /path/to/wordpress

دستور زیر افزونه‌های نصب شده را نمایش می‌دهد:

wp plugin list

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

برای جستجوی افزونه‌ها در مخزن می‌توانید از دستور زیر استفاده کنید:

wp plugin search seo

با این دستور لیست ده افزونه برتر مرتبط نمایش داده می‌شود. برای مشاهده صفحه بعدی:

wp plugin search seo --page=2

برای نصب افزونه، نام slug افزونه مورد نظر را گرفته و دستور زیر را اجرا کنید:

wp plugin install plugin-slug

برای نصب و فعال‌سازی همزمان:

wp plugin install plugin-slug --activate

افزونه‌ها را می‌توان به صورت زیر فعال یا غیرفعال کرد:

wp plugin activate plugin-slug
wp plugin deactivate plugin-slug

برای فعال یا غیرفعال کردن همه افزونه‌ها به صورت زیر:

wp plugin activate --all
wp plugin deactivate --all

برای بروزرسانی افزونه‌ها:

wp plugin update plugin-slug
wp plugin update --all

برای حذف افزونه‌ها:

wp plugin delete plugin-slug
wp plugin delete --all

مدیریت قالب‌ها با WP-CLI

مدیریت قالب‌ها مشابه افزونه‌ها است.

نمایش قالب‌های نصب شده:

wp theme list

جستجوی قالب:

wp theme search color

قالب دلخواه را نصب و فعال کنید:

wp theme install ColorMag --activate

بروزرسانی قالب‌ها:

wp theme update twentynineteen twentytwentyone

حذف قالب‌ها و سایر عملیات با دستورات مشابه قابل انجام است. برای مشاهده دستورها:

wp help theme
wp help theme install

مدیریت محتوا با WP-CLI

مطالب سایت را می‌توانید با:

wp post list

مشاهده کنید.

حذف پست با شناسه:

wp post delete ID

ایجاد پست جدید:

wp post create --post_status=publish --post_title="عنوان پست" --edit

در ویرایشگر vim باز خواهد شد. برای نوشتن متن، کلید i را بزنید و بعد از اتمام ESC سپس :wq و ENTER بزنید.

در صورت تمایل می‌توانید محتوا را از فایل متنی وارد کنید:

ابتدا فایل متنی را بسازید و ویرایش کنید سپس:

wp post create /path/to/file.txt --post_status=publish --post_title="عنوان پست"

برای ایجاد صفحه (page) به جای نوشته:

wp post create --post_type=page --post_status=publish --post_title="عنوان صفحه"

تولید داده تستی (dummy data) جهت تست قالب یا افزونه:

wp post generate
wp post generate --count=20
wp post generate --post_type=page --count=10

حذف تمام نسخه‌های ذخیره شده (revisions) محتوا جهت بهبود عملکرد:

wp post delete $(wp post list --post_type='revision' --format=ids) --force

کار با دیتابیس وردپرس با WP-CLI

برای ورود به محیط تعاملی MySQL:

wp db cli

اجرای کوئری‌های سفارشی:

wp db query "SELECT * FROM wp_users;"

پشتیبان‌گیری از دیتابیس:

wp db export

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

برای بازگردانی دیتابیس از فایل پشتیبان:

wp db import /path/to/backup.sql

عملیات جستجو و جایگزینی (find and replace) در دیتابیس:

بررسی تعداد مواردی که تغییر می‌کند (dry run):

wp search-replace 'oldstring' 'newstring' --dry-run

اجرای واقعی جایگزینی:

wp search-replace 'oldstring' 'newstring'

بروزرسانی هسته وردپرس با WP-CLI

بررسی نسخه فعلی وردپرس:

wp core version

بررسی بروزرسانی‌های موجود:

wp core check-update

نصب بروزرسانی:

wp core update

بروزرسانی به نسخه خاص:

wp core update --version=5.7.2

برای برگشت به نسخه قدیمی باید از –force استفاده کنید (غیرمترجح):

wp core update --version=5.7.2 --force

مجوزهای کاربری و مشکلات دسترسی WP-CLI

اگر هنگام اجرای دستورات WP-CLI خطای دسترسی به فایل‌ها مانند wp-config.php دریافت می‌کنید، احتمالاً مشکل از سطح دسترسی فایل‌ها و کاربران اجرای WP-CLI است.

بهتر است WP-CLI با همان کاربری که وب‌سرور استفاده می‌کند اجرا شود تا اجازه‌ دسترسی به فایل‌ها و دایرکتوری‌های مربوطه داشته باشد.

برای اضافه کردن دسترسی مورد نیاز به کاربر MySQL خود با استفاده از WP-CLI، به صورت مستقیم در WP-CLI دستوری برای تغییر پرمیشن MySQL وجود ندارد، اما می‌توانید به پنل مدیریتی دیتابیس مثل mysql CLI یا phpMyAdmin متصل شده و مجوزها را تنظیم کنید.

در سرورهایی که با planهای پارمین کلود در زیر بار لود بالانسر هستند و سایت بدون راه‌اندازی اولیه WP-CLI نصب شده، می‌توانید به سادگی فایل اجرایی wp را نصب و با کاربر مناسب راه‌اندازی کنید و نیازی به راه‌اندازی مجدد سایت از ابتدا نیست.

در نهایت، توجه داشته باشید که اجرای WP-CLI نیازمند دسترسی به فایل‌های سایت وردپرس و همچنین دسترسی لازم به دیتابیس است.

از همراهی شما با پارمین کلود سپاسگذاریم.