Zinnector®

Kayan aikin CLI na masu haɓakawa don baƙuncin WordPress

Zinnector® yana gina WordPress a cikin na'urarka ba tare da an shigar da komai ba sai Node — babu Docker, babu MAMP — sannan yana duba abin da ka gina idan aka kwatanta da ramin ɗaukar nauyin yanar gizo da kake shirin tura shi kuma yana gaya maka abin da ba zai dace ba, kafin ka tura. Shigar da shi tare da npm install -g zinnector. Kyauta ne, mai lasisin MIT kuma an gina shi akan API ɗin jama'a ɗaya kamar kowane abu a nan.

Editan lissafin lambobi a cikin burawza, tare da bishiyar fayil kusa da buɗaɗɗen fayil da mai nuna alama a ciki.

Umarni biyar, kuma na tsakiyar shi ne ainihin abin

Yawancin CLI na karɓar baƙuncin yanar gizo suna farawa ne a lokacin tura aiki. Zinnector® yana farawa kafin wannan — yana gina rukunin yanar gizon tare da ku, sannan ya duba aikinku idan aka kwatanta da na'urar da kuke shirin aikawa zuwa gare ta. Tazarar dake tsakanin "ya yi aiki a kan kwamfutar tafi-da-gidanka na" da kuma "yana aiki a kan uwar garke" ita ce inda yammaci ke ɓata, kuma wannan tazarar ana iya auna ta.

sabuwar zinnector

Gina tsarin rukunin yanar gizo, manhaja mai ƙarawa (plugin) ko taken tubali (block theme) wanda ke aiki nan take. Babu fayilolin riƙe gurbi, babu TODOs — manhajar tana kunnuwa kuma za a iya zaɓar taken da zarar an ƙirƙire shi.

zinnector dev

Kyakkyawan WordPress na gaske a kan na'urarka cikin daƙiƙa kaɗan, yana aiki da naka plugins da jigogi, ba tare da Docker ba kuma ba tare da PHP a cikin PATH ɗinka ba. Zaɓi kowane PHP daga 5.2 zuwa 8.5 don yin haɓakawa.

binciken zinnector

Duba na kafin tashi. Yana kwatanta abin da kuka gina da ramin da kuke shirin turawa kuma yana ambaton kowane rashin dacewa — da kowane binciken da bai samu damar yi ba — kafin ku tura.

zinnector push

Gudanar da binciken farko, tura aikace-aikacenku (commits), kunna tura bayanan kuma bibiye shi har zuwa kammalawa. Idan ya gaza, bayanan gini (build log) na nesa da umarni ɗaya kacal.

zinnector ai

Tambayi mataimaki daga tashar umarni (terminal), tare da aikin ku da rukunin yanar gizon ku a matsayin mahallin. Yana aiki a kan dandamali ta hanyar asusun ku, don haka babu makullin samfuri da ake adanawa a kan na'urar ku.

Gwada aikinsa a cikin minti biyu, ba a buƙatar asusu

