מאגר ידע
פתרון בעיות ב-Zinnector®
השגיאות שאנשים נתקלים בהן בפועל ב-Zinnector CLI והפתרון לכל אחת מהן: spawn EINVAL ב-Windows, אזהרת EBADENGINE של npm, בקשה מצד node-gyp ל-Visual Studio ב-Node 26, EPERM במהלך ההתקנה, סביבת ריצה שלא עולה, ופורט בשימוש.
השגיאות שאנשים נתקלים בהן בפועל עם ה-CLI של Zinnector®, מה שכל אחת מהן אומרת, והתיקון. כל ערך מציין בדיוק את הטקסט שתראו, כך שתוכלו לחפש אותו בעמוד זה. אם שלכם אינו כאן, הפעילו את הפקודה הנכשלה עם ZINNECTOR_DEBUG=1 ופתחו בעיה ב- github.com/Zinn-Digital/zinnector/issues יחד עם הפלט, ה-node --version שלכם ומערכת ההפעלה שלכם.
"spawn EINVAL" ממש לאחר אישור התקנת סביבת הריץ (Windows)
באג ב-Zinnector® גרסאות 0.1.0 ו-0.1.1. ב-Windows מתקין סביבת הריץ הפעיל את npm.cmd לפי שם, ו-Node מסרבת להפעיל קובץ .cmd ללא מעטפת (shell) מאז התיקון שלה ל-CVE-2024-27980 — כך שההתקנה קרסה שנייה אחת לאחר שעניתם Y. תוקן בגרסה 0.1.2: npm מופעל כעת כ-node npm-cli.js, שהוא זהה בכל פלטפורמה ואינו דורש מעטפת. הפעילו npm install -g zinnector@latest, ולאחר מכן שוב zinnector dev.
"npm WARN EBADENGINE" במהלך ההתקנה, או "Zinnector® needs Node 24 or newer"
גרסת ה-Node שלכם ישנה מ-24. npm מדפיסה את האזהרה מכיוון שהחבילה מצהירה על engines: >=24.18.1; ההתקנה הושלמת בכל מקרה, אך zinnector מסרב לאחר מכן להפעיל (קוד יציאה 78) במקום להיכשל במקום מבלבל בהמשך. התקינו את גרסת ה-LTS הנוכחית מתוך nodejs.org — winget install OpenJS.NodeJS.LTS ב-Windows, brew install node@24 ב-macOS — ודאו ש-node --version מדפיס v24 או גבוה יותר, והתקינו את Zinnector® מחדש.
"gyp ERR!", "Building from source with node-gyp", או "You need to install Visual Studio"
סביבת הריץ של WordPress כוללת מודול ניטיב (native) שקובצי הבינארי המוכנים מראש שלו קיימים עבור Node 24 ו-25 בלבד. בגרסת Node חדשה יותר (26 ומעלה, נכון לספטמבר 2026) המתקין שלה חוזר לקומפילציה ממקור (source), מה שבמחשב Windows רגיל מסתיים בבקשה להתקנת Visual Studio. תוקן בגרסה 0.1.2: Zinnector® מזהה זאת לפני הורדת דבר מה ומביא סביבת Node 24 עבור סביבת הריץ לבד — כ-30 מגה-בייט, מאומת מול בדיקות הסיכום (checksums) של nodejs.org — כך ששום דבר אינו מקומפל לעולם. אם אתם עדיין רואים זאת לאחר השדרוג, הפעילו zinnector dev --reset-runtime כך שההתקנה החצי-גמור מקודם תיזרק לפח קודם לכן.
אזהרות "EPERM" מ-npm בזמן ניקוי (Windows)
כמעט תמיד מדובר בסורק אנטי-ווירוס או באינדקס חיפוש שתופסים קובץ פתוח תחת node_modules של סביבת הריץ בזמן ש-npm מנסה להסירו. ההתקנה מנוסה מחדש מתיקייה נקייה ב-zinnector dev הבא; אם הדבר ממשיך לקרות, zinnector dev --reset-runtime מסיר תחילה את כל תיקיית סביבת הריץ ומתקין שוב.
"the local playground runtime could not be installed"
ההודעה כוללת את השורות האחרונות של npm עצמו ואת הפקודה המדויקת ש-Zinnector® הריץ, כך תוכלו להריץ אותה בעצמכם ולראות את הפלט המלא. הגורמים הרגילים הם בעיית רשת או פרוקסי — סביבת הריץ מובאת באמצעות ה-npm שלכם, כך ש-npm config set proxy … ומראה (mirror) של הרישום חלים — או התקנה קודמת חצי-גמורה, שאותה --reset-runtime מנקה.
"the local playground exited before it was ready", או שהיא לעולם אינה מוכנה
הפעילו zinnector dev --verbose כדי לראות את הפלט של סביבת הריץ עצמה. פורט שכבר נמצא בשימוש הוא מקרה נפוץ: zinnector dev --port 9401, או הגדירו port בתוך zinnector.json. סביבת ריץ שהותקנה אך תסרב לעלות: zinnector dev --reset-runtime. ההפעלה הראשונה מורידה גם את WordPress עצמו, לכן בחיבור איטי תנו לזה מספר דקות; ה-CLI ממתין עד חמש דקות לפני שהוא מדווח על פגי תוקף (timeout) במקום להיתקע.
"this project is not a git repository" בעת דחיפה (push)
פריסות מנוהלות מתוך מאגר (repository), ולכן zinnector push דורש מאגר עם כתובת רחוקה (remote) שהפלטפורמה יכולה להגיע אליה. git init && git add -A && git commit -m initial, הוסיפו את הכתובת הרחוקה של GitHub או GitLab שלכם, ולאחר מכן zinnector link כדי לחבר אותו לאתר.
האתר לבן לאחר פריסה
הפעילו zinnector check. תשע פעמים מתוך עשר מדובר בפערי גרסת PHP — בניתם על PHP חדש יותר מזה שהסלוט פועל עליו — והדוח מציין באיזו גרסה יש להחליף את הסלוט באמצעות zinnector php <version>, או מול איזו גרסה יש לפתח באמצעות zinnector dev --php <version>. zinnector logs --error מציג את השגיאה הקריטית עצמה.