Zinnector®

A fejlesztői CLI a WordPress hosztoláshoz

A Zinnector® a WordPress helyi összeállítására szolgál anélkül, hogy a Node-on kívül bármi más telepítve lenne – nincs szükség Dockerre vagy MAMP-ra –, majd összehasonlítja az elkészült oldalt azzal a tárhelyhellyel, ahová telepíteni kívánja, és még az élesítés előtt jelzi, ha valami eltér. Telepítse az npm install -g zinnector paranccsal. Ingyenes, MIT-licences, és ugyanarra a nyilvános API-ra épül, mint az összes többi eszköz itt.

Öt parancs, és a középső a lényeg

A legtöbb tárhelyszolgáltatói CLI a telepítéssel kezdődik. A Zinnector® ennél korábban indul – együtt építi fel önnel a webhelyet, majd ellenőrzi a munkáját azon a gépen, amelyre küldeni készül. A rés „futott a laptopomon” és „fut a szerveren” között az az idő, ami elviszi a délutánokat, és ez a rés mérhető.

új zinnector

Készítsen el egy webhelyet, bővítményt vagy blokktémát, amely azonnal elindul. Nincsenek helyőrző fájlok, nincsenek TODO-k – a bővítmény aktiválódik, és a téma a létezésének pillanatában kiválasztható.

zinnector dev

Valódi WordPress a gépén másodpercek alatt, saját bővítményeit és témáit kiszolgálva, Docker és a PATH-on lévő PHP nélkül. Válasszon tetszőleges PHP-t az 5.2-estől a 8.5-ös verzióig a fejlesztéshez.

zinnector ellenőrzés

A repülés előtti ellenőrzés. Összehasonlítja az Ön által készítetteket azzal a hellyel, amelyre telepíteni készül, és minden eltérést – valamint minden olyan ellenőrzést, amelyet nem tudott elvégezni – megnevez, mielőtt elindítaná.

zinnector push

Ellenőrzés, küldje be a commitokat, indítsa el a telepítést, és kövesse figyelemmel a befejezésig. Ha sikertelen, a buildnapló csak egy parancsra van.

zinnector ai

Kérdezze meg az asszisztenst a terminálból, a projektjét és a webhelyét kontextusként használva. A platformon fut a saját fiókja ellenében, így semmilyen modellkulcs nem kerül tárolásra a gépén.

Test it works in two minutes, no account needed

Six commands, in order, and what success looks like at each one. Everything here runs on your own machine; an API key is only needed when you reach a hosting slot.

  1. Install it

    Run npm install -g zinnector on Node 24 or newer. If npm prints EBADENGINE, your Node is older than 24 — install the current LTS from nodejs.org and run the install again.

  2. Check the version

    zinnector --version prints a version number such as 0.1.2. On a Node older than 24 it prints a message saying Node 24 or newer is needed, and exits.

  3. Read the help

    zinnector --help lists every command below with a one-line purpose. Every command also takes --help of its own.

  4. Scaffold a site

    zinnector new my-site creates a project that boots immediately — a zinnector.json, a wp-content tree and a README — and prints the next commands to run.

  5. Run it

    cd my-site, then zinnector dev. The first run asks once to download the WordPress runtime (about 570 MB, kept in the CLI’s own cache, never in your project). Success looks like “running at http://127.0.0.1:9400”.

  6. Open it in a browser

    http://127.0.0.1:9400 is a fresh WordPress site; /wp-admin opens the dashboard already signed in. Drop a plugin into wp-content/plugins and it is there on the next reload.

  7. Then, with a hosting slot

    zinnector login, zinnector link, zinnector check, zinnector push — pre-flight what you built against the slot, then deploy and watch it finish.

A repülés előtti ellenőrzés részletesen

PHP 8.3-on építkeztél. A slot 8.1-et futtat. Semmi sem szól, amíg a webhely fehér nem lesz. Ez az a probléma, amiért ez a parancs létezik, és ezt kérte név szerint ennek a platformnak a tulajdonosa. A Zinnector® mindkét környezetet beolvassa, és egymás mellé helyezi – aztán mégis engedi a telepítést, mert lehet, hogy megvan az okod rá.

PHP, tisztességesen besorolva

A főverzió-beli eltérés azért van magas kockázatúként jelölve, mert szinte biztosan összetöri a webhelyet, míg a alverziókbeli eltérés alacsonyabb jelölést kap. Ha mindent kritikusnak minősítünk, azzal csak arra tanítjuk az embereket, hogy figyelmen kívül hagyják a figyelmeztetést.

