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

Zinnector® — це безкоштовний інструмент командного рядка від Zinn Digital® із ліцензією MIT для розробників 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, де ми раді звітам про помилки та пул-реквестам.