የZinnector® መላ ፍለጋ

ሰዎች በ Zinnector® CLI አማካኝነት በትክክል የሚገጥሟቸው ስህተቶች፣ እያንዳንዱ ምን ማለት እንደሆነ እና መፍትሔው። እያንዳንዱ መዝገብ የሚያዩትን ትክክለኛ ጽሑፍ ይጠቅሳል፣ ስለዚህ ይህን ገጽ ለዚያ መፈለግ ይችላሉ። የእርስዎ እዚህ ከሌለ፣ እየተሸነፈ ያለውን ትዕዛዝ በ ZINNECTOR_DEBUG=1 ያሂዱ እና የውጤቱን መረጃ፣ የእርስዎን node --version እና የስርዓተ ክወናዎን በመያዝ በ github.com/Zinn-Digital/zinnector/issues ላይ ችግር ይክፈቱ (open an issue)።

የ runtime ጭነቱን ከተቀበሉ በኋላ ወዲያውኑ የሚመጣ "spawn EINVAL" (Windows)

በ Zinnector® 0.1.0 እና 0.1.1 ላይ ያለ ችግር (bug)። በ Windows ላይ የ runtime ጫኚው npm.cmdን በስም ያሂድ ነበር፣ እና Node ለ CVE-2024-27980 ማስተካከያ ካደረገ ወዲህ ያለ shell የ .cmd ፋይልን ከማንሳት (spawn) ተቆጥቧል — ስለዚህ Y ብለው ከተመለሱ ከአንድ ሰከንድ በኋላ ጭነቱ ተቋርጧል። በ 0.1.2 ላይ ተስተካክሏል: npm አሁን እንደ node npm-cli.js ይሮጣል፣ ይህም በሁሉም ፕላትፎርም ላይ ተመሳሳይ ነው እና ምንም shell አያስፈልገውም። npm install -g zinnector@latest ን ያሂዱ፣ ከዚያ እንደገና zinnector dev ን ያሂዱ።

በጭነት ወቅት የሚመጣ "npm WARN EBADENGINE"፣ ወይም "Zinnector® needs Node 24 or newer"

የእርስዎ Node ከ 24 ያነሰ ነው። ፖኬጁ engines: >=24.18.1 ብሎ ስለሚያውጅ npm ማስጠንቀቂያውን ያትማል፤ ጭነቱ ቢሆንም ይጠናቀቃል፣ ነገር ግን zinnector በኋላ ላይ አደናጋሪ ቦታ ላይ ከመውደቅ ይልቅ መነሳትን ይከለክላል (exit code 78)። የአሁኑን LTS ከ nodejs.org ይጫኑ — በ Windows ላይ winget install OpenJS.NodeJS.LTS፣ በ macOS ላይ brew install node@24 — node --version v24 ወይም ከዚያ በላይ ማተሙን ያረጋግጡ፣ እና Zinnector® ን እንደገና ይጫኑ።

"gyp ERR!"፣ "Building from source with node-gyp"፣ ወይም "You need to install Visual Studio"

የ WordPress runtime ቀድመው የተገነቡ ባይነሪዎቻቸው ለ Node 24 እና 25 ብቻ የሚገኙ ቤተኛ ሞጁል (native module) አለው። በአዲስ Node ላይ (ከሴፕቴምበር 2026 ጀምሮ፣ 26 እና ከዚያ በላይ) ጫኚው ከምንጭ (source) ወደ ማጠናቀር ይወርዳል፣ ይህም በተራ የ Windows ማሽን ላይ Visual Studio የመጠየቅ መጨረሻ ይኖረዋል። በ 0.1.2 ላይ ተስተካክሏል: Zinnector® ማንኛውንም ነገር ከመውረዱ በፊት ይህንን ይለያል እና ለ runtime ብቻ የሚሆን Node 24 ያመጣል — ወደ 30 MB ገደብ፣ ከ nodejs.org ቼክሰሞች ጋር የተረጋገጠ — ስለዚህ ምንም ነገር አይጠናቀረም። ካሻሻሉ በኋላ አሁንም የሚያዩት ከሆነ፣ የቀደመው በግማሽ የተጠናቀቀ ጭነት በመጀመሪያ እንዲጣል zinnector dev --reset-runtime ን ያሂዱ።