Lemez- és fájlhasználat külön-külön

Egy WordPress faszerkezet tízezernél is több kis fájlból áll, és egy webhely a lemezterület-korlátja alatt maradva is kimerítheti az inode-keretét. Mindkettőt a tárhelyen ténylegesen fennmaradó kapacitás alapján ellenőrizzük, nem a csomag szerint.

„Az „Ellenőrzés nem sikerült” önmagában is válasz”

Egy ellenőrzés, amely nem látja a vizsgált alanyát, ellenőrizetlenként jelez, sosem sikeresként. Egy tiszta futtatás azt is jelenti, hány dolgot nem tudott ellenőrizni, mert a hamis mindent rendben jelzés az az egy, amit senki sem vizsgál meg kétszer.

Figyelmeztet, de soha nem blokkol

Minden egyes megállapítás felülbírálható a --force kapcsolóval, és az összefoglaló ezt jelzi is. CI környezetben ehelyett a kilépési kód szolgál kapuként, így egy folyamat lehet szigorú, miközben egy ember marad az irányítás atyja.

Két helyi futtatókörnyezet, mindkettő valódi

A WordPress Playground az alapértelmezett: a WebAssemblyre lefordított PHP a Node-on belül fut, így a semmilyen más szoftverrel nem rendelkező, csak a Node-ot telepített laptop a semmiből egy futó WordPress elérésébe jut annyi idő alatt, amíg elolvassa ezt a mondatot.

Ha egy natív PHP-ra — olyan kiterjesztésre, mint az imagick, vagy egy igazi MySQL-re — van szüksége, adja meg a --runtime docker kapcsolót, és helyette php-fpm, valamint MariaDB tárolókat kap. Mindkettő ugyanazokat a fájlokat szolgálja ki ugyanmiből a projektből, így a kettő közötti váltás csak a motort módosítja, mást nem.

Minden mást már elvégez a panelben

A Zinnector® ugyanarra a nyilvános API-ra épül, mint a vezérlőpult, így amit a panel meg tud tenni, azt ez is képes végrehajtani – ráadásul minden parancs egy dokumentált művelet az OpenAPI specifikációban, nem pedig egy privát végpont.

Webhelyek és telepítések

Webhelyek listázása, a platform által egyről tudott összes információ olvasása, újbóli üzembe helyezés, valamint az üzembe helyezési előzmények és a buildnaplók olvasása.

Domainok, DNS és levelezés

Domainek felsorolása, DNS-rekordok olvasása és módosítása azelőtt, hogy a rekord a kiírása előtt megjelenne, valamint levelezési szolgáltatások olvasása.

PHP, kvóta, adatbázis és naplófájlok

Váltson PHP-verziót, ellenőrizze a lemez- és inode-használatot a csomagja kereteihez képest, kapjon egyszer használatos hivatkozásokat a phpMyAdmin felülethez, valamint kövesse figyelemmel a hozzáférési és hibanaplókat.

WP-CLI és tömeges műveletek

Futtasson engedélyezett listán szereplő WP-CLI parancsokat egy webhelyen, és törölje a gyorsítótárakat vagy indítson kártevő-ellenőrzéseket egy teljes kijelölésen egyetlen hívással ahelyett, hogy webhelyenként külön kellene megtennie.

Every command, exactly as --help lists it

The full list, one line each. The complete reference — every flag, a runnable example and what each command prints — is generated from the CLI itself and lives in the developer docs and the knowledge base, so it cannot drift from the tool you have installed.

zinnector new

Scaffold a WordPress project you can run immediately.

zinnector dev

Run this project locally — no Docker required.

zinnector login

Sign in with a Zinn Digital® API key.

zinnector logout

Forget a stored API key.

zinnector whoami

Show who this CLI is authenticated as.

zinnector sites

List the sites this key can see.

zinnector status

Everything the platform knows about one site.

zinnector share

Give one person access to a single site — a developer, a designer, a client — with a role and a reason.

zinnector collaborators

See who has been given access to a site, their role, and whether they have accepted yet.

zinnector unshare

Take a person's access back, by email or grant id.

zinnector invitations

The invitations waiting for you, and accept one.

zinnector link

Point this project at a hosting slot (and connect its repository).

zinnector pull

Pull a hosted site's files into this project for local development, and re-run to re-sync. Takes the fast path when the site syncs to its own repository, otherwise works from the latest backup.

zinnector clone

Make a local project from a hosted site in one step: clone its repository or pull its files, write the project file, and leave you ready to run zinnector dev.

