Как использовать WP-CLI для массового изменения мета данных в WordPress

Диагностика проблемы: зачем массово менять мета данные

В крупных проектах на WordPress часто возникает необходимость массово обновить или удалить мета данные (custom fields) для множества записей. Например, после смены плагина, оптимизации структуры данных или исправления ошибок в заполнении. Делать это вручную через админку долго и рискованно. WP-CLI — мощный инструмент для таких задач.

Основы работы с WP-CLI и мета данными

WP-CLI — это интерфейс командной строки для управления WordPress. Он позволяет выполнять операции с записями, пользователями, мета данными и многим другим без загрузки админки.

Для работы с мета данными используется команда wp post meta, которая поддерживает:

• get — получение значения
• update — обновление значения
• delete — удаление по ключу

Синтаксис базовой команды для обновления мета данных записи:

wp post meta update <post_id> <meta_key> <meta_value>

Пошаговое решение: массовое обновление мета данных через WP-CLI

1. Создайте список ID записей для изменения

Используйте WP-CLI для выборки ID, например, всех постов определённого типа:

wp post list --post_type=post --field=ID --posts_per_page=-1 > post_ids.txt

Это создаст файл post_ids.txt с ID всех записей типа «post».

2. Подготовьте скрипт для обновления мета данных

Например, нужно заменить значение мета ключа old_meta_key на new_value для всех постов из списка. Можно использовать bash-скрипт:

while read post_id; do
  wp post meta update $post_id old_meta_key new_value
  echo "Updated meta for post $post_id"
done < post_ids.txt

3. Если нужно массово удалить мета данные:

while read post_id; do
  wp post meta delete $post_id old_meta_key
  echo "Deleted meta for post $post_id"
done < post_ids.txt

4. Для более сложных условий используйте WP-CLI вместе с PHP-скриптами

Например, обновлять только если текущее значение равно определённому:

while read post_id; do
  current_val=$(wp post meta get $post_id old_meta_key)
  if [ "$current_val" = "value_to_replace" ]; then
    wp post meta update $post_id old_meta_key new_value
    echo "Updated meta for post $post_id"
  fi
done < post_ids.txt

Проверка результата после внедрения

Для проверки изменений используйте команду:

wp post meta get <post_id> old_meta_key

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

Также можно вывести сводку по мета данным:

wp post meta list <post_id>

Частые ошибки и их исправление

• Команда wp не найдена: Убедитесь, что WP-CLI установлен и правильно настроен. Проверьте, что команда запускается из корня WordPress.
• Нет прав на выполнение команд: Запускайте WP-CLI с пользователем, который имеет доступ к файлам и базе данных сайта.
• Неверный ID поста: Проверьте, что ID постов актуален, и записи не удалены.
• Мета ключ не существует: Команда update создаст мета ключ, а delete ничего не сделает, если ключа нет. При необходимости проверьте существование ключа перед операцией.

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

• Перед массовыми изменениями сделайте полный бэкап базы данных.
• Работайте на тестовом или staging-сайте, чтобы проверить скрипты.
• Для очень большого объёма данных разбивайте операции на части, чтобы избежать таймаутов.
• Используйте транзакции в базе (если поддерживается) для отката изменений в случае ошибки.
• Ограничивайте доступ к WP-CLI для безопасности сервера.

Сравнение методов массового изменения мета данных

Метод	Преимущества	Недостатки
WP-CLI	Быстро, подходит для больших объёмов, без нагрузки на сайт	Нужен доступ к серверу, базовые навыки командной строки
Плагины массового редактирования	Удобный интерфейс, без командной строки	Могут быть медленными, нагрузка на сервер, ограничены функционалом
Прямые SQL-запросы	Максимальная скорость и гибкость	Высокий риск ошибок, требует знаний SQL, опасно без бэкапа