zinnector cusub
Samee qaab-dhismeedka goob, furin (plugin) ama mawduuc baloog ah oo isla markiiba boot-gareynaya. Ma jiraan faylal meel-haye ah, ma jiraan TODOs — furintu way shaqo bilaabaysaa mawduucana waa la dooran karaa isla marka la abuuro.
Zinnector®
Zinnector® waxa uu WordPress gudaha ku dhisaa iyada oo aan waxba la rakibin marka laga reebo Node — ma jiro Docker, ma jiro MAMP — ka dibna waxa uu hubiyaa waxaad dhistay marka loo eego qaybta martigelinta (hosting slot) ee aad ku daabici rabto, waxana uu kuu sheegaa waxa aan iswaafaqi doonin, ka hor inta aadan dirin (push). Ku rakibo npm install -g zinnector. Waa lacag-la'aan, waxay haysataa shatiga MIT waxaana lagu dhisay isla API-ga guud ee wax kasta oo kale oo halkan ku yaal lagu dhisay.
Aaladaha CLI ee martigelinta badankoodu waxay bilaabmaan marka la geynayo (deploy). Zinnector® wuxuu bilaabmaa ka hor intaas — wuxuu goobta kula dhisaa adiga, ka dibna wuxuu hubiyaa shaqadaada marka loo eego mashiinka aad u diri rabto. Farqiga u dhexeeya "laptop-kayga ayuu ku shaqeeyay" iyo "server-ka ayuu ku shaqaynayaa" waa halka ay galbihi ku lumaan, farqigaasna waa mid la qiyaasi karo.
Samee qaab-dhismeedka goob, furin (plugin) ama mawduuc baloog ah oo isla markiiba boot-gareynaya. Ma jiraan faylal meel-haye ah, ma jiraan TODOs — furintu way shaqo bilaabaysaa mawduucana waa la dooran karaa isla marka la abuuro.
WordPress dhab ah oo ku jira mashiinkaaga ilbiriqsiyo gudahood, u adeegaya furayaashaada iyo mawduucyadaada, iyada oo aan lahayn Docker oo aan lahayn PHP ee PATH-kaaga. Dooro PHP kasta laga bilaabo 5.2 ilaa 8.5 si aad wax ugu horumariso.
Hubinta ka hor duulimaadka. Waxay isbarbardhigaysaa waxaad dhistay iyo meesha aad ku daabici rabto waxayna sheegaysaa is-waafaqid la'aan kasta — iyo hubin kasta oo ay samayn weyday — ka hor inta aadan riixin.
Samee hubinta hordhaca ah, gudbi ballamahaaga, billow howlgalinta oo la soco ilaa ay ka dhammaanayso. Haddii ay guuldarraysato, diiwaanka dhismaha waxa uu u jiraa hal amar oo keliya.
Ka weydii kaaliyaha terminal-ka, adigoo mashruucaaga iyo boggaaga u isticmaalaya xaalad ahaan. Waxay ku shaqaysaa madasha iyadoo adeegsanaysa akoonkaaga, markaa wax furaha nooca ah waligood laguma kaydiyo qalabkaaga.
Lix amar, si isku xigta, iyo waxa guushu u egtahay mid kasta. Wax kasta oo halkan ku jira waxay ku shaqeeyaan mashiinkaaga; furaha API waxaa loo baahan yahay oo keliya marka aad gaadho meel martigelinta ah.
Ku socodsii npm install -g zinnector Node 24 ama ka cusub. Haddii npm uu daabaco EBADENGINE, Node-kaagu wuu ka duqsan yahay 24 — ka soo rakib LTS-ka hadda jira nodejs.org oo mar kale socodsii rakibidda.
zinnector --version wuxuu daabacayaa lambarka nooca sida 0.1.2. Node ka weyn 24 wuxuu daabacayaa farriin sheegaysa in loo baahan yahay Node 24 ama ka cusub, wuuna baxayaa.
zinnector --help waxay hoos ku taxaysaa amar kasta oo wata ujeeddo hal sadar ah. Amar kasta wuxuu sidoo kale qaataa --help u gaar ah.
zinnector new my-site waxa uu abuuraa mashruuc isla markiiba kaca — zinnector.json, geedka wp-content iyo README — waxana uu soo daabacaa amarrada xiga ee la socodsiinayo.
cd my-site, ka dibna zinnector dev. Orodka koowaad wuxuu hal mar ku weydiinayaa inaad soo dejiso runtime-ka WordPress (qiyaastii 570 MB, oo lagu hayo khasnada u gaarka ah CLI, marnaba mashruucaaga kuma jirto). Guushu waxay u egtahay “running at http://127.0.0.1:9400”.
http://127.0.0.1:9400 waa bog cusub oo WordPress ah; /wp-admin wuxuu furayaa muraayada koontaroolka adoo horay u soo galay. Geli furin (plugin) gudaha wp-content/plugins waxaana laga heli doonaa dib-u-soo-dejinta xigta.
zinnector login, zinnector link, zinnector check, zinnector push — horay u hubi waxaad ku dhistay booska, ka dibna daadguree oo daawasho u yeelo marka ay dhammaato.
Waxaad ku dhistay PHP 8.3. Boosku wuxuu wadaa 8.1. Waxba kuu sheegi maayaan ilaa goobtu ka caddaato. Taasi waa dhibaatada uu amarkani u jiro, waana waxa uu mulkiilaha madashani magac ahaan u codsaday. Zinnector® wuxuu akhriyaa labada deegaan wuxuuna dhigaa dhinac ilaa dhinac — ka dibna wuxuu kuu oggolaanayaa inaad baroojektiga dirtid si kasta, sababtoo ah waxaa laga yaabaa inaad sabab leedahay.
Farqiga nooca weyn waxaa loo calaamadeeyay mid sarreeya sababtoo ah si lagu kalsoonaan karo ayuu u jebiyaa barta; farqiga yar waxaa loo calaamadeeyay hoose. Qiimaynta wax walba inay muhiim yihiin waxay dadka baraysaa oo keliya inay ka boodaan digniinta.
Geedka WordPress wuxuu ka kooban yahay tobanaan kun oo faylal yaryar ah, waxaana dhici karta in goobtu ay dhammeyso xadka inode-ka iyadoo weli aad uga hooseysa xadka diskiga. Labadaba waxaa lagu hubiyaa waxa dhabta ah ee ku haray booska, ee laguma hubiyo qorshaha.
Hubinta aan arki karin mowduuceeda waxay soo sheegtaa inaan la hubin, waligeedna laguma sheego mid gudubtay. Shaqada si sax ah u dhammaatay waxay sheegaysaa inta waxyaabood ee ay xaqiijin kari weyday, maxaa yeelay qofna laba jeer ma eego xaqiijin been abuur ah oo sheegaysa in wax walba caadi yihiin.
Natiijo kasta waxa lagu baabi'in karaa --force, koobidduna sidaas ayay sheegaysaa. CI gudaheeda koodhka bixitaanka ayaa irrid u ah beddelkeeda, sidaa darteed dhuumuhu waxay noqon karaan kuwo adag iyadoo qofku gacanta ku hayo.
WordPress Playground waa kan caadiga ah: PHP lagu dhex dhisay WebAssembly, oo ka dhex shaqeynaya Node, sidaas darteed laptop aan wax kale ku rakibnayn marka laga reebo Node wuxuu eber kaga gaarayaa WordPress shaqeynaya qiyaastii waqtiga ay qaadanayso akhrinta jumladdan.
Markaad u baahato PHP dabiici ah — kordhin sida imagick ah, MySQL dhab ah — gudbi --runtime docker oo taa beddelkeeda hel weelasha php-fpm iyo MariaDB. Labaduba waxay isla faylasha ka adeegaan isla mashruuca, sidaa darteed u kala beddelashadoodu waxay beddeshaa mootada oo wax kale ma beddesho.
Zinnector® waxa lagu dhisay isla API-ga guud ee dashboard-ka, markaa wax kasta oo dashboard-ku qaban karo, isaguna wuu qaban karaa — amar kastaana waa hawlgal lagu diiwaangeliyay qeexitaanka OpenAPI halkii uu ka ahaan lahaa barta gaarka ah ee dhammaadka.
Liis garee goobaha, akhri wax kasta oo barxaddu ka ogtahay mid ka mid ah, dib u daadguree, oo akhri taariikhda daadgureynta iyo diiwaannada dhisidda.
Liis garee boggaga, akhri oo beddel diiwaannada DNS iyadoo diiwaanka la muujinayo ka hor inta aan la qorin, oo akhri adeegyadaada boostada.
Beddel noocyada PHP, fiiri isticmaalka disk-ga iyo inode-ka marka loo eego waxa uu qorshahaagu oggol yahay, hel xiriiriyeyaal hal mar la isticmaalo oo loogu galo phpMyAdmin, oo si toos ah ula soco diiwaannada gelitaanka iyo khaladaadka.
Ku socodsii amarada WP-CLI ee liiska la oggol yahay ku jira goobta, oo nadiifi kaydadka ku meel gaarka ah ama bilow baaritaannada malware-ka ee dhammaan xulashada hal wicitaan halkii aad midkiiba goob u wici lahayd.
Liiska oo buuxa, midkiiba hal xariiq. Tixraaca oo dhammaystiran — calan kasta, tusaale la fulin karo iyo waxa amar kasta uu daabaco — waxaa laga soo saaray CLI lafteeda waxaanu ku jiraa dukumeentiyada horumariyaha iyo xogta aqoonta, sidaa darteed kama leexan karo qalabka aad rakibtay.
Samee qaab-dhismeedka mashruuc WordPress ah oo aad isla markiiba socodsiin karto.
Mashruucan gudaha ugu wad — Docker looma baahna.
Ku gal furaha API ee Zinn Digital®.
Iilow furaha API ee la kaydiyay.
Muuji cidda CLI-gan ahaan loo xaqiijiyay.
Liis garee goobaha uu furehani arki karo.
Wax kasta oo madalku ka og yahay hal goob.
Sii hal qof fursad uu ku galo hal degel — horumariye, naqshadeeye, macmiil — oo leh door iyo sabab.
Eeg cidda loo oggolaaday gelitaanka goobta, doorkooda, iyo haddii ay weli aqbleen.
Kala noqo gelitaanka qofka, adoo adeegsanaya iimayl ama aqoonsiga bixinta.
Casuumaadaha adiga ku sugaya, oo aqbal mid.
Ku hagaaji mashruucan booska martigelinta (oo ku xir keydkiisa).
Soo jiido faylasha bogga martigelisan ee mashruucan si aad gudaha ugu horumariso, dibna u kici si aad dib ugu wada-waafajiso. Waxa uu adeegsadaa jidka gaaban marka bogguhu ula jaanqaado kaydkiisa u gaarka ah, haddii kale wuxuu ka hawlgalaa nuqulkii ugu dambeeyay ee kaydka ah.
Isku-dhafid laba-dhinac ah oo u dhexeysa faylasha tooska ah ee goobta la martigeliyay iyo keydkeeda: eeg heerka ay marayso, shid, xaqiiji isbeddellada goobta, ama dooro dhinaca guuleysanaya.
Buundo ku socota seerfarka MCP ee Zinn Digital® ee loogu talagalay Claude Desktop iyo macaamiisha kale ee AI ee bilaaba seerfarada maxalliga ah oo keliya.
Ka samee mashruuc maxalli ah goob la martigeliyay hal tallaabo gudaheed: koobiyeey keydkeeda ama soo jiid faylasheeda, qor faylka mashruuca, oo diyaar u noqo inaad maamusho zinnector dev.
Mashruucan barbar dhig meesha aad ku daadgureyn rabto.
Samee hubinta hordhaca ah, gudbi commits-kaaga, oo hawlgeli.
Dib u geey waxa madalku horey u lahayd, adigoon riixin.
Taariikhda daabacaadda goobta.
Muuji ama beddel nooca PHP ee goobta.
Isticmaalka saxanka, faylasha, iyo xog-kaydiyaha marka loo eego waxa uu qorshuhu oggol yahay.
Baaxadda keydka xogta, iyo xiriiriyeyaal hal mar la isticmaalo oo loogu talagalay phpMyAdmin iyo maamulaha faylasha.
Si toos ah ula soco diiwaannada gelitaanka iyo khaladaadka ee goobta.
Ku socodsii amar WP-CLI oo la oggol yahay degel.
Liis garee oo qaad kaydka goobta. Amar-hoosaadyo: list, now.
Liis garee xayndaabyada uu furahani arki karo.
Akhri oo wax ka beddel diiwaannada DNS. Amar-hoosaadyada: list, add, rm.
Liis garee adeegyada boostada.
Ku socodsii hal hawlgal goobo badan (cache_purge, malware_scan, sitemap, block_ip).
Weydii kaaliyaha Zinn Digital®, adoo mashruucan u isticmaalaya xaalad ahaan.
Maya. `zinnector new` iyo `zinnector dev` uma baahna wax akoon ah haba yaraatee — qaabee furin (plugin), mawduuc (theme) ama bog dhan oo ku socodsii gudaha, lacag la'aan, weligaaba. Furaha API waxaa kaliya loo baahan yahay amarrada la xiriira martigelintaada.
Uma aha runtime-ka caadiga ah. WordPress Playground waxa ay PHP u soo ururisaa WebAssembly waxaanay ku dhex shaqaysaa Node, markaa `zinnector dev` waxa uu WordPress dhab ah ku kiciyaa ilbiriqsiyo gudahood iyada oo aan wax kale la rakibin. Haddii aad u baahan tahay PHP asalka ah — si aad u tijaabiso kordhin sida imagick ama ionCube — `--runtime docker` waxa ay beddelkeeda ku siinaysaa weelasha php-fpm iyo MariaDB. Labadaba waa la taageeraa; midna maaha mid ku-meel-gaar ah oo dib loogu noqdo.
Noocaaga maxalliga ah ee PHP marka la barbar dhigo kan booska (slot), haddii boosku xitaa u beddeli karo noocii aad ku dhistay, haddii PHP-ga boosku uu dhaafay dhammaadka nolosha iyo haddii mashiinku dhab ahaan adeegsaday, cabbirka mashruucaaga iyo tirada faylasha marka la barbar dhigo booska bannaan ee disk-ga iyo inode-ka haray, noocyada WordPress ee dhinac kasta, haddii boosku dhammeeyay diyaarinta, iyo haddii kaydka git ku xiran yahay si looga daabaco. Wax kasta oo aan la hubin karin waxaa loo soo sheegaa sidii wax aan la hubin halkii loo qaadan lahaa mid gudbay.
Maya, taasina waa mid ula kas ah. Duulimaadka ka hor waxa uu bixiyaa digniin oo uu kuu ogolaanayaa inaad gudubto — `--force` waxa ay geyneysa marka ay dhaafto natiijo kasta. Waxaad ogtahay waxyaabo ku saabsan goobtaada oo uusan ogayn hubiyahu, qalab diida inuu wax geyyo waa qalab ay dadku ka saaraan kombuyuutarka.
Furaha waligeed lagama akhriyo laynka amarka — waxa kaliya oo laga akhriyaa weydiinta ama stdin la dhuumiyey — sidaas darteed kuma dambayn karto taariikhdaada shell ama liiska habsocodka. Waxaa lagu kaydiyaa tusahaaga qaabeynta iyadoo leh qaabka faylka 600, Zinnector®-na waxay dib u xaqiijisaa oggolaanshahaas mar kasta oo ay wax qorayso.
Haa. Deji `ZINNECTOR_TOKEN`, amar kastaana wuxuu qaadanayaa `--json`. Waxsoosaarka aadanaha wuxuu aadaa stderr xogtana waxay aadaa stdout, markaa dhuumuhu waxay ahaanayaan kuwo nadiif ah. `zinnector check` wuxuu ku baxaa wax aan eber ahayn markuu wax helo, markaa wuxuu u shaqeeyaa sidii albaab dhuun (pipeline gate), `--strict`-na sidoo kale wuu fashilmaa marka la barbar dhigi waayo.
Orodh npm install -g zinnector, ama hal mar ku tijaabi npx zinnector new my-site. Bilaash ah, shatiyeysan MIT oo lagu dhisay API-ga guud. Samee qaabdhismeedka mashruuca, si maxalli ah ugu wad adigoon adeegsan Docker, oo samee hubin horudhac ah ka hor inta aadan daabicin.
Akhri dukumentiyada