zinnector check

Compare this project against the slot you are about to deploy to.

zinnector push

Pre-flight, push your commits, and deploy.

zinnector deploy

Redeploy what the platform already has, without pushing.

zinnector deploys

A site's deploy history.

zinnector php

Show or switch a site's PHP version.

zinnector quota

Disk, files and database usage against what the plan grants.

zinnector db

Database size, and single-use links into phpMyAdmin and the file manager.

zinnector logs

Tail a site's access and error logs.

zinnector wp

Run an allow-listed WP-CLI command on a site.

zinnector backup

List and take site backups. Subcommands: list, now.

zinnector domains

List the domains this key can see.

zinnector dns

Read and change DNS records. Subcommands: list, add, rm.

zinnector mail

List mail services.

zinnector bulk

Run one operation across many sites (cache_purge, malware_scan, sitemap, block_ip).

zinnector ai

Ask the Zinn Digital® assistant, with this project as context.

Kérdések

Kell a Zinn Digital® ügyfelének lennem a használatához?

Nem. A `zinnector new` és a `zinnector dev` parancsokhoz egyáltalán nincs szükség fiókra – hozzon létre bővítményt, témát vagy egy egész webhelyet sablonból, és futtassa helyben, ingyen, örökre. API-kulcs csak a tárhelyével kommunikáló parancsokhoz szükséges.

Szüksége van Dockerre?

Nem az alapértelmezett futtatókörnyezethez. A WordPress Playground lefordítja a PHP-t WebAssemblyre és a Node-on belül fut, így a `zinnector dev` másodpercek alatt elindít egy valódi WordPresst anélkül, hogy bármi mást telepíteni kellene. Ha natív PHP-re van szüksége – egy bővítmény, például az imagick vagy az ionCube teszteléséhez –, a `--runtime docker` a php-fpm és MariaDB konténereket biztosít helyette. Mindkettő támogatott; egyik sem tartalék opció.

Mit hasonlít össze valójában az indítás előtti ellenőrzés?

A helyi PHP-verzió a slot verziójához képest, hogy a slot egyáltalán átválthat-e arra a verzióra, amelyen az építkezést végezte, hogy a slot PHP-je túl van-e a támogatási időszakán (end of life), és hogy a gép ténylegesen alkalmazta-e azt, a projekt mérete és fájlszáma a hátralévő lemez- és inód-kapacitáshoz képest, a WordPress verziói mindkét oldalon, hogy a slot befejezte-e a kiépítést, valamint hogy csatlakoztatva van-e git-tárház a központi üzembe helyezéshez. Bármit, amit nem tudott ellenőrizni, ellenőrizetlenként jelent, ahelyett hogy sikeresnek számítana.

Megakadályozhat a közzétételben?

Nem, és ez szándékos. Az indítás előtti ellenőrzés figyelmeztet, de átengedi a folyamatot – a `--force` pedig bármilyen észlelt probléma ellenére telepít. Ön jobban ismeri a saját webhelyét, mint egy ellenőrző, és egy olyan eszköz, amely megtagadja a telepítést, olyan eszköz, amelyet az emberek eltávolítanak.

Biztonságban van az API-kulcsom?

A kulcsot a rendszer soha nem olvassa be a parancssorból – kizárólag promptból vagy csövezett (piped) szabványos bemenetből –, így az nem kerülhet be a parancsértelmező előzményeibe vagy a folyamatlistába. A tárolás a saját konfigurációs könyvtárában történik 600-as fájlmódban, és a Zinnector® minden írás alkalmával érvényesíti ezeket a jogosultságokat.

Használhatom CI-ben?

Igen. Állítsa be a `ZINNECTOR_TOKEN` változót, és minden parancs elfogadja a `--json` kapcsolót. Az emberi olvasásra szánt kimenet az stderr-re, az adatok pedig az stdout-ra kerülnek, így a csövek (pipe-ok) tiszták maradnak. A `zinnector check` nem nulla értékkel lép ki, ha talál valamit, így csővezeték-kaputként is használható, és a `--strict` szintén hibával leáll, ha egy összehasonlítás nem volt elvégezhető.

Telepítse, és indítson el egy webhelyet a következő percben

Futtassa az npm install -g zinnector parancsot, vagy próbálja ki egyszer az npx zinnector new my-site paranccsal. Ingyenes, MIT-licencű és a nyilvános API-ra épül. Hozzon létre egy projektet, futtassa helyben Docker nélkül, és végezzen el egy ellenőrzést a telepítés előtt.

Dokumentáció olvasása