وردپرس

WP-CLI: نصب وردپرس

wp-cli

WP-CLI رابط Command Line رسمی برای مدیریت WordPress است و امکان انجام بسیاری از عملیات‌ها را بدون ورود به Dashboard فراهم می‌کند. با استفاده از آن می‌توان WordPress را دانلود کرد، فایل wp-config.php ساخت، Database را آماده کرد و Installation را از طریق Terminal تکمیل کرد.

نصب WordPress با WP-CLI مخصوصاً برای Administratorها، VPSها، سرورهای دارای SSH و زمانی که چند Installation باید با سرعت و دقت بیشتری مدیریت شوند مناسب است.

فرآیند اصلی نصب شامل چهار مرحله است:

Download WordPress
        ↓
Create wp-config.php
        ↓
Prepare Database
        ↓
Run WordPress installation

پیش‌نیازهای نصب

قبل از شروع باید موارد زیر آماده باشند:

  • دسترسی SSH به هاست یا Server
  • PHP CLI
  • WP-CLI
  • Database و Database User
  • دسترسی نوشتن در Document Root
  • Domain یا Subdomain موردنظر

ابتدا بررسی کنید WP-CLI در دسترس است:

Bash
wp --info

این دستور اطلاعاتی مانند نسخه WP-CLI، PHP Binary و PHP Version مورد استفاده در Terminal را نمایش می‌دهد.

WP-CLI: نصب وردپرس

برای بررسی PHP:

Bash
php -v

WP-CLI طبق مستندات فعلی حداقل به PHP 7.2.24 نیاز دارد، هرچند برای یک WordPress جدید بهتر است از نسخه‌های PHP پشتیبانی‌شده و به‌روز استفاده شود.

WP-CLI: نصب وردپرس

اگر دستور:

wp

شناخته نمی‌شود، WP-CLI باید روی Server نصب شود یا Hosting Provider دسترسی آن را فراهم کند.

انتخاب مسیر نصب WordPress

ابتدا وارد Document Root دامنه شوید.

برای مثال در cPanel ممکن است مسیر سایت اصلی:

Bash
cd ~/public_html

باشد.

در یک ساختار دیگر ممکن است مسیری مانند:

Bash
cd /var/www/example.com/public_html

داشته باشید.

قبل از ادامه:

Bash
pwd

و:

Bash
ls -la

را اجرا کنید تا مطمئن شوید در Directory صحیح قرار دارید.

این مرحله مهم است، زیرا اجرای wp core download در مسیر اشتباه باعث می‌شود فایل‌های WordPress در Directory نامناسب قرار بگیرند.

در صورتی که از root برای دستورات wp استفاده می‌کنید باید از --allow-root در انتهای هر دستور استفاده کنید. پیشنهاد می‌شود انجام هر یک از این دستورات به جای root با دسترسی کاربر صاحب website یا یک کاربر با دسترسی sudo به جز root انجام شود.

دانلود WordPress با WP-CLI

برای دانلود آخرین نسخه WordPress در Directory فعلی:

Bash
wp core download

WP-CLI فایل‌های WordPress را دانلود و Extract می‌کند. دستور wp core download به‌صورت پیش‌فرض از Directory فعلی استفاده می‌کند و Package دانلودشده را نیز بررسی می‌کند.

WP-CLI: نصب وردپرس

بعد از پایان می‌توانید بررسی کنید:

Bash
ls -la

باید فایل‌ها و Directoryهایی مانند زیر دیده شوند:

wp-admin
wp-content
wp-includes
wp-config-sample.php
wp-login.php
index.php
...
WP-CLI: نصب وردپرس

دانلود WordPress با زبان مشخص

برای مثال برای دانلود نسخه فارسی:

Bash
wp core download --locale=fa_IR

یا برای انگلیسی:

Bash
wp core download --locale=en_US

گزینه --locale زبان Package را مشخص می‌کند. همچنین --version برای انتخاب نسخه خاص WordPress قابل استفاده است.

مثلاً:

Bash
wp core download --version=6.x.x

در حالت عادی بهتر است آخرین نسخه Stable نصب شود و نسخه قدیمی فقط زمانی انتخاب شود که نیاز Compatibility مشخصی وجود داشته باشد.

آماده‌سازی Database

WordPress به یک Database و Database User نیاز دارد.

اطلاعات موردنیاز معمولاً شامل موارد زیر است:

Database Name
Database Username
Database Password
Database Host

در بیشتر Hostingها مقدار Database Host:

localhost

است، اما همیشه این موضوع را از Control Panel یا Hosting Provider بررسی کنید.

در cPanel، Plesk یا DirectAdmin معمولاً بهتر است Database و User را ابتدا از Control Panel ایجاد کرده و User را به Database متصل کنید.

