Bash WP-CLI Update 9.0.0 — мажорный релиз по одной причине: поднята минимальная версия bash до 5.1, и на хостах с 4.x скрипт теперь отказывается работать с кодом выхода 3. Вторая часть релиза — четыре исправления в отборе целей: обращение к несуществующему полю slug, попадание mu-plugins и dropins в команду обновления, ошибка фильтра dropin и падение --debug. Сразу за ним вышел 9.0.1 — выпуск только с документацией: тот же архив 9.0.0, но с исправленным README.

TL;DR: пять пунктов
- Планка bash — 5.1. Менеджер, поисковик и
install.shотказывают старому bash с кодом 3. - Выбор плагинов починен. У
wp plugin listнет поляslug:name— это и есть slug, а отображаемое имя лежит вtitle. - mu-plugins и dropins пропускаются. Раньше они уходили в
plugin updateи валили здоровый сайт. --debugбольше не ломает проверку обновлений. Эхо отладочного вывода попадало в$( )и убивало арифметику.- 9.0.1 — документация. Ни скрипт, ни опции, ни коды выхода не менялись.
Что нового
flowchart TD
START["запуск скрипта"] --> VER{"bash 5.1 или новее?"}
VER -- да --> RUN["работа"]
VER -- нет --> STOP["выход с кодом 3"]| Параметр | Значение |
|---|---|
| Версии | 9.0.0 (17.11.2026, 15:15 UTC) и 9.0.1 (17.11.2026, 15:43 UTC) |
| Тип | мажорный: поднята минимальная версия bash |
| Исправлений | 4 |
| Изменений поведения | 3 |
| Архив 9.0.1 | это 9.0.0 с исправленным README |
| Прошлая версия | 8.1.1 (06.11.2026) |
| Лицензия | MIT |
| Репозиторий | paulmann/Bash_WP-CLI_Update, 2 012 КБ |
Мажорность здесь не формальность. Документированное требование к среде изменилось: хост, на котором есть только bash 4.x, должен либо обновить bash, либо остаться на 8.1.1 — а 8.1.1 содержит дефект выбора, из-за которого часть прогонов вообще не доходит до обновления.
Ключевые изменения
Планка bash 5.1
Bash 4.2 (2011 год) остался только на CentOS 7, снятом с поддержки в июне 2024, и на дистрибутивах, которые давно не получают обновлений. Всё, что поддерживается в 2026 году, несёт 5.1 или новее: Ubuntu 22.04+, Debian 11+, RHEL/Rocky/Alma 9+, Alpine 3.14+.
Проверка стоит прямо в коде — строка 89 основного скрипта:
if ((BASH_VERSINFO[0] < 5 || (BASH_VERSINFO[0] == 5 && BASH_VERSINFO[1] < 1))); then
| Хост | bash | Что работает |
|---|---|---|
| Ubuntu 22.04+ | 5.1+ | 9.0.0 и новее |
| Debian 11+ | 5.1+ | 9.0.0 и новее |
| RHEL/Rocky/Alma 9+ | 5.1+ | 9.0.0 и новее |
| Alpine 3.14+ | 5.1+ | 9.0.0 и новее |
| RHEL/Rocky/Alma 8 | 4.4 | только 8.1.1 |
| CentOS 7 | 4.2 | только 8.1.1 |
Отдельно изменена сборка в CI: планка берётся из образа ubuntu-22.04, а не из bash 4.2, собранного вручную. Ручная сборка перестала работать после того, как ubuntu-latest перешёл на компилятор, по умолчанию использующий C23. Побочная выгода: опубликованный bash проверяет планку честнее, чем собранный на месте.
И ещё одно уточнение из заметок: -j N остаётся барьером пакета, а не непрерывным пулом. wait -n позволил бы пул, но барьер сохраняет непрерывность вывода по каждому сайту и стоит не больше одного медленного сайта на пакет.
Поля, которых нет
Самое важное исправление — то, из-за которого селективное обновление не работало вовсе.
wp plugin list и wp theme list не имеют поля slug. name — это и есть slug, а отображаемое имя — необязательное поле title. Строка --fields=name,slug,status,update была жёсткой ошибкой: Invalid field: slug., код выхода 1. Перечисление падало до того, как рассматривался первый плагин.
Теперь все три места вызова (plugin_select_targets, theme_select_targets, plugin_resolve_slug) просят name,status[,update] плюс title и берут slug из name.
mu-plugins и dropins
Эти записи видны в plugin list, но не являются устанавливаемыми пакетами. Команда wp plugin update disable-cf7-updates zbs-support отвечала «could not be found» и валила сайт, который полностью здоров. Теперь записи со статусом must-use или dropin пропускаются, а причина пишется в отладочный журнал.
Пустая колонка и фильтр dropin
Фильтр dropin можно было обойти пустой ячейкой: json_to_tsv выдаёт пустое поле для отсутствующего значения, а read с IFS=$'\t' схлопывает пустое поле — и status съезжал в title для всех dropin (у них нет отображаемого имени), после чего запись проходила фильтр. Необязательная колонка теперь запрашивается последней, чтобы пустое значение могло попасть только в последнюю переменную.
--debug и проверка обновлений
pending_count и site_core_version возвращают ответ на stdout; под --debug консольное эхо их собственного вызова wp попадало в $( ) вызывающего, и арифметика падала с «DBG: unbound variable». Воспроизводилось на любом хосте, который следует документированному производственному профилю (SKIP_IF_NO_UPDATES=1) и включает отладку.
Сопоставление по slug и имени
Исключения, удержания и --name теперь сопоставляются и со slug, и с отображаемым именем — из одного вызова wp <kind> list (поле title), как и обещала документация с версии 6.0. Сравнение нечувствительно к регистру и пробелам, поэтому --exclude-plugins 'All in One SEO' работает, хотя разбор списка убирает пробелы. На WP-CLI, где поля title ещё нет, вызов повторяется без него, сопоставление идёт по slug, а возможность проверяется один раз за прогон.
Установка и обновление
# обновить архив из репозитория
git clone https://github.com/paulmann/Bash_WP-CLI_Update.git
cd Bash_WP-CLI_Update
git checkout v9.0.1 # тег документации, код тот же, что в 9.0.0
# проверить версию и режимы
bash Bash_WP-CLI_Update.sh --version
bash Bash_WP-CLI_Update.sh --list-modes
| Шаг | Что сделать | Зачем |
|---|---|---|
| 1 | Проверить bash: bash --version |
нужна 5.1 или новее |
| 2 | На хостах с 4.x решить: обновлять bash или остаться на 8.1.1 | иначе скрипт выйдет с кодом 3 |
| 3 | Обновить файлы скрипта и установщика | install.sh тоже проверяет планку |
| 4 | Прогнать --version и --list-modes |
версия должна быть 9.0.1 или 9.0.0 |
| 5 | Прогнать на одном сайте в режиме check |
убедиться, что выбор целей работает |
| 6 | Перейти на полный прогон по парку | после проверки на одном сайте |
Для установки предусмотрен install.sh — 5 695 байт, с той же проверкой версии bash.
Проверка после обновления
flowchart LR
LIST["wp plugin list / theme list"] --> FIELDS["поля: name, status, title"]
FIELDS --> SLUG["slug = name"]
FIELDS --> TITLE["отображаемое имя = title"]
SLUG --> MATCH["--name, --exclude, hold"]
TITLE --> MATCH
MATCH --> SKIP{"status must-use или dropin?"}
SKIP -- да --> OUT["пропустить и записать в отладочный журнал"]
SKIP -- нет --> UPD["wp plugin update"]| Что проверить | Как | Ожидаемый результат |
|---|---|---|
| Версия скрипта | --version |
Bash_WP-CLI_Update.sh 9.0.1 |
| Список режимов | --list-modes |
14 строк, первая — full |
| Планка bash | bash --version на каждом хосте |
5.1 или новее |
| Выбор по имени | прогон с --exclude-plugins '<Отображаемое имя>' |
плагин исключён |
| mu-plugins | прогон на сайте с mu-plugin | запись пропущена, сайт здоров |
--debug |
прогон с --debug на профиле SKIP_IF_NO_UPDATES=1 |
нет «unbound variable» |
Замер на живом хосте 17 ноября 2026: на сервере bash 5.3.9, WP-CLI 2.12.0 — планка пройдена с запасом. Локальный прогон склонированного архива: --version сообщает 9.0.1, --help печатает справку, --list-modes отдаёт 14 режимов (full, core, plugins, themes, db-optimize, db-fix, cron, astra, list-plugins, plugin-manage, verify, check, status, health).

