Как правильно установить WP-CLI: полное руководство по настройке WP-CLI для Linux, macOS и Windows

В этой статье мы расскажем, как пошагово установить WP-CLI в Debian, Ubuntu, Fedora, RHEL, AlmaLinux, Rocky Linux, macOS и Windows (через WSL).

В этой статье также рассказывается об установке PHP, MySQL, необходимых расширений и полной предварительной проверке. Выполняйте все шаги по порядку, особенно если у вас новый сервер или чистая установка ОС.

Прежде чем начать

Это часть 2 из серии статей о WP-CLI. Если вы еще не читали первую часть, начните с нее.

Здесь объясняется, что такое WP-CLI, почему его используют профессионалы и какие тарифные планы хостинга его поддерживают.

Список необходимых условий

Прежде чем загружать WP-CLI, убедитесь, что в вашей системе есть пять необходимых компонентов. Если какого-то из них не хватает, WP-CLI либо не установится, либо выдаст фатальную ошибку при выполнении первой команды. Проверьте все пункты этого списка.

Необходимое условие 1: UNIX-подобная среда

WP-CLI изначально работает на Linux, macOS и FreeBSD. В Windows используйте WSL (подсистему Windows для Linux). WP-CLI не работает в обычной командной строке Windows или PowerShell.

Подтвердите, что ваша оболочка работает:

whoami
pwd

Обе команды должны выполняться без ошибок. Если это так, значит, ваша среда готова.

Необходимое условие 2: доступ по SSH

Для работы WP-CLI требуется доступ к терминалу на вашем сервере. На локальном компьютере он уже есть. На удаленном сервере необходимо включить SSH в тарифном плане хостинга.

Проверьте, работает ли SSH-доступ:

echo "SSH работает"

Если вы видите эту строку на экране, значит, у вас есть необходимый доступ. Если вы не уверены, что ваш тарифный план хостинга включает SSH, обратитесь к разделу «Требования к хостингу» в первой части этой серии статей.

Необходимое условие 3: PHP 7.2.24 или более поздняя версия с необходимыми расширениями

Если это новый сервер или чистая установка ОС, PHP может отсутствовать. Сначала выполните эту проверку:

php --version

Если вы видите сообщение «команда не найдена», установите PHP, прежде чем делать что-либо еще.

Вам нужен PHP 7.2.24 или более поздняя версия (это минимальный необходимый уровень согласно официальной документации). Если у вас более старая версия, обновите PHP, прежде чем продолжить.

Установите PHP с необходимыми расширениями в Ubuntu / Debian:

sudo apt update
sudo apt install php php-cli php-mysql php-curl php-xml php-mbstring php-zip php-gd php-intl php-bcmath

Fedora / RHEL / CentOS / AlmaLinux / Rocky Linux:

sudo dnf install php php-cli php-mysqlnd php-curl php-xml php-mbstring php-zip php-gd php-intl php-bcmath

openSUSE (открЫТОЕ использование):

sudo zypper install php8 php8-cli php8-mysql php8-curl php8-xml php8-mbstring php8-zip php8-gd php8-intl php8-bcmath

macOS (через Homebrew):

brew install php

Примечание: большинство необходимых расширений по умолчанию включены в macOS.

После установки убедитесь, что PHP готов к работе:

php --version
php -m | grep -E 'mysqli|curl|xml|mbstring|zip|gd|intl'

Обе проверки должны завершиться успешно, прежде чем вы перейдете к следующему шагу.

При запросе расширений php вы должны увидеть список всех доступных расширений. Если каких-то расширений нет в списке, установите пакет для этой версии, содержащий это расширение, и повторите проверку.

Вот что делает каждое расширение, чтобы вы точно знали, зачем оно нужно:

Необходимое условие 4: MySQL или MariaDB запущены и доступны

WordPress хранит все данные (контент, настройки, информацию о пользователях и параметры) в базе данных. Без работающего сервера базы данных wp config create и wp core install сразу же выдадут ошибку подключения.

WordPress рекомендует MySQL 8.0+ или MariaDB 10.6+ в качестве безопасного и современного базового решения для обеспечения производительности и безопасности. При установке с нуля используйте MySQL 8.4 LTS или MariaDB 10.11 LTS. Обе версии имеют длительный срок поддержки.

Проверьте, установлен ли уже сервер базы данных

mysql --version

# или

mariadb --version

Если вы видите сообщение «команда не найдена» для обеих команд, установите одну из них.

Установите MySQL

Debian / Ubuntu / Linux Mint:

sudo apt update
sudo apt install mysql-server

RHEL / CentOS / AlmaLinux / Rocky Linux:

sudo dnf install mysql-server

Установите MariaDB (рекомендуется в качестве замены)

Debian / Ubuntu / Linux Mint:

sudo apt update
sudo apt install mariadb-server

Fedora / RHEL / CentOS / AlmaLinux / Rocky Linux:

sudo dnf install mariadb-server

openSUSE (открЫТОЕ использование):

sudo zypper install mariadb

macOS (через Homebrew):

brew install mariadb

Запустите и включите Службу