دلیل این موضوع این است که Hosting User ممکن است Permission لازم برای اجرای:

CREATE DATABASE

را از طریق WP-CLI نداشته باشد.

ساخت wp-config.php

فایل Configuration را ایجاد کنید.

مثلاً:

Bash
wp config create \
  --dbname=example_wp \
  --dbuser=example_user \
  --dbpass='STRONG_PASSWORD' \
  #--skip-check \  # if you are using wp-cli to create the database
  --dbhost=localhost

این دستور فایل:

wp-config.php

را ایجاد و اطلاعات Database را در آن ثبت می‌کند.

WP-CLI: نصب وردپرس
WP-CLI: نصب وردپرس

در این دستور --skip-check هم قرار داده شده است. این دستور اتصال به دیتابیس را بررسی نمی‌کند. دلیل این است که می‌توانیم با استفاده از اطلاعات ثبت شده در wp-config و دستور wp db create دیتابیس را با wp-cli ایجاد کنیم.

به طور کلی wp config create به‌صورت پیش‌فرض اتصال Database را نیز بررسی می‌کرد و Saltهای موردنیاز WordPress را ایجاد می‌کند.

دستورات متفاوتی نیز برای بررسی wp-config.php بعد از ایجاد شدن آن وجود دارد:

Bash
wp config get DB_USER

خروجی این دستور نام کاربر دیتابیس است، از این دستور می‌توان برای DB_PASS، DB_NAME و دیگر اطلاعات استفاده کرد.

همچنین می‌توان با:

Bash
wp config list

اطلاعات کلی wp-config را در یک جدول مشابه تصویر زیر مشاهده کنید.

WP-CLI: نصب وردپرس

در صورتی که نیاز به تغییر این اطلاعات پس از ایجاد اولیه wp-config.php وجود داشته باشد می‌توان از دستور زیر نیز استفاده کرد:

Bash
wp config set DB_HOST <host_ip>

ساخت دیتابیس با wp-cli

WP-CLI از دستور:

Bash
wp db create

نیز پشتیبانی می‌کند و می‌تواند Database تعریف‌شده در wp-config.php را ایجاد کند. به همین علت برای این روش باید ابتدا wp-config را ایجاد کنید. این روش در راهنمای رسمی Installation نیز استفاده شده است.

خروجی مورد انتظار دستور خروجی زیر است:

WP-CLI: نصب وردپرس

پس از اینکه دیتابیس ساخته شد می‌توان دسترسی وردپرس به سایت را بررسی کرد. برای این منظور از این دستور استفاده کنید:

Bash
wp db check
WP-CLI: نصب وردپرس

جلوگیری از ذخیره Password در Shell History

قرار دادن Password به شکل مستقیم:

--dbpass='PASSWORD'

ممکن است باعث شود Password داخل Shell History باقی بماند.

برای محیط‌های حساس می‌توانید از Prompt استفاده کنید:

Bash
wp config create \
  --dbname=example_wp \
  --dbuser=example_user \
  --dbhost=localhost \
  --prompt=dbpass

در این حالت WP-CLI مقدار Password را جداگانه درخواست می‌کند. مستندات رسمی wp config create نیز استفاده از --prompt=dbpass را برای جلوگیری از قرار دادن مستقیم Password در Command پیشنهاد می‌کنند.

تغییر Table Prefix

Prefix پیش‌فرض WordPress:

wp_

است.

در صورت نیاز می‌توانید هنگام ساخت Configuration مقدار دیگری تعیین کنید:

Bash
wp config create \
  --dbname=example_wp \
  --dbuser=example_user \
  --prompt=dbpass \
  --dbprefix=site_

در این حالت Tableهایی مانند:

site_posts
site_users
site_options

ایجاد خواهند شد.

تغییر Prefix به‌تنهایی یک مکانیزم امنیتی مهم محسوب نمی‌شود و معمولاً دلیل اصلی استفاده از آن Naming یا جداسازی Installationها است.

اجرای Installation اصلی WordPress

بعد از آماده شدن فایل‌های WordPress و wp-config.php، Installation را اجرا کنید:

Bash
wp core install \
  --url="https://example.com" \
  --title="Example Website" \
  --admin_user="siteadmin" \
  --admin_password="STRONG_ADMIN_PASSWORD" \
  --admin_email="admin@example.com"

دستور wp core install جدول‌های WordPress را داخل Database ایجاد کرده و اطلاعات سایت و Administrator اولیه را ثبت می‌کند.

در صورت موفقیت باید پیامی مشابه زیر مشاهده شود:

Success: WordPress installed successfully.
WP-CLI: نصب وردپرس

پارامترهای wp core install

مهم‌ترین مقادیر عبارت‌اند از:

--url

آدرس اصلی سایت:

https://example.com

