Pierwsze kroki z Zinnector®, interfejsem wiersza poleceń dla programistów

Zainstaluj darmowy interfejs wiersza poleceń Zinnector CLI w wersji Node 24 lub nowszej, a następnie sprawdź jego działanie w dwie minuty: --version, --help, stwórz szkielet witryny, uruchom lokalnie prawdziwy WordPress bez użycia platformy Docker i otwórz go w przeglądarce — zobacz, jak wygląda sukces na każdym etapie.

Zinnector® to bezpłatne narzędzie wiersza poleceń na licencji MIT od Zinn Digital® dla deweloperów WordPress. Przygotowuje szkielet witryny, uruchamia prawdziwego WordPressa na własnym komputerze bez instalowania niczego poza Node — bez Dockera, bez MAMP, bez PHP w zmiennej ścieżki (PATH) — a następnie sprawdza to, co zostało zbudowane, pod kątem miejsca hostingu, na które ma nastąpić wdrożenie, i przesyła to. Ten przewodnik pozwala przejść od zera do działającej witryny w około dwie minuty i informuje, jak wygląda sukces na każdym kroku, aby można było rozpoznać, kiedy coś poszło nie tak.

Czego potrzebujesz

Node w wersji 24 lub nowszej. Uruchom node --version; polecenie musi zwrócić v24 lub wyższą wersję. Zainstaluj bieżącą wersję LTS z nodejs.org — w systemie Windows winget install OpenJS.NodeJS.LTS, w systemie macOS brew install node@24.
npm, który jest dostarczany razem z Node. Zinnector® używa go raz, aby pobrać środowisko wykonawcze WordPress do własnej pamięci podręcznej.
git, wyłącznie na potrzeby zinnector push — wdrożenia są inicjowane z repozytorium.
Docker, wyłącznie jeśli zażądasz tego za pomocą flagi --runtime docker. Domyślne środowisko wykonawcze nie wymaga go wcale.

Żaden z poniższych elementów nie wymaga zakładania konta. Klucz API jest potrzebny tylko w momencie dotarcia do miejsca hostingu, zgodnie z instrukcjami w sekcji Wdrażanie za pomocą Zinnector®.

Krok 1 — instalacja

npm install -g zinnector

Jeśli npm wyświetli komunikat npm WARN EBADENGINE, wersja posiadanego środowiska Node jest starsza niż wymagana przez pakiet wersja >=24.18.1. Instalacja zakończy się pomimo to, ale interfejs CLI odmówi uruchomienia. Najpierw zaktualizuj Node, a następnie zainstaluj narzędzie ponownie.

Krok 2 — sprawdzenie wersji

zinnector --version

Sukces: numer wersji, na przykład 0.1.2. Jeśli zobaczysz komunikat "Zinnector® needs Node 24 or newer — this is Node 20.x", plik bynarny jest zainstalowany, ale wersja środowiska Node jest zbyt stara; polecenie kończy działanie z kodem 78, nie wykonując żadnych operacji.

Krok 3 — odczytanie pomocy

zinnector --help

Sukces: baner zawierający nazwy pięciu poleceń wchodzących w skład przepływu (new, dev, link, check, push), a następnie każde polecenie wraz z opisem przeznaczenia mieszczącym się w jednej linijce. Każde polecenie obsługuje również własną flagę --help — zinnector dev --help wyświetla listę flag środowiska wykonawczego, PHP oraz portów. Pełna lista wraz z przykładami znajduje się w dokumentacji poleceń.

Krok 4 — przygotowanie szkieletu witryny

zinnector new my-site

Sukces: nagłówek Created my-site oraz lista zapisanych plików — zinnector.json, drzewo katalogów wp-content zawierające plugins/, themes/ oraz plik pomocniczy mu-plugins/, plik .gitignore oraz plik README — po których następuje lista kolejnych poleceń do uruchomienia. Żaden element nie jest symbolem zastępczym; projekt uruchamia się w obecnej postaci. Flagi --template plugin lub --template theme pozwalają przygotować szkielet wtyczki lub motywu blokowego, które aktywują się w momencie utworzenia.

Krok 5 — uruchomienie

cd my-site
zinnector dev

Przy pierwszym uruchomieniu Zinnector® pyta użytkownika raz przed pobraniem środowiska wykonawczectwa WordPress — pliku o wielkości około 570 MB, ponieważ zawiera on każdą wersję PHP od 5.2 do 8.5 — do własnego katalogu pamięci podręcznej, nigdy do katalogu projektu. Odpowiedz Y lub przekazuj flagę --yes, aby pominąć to pytanie. W środowisku Node w wersji 26 lub nowszej pobierane jest również środowisko Node 24 przeznaczone wyłącznie dla środowiska wykonawczego (około 30 MB, zweryfikowane za pomocą sum kontrolnych z nodejs.org), ponieważ wbudowane moduły środowiska wykonawczego posiadają wstępnie skompilowane pliki binarne wyłącznie dla wersji Node 24 i 25; nie jest wymagany żaden kompilator ani program Visual Studio.

Sukces: blok zawierający nazwę projektu, wersję PHP oraz wersję WordPressa, a następnie:

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

Krok 6 — otwarcie witryny

Odwiedź adres http://127.0.0.1:9400 w przeglądarce. Sukces: nowa witryna WordPress zatytułowana My WordPress Website, obsługiwana przez wskazaną wersję PHP. Adres http://127.0.0.1:9400/wp-admin otwiera pulpit nawigacyjny z automatycznie rozpoczętą sesją. Umieść wtyczkę w katalogu wp-content/plugins/ lub motyw w katalogu wp-content/themes/, a pojawi się ona przy kolejnym odświeżeniu — środowisko wykonawcze obsługuje te katalogi bezpośrednio z poziomu projektu.

Naciśnij kombinację klawiszy Ctrl-C, aby zatrzymać działanie. Polecenie zinnector dev --once uruchamia środowisko wykonawcze, wyświetla informacje o tym, co faktycznie działa (wersja PHP, wersja WordPressa, załadowane rozszerzenia) i kończy działanie — jest to przydatne, gdy potrzebujesz dowodu, a nie obietnicy.

Co zrobić dalej

Rozwój lokalny za pomocą zinnector dev — dwa środowiska wykonawcze, wybór wersji PHP i WordPressa oraz informacje o tym, co i skąd jest obsługiwane.
Wdrażanie za pomocą Zinnector® — logowanie, powiązanie projektu z miejscem, test przedwdrożeniowy, przesyłanie.
Dokumentacja poleceń — każde polecenie, flaga i przykład.
Rozwiązywanie problemów — błędy, z którymi faktycznie stykają się użytkownicy, oraz sposoby ich naprawy.

Ta sama dokumentacja znajduje się w pliku README pakietu w serwisie npm oraz w serwisie GitHub, gdzie mile widziane są zgłoszenia problemów (issues) oraz żądania ściągnięcia (pull requests).