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

Zinnector® — это бесплатный инструмент командной строки с лицензией MIT от Zinn Digital® для разработчиков WordPress. Он разворачивает структуру сайта, запускает полноценный 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», исполняемый файл установлен, но ваша версия 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 request.