Как использовать WP-CLI для автоматического экспорта метаполей WooCommerce

Диагностика проблемы экспорта метаполей WooCommerce

При резервном копировании WooCommerce часто возникает проблема: стандартные средства резервного копирования не сохраняют все метаполя заказов и товаров, что ведёт к потере данных при восстановлении. Это происходит из-за того, что метаполя хранятся в отдельных таблицах и иногда не включаются в экспорт автоматически.

Проверить, сохраняются ли метаполя, можно так:

• Создать тестовый заказ с уникальным метаполем (например, _custom_order_note).
• Выполнить экспорт базы данных стандартными средствами (phpMyAdmin, плагином).
• Открыть дамп и проверить наличие строки с этим метаполем в таблице wp_postmeta или wp_woocommerce_order_itemmeta.

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

Пошаговое решение с использованием WP-CLI

1. Установка WP-CLI

WP-CLI — удобный инструмент для управления WordPress из командной строки. Убедитесь, что он установлен и доступен на сервере:

wp --info

Если команда не найдена, установите WP-CLI согласно официальной инструкции https://wp-cli.org/#installing.

2. Экспорт метаполей WooCommerce через WP-CLI

Для экспорта метаполей заказов и товаров используем команду wp db export с дополнительным SQL-запросом, чтобы выгрузить только нужные таблицы или данные.

Пример экспорта таблиц, связанных с WooCommerce:

wp db export woocommerce-metafields.sql --add-drop-table --tables=wp_postmeta,wp_woocommerce_order_itemmeta,wp_woocommerce_order_items

Если префикс базы данных отличается (wp_ — стандартный), замените его на свой. Команда выгрузит только таблицы с метаполями WooCommerce.

3. Экспорт конкретных метаполей через SQL-запрос

Если нужно выгрузить только определённые метаполя, используйте прямой SQL-запрос, например, через wp db query:

wp db query "SELECT * FROM wp_postmeta WHERE meta_key LIKE '_custom_%'" --skip-column-names > custom-meta-export.sql

Этот запрос выгрузит все метаполя, начинающиеся с _custom_, в отдельный файл.

4. Автоматизация экспорта с помощью скрипта

Создайте bash-скрипт для регулярного экспорта:

#!/bin/bash

# Экспорт таблиц WooCommerce метаполей
wp db export /backups/woocommerce-metafields-$(date +%F).sql --add-drop-table --tables=wp_postmeta,wp_woocommerce_order_itemmeta,wp_woocommerce_order_items

# Экспорт пользовательских метаполей
wp db query "SELECT * FROM wp_postmeta WHERE meta_key LIKE '_custom_%'" --skip-column-names > /backups/custom-meta-$(date +%F).sql

Добавьте этот скрипт в cron для ежедневного запуска.

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

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

wp post meta get <order_id> _custom_order_note

Если метаполя доступны, экспорт и импорт прошли успешно.

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

• Неправильный префикс таблиц: Если база использует нестандартный префикс, команды не сработают. Проверьте префикс в wp-config.php и замените wp_ на правильный.
• Недостаточно прав для экспорта: Убедитесь, что пользователь, под которым запускается WP-CLI, имеет права на чтение базы данных и запись в папку для бэкапов.
• Экспорт слишком больших таблиц: При большом объёме данных экспорт может прерваться. Используйте опцию --single-transaction для консистентного дампа или делайте инкрементальные бэкапы.
• Проблемы с кодировкой: При импорте метаполей появляется ошибка кодировки. Проверяйте, что дамп сохранён в UTF-8 без BOM.

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

• Храните резервные копии вне корня сайта и обеспечьте их доступ по защищённым каналам (SFTP/SSH).
• Ограничьте доступ к скриптам экспорта и файлам бэкапов, чтобы избежать утечки данных.
• Используйте WP-CLI в режиме --quiet для логирования ошибок без лишнего вывода.
• Для ускорения экспорта используйте опцию --quick или делайте инкрементальные дампы.
• Регулярно проверяйте целостность экспортированных метаполей при помощи тестовой среды, чтобы избежать потери данных.

Сравнение вариантов экспорта метаполей WooCommerce

Метод	Плюсы	Минусы	Применение
Плагины резервного копирования	Простота, интерфейс	Могут не учитывать все метаполя, нагрузка на сервер	Для небольших сайтов, без кастомных метаполей
WP-CLI с экспортом таблиц	Точный контроль, быстро	Требует доступа к серверу, навыков CLI	Для разработчиков и продвинутых администраторов
Ручной SQL-экспорт	Максимальный контроль	Сложно автоматизировать, риск ошибки	Восстановление сложных метаданных