npm ሲያጸዳ ከእሱ የሚመጡ "EPERM" ማስጠንቀቂያዎች (Windows)

አንቲቫይረስ ስካነር ወይም የፍለጋ ማውጫ (search indexer) npm ለማስወገድ በሚሞክርበት ጊዜ በ runtime node_modules ስር ፋይል ክፍት አድርጎ ሲይዝ የሚከሰት ነው። ጭነቱ በሚቀጥለው zinnector dev ላይ ከጸዳ ማውጫ እንደገና ይሞከራል፤ መከሰቱ የሚቀጥል ከሆነ፣ zinnector dev --reset-runtime መጀመሪያ ሙሉውን የ runtime ማውጫ ያስወግዳል እና እንደገና ይጫናል።

"the local playground runtime could not be installed"

መልእክቱ የ npm ን የራሱን የመጨረሻ መስመሮች እና Zinnector® ያሄደውን ትክክለኛ ትዕዛዝ ያካትታል፣ ስለዚህ እርስዎ sendiri ያሂዱት እና ሙሉውን ውጤት ማየት ይችላሉ። የተለመዱት ምክንያቶች የኔትወርክ ወይም የ proxy ችግር ናቸው — runtime በራስዎ npm የሚመጣ ነው፣ ስለዚህ npm config set proxy … እና የ registry mirror ተተጋቢ ይሆናሉ — ወይም በግማሽ የተጠናቀቀ የቀደመ ጭነት ነው፣ ይህም በ --reset-runtime ይጸዳል።

"the local playground exited before it was ready"፣ ወይም በፍጹም ዝግጁ አይሆንም

የ runtime ን የራሱን ውጤት ለማየት zinnector dev --verbose ን ያሂዱ። አስቀድሞ በስራ ላይ ያለ port የተለመደው ነው፦ zinnector dev --port 9401፣ ወይም በ zinnector.json ውስጥ port ን ያዘጋጁ። የተጫነ ነገር ግን የማይነሳ runtime፦ zinnector dev --reset-runtime። የመጀመሪያው መነሳት WordPress ራሱን ያወርዳል፣ ስለዚህ በዝግተኛ ግንኙነት ላይ ጥቂት ደቂቃዎችን ይስጡት፤ CLI ከሚንጠለጠል ይልቅ ጊዜ ማለቁን (timeout) ከመግለጹ በፊት እስከ አምስት ደቂቃ ይቆያል።

በ push ጊዜ የሚመጣ "this project is not a git repository"

ትግበራዎች (Deploys) የሚካሄዱት ከ repository ነው፣ ስለዚህ zinnector push ፕላትፎርሙ ሊደርስበት የሚችል remote ያለው repository ያስፈልገዋል። git init && git add -A && git commit -m initial፣ የእርስዎን GitHub ወይም GitLab remote ይጨምሩ፣ ከዚያ ከጣቢያው ጋር ለማገናኘት zinnector link ን ያሂዱ።

ከትግበራ (deploy) በኋላ ጣቢያው ነጭ ነው

zinnector check ን ያሂዱ። ከአስር ዘጠኙ ጊዜ የ PHP ስሪት ክፍተት ነው — ቦታው (slot) ከሚሰራበት ይልቅ በአዲስ PHP ላይ ገንብተዋል — እና ሪፖርቱ ቦታውን በ zinnector php <version> ወደ የትኛው ስሪት መቀየር እንዳለብዎ፣ ወይም በ zinnector dev --php <version> የትኛውን በመጠቀም ማልማት እንዳለብዎ ይናገራል። zinnector logs --error አደገኛውን ስህተት (fatal) እራሱን ያሳያል።

ተዛማጅ

• መጀመር · የሀገር ውስጥ ልማት · መተግበር (Deploying) · የትዕዛዝ ማጣቀሻ