תחילת העבודה עם Zinnector®, ממשק שורת הפקודה למפתחים

Zinnector® הוא כלי שורת פקודה חינמי ברישיון MIT מבית Zinn Digital® עבור מפתחי WordPress. הוא יוצר את שלד האתר (scaffold), מריץ WordPress אמיתי במחשב שלכם ללא צורך בהתקנת דבר מלבד Node — ללא Docker, ללא MAMP, וללא PHP ב-PATH שלכם — לאחר מכן בודק את מה שבניתם מול מרווח האחסון (hosting slot) שאליו אתם עומדים לפרוס, ומבצע את הפריסה. מדריך זה יוביל אתכם מכלום לאתר פעיל בתוך כשתי דקות, ויסביר לכם כיצד נראית הצלחה בכל שלב כדי שתדעו מתי משהו השתבש.

מה שדרוש לכם

• Node 24 או גרסה חדשה יותר. הריצו node --version; חייבת להופיע התוצאה v24 או גרסה גבוהה יותר. התקינו את גרסת ה-LTS הנוכחית מ-nodejs.org — ב-Windows באמצעות winget install OpenJS.NodeJS.LTS, ב-macOS באמצעות brew install node@24.
• npm, המגיע יחד עם Node. Zinnector® משתמש בו פעם אחת, כדי להוריד את סביבת ההרצה של WordPress אל הזיכרון המטמון (cache) שלו.
• git, רק עבור zinnector push — הפריסות מופעלות מתוך המאגר (repository) שלכם.
• Docker, רק אם תבקשו זאת מפורשות באמצעות --runtime docker. סביבת ההרצה של ברירת המחדל אינה דורשת זאת.

אף שלב בהמשך אינו דורש חשבון. מפתח API נדרש רק כאשר מגיעים לשלב החיבור למרווח האחסון, ב-פריסה באמצעות Zinnector®.

שלב 1 — התקנה

npm install -g zinnector

אם npm מציג את ההודעה npm WARN EBADENGINE, גרסת ה-Node שלכם ישנה יותר מ->=24.18.1 שמוגדרת בחבילה. ההתקנה תסתיים בכל זאת, אך ממשק שורת הפקודה (CLI) יסרב לפעול. שדרגו את Node תחילה, ואז התקינו שוב.

שלב 2 — בדיקת הגרסה

zinnector --version

הצלחה: מספר גרסה, למשל 0.1.2. אם מוצגת ההודעה "Zinnector® needs Node 24 or newer — this is Node 20.x", הקובץ הבינארי מותקן אך גרסת ה-Node שלכם ישנה מדי; הפקודה תסתיים עם קוד יציאה 78 מבלי לבצע דבר.

שלב 3 — קריאת העזרה

zinnector --help

הצלחה: באנר המפרט את חמש הפקודות של תהליך העבודה (new, dev, link, check, push) ולאחריו כל פקודה בצרוף תיאור תכליתה בשורה אחת. כל פקודה מקבלת גם דגל --help משלה — הפקודה zinnector dev --help מציגה את דגלי סביבת ההרצה, ה-PHP והפורט. הרשימה המלאה, כולל דוגמאות, נמצאת ב-מילון הפקודות.

שלב 4 — יצירת שלד האתר

zinnector new my-site

הצלחה: כותרת Created my-site ורשימת הקבצים שנכתבו — zinnector.json, עץ wp-content המכיל plugins/, themes/ ומסייע mu-plugins/, קובץ .gitignore ו-README — ולאחריהם הפקודות הבאות שיש להריץ. שום דבר אינו מחזיק מקום בלבד (placeholder); הפרויקט עולה כפי שהוא. השימוש ב---template plugin או --template theme יוצר שלד עבור תוסף או תבנית בלוקים המופעלים ברגע יצירתם.

שלב 5 — הרצה

cd my-site
zinnector dev

בפעם הראשונה, Zinnector® מבקש אישור פעם אחת לפני הורדת סביבת ההרצה של WordPress — כ-570 MB, מכיוון שהיא מכילה את כל גרסאות ה-PHP מ-5.2 עד 8.5 — אל ספריית הזיכרון המטמון שלו, ולעולם לא לתוך הפרויקט שלכם. השיבו Y, או העבירו את הדגל --yes כדי לדלג על השאלה. ב-Node 26 או גרסה חדשה יותר, הוא מוריד בנוסף גרסת Node 24 עבור סביבת ההרצה בלבד (כ-30 MB, מאומת מול סכומי הביקורת של nodejs.org), מכיוון שלמודול טבעי (native module) של סביבת ההרצה יש קבצים בינאריים מוכנים מראש רק עבור Node 24 ו-25; אין לכם צורך במהדר (compiler) או ב-Visual Studio.

הצלחה: בלוק המציג את שם הפרויקט, גרסת ה-PHP וגרסת ה-WordPress, ולאחריו:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

שלב 6 — פתיחת האתר

היכנסו לכתובת http://127.0.0.1:9400 בדפדפן. הצלחה: אתר WordPress חדש בשם My WordPress Website, המוגש באמצעות גרסת ה-PHP שביקשתם. הכתובת http://127.0.0.1:9400/wp-admin פותחת את לוח הבקרה כשאתם כבר מחוברים. הניחו תוסף בתוך wp-content/plugins/ או תבנית בתוך wp-content/themes/ והם יופיעו בריענון הבא — סביבת ההרצה מגישה ספריות אלו ישירות מהפרויקט שלכם.

לחצו על Ctrl-C כדי לעצור. הפקודה zinnector dev --once מעלה את סביבת ההרצה, מדפיסה את מה שרץ בפועל (גרסת PHP, גרסת WordPress, הרחבות שטעונות) ועוצרת — שימושי כאשר אתם זקוקים להוכחה ולא רק להבטחה.

לאן ממשיכים מכאן

• פיתוח מקומי באמצעות zinnector dev — שתי סביבות ההרצה, בחירת גרסאות PHP ו-WordPress, ומה מוגש ומאיפה.
• פריסה באמצעות Zinnector® — התחברות, קישור הפרויקט למרווח אחסון, בדיקת טרום-טיסה (pre-flight), וביצוע הפריסה.
• מילון הפקודות — כל פקודה, דגל ודוגמה.
• פתרון תקלות — השגיאות שמשתמשים נתקלים בהן בפועל, והפתרון לכל אחת.

אותו תיעוד זמין בקובץ ה-README של החבילה ב-npm וב-GitHub, שם נשמח לקבל דיווחי שגיאות (issues) ובקשות שילוב קוד (pull requests).