| Размер части | Значение |
|---|---|
Bash_WP-CLI_Update.sh |
220 800 байт, 5 075 строк |
Find_WP_Senior.sh |
33 136 байт, 884 строки |
install.sh |
5 695 байт |
CHANGELOG.md |
43 531 байт |
README.md |
32 509 байт |
Совместимость
| Среда | Поддержка 9.0.0 | Комментарий |
|---|---|---|
| bash 5.1+ | да | требование релиза |
| bash 4.4 (RHEL/Rocky/Alma 8) | нет | остаётся 8.1.1 |
| bash 4.2 (CentOS 7) | нет | остаётся 8.1.1 |
WP-CLI с полем title |
да | сопоставление по slug и имени |
WP-CLI без поля title |
да | повтор вызова без title, сопоставление по slug |
| mu-plugins, dropins | да | пропускаются с записью в отладочный журнал |
Отдельно про WP-CLI: способность к полю title проверяется один раз за прогон, а не на каждом сайте — это важно для парка из десятков сайтов, где лишний вызов на сайт превращается в минуты.
Подводные камни
- Хосты на RHEL/Rocky/Alma 8 остаются на 8.1.1. А 8.1.1 содержит дефект выбора плагинов — то есть на таких хостах селективное обновление не работает.
- Код выхода 3 — это не сбой. Так скрипт сообщает, что версия bash ниже планки; проверять надо версию, а не права на файлы.
install.shтоже проверяет планку. Обновление только основного скрипта не поможет.- 9.0.1 не приносит кода. Если в скрипте 9.0.0 — у вас ровно то же поведение.
-j N— барьер. Не ждите непрерывного конвейера: пакеты идут последовательно.- Сопоставление с пробелами. Разбор списка убирает пробелы, поэтому сравнение сделано нечувствительным к пробелам — не полагайтесь на точное совпадение строки.
- mu-plugins не обновляются. Их пропуск — не ошибка: они не устанавливаемые пакеты.
- Отладочный режим в производстве.
--debugтеперь безопасен, но объём вывода растёт; для планировщика лучше выключить. - Автор релиза честно пишет о дефекте 8.1.1. Если вы остаётесь на ней — ведите список плагинов вручную.
FAQ
Почему релиз мажорный, если ломающих изменений в поведении нет?
Потому что поднято документированное требование к среде: bash 5.1. Хост, который раньше работал, теперь получит отказ с кодом 3.
Что делать на RHEL/Rocky/Alma 8?
Либо обновить bash до 5.1 и перейти на 9.0.0, либо остаться на 8.1.1. Второй вариант рабочий, но селективное обновление плагинов там не работает из-за дефекта slug.
Чем 9.0.1 отличается от 9.0.0?
Только README. Архив 9.0.1 — это 9.0.0 с исправленной историей изменений и правкой в wiki: режимы CVE появились в 8.1.0, а не в 9.0.0.
Почему mu-plugins и dropins больше не обновляются?
Они видны в списке, но не являются устанавливаемыми пакетами. Попытка обновить их давала «could not be found» и валила здоровый сайт.
Что было не так с --debug?
Эхо отладочного вывода попадало в подстановку команды, и арифметика падала с «unbound variable». Проявлялось на профиле с SKIP_IF_NO_UPDATES=1.
Итог
9.0.0 — релиз из двух частей: поднятая планка bash 5.1 и четыре исправления в отборе целей, из которых главное — обращение к несуществующему полю slug. Именно оно не давало селективному обновлению работать вовсе. Заодно убраны mu-plugins и dropins из команды обновления, закрыт обход фильтра пустой ячейкой и починен --debug.
Прогон подтверждает: скрипт сообщает версию 9.0.1, отдаёт 14 режимов и содержит проверку планки в строке 89. Сервер с bash 5.3.9 и WP-CLI 2.12.0 требование проходит. Тем, у кого bash 4.x, релиз честно говорит: оставайтесь на 8.1.1 и помните, что селективное обновление там сломано.
Цитата: Мажорная версия — это не про новые возможности, а про то, что старая среда больше не подходит.
Связанные материалы
- Bash WP-CLI Update: обслуживание парка WordPress — обзор продукта целиком.
- Релиз 9.0.0 — заметки к выпуску.
- Релиз 9.0.1 — выпуск только с документацией.
- Защита админки WordPress: Basic Auth вторым слоем — что делать после обновлений.
- Clean BOM Senior: удаление BOM и CRLF за прогон — гигиена файлов на парке сайтов.
LLM Summary
- Релиз: Bash WP-CLI Update 9.0.0 (17.11.2026, 15:15 UTC) и 9.0.1 (15:43 UTC, только документация).
- Мажорность: минимальная версия bash поднята до 5.1; менеджер, поисковик и
install.shотказывают старому bash с кодом выхода 3. - Почему 5.1: bash 4.2 остался лишь на CentOS 7 (EOL июнь 2024) и заброшенных дистрибутивах; поддерживаемые в 2026 несут 5.1+.
- Исправление №1: у
wp plugin list/wp theme listнет поляslug(name— это slug,title— отображаемое имя); запрос--fields=name,slug,status,updateпадал сInvalid field: slug.и кодом 1. - Исправление №2: mu-plugins и dropins больше не попадают в
wp plugin update, пропускаются с записью в отладочный журнал. - Исправление №3: обход фильтра dropin пустой ячейкой (сдвиг
statusвtitle); необязательная колонка теперь последняя. - Исправление №4:
--debugломалpending_count/site_core_version(«DBG: unbound variable») приSKIP_IF_NO_UPDATES=1. - Сопоставление: исключения, удержания и
--nameработают по slug и отображаемому имени, без учёта регистра и пробелов; на старом WP-CLI — повтор безtitle. - Замер 17.11.2026: локальный прогон —
--versionдаёт 9.0.1,--list-modes— 14 режимов; скрипт 220 800 байт / 5 075 строк, поисковик 33 136 / 884,install.sh5 695, CHANGELOG 43 531, README 32 509 байт; проверка планки — строка 89. - Сервер: bash 5.3.9, WP-CLI 2.12.0 — требование выполнено.
- Не проверялось: полный прогон по парку сайтов, поведение на WP-CLI старше 2.x, обновление на хостах с bash 4.4.
Промт для агента (установка и настройка)
Готовый промт: скопируйте блок целиком. Источник шагов — заметки к выпуску 9.0.0 и README.md репозитория; файла AGENTS.md в проекте нет (в репозитории лежит AGENT.md).
Задача: обновить Bash WP-CLI Update до 9.0.0/9.0.1 на парке хостов и проверить, что выбор целей работает.
Материалы:
- репозиторий: https://github.com/paulmann/Bash_WP-CLI_Update
- релиз: https://github.com/paulmann/Bash_WP-CLI_Update/releases/tag/v9.0.1
- обзор продукта: https://sysadministrator.ru/bash-wp-cli-update/
Шаг 1. На каждом хосте выполнить bash --version и записать результат.
Шаг 2. Хосты с bash 5.1+ — обновлять; хосты с 4.x — решить: обновить bash или остаться на 8.1.1.
Шаг 3. Обновить файлы из репозитория: git checkout v9.0.1 (код тот же, что в 9.0.0).
Шаг 4. Проверить, что install.sh тоже обновлён: он содержит собственную проверку версии bash.
Шаг 5. Выполнить --version: ожидается Bash_WP-CLI_Update.sh 9.0.1.
Шаг 6. Выполнить --list-modes: ожидается 14 режимов, первый — full.
Шаг 7. На одном сайте прогнать режим check и убедиться, что список целей строится.
Шаг 8. Проверить исключение по отображаемому имени: --exclude-plugins '<Отображаемое имя>'.
Шаг 9. На сайте с mu-plugin убедиться, что запись пропущена, а сайт здоров.
Шаг 10. Прогнать с --debug на профиле SKIP_IF_NO_UPDATES=1: не должно быть «unbound variable».
Шаг 11. Перейти на полный прогон по парку, начиная с одного сайта.
Шаг 12. Записать в реестр: версия bash по хостам, версия скрипта, где остались хосты на 8.1.1.
Запрещено:
- считать код выхода 3 сбоем прав или файлов: это проверка версии bash;
- обновлять только основной скрипт, забыв install.sh;
- оставаться на 8.1.1 и при этом ждать работающего селективного обновления;
- обновлять mu-plugins и dropins вручную через plugin update;
- включать --debug в планировщике на постоянной основе;
- запускать полный прогон по парку без проверки на одном сайте.
Что считать успехом: на всех хостах bash 5.1+, скрипт сообщает 9.0.1, режимы на месте, выбор целей строится, исключения по отображаемому имени работают, mu-plugins пропускаются, --debug не падает, результат записан.