WooCommerce 1C Data Cleaner#

Один PHP-файл для безопасного сброса устаревших ID обмена между 1С и WooCommerce: GUID товаров, цен и складов. Инструмент предназначен для плагина ItGalaxy WooCommerce Synchronization 1C — «WooCommerce — 1C:Предприятие — Обмен данными» и нужен прежде всего после обновления конфигурации или версии 1С, когда идентификаторы в старом обмене перестают совпадать с актуальными данными.

Скрипт удаляет старые идентификаторы и связанные служебные данные, не удаляя товары. Во время следующей синхронизации плагин ItGalaxy находит товар по артикулу и записывает для него новый актуальный ID / GUID из 1С. Параллельно заново формируются привязки цен и складов.

Содержание#

• Назначение и сценарий применения

• Как решается проблема GUID

• Возможности

• Что изменяется в базе данных

• Требования

• Установка

• Первый запуск и пароль доступа

• Сброс забытого пароля

• Режим отладки

• Рабочий процесс

• CLI-режим

• Архитектура и безопасность

• Бэкап и откат

• Диагностика

• FAQ

• Дорожная карта

• Лицензия и автор

Назначение и сценарий применения#

Скрипт разработан для работы с плагином ItGalaxy WooCommerce Synchronization 1C / WooCommerce — 1C:Предприятие — Обмен данными. Официальная документация и инструкции плагина доступны на сайте ITGALAXY: «WooCommerce — 1C:Предприятие — Обмен данными — Инструкции».

Типичный сценарий выглядит так:

1. На стороне 1С обновляют конфигурацию, переходят на новую версию 1С, восстанавливают базу из резервной копии, переносят справочники или меняют правила обмена.

2. В результате GUID / ID товаров, типов цен или складов, ранее сохранённые плагином в WooCommerce, могут стать неактуальными или исчезнуть из новой версии 1С.

3. Новый обмен не может корректно сопоставить часть объектов по старым ID: появляются дубли, «залипшие» цены, остатки или склады.

4. Администратор запускает этот скрипт и очищает только устаревшие идентификаторы и связанные данные обмена.

5. При следующем обмене плагин ItGalaxy выполняет сопоставление товаров по артикулу и прописывает новые ID / GUID из актуальной базы 1С.

6. Цены и остатки загружаются заново в соответствии с текущими типами цен и складами в 1С.

Именно поэтому это не «удалятор каталога», а сервисная утилита для контролируемого перепривязывания существующих товаров к обновлённой 1С.

Какие симптомы устраняет#

• После обновления 1С товары начали дублироваться при обмене.

• Цены не обновляются, остаются пустыми или относятся к старым типам цен.

• Остатки по складам не приходят, отображаются некорректно или «прилипли» от старой базы.

• В настройках плагина и списках WooCommerce остаются несуществующие цены, склады или GUID.

• Нужно подключить существующий каталог WooCommerce к новой или восстановленной базе 1С без ручного удаления товаров.

Как решается проблема GUID#

До очистки#

WooCommerce                         Старая / обновлённая 1С
───────────                         ──────────────────────
Товар: «Аккумулятор X»              Товар: «Аккумулятор X»
Артикул: BAT-X-100                  Артикул: BAT-X-100
_id_1c: OLD-GUID-123   ────────X──> GUID: NEW-GUID-987

После обновления 1С старый OLD-GUID-123, ранее записанный в wp_postmeta, может отсутствовать или соответствовать уже другому объекту. Плагин не должен продолжать использовать устаревшую привязку.

После очистки и нового обмена#

1. Скрипт удаляет старый _id_1c, старые данные цен / остатков и карты соответствий.

2. Плагин ItGalaxy выполняет обмен:

WooCommerce                         1С
───────────                         ──────────────────────
Товар: «Аккумулятор X»              Товар: «Аккумулятор X»
Артикул: BAT-X-100   <───────────>  Артикул: BAT-X-100

3. Сопоставление по артикулу успешно:
   WooCommerce postmeta._id_1c = NEW-GUID-987
   WooCommerce получает актуальные цены и остатки.

Таким образом, скрипт создаёт «чистую точку старта» для повторной синхронизации. Он не генерирует GUID сам и не меняет данные номенклатуры: актуальные идентификаторы задаёт 1С, а плагин ItGalaxy записывает их в WordPress во время обмена.

Возможности#

• Целевое назначение: работа с ItGalaxy WooCommerce Synchronization 1C / WooCommerce — 1C:Предприятие — Обмен данными.

• Четыре операции: очистка GUID 1С, цен, остатков или полная очистка всех трёх групп в одной транзакции.

