डेवलपर CLI, Zinnector® का उपयोग शुरू करना

Zinnector® Zinn Digital® का WordPress डेवलपर्स के लिए एक मुफ़्त, MIT-लाइसेंस प्राप्त कमांड-लाइन टूल है। यह एक साइट का ढांचा तैयार करता है, आपकी अपनी मशीन पर केवल Node इंस्टॉल होने के साथ एक वास्तविक WordPress चलाता है — कोई Docker नहीं, कोई MAMP नहीं, आपके PATH पर कोई PHP नहीं — फिर आपने जो बनाया है उसकी उस होस्टिंग स्लॉट से जांच करता है जहाँ आप डिप्लॉय करने वाले हैं और उसे पुश करता है। यह गाइड आपको लगभग दो मिनट में शून्य से एक चालू साइट तक ले जाती है, और आपको बताती है कि प्रत्येक चरण में सफलता कैसी दिखती है ताकि आपको पता चल सके कि कब कुछ गलत हुआ है।

आपको क्या चाहिए

• Node 24 या नया। node --version चलाएँ; यह v24 या उच्चतर प्रिंट करना चाहिए। nodejs.org से वर्तमान LTS इंस्टॉल करें — Windows पर winget install OpenJS.NodeJS.LTS, macOS पर brew install node@24।
• npm, जो Node के साथ आता है। Zinnector® इसका उपयोग एक बार, WordPress रनटाइम को अपने स्वयं के कैश में डाउनलोड करने के लिए करता है।
• git, केवल zinnector push के लिए — डिप्लॉय आपके रिपॉजिटरी से संचालित होते हैं।
• 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, plugins/, themes/ और एक mu-plugins/ हेल्पर के साथ एक wp-content ट्री, एक .gitignore और एक README — इसके बाद चलाने के लिए अगले कमांड। इसमें कुछ भी प्लेसहोल्डर नहीं है; प्रोजेक्ट वैसे ही बूट होता है जैसा वह है। --template plugin या --template theme एक प्लगइन या ब्लॉक थीम का ढांचा तैयार करते हैं जो बनते ही सक्रिय हो जाते हैं।

चरण 5 — इसे चलाएँ

cd my-site
zinnector dev

पहली बार, Zinnector® WordPress रनटाइम — लगभग 570 MB, क्योंकि इसमें 5.2 से 8.5 तक का प्रत्येक PHP बिल्ड शामिल है — को अपनी स्वयं की कैश डायरेक्टरी में डाउनलोड करने से पहले एक बार पूछता है, कभी भी आपके प्रोजेक्ट में नहीं। Y उत्तर दें, या प्रश्न को छोड़ने के लिए --yes पास करें। Node 26 या नए पर यह केवल रनटाइम के लिए एक Node 24 भी फ़ेच करता है (लगभग 30 MB, nodejs.org के चेकसम के विरुद्ध सत्यापित), क्योंकि रनटाइम के नेटिव मॉड्यूल में केवल Node 24 और 25 के लिए प्रीबिल्ट बाइनरी हैं; आपको कंपाइलर या 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 पर जाएँ। सफलता: आपके द्वारा अनुरोधित PHP संस्करण द्वारा सेव की गई My WordPress Website शीर्षक वाली एक नई WordPress साइट। 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® के साथ डिप्लॉय करना — साइन इन करें, प्रोजेक्ट को स्लॉट से लिंक करें, प्री-फ़्लाइट करें, पुश करें।
• कमांड संदर्भ — प्रत्येक कमांड, फ़्लैग और उदाहरण।
• समस्या निवारण — वे त्रुटियां जिनका लोग वास्तव में सामना करते हैं, और प्रत्येक के लिए समाधान।

वही दस्तावेज़ npm पर और GitHub पर पैकेज के README में है, जहाँ समस्याओं और पुल अनुरोधों का स्वागत है।