# Для MySQL
sudo systemctl start mysql
sudo systemctl enable mysql

# Для MariaDB
sudo systemctl start mariadb
sudo systemctl enable mariadb

Флаг enable обеспечивает автоматический запуск службы при каждой перезагрузке сервера. Без него вам придется каждый раз запускать базу данных вручную.

Запустите мастер безопасной установки

Рекомендуется для любых сред, кроме Docker и локальных.

# Для MySQL
sudo mysql_secure_installation

# Для MariaDB
sudo mariadb-secure-installation

Это позволяет удалить тестовые базы данных по умолчанию, отключить удаленный вход в систему с правами root и установить надежный пароль для root. Процедура занимает около двух минут и значительно повышает безопасность вашей базы данных.

Создание базы данных и пользователя WordPress

sudo mysql -u root -p

Затем в командной строке MySQL/MariaDB выполните следующие SQL-команды:

CREATE DATABASE wordpress CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'wpuser'@'localhost' IDENTIFIED BY 'StrongPassword123';
GRANT ALL PRIVILEGES ON wordpress.* TO 'wpuser'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Замените приведенные ниже значения на свои:

• wordpress — предпочитаемое вами имя базы данных (например, mysite_db).
• wpuser — предпочитаемое вами имя пользователя базы данных.
• StrongPassword123 — надежный и уникальный пароль. Никогда не используйте простой пароль на рабочем сервере.

Параметр CHARACTER SET utf8mb4 гарантирует, что WordPress с самого начала корректно обрабатывает международные символы, эмодзи и специальные знаки. Строка FLUSH PRIVILEGES указывает серверу базы данных на необходимость немедленной перезагрузки таблиц разрешений.

Проверьте подключение к базе данных

Прежде чем двигаться дальше, убедитесь, что новый пользователь действительно может подключиться:

mysql -u wpuser -p wordpress

Если после этого в командной строке MySQL не возникнет ошибок, ваша база данных готова. Введите exit для выхода.

Зачем использовать 127.0.0.1 вместо localhost иногда: Когда вы передаете --dbhost=localhost, PHP подключается через файл сокета Unix. Если этот путь к сокету отличается между PHP и MySQL в вашей системе, вы получаете ошибку 2002 «Нет такого файла или каталога». Использование --dbhost=127.0.0.1 заставляет PHP использовать вместо этого TCP-соединение, которое полностью обходит сокет. Переключитесь на 127.0.0.1 если localhost выдает эту ошибку.

Необходимое условие 5: WordPress 4.9 или более поздняя версия

Для WP-CLI требуется WordPress 4.9 или более поздняя версия. Версии, выпущенные до последней версии WordPress, могут иметь ограниченную функциональность. Это не проблема для новых установок, поскольку при загрузке ядра WordPress с помощью wp core download всегда устанавливается последняя стабильная версия. Однако если вы используете WP-CLI на существующем старом сайте, сначала проверьте версию WordPress:

wp core version

Если у вас версия ниже 4.9, обновите WordPress, прежде чем использовать WP-CLI:

wp core update

Full Preliminary Check

Run all four checks before downloading WP-CLI. Every line must return clean output with no errors before you proceed.

#1. Убедитесь, что у вас установлена версия PHP 7.2.24 или выше
php --version

# 2. Убедитесь, что загружены все необходимые расширения
php -m | grep -E 'mysqli|curl|xml|mbstring|zip|gd|intl|bcmath'

# 3. Убедитесь, что MySQL или MariaDB запущены
sudo systemctl status mysql # или: sudo systemctl status mariadb

# 4. Убедитесь, что вы можете войти в базу данных под учетной записью WordPress
mysql -u wpuser -p wordpress -e "SELECT 'Connection OK';"

Все четыре проверки должны пройти успешно. После этого загрузите WP-CLI.

Шаг 1. Проверка доступа по SSH

Прежде чем загружать WP-CLI, выполните быструю финальную проверку, чтобы убедиться, что сеанс работы в командной оболочке активен и вы находитесь в нужном месте на сервере:

whoami # показывает, от имени какого пользователя вы работаете
pwd # показывает, в каком каталоге вы находитесь в данный момент

Обе команды должны выполняться без ошибок. Если вы работаете на удаленном сервере, перед продолжением убедитесь, что вы подключены по протоколу SSH. Если вы работаете локально, например в контейнере Docker или в локальной среде Linux, у вас уже есть доступ и вы можете сразу перейти к шагу 2.

Шаг 2. Скачайте WP-CLI

Скачайте последнюю стабильную версию WP-CLI с помощью:

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

Или используйте wget, если curl недоступно в вашей системе:

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

Для тех, кто не в курсе: PHAR-файл — это автономное PHP-приложение.

Проверьте подпись PHAR

Этот шаг рекомендуется выполнять на рабочих серверах и в средах с повышенными требованиями к безопасности. Он подтверждает, что загруженный файл не был изменен.

Скачайте файл с подписью:

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

Затем проверьте его с помощью открытого ключа WP-CLI:

gpg --keyserver keyserver.ubuntu.com --recv-keys 63AF7AA15067C05616FDDD88A3A2E8F226F0BC06
gpg --verify wp-cli.phar.asc wp-cli.phar

