وہ خرابیاں جن کا صارفین کو اصل میں Zinnector® CLI کے ساتھ سامنا ہوتا ہے، ہر ایک کا کیا مطلب ہے، اور اس کا حل۔ ہر اندراج میں وہی اصل متن درج ہے جو آپ کو نظر آئے گا، تاکہ آپ اس صفحے پر اسے تلاش کر سکیں۔ اگر آپ کا مسئلہ یہاں موجود نہیں ہے، تو ناکام ہونے والی کمانڈ کو ZINNECTOR_DEBUG=1 کے ساتھ چلائیں اور آؤٹ پٹ، اپنے node --version اور اپنے آپریٹنگ سسٹم کے ساتھ github.com/Zinn-Digital/zinnector/issues پر مسئلہ درج کریں۔
رن ٹائم انسٹال قبول کرنے کے فوراً بعد "spawn EINVAL" (Windows)
Zinnector® 0.1.0 اور 0.1.1 میں ایک نقص۔ Windows پر رن ٹائم انسٹالر نے نام سے npm.cmd چلایا، اور Node نے CVE-2024-27980 کے اپنے حل کے بعد سے شیل کے بغیر کسی .cmd فائل کو چلانے سے انکار کر دیا ہے — چنانچہ آپ کے 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 شروع ہونے سے انکار کر دیتا ہے (exit code 78)۔ nodejs.org سے موجودہ LTS انسٹال کریں — Windows پر winget install OpenJS.NodeJS.LTS، macOS پر brew install node@24 — تصدیق کریں کہ node --version کا نتیجہ v24 یا اس سے زیادہ ہو، اور Zinnector® کو دوبارہ انسٹال کریں۔
"gyp ERR!"، "Building from source with node-gyp"، یا "You need to install Visual Studio"
WordPress رن ٹائم میں ایک نیٹِو ماڈیول ہے جس کی پہلے سے تیار شدہ بائنریز صرف Node 24 اور 25 کے لیے دستیاب ہیں۔ ایک نئے Node (ستمبر 2026 کے مطابق 26 اور اس سے اوپر) پر اس کا انسٹالر سورس سے کمپائل کرنے کی طرف واپس جاتا ہے، جو ایک عام Windows مشین پر Visual Studio کے مطالبے پر ختم ہوتا ہے۔ 0.1.2 میں طے شدہ: Zinnector® کچھ بھی ڈاؤن لوڈ کرنے سے پہلے اس کی نشاندہی کر لیتا ہے اور صرف رن ٹائم کے لیے Node 24 حاصل کرتا ہے — تقریباً 30 MB، جس کی تصدیق nodejs.org کے چیک سم سے کی جاتی ہے — تاکہ کبھی بھی کچھ کمپائل نہ کرنا پڑے۔ اگر اپ گریڈ کرنے کے بعد بھی آپ کو یہ نظر آتا ہے، تو zinnector dev --reset-runtime چلائیں تاکہ پہلے والی ادھوری انسٹالیشن ختم ہو جائے۔
صفائی کرتے وقت npm سے "EPERM" کی وارننگز (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 … اور رجسٹری مرر لاگو ہوتے ہیں — یا پہلے والی ادھوری انسٹالیشن، جسے --reset-runtime صاف کر دیتا ہے۔
"the local playground exited before it was ready"، یا یہ کبھی تیار نہیں ہوتا
رن ٹائم کا اپنا آؤٹ پٹ دیکھنے کے لیے zinnector dev --verbose چلائیں۔ کسی پورٹ کا پہلے سے استعمال میں ہونا ایک عام وجہ ہے: zinnector dev --port 9401 چلائیں، یا zinnector.json میں port سیٹ کریں۔ ایک رن ٹائم جو انسٹال تو ہو گیا لیکن بوٹ نہیں ہو گا: zinnector dev --reset-runtime۔ پہلا بوٹ خود WordPress کو بھی ڈاؤن لوڈ کرتا ہے، اس لیے سست کنکشن پر اسے چند منٹ دیں؛ CLI بغیر کسی نتیجے کے معلق رہنے کے بجائے ٹائم آؤٹ رپورٹ کرنے سے پہلے پانچ منٹ تک انتظار کرتا ہے۔
پش پر "this project is not a git repository"
ڈپلوائے ایک ریپوزٹری سے کیے جاتے ہیں، اس لیے zinnector push کو ایسے ریموٹ والی ریپوزٹری کی ضرورت ہوتی ہے جس تک پلیٹ فارم رسائی حاصل کر سکے۔ 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 اصل مہلک خرابی دکھاتا ہے۔
متعلقہ