• Без удаления каталога: записи posts, товары, вариации, названия, описания, изображения, категории и артикулы не удаляются.

• Предпросмотр: до запуска видны количества товаров, GUID, записей цен и остатков, типов цен и складов.

• Автопоиск WordPress: параметры БД читаются из wp-config.php; файл ищется в каталоге скрипта и до трёх уровней выше.

• Транзакции: START TRANSACTION → операции → COMMIT; при исключении выполняется ROLLBACK.

• Prepared statements: PDO MySQL приоритетно, mysqli как фолбэк; пользовательские значения не конкатенируются в SQL.

• Пароль и ACL: при первом запуске создаётся пароль, хранится только его хеш, авторизованный IP запоминается на 30 суток.

• AJAX-интерфейс: страница не перезагружается; кнопка на время операции меняет состояние, остальные блокируются, ошибки в консоли не стираются.

• Режим отладки: полный журнал серверных и клиентских событий, SQL, количество строк и тайминги — из переключателя интерфейса или через ?debug=1.

• CLI-восстановление доступа: команды проверки, генерации и ручной установки пароля.

• Один файл: без Composer, дополнительных библиотек и загрузки WordPress.

Что изменяется в базе данных#

{prefix} — значение $table_prefix из wp-config.php; для стандартной установки WordPress это wp_.

Отсутствующие таблицы woocommerce_attribute_taxonomies и wc_product_meta_lookup определяются автоматически и пропускаются с записью в журнал.

Соответствие кнопок и сценариев#

Требования#

Установка#

1. Сделайте бэкап базы данных#

# Полный резервный дамп перед очисткой
mysqldump --single-transaction --routines --triggers -u USER -p DBNAME \
  | gzip > backup-before-wc1c-clean-$(date +%F-%H%M).sql.gz

2. Скачайте скрипт в корень WordPress#

Файл должен лежать рядом с wp-config.php либо не глубже трёх уровней от него.

cd /var/www/example.com/public_html
curl -fsSLO https://raw.githubusercontent.com/paulmann/woocommerce-1c-data-cleaner/main/1c-data-cleaner.php

# Пример прав — скорректируйте пользователя веб-сервера для своего окружения
chmod 640 1c-data-cleaner.php
chown www-data:www-data 1c-data-cleaner.php

3. Ограничьте доступ на уровне веб-сервера#

Пароль скрипта не заменяет сетевую защиту. Рекомендуется дополнительно разрешить доступ только со своего IP.

Nginx:

location = /1c-data-cleaner.php {
    allow 203.0.113.10; # Замените на свой внешний IP
    deny all;

    include fastcgi_params;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

# Хранилище авторизации и файл-маркер никогда не должны отдаваться по HTTP
location ~ /\.wc1c-cleaner- {
    deny all;
    return 404;
}

Apache / .htaccess:

<Files "1c-data-cleaner.php">
    Require ip 203.0.113.10
</Files>

<FilesMatch "^\.wc1c-cleaner-">
    Require all denied
</FilesMatch>

4. Откройте интерфейс#

Откройте в браузере:

https://example.com/1c-data-cleaner.php

При первом запуске скрипт сгенерирует пароль, авторизует текущую сессию и покажет пароль только один раз.

Первый запуск и пароль доступа#

При первом обращении выполняются следующие действия:

1. Генерируется пароль из 20 символов криптографически безопасным генератором random_int().

2. В .wc1c-cleaner-auth.json записывается только хеш пароля: Argon2id, если он доступен в PHP, иначе bcrypt через PASSWORD_DEFAULT.

3. Файл записывается атомарно (.tmp + rename) и получает права 0600.

4. Текущий пользователь автоматически получает доступ, а его IP добавляется в ACL.

5. Пароль отображается один раз с возможностью копирования.

┌────────────────────────────────────────────────────────────────────┐
│ Пароль доступа сгенерирован — сохраните его сейчас                 │
│                                                                    │
│ 7hK2mQ+xR9tLpZ4wNb3e                          [Скопировать]        │
│                                                                    │
│ Он нужен для входа с другого IP или другого компьютера.           │
│ На текущем IP пароль больше не спрашивается.                      │
└────────────────────────────────────────────────────────────────────┘

Модель доступа#

• Текущая PHP-сессия авторизована, поэтому пароль не спрашивается повторно до завершения сессии.

• Успешно авторизованный IP записывается в ACL на 30 суток. Сам IP в файле не хранится: используется HMAC-SHA-256 с отдельной случайной солью.

• С другого IP или компьютера будет показана форма входа — потребуется сохранённый пароль.

• После 8 неудачных попыток в рамках одной сессии дальнейший ввод блокируется; на каждый неверный пароль добавляется задержка 400 мс.

• «Выйти и забыть IP» уничтожает сессию и удаляет текущий IP из ACL.

Сброс забытого пароля#

Сброс меняет соль ACL, поэтому всем клиентам — включая ранее доверенные IP — потребуется снова ввести новый пароль.

Способ 1: SSH / CLI — рекомендуется#

# Показать состояние хранилища доступа
php 1c-data-cleaner.php --status

# Сгенерировать новый пароль и вывести его в консоль
php 1c-data-cleaner.php --reset

# Задать свой пароль вручную, минимум 10 символов
php 1c-data-cleaner.php --set-password='НовыйСложныйПароль'

Способ 2: FTP или файловый менеджер#

Удалите файл хранилища рядом со скриптом:

rm /var/www/example.com/public_html/.wc1c-cleaner-auth.json

При следующем открытии страницы будет создан новый пароль и показан один раз.

Способ 3: файл-маркер сброса#

Если можно создавать файлы, но нежелательно удалять существующие:

touch /var/www/example.com/public_html/.wc1c-cleaner-reset

При следующем HTTP-запросе скрипт удалит старое хранилище, удалит маркер и создаст новую пару «пароль + ACL».

Режим отладки#

Режим отладки включается без изменения кода:

• переключателем «Режим отладки» в верхней части интерфейса;

• URL-параметром ?debug=1 для включения;

• URL-параметром ?debug=0 для выключения.

Состояние сохраняется в текущей PHP-сессии. При включённом debug скрипт показывает и отправляет в консоль браузера полный журнал:

+    0.31 ms  INFO  Входящий запрос {"method":"POST","php":"8.3.14","debug":true}
+    1.08 ms  INFO  wp-config.php найден {"path":"/var/www/.../wp-config.php"}
+    3.42 ms  INFO  Подключение к БД установлено {"driver":"PDO","port":3306}
+   12.77 ms  INFO  Транзакция START
+   13.05 ms  INFO  Шаг 1/4: GUID товаров и вариаций
+  184.62 ms  DEBUG SQL выполнен {"rows":10432,"ms":171.2}
+  512.90 ms  INFO  Транзакция COMMIT

В журнал входят: события авторизации и ACL, проверка CSRF, поиск wp-config.php, драйвер БД, SQL-запросы и их тайминги, границы транзакций, число затронутых строк, предпросмотр до и после очистки, а также JavaScript-ошибки и сетевые ошибки клиента. Пароли, хеши, токены и соли маскируются как ***.

Рабочий процесс#

1. Проверьте, что в актуальной 1С у товаров заполнены корректные и уникальные артикулы.

2. Создайте бэкап БД.

3. Остановите автоматический обмен с 1С на время работ, если он выполняется по расписанию.

4. Загрузите 1c-data-cleaner.php в каталог WordPress и откройте его в браузере.

5. На первом запуске сохраните сгенерированный пароль.

6. Включите режим отладки, если хотите зафиксировать подробный ход операции.

7. Изучите таблицу «Текущее состояние» и выберите нужную область очистки.

8. Отметьте галочку «Я понимаю, что данные будут удалены, бэкап сделан».

9. Нажмите кнопку очистки и подтвердите действие в диалоговом окне.

10. Убедитесь, что в блоке «Результат» нет ошибок, а в debug-журнале есть Транзакция COMMIT.

11. Запустите синхронизацию в плагине ItGalaxy. Товары будут сопоставлены по артикулу, после чего плагин создаст актуальные GUID / ID, цены и остатки.

12. Проверьте несколько товаров, цены и остатки в витрине и панели WordPress.

13. Удалите 1c-data-cleaner.php, .wc1c-cleaner-auth.json и возможный .wc1c-cleaner-reset с сервера.

CLI-режим#

CLI-режим предназначен только для управления доступом, не для удаления данных БД.

$ php 1c-data-cleaner.php --status
WooCommerce 1C Data Cleaner 3.0.0
Хранилище: /var/www/example.com/public_html/.wc1c-cleaner-auth.json
Создано: 2026-08-27 15:42:10
Тип пароля: сгенерирован автоматически
Доверенных IP: 2

Архитектура и безопасность#

Скрипт состоит из одного PHP-файла с declare(strict_types=1) и разделён на небольшие компоненты.

Меры защиты#

• нет SQL-конкатенации пользовательских значений: используются подготовленные выражения;

• имена таблиц валидируются регулярным выражением [A-Za-z0-9_]+;

• unserialize() вызывается с allowed_classes => false;

• CSRF-токен создаётся через random_bytes(32), проверяется через hash_equals;

• после успешной авторизации обновляется ID сессии;

• cookie сессии имеют HttpOnly, SameSite=Strict, а при HTTPS — Secure;

• ответы имеют Cache-Control: no-store, X-Robots-Tag: noindex, nofollow и meta robots;

• display_errors=0: PHP notices и warnings попадают в EventLog, не ломая JSON-ответ;

• .gitignore исключает хранилище пароля, ACL и reset-marker.

Бэкап и откат#

Быстрый бэкап затрагиваемых таблиц#

Замените wp_ на фактический префикс таблиц, если он отличается.

mysqldump --single-transaction -u USER -p DBNAME \
  wp_postmeta \
  wp_termmeta \
  wp_options \
  wp_woocommerce_attribute_taxonomies \
  wp_wc_product_meta_lookup \
  | gzip > wc1c-before-clean-$(date +%F-%H%M).sql.gz

Восстановление из дампа#

gunzip < wc1c-before-clean-2026-08-27-1542.sql.gz | mysql -u USER -p DBNAME

После восстановления или нового полного обмена можно очистить кэш:

wp cache flush
wp wc update_db

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

Диагностика#

FAQ#

Товары, изображения и описания точно останутся?#

Да. Скрипт не содержит DELETE из {prefix}posts. Он не удаляет товары, вариации, артикулы, названия, описания, медиафайлы, категории или теги. Очищаются только служебные привязки обмена, цены, остатки и связанные кэш-значения.

Когда использовать скрипт?#

Основной случай — обновление версии или конфигурации 1С, перенос на другую базу, восстановление базы из бэкапа и другие ситуации, в которых старые GUID товаров, цен или складов перестали соответствовать данным новой 1С. Утилита удаляет старые ID; следующий обмен создаёт новые.

Почему после очистки товары снова «находятся» в 1С?#

Потому что плагин ItGalaxy при синхронизации сопоставляет товары по артикулу. Если артикулы идентичны и уникальны, плагин находит существующую карточку WooCommerce и записывает в неё актуальный ID / GUID из 1С вместо создания нового товара.

Нужно ли очищать всё?#

Нет. Выбирайте минимально необходимую операцию. Если изменились только типы цен — используйте «Очистить цены». Если проблема только со складами — «Очистить остатки». «Очистить всё» подходит после полного обновления/переноса базы 1С, когда нет доверия всем старым идентификаторам.

Можно ли отменить очистку?#

До конца HTTP-запроса ошибки откатываются транзакцией. После успешного COMMIT вернуть старые данные можно только из резервного дампа БД.

Поддерживаются ли другие плагины обмена с 1С?#

Нет, готовая схема ключей ориентирована на ItGalaxy WooCommerce Synchronization 1C. Для других решений требуется отдельно проверить, где они хранят GUID, цены и остатки, и адаптировать константы в Config.

Поддерживается ли WordPress Multisite?#

Скрипт использует один $table_prefix из wp-config.php и по умолчанию работает с основным сайтом. Для подсайтов необходимо адаптировать префикс (wp_2_, wp_3_ и т. п.) после предварительного бэкапа и теста на копии.

Почему пароль привязан к IP?#

Это дополнительный уровень удобства и защиты: после единственного успешного входа с доверенного рабочего адреса пароль не приходится вводить снова. При смене IP, при работе с другого компьютера или после сброса ACL потребуется сохранённый пароль.

Дорожная карта#

• dry-run: подробный подсчёт будущих изменений без модификации БД

• Экспорт debug-журнала в JSON и текстовый файл

• Выборочная очистка по категориям, товарам и диапазонам ID

• Поддержка WordPress Multisite с выбором подсайта

• Поддержка конфигураций ключей других плагинов 1С-обмена

• Двухфакторное подтверждение деструктивных операций (TOTP)

• Автоматическая проверка уникальности артикулов перед удалением GUID

Лицензия и автор#

Проект распространяется по лицензии PolyForm Noncommercial 1.0.0 © 2026 Mikhail Deynekin. Программа поставляется «как есть», без гарантий; пользователь самостоятельно отвечает за бэкапы и последствия операций с данными.

Mikhail Deynekin

• Сайт: Deynekin.com

• GitHub: paulmann (Mikhail Deynekin)

• Репозиторий: woocommerce-1c-data-cleaner

• Другой инструмент: Clean_BOM_Senior — очистка невидимых UTF-8 BOM и CRLF в исходных файлах

Если инструмент помог корректно перепривязать каталог после обновления 1С — поставьте звезду репозиторию.