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.

bash wp cli update 9 0 0 cover

TL;DR: пять пунктов

  1. Планка bash — 5.1. Менеджер, поисковик и install.sh отказывают старому bash с кодом 3.
  2. Выбор плагинов починен. У wp plugin list нет поля slug: name — это и есть slug, а отображаемое имя лежит в title.
  3. mu-plugins и dropins пропускаются. Раньше они уходили в plugin update и валили здоровый сайт.
  4. --debug больше не ломает проверку обновлений. Эхо отладочного вывода попадало в $( ) и убивало арифметику.
  5. 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 9.0.0: прогон и проверка хоста
Bash WP-CLI Update 9.0.0: что показали прогон и проверка хоста
Размер части Значение
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 и помните, что селективное обновление там сломано.

Цитата: Мажорная версия — это не про новые возможности, а про то, что старая среда больше не подходит.

Связанные материалы

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.sh 5 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 не падает, результат записан.