Àwọn àṣìṣe tí àwọn ènìyàn ń bá pàdé gidi pẹ̀lú Zinnector® CLI, ohun tí ọ̀kọ̀ọ̀kan túmọ̀ sí, àti ojútùú rẹ̀. Àkọsílẹ̀ kọ̀ọ̀kan ń sọ ọ̀rọ̀ gangan tí ẹ óò rí, kí ẹ lè wá a lórí ojú-ewé yìí. Bí tiyín kò bá sí níhìn-ín, ẹ lo àṣẹ tí ń kùnà náà pẹ̀lú ZINNECTOR_DEBUG=1 kí ẹ sì ṣí àkọsílẹ̀ ìṣòro ní github.com/Zinn-Digital/zinnector/issues pẹ̀lú àbájáde rẹ̀, node --version yín àti ètò ìṣiṣẹ́ kọ̀m̀pútà yín.
"spawn EINVAL" lẹ́sẹ̀kẹsẹ̀ lẹ́yìn gbígba ìfìsípò runtime (Windows)
Àbùkù kan nínú Zinnector® 0.1.0 àti 0.1.1. Lórí Windows olùfìsípò runtime lo npm.cmd nípa orúkọ, Node sì ti kọ̀ láti dá fáìlì .cmd sílẹ̀ láìsí shell láti ìgbà àtúnṣe rẹ̀ fún CVE-2024-27980 — nítorí náà ìfìsípò náà jákù ní ìṣẹ́jú-àáyá kan lẹ́yìn tí ẹ dáhùn Y. A tún un ṣe ní 0.1.2: A ń lo npm báyìí gẹ́gẹ́ bí node npm-cli.js, èyí tí ó jẹ́ bákan náà lórí gbogbo pẹpẹ tí kò sì nílò shell. Ẹ lo npm install -g zinnector@latest, lẹ́yìn náà zinnector dev lẹ́ẹ̀kan sí i.
"npm WARN EBADENGINE" lásìkò ìfìsípò, tàbí "Zinnector® needs Node 24 or newer"
Node yín ti pé ju 24 lọ. npm tẹ ìkìlọ̀ náà jáde nítorí pé àkójọ náà kéde engines: >=24.18.1; ìfìsípò náà parí bí ó ti wù kí ó rí, ṣùgbọ́n zinnector yóò kọ̀ láti bẹ̀rẹ̀ (exit code 78) dípò kí ó kùnà lọ́nà tí ó rúni lójú nígbà tí ó yá. Ẹ fi LTS lọ́wọ́lọ́wọ́ sípò láti nodejs.org — winget install OpenJS.NodeJS.LTS lórí Windows, brew install node@24 lórí macOS — ẹ rí i dájú pé node --version tẹ v24 tàbí èyí tí ó ga jù bẹ́ẹ̀ jáde, kí ẹ sì tún Zinnector® fi sípò lẹ́ẹ̀kan sí i.
"gyp ERR!", "Building from source with node-gyp", tàbí "You need to install Visual Studio"
Runtime ti WordPress ní native module kan tí àwọn prebuilt binary rẹ̀ wà fún Node 24 àti 25 nìkan. Lórí Node tí ó ṣẹ̀ṣẹ̀ dé (26 àti jù bẹ́ẹ̀ lọ, ní ti Oṣù Kẹsàn-án 2026) olùfìsípò rẹ̀ ń padà sẹ́yìn láti se àkójọpọ̀ láti orísun wá, èyí tí ó máa ń yọrí sí ìbéèrè fún Visual Studio lórí kọ̀m̀pútà Windows lásán. A tún un ṣe ní 0.1.2: Zinnector® ń ṣàwárí èyí kí ó tó gba ohunkóhun wọlé ó sì ń mú Node 24 wá fún runtime náà nìkan — nǹkan bí 30 MB, tí a fìdí rẹ̀ múlẹ̀ lòdì sí àwọn checksum ti nodejs.org — nítorí náà a kò ní se àkójọpọ̀ ohunkóhun láé. Bí ẹ bá ṣì ń rí i lẹ́yìn ìgbéga, ẹ lo zinnector dev --reset-runtime kí a lè kọ́kọ́ sọ ìfìsípò àbọ̀ ti tẹ́lẹ̀ nù.
Àwọn ìkìlọ̀ "EPERM" láti ọ̀dọ̀ npm nígbà tí ó ń gbálẹ̀ (Windows)
Ó fẹ́rẹ̀ẹ́ jẹ́ pé nígbà gbogbo ni scanner antivirus tàbí atọ́ka ìṣàwárí ń di fáìlì kan mú ní ṣíṣí lábẹ́ node_modules ti runtime nígbà tí npm ń gbìyànjú láti yọ ọ́ kúrò. A máa ń tún ìfìsípò náà gbìyànjú láti inú àpò-fáìlì tí ó mọ́ lórí zinnector dev tó kàn; bí ó bá ń tẹ̀síwájú, zinnector dev --reset-runtime yóò kọ́kọ́ yọ gbogbo àpò-fáìlì runtime kúrò kí ó sì tún un fi sípò lẹ́ẹ̀kan sí i.
"the local playground runtime could not be installed"
Iṣẹ́ náà ní àwọn ìlà ìkẹyìn ti npm fúnra rẹ̀ nínú àti àṣẹ gangan tí Zinnector® lò, kí ẹ lè lo fúnra yín kí ẹ sì rí gbogbo àbájáde rẹ̀. Àwọn ohun tí ó sábà ń fà á ni ìṣòro nẹ́tíwọ́ọ̀kì tàbí proxy — a ń gba runtime náà wọlé pẹ̀lú npm tiyín fúnra yín, nítorí náà npm config set proxy … àti registry mirror wúlò — tàbí ìfìsípò àbọ̀ ti tẹ́lẹ̀, èyí tí --reset-runtime máa ń pa rẹ́.
"the local playground exited before it was ready", tàbí kò tíì tán láé
Ẹ lo zinnector dev --verbose láti rí àbájáde ti runtime fúnra rẹ̀. Èyí tí ó wọ́pọ̀ ni ibùdó (port) tí a ti ń lò tẹ́lẹ̀: zinnector dev --port 9401, tàbí kí ẹ ṣètò port nínú zinnector.json. Runtime tí a ti fi sípò ṣùgbọ́n tí kò ní bẹ̀rẹ̀: zinnector dev --reset-runtime. Ìbẹ̀rẹ̀ àkọ́kọ́ tún ń gba WordPress fúnra rẹ̀ wọlé, nítorí náà lórí ìsopọ̀ tí ó lọ́ra ẹ fún un ní ìṣẹ́jú díẹ̀; CLI ń dúró títí dé ìṣẹ́jú márùn-ún kí ó tó ròyìn pé àkókò kọjá dípò kí ó kọ̀ láti ṣiṣẹ́.
"this project is not a git repository" lórí push
Àwọn ìfilọ́lẹ̀ máa ń wáyé láti inú ibi-ipamọ́ (repository), nítorí náà zinnector push nílò ọ̀kan pẹ̀lú remote tí pẹpẹ náà lè dé ibẹ̀. git init && git add -A && git commit -m initial, ẹ fi GitHub tàbí GitLab remote yín kún un, lẹ́yìn náà zinnector link láti so ó mọ́ ojú-ewé náà.
Ojú-ewé náà funfun lẹ́yìn ìfilọ́lẹ̀
Ẹ lo zinnector check. Ní ẹ̀ẹ́meje nínú ẹ̀wá ó máa ń jẹ́ àlàfo àtẹ̀jáde PHP — ẹ kọ́ ọ lórí PHP tí ó ṣẹ̀ṣẹ̀ dé ju èyí tí àyè náà ń lò lọ — ìròyìn náà sì ń sọ àtẹ̀jáde tí ẹ lè yí àyè náà sí pẹ̀lú zinnector php <version>, tàbí èyí tí ẹ lè ṣe ìdàgbàsókè sí pẹ̀lú zinnector dev --php <version>. zinnector logs --error ń fi àṣìṣe apanirun fúnra rẹ̀ hàn.
Àwọn tí ó tan mọ́ ọn