Ilé ìmọ̀
Àwọn ìṣòro gbígbéṣẹ́ ti Zinnector®
Àwọn àṣìṣe tí àwọn èèyàn máa ń bá pàdé pẹ̀lu Zinnector CLI àti àtúnṣe fún olúkúlùkù wọn: spawn EINVAL lórí Windows, ìkìlọ̀ EBADENGINE ti npm, node-gyp tí ń béèrè fún Visual Studio lórí Node 26, EPERM nígbà ìfibọ̀, ẹ̀rọ ìṣiṣẹ́ kan tí kò ní bẹ̀rẹ̀, àti ibùdó kan tí ó wà ní lílò.
Àwọn aṣiṣe tí àwọn ènìyàn máa ń bá pàdé pẹ̀lú Zinnector® CLI, ohun tí ọ̀kọ̀ọ̀kan túmọ̀ sí, àti àtúnṣe náà. Ìgbésẹ̀ kọ̀ọ̀kan ń pe ọ̀rọ̀ gangan tí o máa rí, nítorí náà o lè wá ojú ewé yìí ká fún un. Bí ti rẹ kò bá sí níbí, ṣe ìṣiṣẹ́ àṣẹ tíkòṣe náà pẹ̀lú ZINNECTOR_DEBUG=1 kí o sì ṣí ọ̀rọ̀ kan sílẹ̀ ní github.com/Zinn-Digital/zinnector/issues pẹ̀lú àbájáde náà, node --version rẹ àti ẹ̀rọ ìṣiṣẹ́ rẹ.
"spawn EINVAL" lẹ́sẹ̀kẹsẹ̀ lẹ́yìn gbígba ìfiṣ'sílẹ̀ ìṣiṣẹ́ (Windows)
Àṣìṣe kan wà nínú Zinnector® 0.1.0 àti 0.1.1. Lórí Windows, olùfiṣ'sílẹ̀ ìṣiṣẹ́ náà ṣe ìfilọ̀ npm.cmd nípaorúkọ, àti pé Node ti kọ̀ láti mú fáìlì .cmd wá láìsí ẹ̀yà ìṣiṣẹ́ ìbẹ̀rẹ̀ (shell) láti ìgbà àtúnṣe rẹ̀ fún CVE-2024-27980 — nítorí náà ìfiṣ'sílẹ̀ náà jó bẹ́ẹ̀ ni ó parun ní ìṣẹ́jù àbánidọ́gba lẹ́yìn tí o dáhùn Y. Ó ti ni àtúnṣe ní 0.1.2: npm ni a ti ń lo báyìí gẹ́gẹ́ bí node npm-cli.js, èyí tí ó jíjọ lórí gbogbo pẹpẹ tíkò sì nílò ẹ̀yà ìṣiṣẹ́ ìbẹ̀rẹ̀ kankan. Ṣe ìṣiṣẹ́ npm install -g zinnector@latest, lẹ́yìn náà zinnector dev lẹ́ẹ̀kan sí i.
"npm WARN EBADENGINE" nígbà ìfiṣ'sílẹ̀, tàbí "Zinnector® needs Node 24 or newer"
Node rẹ ti pọ̀ jù 24 lọ. npm tẹ ìkìlọ̀ náà jáde nítorí pé àpò náà kéde engines: >=24.18.1; ìfiṣ'sílẹ̀ náà parí síbẹ̀síbẹ̀, ṣùgbọ́n zinnector lẹ́yìn náà kọ̀ láti bẹ̀rẹ̀ (kóòdù ìjáde 78) dípò kí ó kuna ní ibi kan tí ó darúkọ ní ìhà ìsàlẹ̀. Fi LTS lọ́wọ́lọ́wọ́ sori ẹrọ láti nodejs.org — winget install OpenJS.NodeJS.LTS lórí Windows, brew install node@24 lórí macOS — jẹ́rìí sí pé node --version tẹ v24 tàbí gíga jù bẹ́ẹ̀ lọ jáde, kí o sì fi Zinnector® sori ẹrọ lẹ́ẹ̀kan sí i.
"gyp ERR!", "Building from source with node-gyp", tàbí "You need to install Visual Studio"
Ìṣiṣẹ́ WordPress ní ẹ̀yà agbègbè kan tí àwọn àbájáde ìpilẹ̀ṣẹ̀ rẹ̀ tẹ́lẹ̀ wà fún Node 24 àti 25 nìkan. Lórí Node tuntun kan (26 àti lókè, gẹ́gẹ́ bí Oṣù Kẹ̀sán 2026) olùfiṣ'sílẹ̀ rẹ̀ padà sí ṣíṣe àkopọ̀ láti orísun, èyí tí ó parí lórí ẹ̀rọ Windows tí kò ní ohun ìṣọ́ṣọ́ pẹ̀lú ìbéèrè fún Visual Studio. Ó ti ni àtúnṣe ní 0.1.2: Zinnector® wá èyí rí kí o tó ṣe àgbéwọlé ohunkóhun ó sì gba Node 24 wá fún ìṣiṣẹ́ nìkan — ó fẹ́rẹ̀ẹ́ jẹ́ 30 MB, a ti jẹ́rìí rẹ̀ lòdì sí àwọn àmì ayẹwò ti nodejs.org — nítorí náà a kìí ṣe àkopọ̀ ohunkóhun rárá. Bí o bá ṣì ń rí i lẹ́yìn ìgbékalẹ̀, ṣe ìṣiṣẹ́ zinnector dev --reset-runtime kí ìfiṣ'sílẹ̀ tí ó ti parí ní apá kan láti ìṣáájú lè jẹ́ lílù nù ní àkọ́kọ́.
Àwọn ìkìlọ̀ "EPERM" láti ọ̀dọ̀ npm nígbà tí ó ń nu àwọn ohun tíkòlérò nù (Windows)
Ó fẹ́rẹ̀ẹ́ jẹ́ nígbà gbogbo olùṣàyẹ̀wò kòkòrò àìlera tàbí olùtọ́ka àwárí tí ó mú fáìlì kan sílẹ̀ lábẹ́ node_modules ti ìṣiṣẹ́ náà nígbà tí npm ń gbiyanju láti yọ ọ́ kúrò. A tún ₦gbiyanju ìfiṣ'sílẹ̀ náà láti inú àpò mímọ́ kan lórí zinnector dev tó kàn; bí ó bá ń bá a lọ láti ṣẹlẹ̀, zinnector dev --reset-runtime yọ gbogbo àpò ìṣiṣẹ́ kúrò ní àkọ́קọ́ ó sì tún ṣe ìfiṣ'sílẹ̀ lẹ́ẹ̀kan sí i.
"the local playground runtime could not be installed"
Ifiranṣẹ náà ní àwọn ìlà ìkẹhin ti npm tìkararẹ̀ àti àṣẹ gangan tí Zinnector® ṣe ìṣiṣẹ́ rẹ̀, nítorí náà o lè ṣe ìṣiṣẹ́ rẹ̀ fúnra rẹ kí o sì rí àbájáde kíkún náà. Àwọn ìdí tí a mọ̀ sí ni ìṣòro ìsopọ̀ tàbí aṣojú (proxy) — a gba ìṣiṣẹ́ náà wá pẹ̀lú npm tirẹ̀, nítorí náà npm config set proxy … àti àmì ìforúkọsilẹ̀ kan wúlò — tàbí ìfiṣ'sílẹ̀ tí ó ti parí ní apá kan tẹ́lẹ̀, èyí tí --reset-runtime ń nu nù.
"the local playground exited before it was ready", tàbí kò di ẹ̀rọ ti ó ti múra tán rárá
Ṣe ìṣiṣẹ́ zinnector dev --verbose láti rí àbájáde ìṣiṣẹ́ tìkararẹ̀. Ibùdó tí ó ti wà ní lílò jẹ́ ọ̀kan tí a mọ̀: zinnector dev --port 9401, tàbí ṣètò port nínú zinnector.json. Ìṣiṣẹ́ kan tí ó fi sori ẹrọ ṣùgbọ́n tí kò ní bẹ̀rẹ̀: zinnector dev --reset-runtime. Ìbẹ̀rẹ̀ àkọ́kọ́ tún ṣe àgbéwọlé WordPress fúnra rẹ̀, nítorí náà lórí ìsopọ̀ tí ó lọ́ra fún un ní àwọn ìṣẹ́jù díẹ̀; CLI ń dúró di tó ìṣẹ́jù márùן kí ó tó sọ̀ kalẹ̀ nípa àkókò tí ó pé dípò kí ó kó sí ojú ọ̀nà.
"this project is not a git repository" lórí ìtì (push)
A ti ń dari àwọn ìgbékalẹ̀ láti inú àpò (repository) kan, nítorí náà zinnector push nílò èyí tí ó ní ẹ̀yà ìjìnnà (remote) tí pẹpẹ le dé ọ̀dọ̀ rẹ̀. git init && git add -A && git commit -m initial, fi ẹ̀yà ìjìnnà GitHub tàbí GitLab rẹ kún un, lẹ́yìn náà zinnector link láti sọ ọ́ pọ̀ mọ́ ojú opo wẹ́bù náà.
Ojú opo wẹ́bù náà jẹ́ funfun lẹ́yìn ìgbékalẹ̀ kan
Ṣe ìṣiṣẹ́ zinnector check. Ẹ̀ẹ̀mẹ́sàn-án nínú mẹ́wàá ó jẹ́ àlàfo ẹ̀yà PHP — o kọ́ sori PHP tuntun kan ju èyí tí àlàfo náà ń ṣiṣẹ́ lọ — àti pé ìròhin náà sọ èyí ẹ̀yà tí o yẹ kí o yí àlàfo náà sí pẹ̀lú zinnector php <version>, tàbí èyí tí o yẹ kí o ṣe àgbékalẹ̀ lòdì sí pẹ̀lú zinnector dev --php <version>. zinnector logs --error fi ìṣiṣẹ́ ikú tìkararẹ̀ hàn.
Nípa àwọn ohun tó jọ mọ́ ọn
Ṣe o tun di mọ?
Ìtìlẹ́yìn wà lórí gbogbo ètò, a sì ń dáhùn ní èdè rẹ.
Kan si àtìlẹyìn → Gbogbo àpilẹ̀kọ →