Zinnector® ڈویلپر سی ایل آئی کے ساتھ شروعات کرنا

Zinnector® ورڈپریس ڈویلپرز کے لیے Zinn Digital® کا مفت، MIT-لائسنس یافتہ کمانڈ لائن ٹول ہے۔ یہ کسی سائٹ کو سکیفولڈ کرتا ہے، Node کے علاوہ کچھ بھی انسٹال کیے بغیر آپ کی اپنی مشین پر ایک حقیقی ورڈپریس چلاتا ہے — کوئی Docker نہیں، کوئی MAMP نہیں، آپ کے PATH میں کوئی PHP نہیں — پھر آپ نے جو کچھ بنایا ہے اس کا موازنہ اس ہوسٹنگ سلاٹ سے کرتا ہے جہاں آپ ڈیپلائ کرنے والے ہیں اور اسے پش کرتا ہے۔ یہ گائیڈ آپ کو تقریباً دو منٹ میں کسی چیز سے ایک چلتی ہوئی سائٹ تک لے جاتی ہے، اور ہر قدم پر بتاتی ہے کہ کامیابی کیسی دکھائی دیتی ہے تاکہ آپ کو معلوم ہو کہ کب کوئی خرابی پیش آ گئی ہے۔

آپ کو کیا درکار ہے

• Node 24 یا نیا۔ node --version چلائیں؛ اس میں v24 یا اس سے زیادہ پرنٹ ہونا چاہئے۔ nodejs.org سے موجودہ LTS انسٹال کریں — ونڈوز پر winget install OpenJS.NodeJS.LTS، میک او ایس پر brew install node@24۔
• npm، جو Node کے ساتھ آتا ہے۔ Zinnector® اسے ایک بار استعمال کرتا ہے، ورڈپریس رن ٹائم کو اپنی کیشے میں ڈاؤن لوڈ کرنے کے لیے۔
• 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® ورڈپریس رن ٹائم کو ڈاؤن لوڈ کرنے سے پہلے ایک بار پوچھتا ہے — تقریباً 570 MB، کیونکہ یہ 5.2 سے 8.5 تک کا ہر PHP بلڈ لے کر چلتا ہے — اپنی کیش ڈائریکٹری میں، آپ کے پروجیکٹ میں کبھی نہیں۔ Y جواب دیں، یا سوال کو چھوڑنے کے لیے --yes پاس کریں۔ Node 26 یا اس سے جدید تر پر یہ رن ٹائم کے لیے اکیلے Node 24 بھی لاتا ہے (लगभग 30 MB، nodejs.org کے چیک سمز کے خلاف تصدیق شدہ)، کیونکہ رن ٹائم کے نیٹیو ماڈیول میں صرف Node 24 اور 25 کے لیے پہلے سے بنے ہوئے بائنریز ہیں؛ آپ کو کمپائلر یا Visual Studio کی ضرورت نہیں ہے۔

کامیابی: ایک بلاک جو پروجیکٹ، PHP ورژن اور ورڈپریس ورژن کا نام لیتا ہے، پھر:

✔ 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 ملاحظہ کریں۔ کامیابی: My WordPress Website کے عنوان سے ایک تازہ ورڈپریس سائٹ، جس کی خدمت آپ کی طرف سے پوچھے گئے PHP ورژن کے ذریعے کی جاتی ہے۔ http://127.0.0.1:9400/wp-admin ڈیش بورڈ کو پہلے ہی سائن ان کھولتا ہے۔ wp-content/plugins/ میں کوئی پلگ ان یا wp-content/themes/ میں کوئی تھیم ڈراپ کریں اور اگلی بار ری لوڈ کرنے پر یہ وہاں موجود ہوتا ہے — رن ٹائم ان ڈائریکٹریوں کی خدمت براہ راست آپ کے پروجیکٹ سے کرتا ہے۔

روکنے کے لیے Ctrl-C دبائیں۔ zinnector dev --once رن ٹائم کو بوٹ کرتا ہے، جو اصل میں چل رہا ہے اسے پرنٹ کرتا ہے (PHP ورژن، ورڈپریس ورژن، لوڈ کردہ ایکسٹینشنز) اور رک جاتا ہے — اس وقت مفید ہے جب آپ وعدے کے بجائے ثبوت چاہتے ہیں۔

آگے کہاں جائیں

• Local development with zinnector dev — دو رن ٹائمنز، PHP اور ورڈپریس ورژن کا انتخاب، اور کیا کہاں سے پیش کیا جاتا ہے۔
• Deploying with Zinnector® — سائن ان کریں، پروجیکٹ کو کسی سلاٹ سے لنک کریں، پری فلائٹ کریں، پش کریں۔
• The command reference — ہر کمانڈ، فلیگ اور مثال۔
• Troubleshooting — وہ غلطیاں جن کا لوگ حقیقت میں سامنا کرتے ہیں، اور ہر ایک کا حل۔

یہی دستاویزات npm اور GitHub پر پیکیج کے README میں موجود ہیں، جہاں مسائل اور پل ریکوئسٹس کا خیرمقدم کیا جاتا ہے۔