بهتر است اگر SSL فعال است، از ابتدا HTTPS وارد شود.

--title

نام اولیه سایت:

Example Website

بعداً از WordPress Dashboard نیز قابل تغییر است.

--admin_user

Username مربوط به Administrator.

بهتر است از مقادیر قابل حدس مانند:

admin
administrator
root

استفاده نشود.

--admin_password

Password حساب Administrator.

از Password قوی و منحصربه‌فرد استفاده کنید.

--admin_email

Email مربوط به Administrator که برای Password Reset و Notificationهای WordPress استفاده می‌شود.

بررسی موفق بودن Installation

برای بررسی وضعیت:

Bash
wp core is-installed

این دستور خروجی متنی عادی تولید نمی‌کند و وضعیت Installation را از طریق Exit Code مشخص می‌کند. برای مشاهده exit code می‌توان از دستور echo $? استفاده کرد که 0 مطابق موفقیت آمیز بودن دستور پیشین در لینوکس است:

WP-CLI: نصب وردپرس

یک روش ساده‌تر برای بررسی عملی:

Bash
wp core version

مثلاً:

6.x.x
WP-CLI: نصب وردپرس

همچنین می‌توانید URLهای ثبت‌شده در WordPress را ببینید:

Bash
wp option get home

و:

Bash
wp option get siteurl

هر دو باید با آدرس موردنظر شما هماهنگ باشند.

WP-CLI: نصب وردپرس

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

Bash
wp user list
WP-CLI: نصب وردپرس

در نهایت سایت را در Browser باز کنید:

https://example.com
WP-CLI: نصب وردپرس

و صفحه مدیریت را نیز بررسی کنید:

https://example.com/wp-admin/
WP-CLI: نصب وردپرس

نصب WordPress در Subdirectory

فرض کنید WordPress در:

public_html/wp

قرار گرفته است.

می‌توانید فایل‌ها را مستقیماً در آن مسیر دانلود کنید:

Bash
wp core download --path=wp

یا ابتدا وارد Directory شوید:

Bash
cd wp
wp core download

در Installationهای Subdirectory باید siteurl و URL نهایی سایت با ساختار موردنظر هماهنگ باشند. مستندات wp core install نیز به این موضوع اشاره می‌کنند.

اگر هدف شما یک Installation معمولی روی:

example.com

است، WordPress را در Document Root دامنه نصب کنید تا پیچیدگی اضافی ایجاد نشود.

تنظیم زبان بعد از نصب

اگر WordPress را با زبان دیگری نصب کرده‌اید، Language Pack را بعداً نیز می‌توان با WP-CLI مدیریت کرد.

برای نصب و فعال کردن فارسی:

Bash
wp language core install fa_IR --activate

دستور wp language core install Language Pack را از WordPress.org دریافت می‌کند و گزینه --activate آن را فعال می‌کند.

WP-CLI: نصب وردپرس

و در ورود بعدی به سایت یا داشبورد wp-admin تغییر زبان اعمال خواهد شد:

WP-CLI: نصب وردپرس

نصب Plugin و Theme بعد از Installation

پس از نصب WordPress می‌توانید Pluginها را نیز از Command Line نصب کنید.

مثلاً:

Bash
wp plugin install duplicator --activate
WP-CLI: نصب وردپرس

که در اولین ورود بعدی با صفحه اطلاع نصب این افزونه مواجه خواهیم شد:

WP-CLI: نصب وردپرس

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

یا برای Theme:

Bash
wp theme install twentytwentysix --activate

این قابلیت یکی از مزیت‌های WP-CLI است، زیرا می‌توان یک Installation کامل را بدون ورود به Dashboard آماده کرد.

برای مدیریت عادی Pluginها می‌توانید مقاله زیر را نیز ببینید:

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

Permission و Ownership فایل‌ها

یکی از اشتباهات مهم هنگام استفاده از WP-CLI اجرای Commandها با User نامناسب است.

اگر WordPress متعلق به User هاست است، بهتر است WP-CLI نیز با همان User اجرا شود.

برای بررسی:

ls -la

اگر فایل‌های WordPress به اشتباه متعلق به:

root:root

باشند ولی Web Server یا Hosting Account با User دیگری کار کند، ممکن است مشکلاتی مانند موارد زیر ایجاد شود:

Permission denied
Failed to update plugin
Cannot create directory
Upload failed

بنابراین صرفاً برای راحتی WP-CLI را با root اجرا نکنید.

اگر WP-CLI درباره اجرای Command به‌عنوان Root هشدار می‌دهد، بهتر است به‌جای استفاده مستقیم از --allow-root ابتدا بررسی کنید چرا با Root وارد شده‌اید.

خطای Error establishing a database connection

اگر هنگام:

Bash
wp config create

یا:

Bash
wp core install

