Zinnector®

CLI ya msanidi programu ya uwekaji mwenyeji wa WordPress

Zinnector® huunda WordPress nchini ndani bila chochote kilichosanikishwa isipokuwa Node — hakuna Docker, hakuna MAMP — kisha hukagua ulichojenga dhidi ya nafasi ya mwenyeji utakayokaribia kupeleka na kukuambia kile ambacho hakitalingana, kabla ya kusukuma. Isakinishe na npm install -g zinnector. Ni bure, ina leseni ya MIT na imejengwa kwenye API ile ile ya umma kama kila kitu kingine hapa.

Amri tano, na ya katikati ndiyo hasa lengo

CLI nyingi za mwenyeji huanza wakati wa kutoa huduma. Zinnector® huanza kabla ya hapo — hujenga tovuti pamoja nawe, na kisha hukagua kazi yako dhidi ya mashine unayotaka kuituma. Pengo kati ya “ilifanya kazi kwenye kompyuta yangu ndogo” na “inapiga kazi kwenye seva” ndipo muda unapoenda, na pengo hilo linaweza kupimwa.

zinnector mpya

Tengeneza tovuti, programu-jalizi au mandhari ya kuzuia inayoanza mara moja. Hakuna faili za nafasi, hakuna TODO — programu-jalizi huamilishwa na mandhari inaweza kuchaguliwa mara tu inapokuwepo.

zinnector dev

WordPress halisi kwenye kompyuta yako kwa sekunde chache, ikihudumia programu-jalizi na mandhari zako mwenyewe, bila Docker na bila PHP kwenye PATH yako. Chagua PHP yoyote kuanzia 5.2 hadi 8.5 kwa ajili ya kufanyia kazi.

ukaguzi wa zinnector

Ukaguzi wa kabla ya safari. Hulinganishwa kile ulichounda na nafasi unayokaribia kupeleka na kutaja kila kutolingana — na kila ukaguzi ambao haukuweza kufanya — kabla ya kusukuma.

zinnector push

Kabla ya kupaa, peleka marekebisho yako, anzisha usambazaji na ufuatilie hadi ukamilike. Ukishindwa, kumbukumbu ya ujenzi iko umbali wa amri moja.

zinnector ai

Uliza msaidizi kutoka kwenye terminal, ukiwa na mradi wako na tovuti yako kama muktadha. Inaendeshwa kwenye jukwaa dhidi ya akaunti yako mwenyewe, kwa hivyo hakuna ufunguo wa mfano unaowahi kuhifadhiwa kwenye kompyuta yako.

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.

Kipaumbele cha mwisho, kwa kina

Ulitengeneza kwa PHP 8.3. Nafasi hii inaendesha 8.1. Hakuna kinachokujulisha hadi tovuti inapogeuka kuwa nyeupe. Hilo ndilo tatizo ambalo amri hii ipo kwa ajili yake, na ndilo ambalo mmiliki wa jukwaa hili aliomba kwa jina. Zinnector® inasoma mazingira yote mawili na kuyaweka kando kwa kando — kisha inakuacha utume hata hivyo, kwa sababu unaweza kuwa na sababu.

PHP, iliyopimwa kwa uaminifu

Pengo la toleo kuu linawekewa alama ya juu kwa sababu linavunja tovuti kwa hakika; pengo dogo linawekewa alama ya chini. Kuweka kila kitu katika kiwango cha hatari kubwa hufundisha tu watu kupuuza onyo hilo.

Diski na idadi ya faili, kando kando

Mti wa WordPress una makumi ya maelfu ya faili ndogo, na tovuti inaweza kumaliza mgawo wake wa inode wakati bado iko chini ya kikomo chake cha diski. Zote mbili hukaguliwa dhidi ya kile kilichobaki kwenye nafasi hiyo, sio dhidi ya mpango.

“Haikuweza kuangaliwa” ni jibu lake lenyewe

Ukaguzi usioweza kumwona mlengwa wake hutoa ripoti ya haijakagត្រូវបាន, haujapitishwa kamwe. Usafishaji safi husema ni vitu vingapi ambavyo havikumudu kuvithibitisha, kwa sababu onyo la uwongo la usalama kamili ndilo ambalo hakuna mtu anayeliangalia mara mbili.

Inaonya, haizuie kamwe

Kila ugunduzi unaweza kubatilishwa kwa --force, na muhtasari unasema hivyo. Katika CI msimbo wa kutokea ndio kizuizi badala yake, ili bomba liweze kuwa kali huku mtu akiwa bado anadhibiti.

Mazingira mawili ya ndani ya utekelezaji, yote ni halisi

WordPress Playground ndiyo chaguo-msingi: PHP iliyoundwa kwa ajili ya WebAssembly, inayofanya kazi ndani ya Node, kwa hiyo kompyuta ya mkononi isiyo na chochote isipokuwa Node iliyosakinishwa huenda kutoka bila kitu hadi kwenye WordPress inayofanya kazi katika muda unaochukua kusoma sentensi hii.

Unapohitaji PHP asilia — kiendelezi kama imagick, MySQL halisi — pitisha --runtime docker na upate vyombo vya php-fpm na MariaDB badala yake. Vyote viwili vinahudumia faili zilezile kutoka kwenye mradi uleule, kwa hivyo kubadilisha kati yao hubadilisha injini na si kingine chochote.

