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

Установіть безкоштовний Zinnector CLI на Node 24 або новішої версії, а потім перевірте його роботу за дві хвилини: --version, --help, створіть каркас сайту, запустіть справжній WordPress локально без Docker і відкрийте його у своєму браузері — з описом того, як має виглядати успішний результат на кожному кроці.

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