Начало работы с Zinnector®, интерфейсом командной строки для разработчиков

Zinnector® — это бесплатный инструмент командной строки для разработчиков WordPress от компании Zinn Digital®, распространяемый по лицензии MIT. Он создает каркас сайта, запускает настоящий WordPress на вашем собственном компьютере, когда установлен только Node (никаких Docker, MAMP или PHP в системном переменной PATH), после чего проверяет то, что вы создали, на соответствие хостинг-слоту, на который вы собираетесь выполнить развертывание, и отправляет данные туда. Это руководство проведет вас путь от нуля до работающего сайта примерно за две минуты и на каждом этапе покажет, как выглядит успешный результат, чтобы вы знали, если что-то пошло не так.

Что вам понадобится

• Node 24 или новее. Запустите node --version; в выводе должно быть v24 или выше. Установите текущую версию LTS с сайта nodejs.org: в Windows — winget install OpenJS.NodeJS.LTS, в macOS — brew install node@24.
• npm, который поставляется вместе с Node. Zinnector® использует его один раз, чтобы загрузить среду выполнения WordPress в собственный кэш.
• git, необходимый только для команды zinnector push — развертывание запускается из вашего репозитория.
• Docker, только если вы запросите его с помощью параметра --runtime docker. Среда выполнения по умолчанию работает без него.

Для всего, что описано ниже, аккаунт не нужен. Ключ API требуется только при переходе к хостинг-слоту, как описано в разделе Развертывание с помощью Zinnector®.

Шаг 1 — установка

npm install -g zinnector

Если npm выводит сообщение npm WARN EBADENGINE, установленная у вас версия Node ниже требования >=24.18.1, которое заявляет пакет. Установка все равно завершится, но интерфейс командной строки откажется запускаться. Сначала обновите Node, затем повторите установку.

Шаг 2 — проверка версии

zinnector --version

Успешный результат: номер версии, например 0.1.2. Если вы видите текст "Zinnector® needs Node 24 or newer — this is Node 20.x" (Zinnector® требуется Node 24 или новее, используется Node 20.x), значит, бинарный файл установлен, но ваша версия Node устарела; команда завершает работу с кодом 78, не выполняя никаких действий.

Шаг 3 — чтение справки

zinnector --help

Успешный результат: баннер с перечислением пяти команд рабочего процесса (new, dev, link, check, push), после которого для каждой команды указано ее назначение в одну строку. Каждая команда также поддерживает собственный параметр --help — например, zinnector dev --help выводит список флагов среды выполнения, PHP и портов. Полный список с примерами приведен в справочнике команд.

Шаг 4 — создание структуры сайта

zinnector new my-site

Успешный результат: заголовок Created my-site и список созданных файлов — zinnector.json, дерево каталогов wp-content с папками plugins/, themes/ и вспомогательным файлом mu-plugins/, файл .gitignore и README, а также следующие команды, которые нужно запустить. Ни один элемент здесь не является за-полнителем; проект готов к за-пуску в текущем виде. Параметры --template plugin или --template theme создают каркас плагина или блочной темы, которые активируются сразу после появления.

Шаг 5 — запуск

cd my-site
zinnector dev

При первом запуск Zinnector® запрашивает подтверждение перед тем, как загрузить среду выполнения WordPress (около 570 МБ, поскольку она содержит все версии PHP от 5.2 до 8.5) в собственный каталог кэша, а не в ваш проект. Введите Y или передайте флаг --yes, чтобы пропустить этот вопрос. На Node 26 или новее он также загружает Node 24 исключительно для среды выполнения (около 30 МБ, проверяется по контрольным суммам nodejs.org), поскольку нативные модули среды выполнения имеют предварительно скомпилированные бинарные файлы только для Node 24 и 25; вам не нужны компилятор или Visual Studio.

Успешный результат: блок, в котором указаны название проекта, версия PHP и версия WordPress, а затем:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

Шаг 6 — открытие сайта

Откройте адрес http://127.0.0.1:9400 в браузере. Успешный результат: новый сайт на WordPress с заголовком My WordPress Website, обслуживаемый запрошенной вами версией PHP. Адрес http://127.0.0.1:9400/wp-admin открывает панель управления с выполненным входом. Добавьте плагин в папку wp-content/plugins/ или тему в wp-content/themes/, и они появятся при следующей перезагрузке — среда выполнения обслуживает эти каталоги напрямую из вашего проекта.

Нажмите Ctrl-C для остановки. Команда zinnector dev --once запускает среду выполнения, выводит информацию о том, что именно запущено (версия PHP, версия WordPress, загруженные расширения) и останавливается — это полезно, когда вам нужны доказательства, а не обещания.

Что делать дальше

• Локальная разработка с помощью zinnector dev — две среды выполнения, выбор версий PHP и WordPress, а также информация о том, что и откуда обслуживается.
• Развертывание с помощью Zinnector® — вход в систему, привязка проекта к слоту, предварительная проверка, отправка.
• Справочник команд — все команды, флаги и примеры.
• Устранение неполадок — реальные ошибки, с которыми сталкиваются пользователи, и способы их решения.

Та же документация содержится в файле README пакета на npm и на GitHub, где приветствуются сообщения об ошибках и запросы на слияние (pull requests).