Kila kitu kingine unachofanya tayari kwenye kidirisha

Zinnector® imejengwa kwa kutumia API ya umma ile ile kama dashibodi, kwa hivyo chochote ambacho paneli inaweza kufanya, inaweza kufanya pia—na kila amri ni operesheni iliyoandikwa katika vipimo vya OpenAPI badala ya kuwa sehemu ya mwisho ya faragha.

Tovuti na usambazaji

Orodhesha tovuti, soma kila kitu kinachojulikana na jukwaa kuhusu tovuti moja, peleka upya, na usome historia ya upelekaji na kumbukumbu za ujenzi.

Domaini, DNS na barua pepe

Orodhesha vikoa, soma na ubadilishe rekodi za DNS ukiwa na rekodi inayoonyeshwa kabla haijaandikwa, na usome huduma zako za barua pepe.

PHP, kiwango, hifadhidata na kumbukumbu

Badilisha matoleo ya PHP, soma matumizi ya diski na inode dhidi ya kile mpango wako unaruhusu, pata viungo vya matumizi mara moja kwenye phpMyAdmin, na ufuatilie kumbukumbu za ufikiaji na makosa.

WP-CLI na shughuli za wingi

Tekeleza amri za WP-CLI zilizoidhinishwa kwenye tovuti, na ufute kashe au uanzishe ukaguzi wa programu hasidi katika uteuzi mzima kwa simu moja badala ya moja kwa kila tovuti.

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.

Maswali

Je, ninahitaji kuwa mteja wa Zinn Digital® ili niitumie?

La. `zinnector new` na `zinnector dev` hazihitaji akaunti yoyote — tengeneza plagi, mada au tovuti nzima na uiiendeshe ndani ya kifaa chako, bure, milele. Ufunguo wa API unahitajika tu kwa amri zinazowasiliana na mwenyeji wako.

Je, inahitaji Docker?

Si kwa ajili ya mazingira chaguo-msingi ya uendeshaji. WordPress Playground hukusanya PHP hadi WebAssembly na huendesha ndani ya Node, kwa hivyo `zinnector dev` huwasha WordPress halisi kwa sekunde chache bila kitu kingine chochote kilichosanikishwa. Ikiwa unahitaji PHP asilia — ili kujaribu kiendelezi kama vile imagick au ionCube — `--runtime docker` hukupa vyombo vya php-fpm na MariaDB badala yake. Vyote viwili vinaungwa mkono; hakuna kinachofanya kazi kama mbadala wa dharura.

Ukaguzi wa kabla ya safari kusema kweli unalinganisha nini?

Toleo lako la ndani la PHP ikilinganishwa na la nafasi (slot), kama nafasi inaweza hata kubadilika hadi toleo ulilojengea, kama PHP ya nafasi imepita mwisho wa maisha yake na kama mashine imetumia kweli, ukubwa wa mradi wako na idadi ya faili dhidi ya nafasi iliyobaki ya diski na inode, matoleo ya WordPress kila upande, kama nafasi imemaliza kuandaliwa, na kama hifadhi ya git imeunganishwa ili kupeleka. Kila kitu ambacho kingeshindwa kuangaliwa kinaripotiwa kuwa hakijaangaliwa badala ya kuhesabiwa kuwa kimefaulu.

Je, inaweza kunizuia kupeleka?

Hapana, na hilo ni kwa makusudi. Pre-flight inatoa maonyo na kukuruhusu uendelee — `--force` inapeleka toleo jipya ikipita ugunduzi wowote. Unajua mambo kuhusu tovuti yako mwenyewe ambayo kichunguzi hakijui, na zana inayokataa kupeleka toleo jipya ni zana ambayo watu huiondoa.

Je, ufunguo wangu wa API uko salama?

Ufunguo hausomwi kamwe kutoka kwenye mstari wa amri — ni kutoka tu kwa kidokezo au stdin iliyopitishwa — kwa hiyo hauwezi kuishia katika historia ya ganda lako au katika orodha ya mchakato. Umehifadhiwa kwenye saraka yako ya usanidi ukiwa na hali ya faili 600, na Zinnector® huthibitisha tena ruhusa hizo kila wakati inapoaandika.

Je, ninaweza kuitumia katika CI?

Ndiyo. Weka `ZINNECTOR_TOKEN`, na kila amri inachukua `--json`. Matokeo ya binadamu huenda kwenye stderr na data kwenye stdout, kwa hiyo mabomba yanabaki safi. `zinnector check` hutoka ikiwa si sifuri inapopata kitu, kwa hiyo inafanya kazi kama lango la bomba, na `--strict` pia hushindwa wakati ulinganisho haukuweza kufanywa.

Iweke kisha uendeshe tovuti katika dakika inayofuata

Endesha npm install -g zinnector, au iejaribu mara moja kwa npx zinnector new my-site. Ni bure, ina leseni ya MIT na imejengwa kwenye API ya umma. Tengeneza mfumo wa mradi, uendeshe ndani ya kifaa chako bila Docker, na uukague kabla ya kuuweka mtandaoni.

Soma nyaraka