با خطای Database Connection مواجه شدید، موارد زیر را بررسی کنید:

Database Name
Database Username
Password
Database Host
User privileges

در cPanel و بعضی Hostingها فقط ساخت Database و User کافی نیست؛ User باید به Database نیز Assign شود و Permission لازم داشته باشد.

خطای wp: command not found

اگر:

wp: command not found

نمایش داده می‌شود، WP-CLI نصب نیست یا Binary آن داخل PATH قرار ندارد.

بررسی کنید:

Bash
which wp

اگر خروجی ندارد، باید WP-CLI نصب شود یا از Hosting Provider درباره دسترسی به آن سؤال کنید.

روش رسمی نصب WP-CLI شامل دانلود Phar این ابزار، سپس Executable کردن آن و قرار دادن Binary در PATH است.

خطای PHP Version یا PHP Extension

گاهی PHP مورد استفاده در Website با PHP موجود در SSH متفاوت است.

برای بررسی PHP مربوط به CLI:

Bash
php -v

و:

Bash
wp --info

را مقایسه کنید.

wp --info مشخص می‌کند WP-CLI در واقع از کدام PHP Binary استفاده می‌کند.

این نکته در Hostingهایی که چند PHP Version دارند اهمیت بیشتری دارد.

مشکل TLS هنگام دانلود WordPress

اگر:

Bash
wp core download

نتواند از WordPress.org فایل دریافت کند، مواردی مانند:

  • DNS Resolver
  • Internet Access
  • CA Certificate
  • Firewall
  • Proxy

را بررسی کنید.

WP-CLI گزینه --insecure نیز دارد، اما این گزینه Certificate Validation را غیرفعال می‌کند و اتصال را در برابر حملات MITM آسیب‌پذیر می‌کند؛ بنابراین نباید به‌عنوان راه‌حل عادی استفاده شود.

بهتر است علت اصلی TLS Error برطرف شود.

یک نمونه کامل از Installation

فرض کنیم موارد زیر را داریم:

Domain: example.com
Database: example_wp
Database User: example_user

ابتدا وارد Document Root شوید:

Bash
cd ~/public_html

WordPress را دانلود کنید:

Bash
wp core download

Configuration را بسازید:

Bash
wp config create \
  --dbname=example_wp \
  --dbuser=example_user \
  --dbhost=localhost \
  --prompt=dbpass

و Installation را کامل کنید:

Bash
wp core install \
  --url="https://example.com" \
  --title="Example Website" \
  --admin_user="siteadmin" \
  --admin_password="STRONG_PASSWORD" \
  --admin_email="admin@example.com"

در پایان:

Bash
wp core version

و:

Bash
wp option get siteurl

را بررسی کنید.

این چهار مرحله برای بیشتر Installationهای معمول WordPress با WP-CLI کافی هستند.

WP-CLI یا WP Toolkit؟

هر دو روش نصب WordPress را ساده‌تر می‌کنند، اما کاربرد متفاوتی دارند.

روشمناسب برای
WP Toolkitکاربران Control Panel و مدیریت گرافیکی
WP-CLIAdministratorها، SSH و Automation
File Managerنصب دستی بدون WP-CLI یا Toolkit

اگر محیط گرافیکی را ترجیح می‌دهید:

نصب وردپرس با WP Toolkit

و اگر SSH یا WP-CLI در دسترس نیست:

آموزش نصب دستی wordpress از طریق File Manager

اشتباهات رایج

اجرای Command در Directory اشتباه

قبل از wp core download همیشه:

Bash
pwd

را بررسی کنید.

استفاده از Root بدون نیاز

این کار می‌تواند Ownership فایل‌های WordPress را خراب کند.

وارد کردن Password در Command History

برای Database Password می‌توانید از:

Bash
--prompt=dbpass

استفاده کنید.

وارد کردن URL اشتباه

اگر سایت HTTPS دارد، هنگام wp core install آدرس صحیح را وارد کنید:

Bash
https://example.com

استفاده از Database User بدون Permission

User باید دسترسی لازم به Database موردنظر داشته باشد.

Workflow سریع

SSH to server
      ↓
Check wp --info
      ↓
Open document root
      ↓
wp core download
      ↓
Create database/user
      ↓
wp config create
      ↓
wp core install
      ↓
Check wp core version
      ↓
Open website and wp-admin

مطالعه بیشتر

مقالات مرتبط در دانشنامه:

منابع رسمی:

جمع‌بندی

مهم‌ترین نکات هنگام Installation، اجرای Commandها در Document Root صحیح، استفاده از User مناسب، تنظیم صحیح Database و وارد کردن URL درست سایت هستند.

نظرات خود را بنویسید...

اشتراک گذاری این مقاله

WP-CLI: نصب وردپرس

کپی کردن لینک

سلام