Zinnector® डेवलपर सीएलआई के साथ शुरुआत करना

Node 24 या उससे नए संस्करण पर निःशुल्क Zinnector CLI इंस्टॉल करें, फिर इसे दो मिनट में काम करते हुए सत्यापित करें: --version, --help, एक साइट स्केफोल्ड करें, बिना Docker के स्थानीय रूप से एक वास्तविक WordPress चलाएं, और इसे अपने ब्राउज़र में खोलें — प्रत्येक चरण पर सफलता कैसी दिखती है, इसके साथ।

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

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

Node 24 या नया। node --version चलाएँ; इसे v24 या उससे अधिक प्रिंट करना चाहिए। वर्तमान LTS को nodejs.org से इंस्टॉल करें — Windows पर winget install OpenJS.NodeJS.LTS, macOS पर brew install node@24।
npm, जो Node के साथ आता है। Zinnector® इसका उपयोग एक बार, WordPress रनटाइम को अपने स्वयं के कैश में डाउनलोड करने के लिए करता है।
git, केवल zinnector push के लिए — डिप्लॉय आपके रिपॉजिटरी से संचालित होते हैं।
Docker, केवल तभी जब आप --runtime docker के साथ इसका अनुरोध करते हैं। डिफ़ॉल्ट रनटाइम को किसी की आवश्यकता नहीं है।

नीचे दी गई किसी भी चीज़ के लिए खाते की आवश्यकता नहीं है। API कुंजी की आवश्यकता केवल तब होती है जब आप किसी होस्टिंग स्लॉट पर पहुँचते हैं, Deploying with 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 और पोर्ट फ़्लैग को सूचीबद्ध करता है। उदाहरणों के साथ पूरी सूची, command reference में है।

चरण 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 — इसे खोलें

ब्राउज़र में http127.0.0.1:9400 पर जाएँ। सफलता: My WordPress Website शीर्षक वाली एक ताज़ा WordPress साइट, आपके द्वारा अनुरोधित PHP संस्करण द्वारा परोसी गई। http://127.0.0.1:9400/wp-admin डैशबोर्ड को पहले से साइन इन किया हुआ खोलता है। wp-content/plugins/ में एक प्लगइन या wp-content/themes/ में एक थीम डालें और यह अगले रीलोड पर वहीं है — रनटाइम उन निर्देशिकाओं को सीधे आपके प्रोजेक्ट से परोसता है।

रोकने के लिए Ctrl-C दबाएँ। zinnector dev --once रनटाइम को बूट करता है, जो वास्तव में चल रहा है उसे प्रिंट करता है (PHP संस्करण, WordPress संस्करण, लोड किए गए एक्सटेंशन) और रुक जाता है — तब उपयोगी जब आप वादे के बजाय प्रमाण चाहते हैं।

आगे कहाँ जाना है

Local development with zinnector dev — दो रनटाइम, PHP और WordPress संस्करण चुनना, और क्या कहाँ से परोसा जाता है।
Deploying with Zinnector® — साइन इन करें, प्रोजेक्ट को किसी स्लॉट से लिंक करें, प्री-फ़्लाइट करें, पुश करें।
The command reference — प्रत्येक कमांड, फ़्लैग और उदाहरण।
Troubleshooting — लोग वास्तव में जिन त्रुटियों का सामना करते हैं, और प्रत्येक के लिए सुधार।

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