Если файл действителен, возвращается Good signature from "WP-CLI (Signing Key)". Если проверка не пройдена, удалите файл PHAR и загрузите его заново. Не устанавливайте файл, подпись которого не прошла проверку.

Шаг 3. Проверьте загрузку

Убедитесь, что загруженный файл работает корректно, прежде чем устанавливать его на всю систему:

php wp-cli.phar --info

Здесь должна отображаться информация о версии WP-CLI, конфигурации вашей системы, пути к двоичному файлу PHP, версии PHP и сведения об операционной системе. Если вы видите такой вывод, файл действителен и готов к установке.

Шаг 4. Сделайте файл доступным для глобального использования

Предоставьте файлу права на выполнение, затем переместите его в системный каталог, чтобы можно было запускать wp из любого каталога:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Шаг 5. Подтвердите установку

Убедитесь, что команда wp работает в любой точке вашей системы:

wp --info

Если вы видите информацию о версии и системе, значит, WP-CLI полностью установлен и готов к использованию. Вот какой результат вы должны получить:

OS:	Linux 7.0.0-15-generic #15-Ubuntu SMP PREEMPT_DYNAMIC Wed Apr 22 16:06:43 UTC 2026 x86_64
Shell:	/bin/bash
PHP binary:	/usr/bin/php8.5
PHP version:	8.5.4
php.ini used:	/etc/php/8.5/cli/php.ini
MySQL binary:	
MySQL version:	
SQL modes:	
WP-CLI root dir:	phar://wp-cli.phar/vendor/wp-cli/wp-cli
WP-CLI vendor dir:	phar://wp-cli.phar/vendor
WP_CLI phar path:	phar:///usr/local/bin/wp
WP-CLI packages dir:	
WP-CLI cache dir:	/home/senthilkumar/.wp-cli/cache
WP-CLI global config:	
WP-CLI project config:	
WP-CLI version:	2.12.0

Официальную документацию по установке можно найти по адресу: https://wp-cli.org/#installing.

Альтернативные способы установки

Описанный выше метод с использованием PHAR работает на всех системах. Однако вам могут больше подойти два других способа.

Ubuntu PPA (apt install)

Если вы управляете серверами на базе Ubuntu или Debian и предпочитаете устанавливать инструменты через apt, то в поддерживаемом сообществом PPA есть готовая версия WP-CLI:

sudo add-apt-repository ppa:tiagohillebrandt/wp-cli
sudo apt update
sudo apt install wp-cli

PPA поддерживается волонтером из сообщества и может немного отставать от последней версии WP-CLI. Для установки самой последней версии используйте описанный выше метод с PHAR. После установки проверьте, какая у вас версия, с помощью wp cli version

Глобальная установка Composer

Если вы уже используете Composer в процессе разработки на PHP, вы можете установить WP-CLI как глобальный пакет Composer:

composer global require wp-cli/wp-cli-bundle

Убедитесь, что глобальный каталог bin Composer находится в вашем $PATH. В большинстве систем это ~/.composer/vendor/bin или ~/.config/composer/vendor/bin:

export PATH="$HOME/.composer/vendor/bin:$PATH"

Добавьте эту строку в свой ~/.bash_profile файл, чтобы сделать ее постоянной. Затем убедитесь, что WP-CLI работает:

wp --info

Метод Composer идеально подходит, если вы хотите, чтобы в проекте использовалась конкретная версия WP-CLI, или если ваша команда использует Composer для управления зависимостями между инструментами.

Установка на Виртуальный Хостинг

На некоторых виртуальных хостингах WP-CLI предустановлен. Проверьте документацию вашего хостинга или выполните wp --info сразу после входа в систему через SSH. Если команда вернула результат, значит, WP-CLI уже установлен.

Если он не установлен по умолчанию, но в вашем тарифном плане предусмотрен доступ по SSH, вы можете запустить PHAR-файл напрямую, не перемещая его в глобальную папку:

php wp-cli.phar --info

Чтобы упростить ввод, добавьте псевдоним к ~/.bash_profile:

alias wp='php ~/wp-cli.phar'

Затем перезагрузите профиль:

source ~/.bash_profile

После этого wp --info будет работать так, как если бы он был установлен глобально.

Включить автодополнение

WP-CLI поддерживает автодополнение в Bash, Zsh и Fish. Вы можете скачать скрипт автодополнения по этой ссылке: https://github.com/wp-cli/wp-cli/raw/main/utils/wp-completion.bash.

Для Bash скачайте скрипт автодополнения и подключите его с помощью ~/.bash_profile:

source /FULL/PATH/TO/wp-completion.bash

Затем перезагрузите свой профиль:

source ~/.bash_profile

Для Zsh с Oh My Zsh добавьте wp-cli в строку с плагинами в ~/.zshrc:

plugins=(wp-cli git ...)

Для Fish shell скачайте wp.fish и поместите его в ~/.config/fish/completions/wp.fish. Fish автоматически найдет его, когда вы введете wp и нажмете Tab.

FAQ

wp cli check-update

Редактор: AndreyEx