Bash WP-CLI Update 9.1.0 вышел 18 ноября 2026 года и закрывает пять дефектов, найденных на парке из 27 сайтов на одном хосте. Общее у них одно: каждый позволял прогону отчитаться об успехе там, где на самом деле ничего не было сделано или сайт оставался сломанным. Это неприятнее любой ошибки в коде — ошибку видно, а ложный «✓» уходит в журнал и живёт там неделями.

TL;DR
--checkспрашивает WordPress. Одна пробаwp core is-installedна сайт под владельцем;--no-wp-probeеё отключает.- Оборванный апгрейдер = провал. Голый
-1при exit 0 больше не считается успехом, апгрейд повторяется с--skip-plugins --skip-themes. .maintenanceснимается. После обработки сайта залипший флаг убирается с предупреждением о его возрасте.--healthчестен. Строкиplugin listразбираются по форме slug, размер базы берётся первым числом.- Поисковик 2.2.0. Датированные копии исключаются по шаблону, вторая копия на той же базе пропускается.
Что нового
flowchart LR CHECK["--check: смотрел файлы"] --> PROBE["--check: спрашивает WordPress"] ABORT["обрыв апгрейдера = успех"] --> RETRY["обрыв = провал и повтор"] FLAG[".maintenance остаётся"] --> CLEAN["флаг снимается с предупреждением"] HEALTH["--health считал строки"] --> SLUG["--health считает slug"] FIND["поисковик: копии и дубли баз"] --> DEDUP["исключения и дедуп по базе"]
Релиз вышел 18.11.2026, тег v9.1.0, коммит 2670a0e. Артефакт bash-wp-cli-update-9.1.0.tar.gz весит 200 284 байта, SHA256SUMS сходится, npm-канал отдаёт latest = 9.1.0.
| Что | Было | Стало |
|---|---|---|
Проверка сайта в --check |
файлы и владелец | плюс wp core is-installed под владельцем |
Обрыв апгрейдера (-1) |
успех | провал, лог и один повтор без плагинов |
Залипший .maintenance |
остаётся, сайт отдаёт 503 | снимается с предупреждением |
Подсчёт плагинов в --health |
любая непустая строка | только строки формы slug |
Размер базы в --health |
склеенные числа из вывода | первое число строки |
| Поисковик | датированные копии как сайты | исключения по шаблону |
| Одна база на два корня | два сайта | второй пропускается без --allow-shared-db |
Что важно в этой таблице: ни один пункт не добавляет функциональность. Все пять — про достоверность отчёта. Обновляться стоит именно из-за этого.
Ключевые изменения
Проба WordPress в --check
Раньше проверка смотрела на wp-config.php, wp-includes/version.php и владельца каталога. Этого достаточно, чтобы понять «это похоже на установку WordPress», и совершенно недостаточно, чтобы понять «WP-CLI здесь работает».
flowchart TD
START["запуск режима"] --> PRE["предполёт: версия и lock"]
PRE --> SITE["сайт: проба wp core is-installed"]
SITE --> UPD["обновления"]
UPD --> RETRY{"апгрейдер оборвался?"}
RETRY -- да --> SKIP["повтор с --skip-plugins --skip-themes"]
RETRY -- нет --> FLAG{"флаг .maintenance?"}
SKIP --> FLAG
FLAG -- да --> CLEAN["снять флаг"]
FLAG -- нет --> REPORT["отчёт"]
CLEAN --> REPORTПрактический случай, ради которого это сделано: сайт с упавшей темой. На нём wp печатает Parse error и завершается, а --check ставил ✓ — потому что файлы на месте и владелец правильный. На двух таких сайтах прогон по парку не мог к ним прикоснуться вовсе, и это выяснялось только по отсутствию результата.
Теперь на каждый сайт выполняется wp core is-installed от имени владельца. Если он падает — сайт в отчёте не «здоров», а проблемный.
Отключатель нужен для одного сценария: частый мониторинг. Проверка файлов занимает доли секунды, проба требует запуска PHP на каждом сайте. Для опроса раз в минуту это лишняя нагрузка, поэтому есть три способа выключить: --no-wp-probe, ключ конфига WP_PROBE=false и переменная WP_CLI_UPDATE_WP_PROBE.
Оборванный апгрейдер
Плагин, который цепляется за хуки апгрейдера, ломает wp plugin update предсказуемым образом: команда печатает голое -1, завершается с кодом 0 и оставляет после себя флаг .maintenance. С точки зрения вызывающего скрипта всё прошло: код возврата нулевой, вывод непустой.
Теперь вывод ровно -1 читается как «ничего не применено». В лог попадает сам вывод, а обновление повторяется один раз с --skip-plugins --skip-themes: файлы на диске — всё, что нужно апгрейдеру, а чужой код при повторе не загружается. В сводке появляется счётчик таких повторов и предупреждение, какие плагины при повторе не участвовали.
Залипший .maintenance
Пока файл .maintenance лежит в корне установки, WordPress отвечает 503 каждому посетителю. 18 ноября это случилось на боевом сайте: прогон отчитался об успехе, а сайт отдавал страницу обслуживания. Причина — тот же оборванный апгрейдер.
Теперь после обработки сайта менеджер проверяет флаг и снимает его, если тот остался, называя возраст флага. В dry-run он только сообщает, что сделал бы.
Честный --health
Сайт с WP_DEBUG, объявленным дважды, печатает перед таблицей wp plugin list строки deprecation-уведомлений. Старый разбор считал каждую непустую строку плагином — и сайт без единого обновления показывал 20 ожидающих плагинов и 20 тем. Размер базы при этом печатался склейкой чисел из тех же уведомлений, что-то вроде 9..1334939..133493.
Исправление простое и надёжное: строки сопоставляются по форме slug (^[A-Za-z0-9._-]+$), а размер берётся первым числом в строке. Тот же сайт теперь показывает 0 плагинов и честные 9 MiB.
Поисковик 2.2.0
Поисковик установок видел проблему шире, чем одну строку отчёта.
| Что попадало в список | Почему это плохо |
|---|---|
site.wp-20261028 — датированная копия |
обновили бы копию и сделали бэкап её базы |
*.bak, *-old, *_bak*, *.orig |
то же самое |
| второй корень на той же базе | два бэкапа одной базы, двойная работа |
Копии теперь отсекаются шаблонами имён. Вторая копия на общей базе определяется чтением DB_HOST, DB_NAME и $table_prefix: если совпало — второй корень пропускается с предупреждением, где назван первый. Кому действительно нужно оба (например, два фронта одной установки), тот передаёт --allow-shared-db.
Что показал прогон на парке
Два замера, оба 19.11.2026 на живом хосте с установленной 9.1.0.
Первый: цена пробы. Проверка по парку с пробой и без неё, 26 сайтов.
| Режим | Время | Строк «wp loads» |
|---|---|---|
--check (с пробой) |
27,64 с | 26 |
--check --no-wp-probe |
1,30 с | — |
Вывод: проба стоит около секунды на сайт. Для разового прогона это ничто, для ежеминутного опроса — заметно, поэтому отключатель и появился. Все 26 сайтов ответили «wp loads», то есть на этом парке мёртвых установок не было.
Второй: честность --health. Тот самый сайт с двойным WP_DEBUG.
| Колонка | 18.11 (9.0.1) | 19.11 (9.1.0) |
|---|---|---|
| CORE | 7.1.5 | 7.1.5 |
| PLUGINS | 20 | 0 |
| THEMES | 20 | 0 |
| DB MiB | мусор из чисел | 9 |
| CVE | safe | safe |
Вывод: числа совпали с реальностью. Именно это и есть содержание релиза — не новые возможности, а правдивые цифры в отчёте.
Чего замеры не показывают: поведение на парке, где есть действительно мёртвая установка (на проверенном хосте таких не оказалось), и работу повтора после обрыва апгрейдера на боевом сайте — этот сценарий проверялся в тестах с подставным wp.
Установка и обновление
| Способ | Что делать |
|---|---|
| Из релиза | скачать bash-wp-cli-update-9.1.0.tar.gz, сверить SHA256SUMS, распаковать поверх каталога скрипта |
| Из репозитория | git fetch --tags && git checkout v9.1.0 |
| npm-канал | установка как раньше, latest уже 9.1.0 |
Перед заменой сохраните текущий скрипт: откат тогда занимает одну команду.
# бэкап и проверка артефакта перед распаковкой
cp Bash_WP-CLI_Update.sh Bash_WP-CLI_Update.sh.bak-$(date +%Y%m%d)
sha256sum -c SHA256SUMS
Одна практическая деталь: обёртка cron на хосте может вызывать скрипт по полному пути. После замены стоит убедиться, что файл исполняемый — при переносе с Windows бит исполнения теряется, и лечится это chmod +x по списку файлов с режимом 100755 из git.
Проверка после обновления
Три шага, по возрастанию цены.
- Версия и режимы. Запустите скрипт с
--helpи убедитесь, что в выводе есть9.1.0и упоминание--no-wp-probe. - Проверка парка.
--check— в отчёте появится строкаwp loads. Если на каком-то сайте её нет, это и есть находка: там WP-CLI не работает, и раньше вы об этом не знали. - Один сайт в режиме
--health. Сравните PLUGINS, THEMES и размер базы с тем, что видите в админке. Расхождение — сигнал разбираться с конфигурацией, а не со скриптом.
Если после обновления на каком-то сайте пропал .maintenance, который вы ставили руками намеренно, — это ожидаемо: флаг снимается после обработки. Ставить его снова на время работ придётся после прогона.
Совместимость
| Что | Требование |
|---|---|
| bash | 4+; поддержка 5.1 проверена ещё в 9.0.0 |
| WP-CLI | любой актуальный wp в PATH или через --wp-cli |
| Права | запуск от root, переключение на владельца сайта |
| ОС | Linux; на Windows полный набор тестов не гоняется |
| Мультисайт | работает, но без --url печатает предупреждение |
Про мультисайт отдельно: если в wp-config.php не задан WP_HOME, скрипт предупреждает, что не знает, какой сайт сети проверять, и повторяет предупреждение на каждый вызов. Это не ошибка, но в отчёте на один сайт их набирается четыре.
flowchart LR CFG["WP_PROBE в конфиге"] --> ENV["WP_CLI_UPDATE_WP_PROBE"] ENV --> CLI["--no-wp-probe"] CLI --> SPEED["проверка за секунды вместо десятков"]
Ключ WP_PROBE нормализуется через require_bool, поэтому значения 0, false, no и off равнозначны. Неизвестное значение даёт ошибку конфигурации, а не тихое «включено».
Подводные камни
- Проба не бесплатна. Около секунды на сайт; для мониторинга раз в минуту отключайте.
--no-wp-probeвозвращает слепоту. Сайт с мёртвым WP-CLI снова получит✓— это осознанный компромисс, а не исправление.- Повтор без плагинов. Если обновление сломано самим плагином, повтор применит файлы, но не выполнит код миграции — проверяйте сайт руками.
.maintenanceпосле прогона. Если флаг ставит ваш собственный процесс, его снимут. Планируйте работы заранее.--allow-shared-db. Без него вторая копия на общей базе не попадёт в список — иногда это ровно то, что нужно, иногда нет.- Размер базы — оценка. Это число из вывода
--health, а не точный размер на диске. - Тесты. Полный набор гоняется на Debian: на Windows часть сценариев висит.
- npm-реплика. Сразу после публикации
latestможет ещё отдавать предыдущую версию — это реплика, а не ошибка. - cron-обёртка. После обновления проверьте, что она зовёт новый файл и что он исполняемый.
FAQ
Зачем проба, если --check и так показывает сайты?
Потому что «файлы на месте» и «WP-CLI работает» — разные вещи. Между ними упавшая тема с синтаксической ошибкой, и именно этот случай проба ловит.
Станет ли прогон медленнее?
--check — да, примерно на секунду на сайт. Режимы обновления по умолчанию пробу не используют.
Что значит голое -1 в выводе?
Это не сообщение об ошибке WP-CLI, а признак, что апгрейдер оборвался на чужом хуке. Скрипт теперь читает его как провал.
Можно ли не снимать .maintenance автоматически?
Отдельного ключа для этого нет. Если флаг нужен надолго, ставьте его после прогона.
Почему --health показывал 20 плагинов?
Из-за WP_DEBUG: deprecation-уведомления печатались перед таблицей, а старый разбор считал каждую непустую строку плагином. Теперь строки фильтруются по форме slug.
Обязательно ли обновляться с 9.0.x?
Да, если вы полагаетесь на отчёт: до 9.1.0 три из пяти дефектов дают ложный «успех».
Итог
Релиз 9.1.0 — про доверие к отчёту. Проба WordPress в --check показывает, работает ли WP-CLI на самом деле; оборванный апгрейдер перестал считаться успехом и повторяется без плагинов; залипший .maintenance снимается; --health считает плагины по форме slug, а размер — первым числом; поисковик не путает датированную копию с сайтом и не обновляет одну базу дважды.
Замеры на парке из 26 установок: проба стоит 27,64 с против 1,30 с без неё, все сайты ответили «wp loads», а проблемный сайт с двойным WP_DEBUG вместо 20 плагинов и мусора в размере базы показал 0 и 9 MiB. Это и есть польза релиза — цифры, которым можно верить.
Цитата: Отчёт об успехе при сломанном сайте хуже ошибки: ошибку видно сразу, а ложный «✓» живёт в журнале месяцами.
Связанные материалы
- Bash WP-CLI Update: обслуживание парка WordPress — основная статья продукта.
- Bash WP-CLI Update 9.0.0: bash 5.1 и починенный выбор — предыдущий крупный релиз.
- Bash WP-CLI Update 8.1.0: проверка CVE-2026-119977 и —harden — откуда взялся интерес к проверке ядра.
- Защита админки WordPress: Basic Auth вторым слоем — что ещё стоит на парке.
- Инкрементальный бэкап Windows: robocopy, версии и защита — почему бэкап базы дважды это не «надёжнее».
LLM Summary
- Релиз: Bash WP-CLI Update 9.1.0, тег
v9.1.0, коммит2670a0e, опубликован 18.11.2026; артефакт 200 284 байта,SHA256SUMSсходится, npmlatest = 9.1.0. - Тема релиза: пять дефектов, каждый из которых давал ложный отчёт об успехе при обслуживании парка из 27 сайтов на одном хосте.
--check+ проба: добавлен вызовwp core is-installedот имени владельца; отключается--no-wp-probe, ключомWP_PROBE=falseили переменнойWP_CLI_UPDATE_WP_PROBE.- Оборванный апгрейдер: вывод ровно
-1при exit 0 теперь означает «ничего не применено»; лог с точным выводом и один повтор с--skip-plugins --skip-themes, счётчик в сводке. .maintenance: после обработки сайта залипший флаг снимается с предупреждением о возрасте; в dry-run только сообщение.--health: строкиplugin listсопоставляются по^[A-Za-z0-9._-]+$, размер базы — первое число строки; сайт с двойнымWP_DEBUGпоказывает 0 плагинов и 9 MiB вместо 20 и мусора.- Поисковик 2.2.0: исключения
*.wp-[0-9]{8},*_bak*,*.bak,*.bak-*,*~,*.orig,*.prev,*-old,*-OLD,*-copy; дедуп поDB_HOST|DB_NAME|$table_prefix, второй корень пропускается,--allow-shared-dbвозвращает оба. - Замер 19.11.2026:
--checkпо 26 сайтам — 27,64 с с пробой и 1,30 с без; 26 строк «wp loads»;--healthдля проблемного сайта — CORE 7.1.5, PLUGINS 0, THEMES 0, DB 9 MiB, CVE safe. - Совместимость: bash 4+, WP-CLI в PATH, запуск от root с переключением на владельца; мультисайт без
--urlпечатает предупреждение. - Не проверялось: поведение пробы на парке с действительно мёртвой установкой и повтор апгрейдера на боевом сайте — сценарий покрыт тестами с подставным
wp.
Промт для агента (обновление)
Готовый промт: скопируйте блок целиком. Источник шагов — AGENTS.md и README репозитория (раздел обновления), плюс примечания к релизу v9.1.0; замеры выполнены на живом хосте 19.11.2026.
Задача: обновить Bash WP-CLI Update до 9.1.0 на хосте с парком WordPress и проверить результат.
Репозиторий: https://github.com/paulmann/Bash_WP-CLI_Update (тег v9.1.0). Шаги соответствуют AGENTS.md и README репозитория.
Шаг 1. Записать текущую версию скрипта и сохранить его копию с датой в имени.
Шаг 2. Скачать релизный архив, сверить SHA256SUMS.
Шаг 3. Распаковать поверх каталога скрипта, проверить бит исполнения (chmod +x).
Шаг 4. Запустить --help и убедиться, что в выводе версия 9.1.0 и ключ --no-wp-probe.
Шаг 5. Запустить --check по парку и проверить, что на каждом сайте есть строка "wp loads".
Шаг 6. Для сайтов без "wp loads" отдельно проверить, работает ли wp под владельцем, и записать причину.
Шаг 7. Запустить --health на одном проблемном сайте и сравнить PLUGINS, THEMES и размер базы с админкой.
Шаг 8. Проверить, что в списке сайтов нет датированных копий (*.wp-YYYYMMDD, *.bak, *-old).
Шаг 9. Проверить, что нет двух корней на одной базе; если нужны оба — запускать с --allow-shared-db.
Шаг 10. Убедиться, что cron-обёртка зовёт новый файл.
Шаг 11. Проверить фронт двух-трёх сайтов: ответ 200 и отсутствие файла .maintenance.
Шаг 12. Записать в журнал: версия до и после, время --check с пробой и без, найденные мёртвые установки.
Запрещено:
- отключать пробу (--no-wp-probe) на разовых прогонах только ради скорости;
- считать вывод -1 успехом;
- удалять .maintenance руками до прогона, не выяснив, откуда он взялся;
- запускать --full на парке без предварительного --check;
- переносить скрипт с Windows без проверки бита исполнения;
- включать --allow-shared-db, не убедившись, что это действительно два разных фронта;
- править чужой код плагинов вместо повтора с --skip-plugins --skip-themes.
Что считать успехом: версия 9.1.0 установлена, --check показал "wp loads" на всех живых сайтах, --health даёт числа, совпадающие с админкой, копий и дублей баз в списке нет, cron работает, сайты отвечают 200.