Umarni shida, bi da bi, da kuma yadda nasara take a kowane ɗaya. Komai a nan yana aiki a kan na'urarku kanta; ana buƙatar maɓallin API ne kawai lokacin da kuka isa ramin ɗaukar baƙuncin yanar gizo.

  1. Sanya shi

    Aiwatar da npm install -g zinnector a kan Node 24 ko wanda ya fi sabo. Idan npm ya nuna EBADENGINE, Node ɗinku ya girmi 24 — shigar da LTS na yanzu daga nodejs.org kuma ku sake aiwatar da shigarwar.

  2. Duba fasalin

    zinnector --version yana buga lambar bita kamar 0.1.2. A kan Node da ta tsufa fiye da 24 yana buga saƙon da ke cewa ana buƙatar Node 24 ko sabuwa, sannan ya fita.

  3. Karanta taimako

    zinnector --help yana jera kowane umarni a ƙasa tare da manufar sa a layi ɗaya. Kowane umarni kuma yana karɓar nasa --help.

  4. Tsara tsarin shafi

    zinnector new my-site yana ƙirƙirar aikin da ke tashi nan take — zinnector.json, bishiyar wp-content da README — kuma yana buga dokoki na gaba da za a gudanar.

  5. Gudanar da shi

    cd my-site, sannan zinnector dev. Fara aiki na farko zai tambaya sau ɗaya don sauke WordPress runtime (kimanin 570 MB, an ajiye shi a ma'ajiyar ɓoye ta CLI kanta, ba a cikin aikinku ba). Nasara tana bayyana kamar “running at http://127.0.0.1:9400”.

  6. Bude shi a cikin burawza

    http://127.0.0.1:9400 sabon shafin WordPress ne; /wp-admin yana buɗe allon kula da an riga an shiga. Sanya manhaja ta plugin a cikin wp-content/plugins kuma za ta kasance a wurin a sake lodawa na gaba.

  7. Sannan, tare da gurbin karɓar baƙuncin yanar gizo

    zinnector login, zinnector link, zinnector check, zinnector push — duba abin da kuka gina kafin aiki dangane da ramin, sannan tura shi kuma kalli kammalawarsa.

Binciken farko, daki-daki

Kun gina a kan PHP 8.3. Ramin yana aiki ne da 8.1. Babu abin da zai sanar da ku har sai shafin ya zama fari sarai. Wannan ita ce matsalar da ta sa wannan umarni yake aiki, kuma shi ne abin da mai wannan dandalin ya buƙata kai tsaye da suna. Zinnector® yana karanta muhallan biyu kuma yana sanya su kusa da juna — sannan yana ba ku damar tura aikin ko ta yaya, domin kuna iya samun dalili.

PHP, an ƙididdige cikin gaskiya

Ana nuna babban bambancin nau'i a matsayin mai tsawo saboda yana lalata shafi tabbatacce; ana nuna ƙaramin bambanci a matsayin ƙasa. Sanya wa kowane abu matsayi mai mahimmanci kawai yana koya wa mutane ƙetare gargaɗin ne.

Adadin faifai da fayiloli, daban-daban

Bishiyar WordPress ta ƙunshi dubun-dubatar ƙananan fayiloli, kuma rukunin yanar gizo na iya cinye izinin inode ɗinsa alhali yana ƙasa da iyakar faifan diskinsa. Ana bincika duka biyun bisa ga ainihin abin da ya rage a ramin, ba bisa ga tsarin ba.

"Ba a iya dubawa ba" amsa ce da kanta

Binciken da ba zai iya ganin abin da yake dubawa ba yana bayar da rahoton cewa ba a duba ba, ba cewa ya ci nasara ba. Aiki mara matsala yana bayyana adadin abubuwan da ya kasa tabbatarwa, saboda tabbaci na ƙarya shine wanda babu wanda zai sake dubawa sau biyu.

Yana gargaɗi, ba ya taɓa toshewa

Kowane sakamako ana iya soke shi da --force, kuma taƙaitaccen bayanin ya ce haka. A cikin CI, lambar fita ita ce ƙofar a maimakon haka, don haka bututun aiki zai iya zama mai tsauri yayin da mutum yake ci gaba da sarrafawa.

Muhallan gudanarwa na gida guda biyu, dukkansu na gaske

WordPress Playground shine tsoho: PHP da aka tattara zuwa WebAssembly, yana aiki a cikin Node, saboda haka kwamfutar tafi-da-gidanka da ba a shigar da komai ba sai Node tana tashi daga komai zuwa WordPress mai aiki a kusan lokacin da ake ɗauka don karanta wannan jimlar.

Lokacin da kuke buƙatar PHP na asali — ƙari kamar imagick, ainihin MySQL — bayar da --runtime docker kuma ku sami kwantenonin php-fpm da MariaDB a maimakon haka. Dukansu suna ba da fayiloli iri ɗaya daga aiki iri ɗaya, don haka canzawa tsakanin su yana canza injin ne kawai ba wani abu ba.

Duk wani abu da kuka riga kuka yi a cikin kwamitin sarrafawa

An gina Zinnector® a kan API na jama'a iri daya da allon sarrafawa, don haka duk abin da allon zai iya yi, shi ma zai iya yi — kuma kowane umarni aiki ne da aka rubuta a cikin ƙayyadaddun OpenAPI maimakon ya zama matattarar sirri.

Shafuka da turawa

Jera shafukan yanar gizo, karanta duk abin da dandamali ya sani game da guda ɗaya, sake turawa, da karanta tarihin turawa da bayanan ginawa.

Yankuna, DNS da wasiku

Jera yankunan yanar gizo, karanta kuma canza bayanan DNS tare da nuna bayanan kafin a rubuta su, kuma karanta ayyukan wasiƙarku.

PHP, kason ajiya, ma'ajiyar bayanai da rajistan ayyuka

Sauya nau'ikan PHP, duba yawan amfanin faifai da inode idan aka kwatanta da abin da tsarin ku ya ba ku, sami hanyoyin shiga na amfani sau ɗaya zuwa phpMyAdmin, kuma ku bi diddigin bayanan shiga da na kuskure.

WP-CLI da ayyukan gama-gari

Gudanar da umarnan WP-CLI da aka amince da su a kan shafi, sannan ku share ma'ajiyar cache ko fara binciken ƙwayoyin cuta a kan duk abubuwan da aka zaɓa a kira ɗaya maimakon ɗaya ga kowane shafi.

Kowane umarni, daidai yadda --help ke lissafa shi

Cikakken jerin, layi ɗaya kowanne. Cikakken bayanin — kowane tuta, misali da za a iya aiwatarwa da abin da kowane umarni yake bugawa — an samar da shi daga CLI ɗin kanta kuma yana cikin takardun masu haɓakawa da rumbun ilimi, saboda haka ba zai iya bambanta da kayan aikin da kuka girka ba.

sabon zinnector

Gina tsarin aikin WordPress wanda za ku iya gudanarwa nan take.

zinnector dev

Gudanar da wannan aikin a cikin na'ura — ba a buƙatar Docker ba.

shigar zinnector

Shiga tare da maɓallin API na Zinn Digital®.

fita daga zinnector

Manta da maɓallin API da aka ajiye.

zinnector whoami

Nuna a matsayin wane ne wannan CLI aka tantance.

shafukan zinnector

Jera shafukan da wannan makullin zai iya gani.

Matsayin zinnector

Duk abin da dandamali ya sani game da shafi ɗaya.

raba zinnector

Ba mutum ɗaya damar shiga shafi guda — mai haɓakawa, mai tsara shafi, abokin ciniki — tare da matsayi da dalili.

ma'aikatan zinnector

Duba wanda aka ba wa damar shiga shafi, matsayinsu, da kuma ko sun riga sun karɓa.

cire raba zinnector

Cire damar shiga ta wani mutum, ta hanyar imel ko ID na ba da dama.

gayyatar zinnector

Gayyatar da ke jiran ku, kuma ku karɓi ɗaya.

haɗin zinnector

Kusantar da wannan aiki zuwa wani ramin ɗaukar nauyi (kuma ku haɗa ma'ajiyar sa).

zinnector pull

Ja fayilolin rukunin da ake da su a wani wuri zuwa cikin wannan aikin don gudanar da su a cikin gida, sannan a sake sarrafa su don sake daidaitawa. Yana amfani da hanya mai sauri lokacin da rukunin ya daidaita zuwa nasa ma'ajiyar bayanai, idan ba haka ba yana aiki daga madadin na karshe.

daidaita zinnector

Aiki biyu na aiki tare tsakanin fayilolin raye-raye na rukunin yanar gizo da aka karɓa da ma'ajiyar sa: duba inda yake, kunna shi, ƙaddamar da canje-canjen shafin, ko zaɓi wane ɓangare ne ya yi nasara.

zinnector mcp

Gada zuwa uwar garken MCP ta Zinn Digital® don Claude Desktop da sauran abokan cinikin AI waɗanda ke fara sabar na gida kawai.

kwashe zinnector

Ƙirƙiri aikin gida daga rukunin yanar gizo da aka karɓi baƙuncinsa a mataki ɗaya: kwafe ma'ajiyarsa ko janyo fayilolinsa, rubuta fayil ɗin aikin, kuma ku kasance a shirye don gudanar da zinnector dev.

duba zinnector

Kwatanta wannan aikin da ramin da kuke shirin tura shi zuwa gare shi.

zinnector push

Gudanar da binciken farko, tura canje-canjenku, kuma ku tura aiki.

zinnector deploy

Sake tura abin da dandamalin yake da shi a halin yanzu, ba tare da tura sabo ba.

zinnector yana turawa

Tarihin tura shafin yanar gizo.

zinnector php

Nuna ko canza sigar PHP ta shafi.

Adadin zinnector

Amfani da faifai, fayiloli, da rumbun adana bayanai idan aka kwatanta da abin da tsarin ya ba da dama.

zinnector db

Girmar ma'adanar bayanai, da kuma hanyoyin haɗin amfani sau ɗaya zuwa phpMyAdmin da manajan fayil.

zinnector logs

Bibiyi bayanan shiga da kura-kurai na shafi kai tsaye.

zinnector wp

Aiwatar da ingantaccen umarnin WP-CLI da aka yarda da shi a wani shafi.

ajiyar zinnector

Jera da kuma ɗauki madadin shafin. Ƙananan umarni: list, now.

zinnector domains

Lissafa yankunan da wannan makullin zai iya gani.

zinnector dns

Karanta kuma ka canza bayanan DNS. Ƙananan umarni: list, add, rm.

zinnector mail

Jera ayyukan wasiku.

zinnector bulk

Gudanar da aiki ɗaya a fadin shafuka da yawa (cache_purge, malware_scan, sitemap, block_ip).

zinnector ai

Tambayi mataimakin Zinn Digital®, tare da wannan aikin a matsayin mahallin.

Tambayoyi

Shin ina buƙatar zama abokin cinikin Zinn Digital® don amfani da shi?

A'a. `zinnector new` da `zinnector dev` ba sa buƙatar kowane asusu ko kaɗan — gina tsarin plugin, jigo ko dukan rukunin yanar gizo kuma ku sarrafa shi a cikin na'urarku, kyauta, har abada. Ana buƙatar maɓallin API ne kawai don umarnin da ke magana da sabar ku.

Yana buƙatar Docker?

Ba na asalin runtime ba. WordPress Playground yana haɗa PHP zuwa WebAssembly kuma yana aiki a cikin Node, don haka `zinnector dev` yana kunna ainihin WordPress a cikin daƙiƙa ba tare da an shigar da wani abu ba. Idan kuna buƙatar asalin PHP — don gwada tsawo kamar imagick ko ionCube — `--runtime docker` yana ba ku kwantenonin php-fpm da MariaDB a maimakon haka. Ana tallafawa duka biyun; babu ɗayan da yake na madadin wucin gadi.

Me binciken kafin tashi yake kwatantawa a zahiri?

Irin fasalin PHP na kwamfutarka idan aka kwatanta da na slot, ko slot ɗin ma zai iya canzawa zuwa fasalin da ka gina a kansa, ko PHP na slot ɗin ya wuce lokacin amfaninsa da kuma ko na'urar ta riga ta aiwatar da shi, girman aikinka da adadin fayiloli idan aka kwatanta da sauran sararin faifai da na inode, nau'ikan WordPress a kowane ɓangare, ko slot ya gama shiryawa, da kuma ko an haɗa ma'ajiyar git don tura aiki daga ciki. Duk wani abin da ba a iya dubawa ba ana bayar da rahotonsa a matsayin wanda ba a duba ba maimakon a ɗauka ya yi nasara.

Shin zai iya hana ni turawa?

A'a, kuma hakan da gangan ne. Binciken kafin aiki yana gargaɗi kuma yana ba ku damar wucewa — `--force` yana tura aiki ko da an samu wata matsala. Kun san abubuwa game da rukunin yanar gizonku waɗanda mai dubawa bai sani ba, kuma kayan aikin da ya ƙi turawa kayan aiki ne da mutane ke gogewa.

Shin makullin API na yana da aminci?

Ba a taba karanta makullin daga layin umarni ba — sai dai daga sanarwa ko kuma stdin da aka aika ta bututu — don haka ba zai iya shiga cikin tarihin shell dinku ko cikin jerin ayyuka ba. Ana adana shi a cikin kundin tsarin kanku tare da yanayin fayil 600, kuma Zinnector® yana sake tabbatar da waɗannan izini a duk lokacin da ya rubuta.

Zan iya amfani da shi a cikin CI?

Ee. Saita `ZINNECTOR_TOKEN`, kuma kowane umarni yana karɓar `--json`. Fitowar ɗan adam tana zuwa stderr kuma bayanai suna zuwa stdout, don haka bututu suna kasancewa da tsabta. `zinnector check` yana fita ba tare da sifili ba lokacin da ya sami wani abu, don haka yana aiki a matsayin ƙofar bututun mai (pipeline gate), kuma `--strict` yana kuma faduwa lokacin da ba a iya yin kwatance ba.

Sanya shi kuma ka fara gudanar da shafi a cikin minti na gaba

Ku gudanar da npm install -g zinnector, ko ku gwada shi sau ɗaya tare da npx zinnector new my-site. Kyauta ne, mai lasisin MIT kuma an gina shi a kan API na jama'a. Gina tushen aiki, gudanar da shi a gida ba tare da Docker ba, kuma ku duba shi kafin ku tura shi.

Karanta takardun