قاعدة المعرفة
الأخطاء التي يواجهها الأشخاص فعليًا مع Zinnector® CLI والحل لكل منها: خطأ spawn EINVAL على Windows، وتحذير EBADENGINE الخاص بـ npm، وطلب node-gyp لـ Visual Studio على Node 26، وخطأ EPERM أثناء التثبيت، وبيئة تشغيل لا تقلع، ومنفذ قيد الاستخدام.
الأخطاء التي يواجهها المستخدمون فعلياً مع واجهة سطر أوامر Zinnector®، وما يعنيه كل منها، والحل. يذكر كل إدخال النص الدقيق الذي ستراه، حتى تتمكن من البحث عنه في هذه الصفحة. إذا لم يكن الخطأ الخاص بك موجوداً هنا، فشغّل الأمر المتعثر مع ZINNECTOR_DEBUG=1 وافتح مشكلة (issue) عبر github.com/Zinn-Digital/zinnector/issues متضمنة المخرجات، وإصدار Node الخاص بك عبر node --version، ونظام التشغيل لديك.
خطأ برمجي في Zinnector® 0.1.0 و0.1.1. في نظام Windows، قام برنامج تثبيت بيئة التشغيل بتشغيل npm.cmd بالاسم، وقد رفض Node توليد عملية (spawn) لملف .cmd بدون shell منذ إصلاحه لثغرة CVE-2024-27980 — لذا تعطل التثبيت بعد ثانية واحدة من إجابتك بـ Y. تم الإصلاح في 0.1.2: يتم الآن تشغيل npm كـ node npm-cli.js، وهو الأمر نفسه على كل منصة ولا يحتاج إلى shell. شغّل npm install -g zinnector@latest، ثم zinnector dev مرة أخرى.
إصدار Node لديك أقدم من 24. يطبع npm التحذير لأن الحزمة تعلن عن engines: >=24.18.1؛ يكتمل التثبيت على أي حال، لكن zinnector يرفض بعد ذلك البدء (رمز الخروج 78) بدلاً من الفشل في مرحلة لاحقة وبشكل مربك. ثبّت إصدار الدعم طويل الأمد (LTS) الحالي من nodejs.org — عبر winget install OpenJS.NodeJS.LTS على Windows، أو brew install node@24 على macOS — وتأكد من أن node --version يطبع v24 أو أعلى، ثم ثبّت Zinnector® مرة أخرى.
تحتوي بيئة تشغيل WordPress على وحدة أصلية (native module) لا تتوفر حزمها الثنائية الجاهزة إلا للإصدارين 24 و25 من Node فقط. في إصدارات Node الأحدث (26 وما فوق، اعتباراً من سبتمبر 2026) يلجأ برنامج التثبيت الخاص بها إلى الترجمة والتجميع من الكود المصدري، وهو ما ينتهي على أجهزة Windows العادية بطلب Visual Studio. تم الإصلاح في 0.1.2: يكتشف Zinnector® ذلك قبل تنزيل أي شيء ويجلب إصدار Node 24 لبيئة التشغيل وحدها — حوالي 30 ميغابايت، تم التحقق منها عبر المجموع الاختباري (checksums) من nodejs.org — بحيث لا تتم ترجمة وتجميع أي شيء على الإطلاق. إذا استمر ظهور ذلك بعد الترقية، فشغّل zinnector dev --reset-runtime حتى يتم التخلص أولاً من التثبيت غير المكتمل سابقاً.
في معظم الحالات، يكون السبب هو برنامج مكافحة الفيروسات أو مفهرس البحث الذي يبقي ملفاً مفتوحاً ضمن مجلد node_modules الخاص ببيئة التشغيل أثناء محاولة npm حذفه. تتم إعادة محاولة التثبيت من مجلد نظيف عند تشغيل zinnector dev في المرة التالية؛ إذا استمر حدوث ذلك، فإن zinnector dev --reset-runtime يحذف مجلد بيئة التشغيل بأكمله أولاً ويقوم بالتثبيت مجدداً.
تتضمن الرسالة الأسطر الأخيرة الخاصة بـ npm والأمر الدقيق الذي قام Zinnector® بتشغيله، حتى تتمكن من تشغيله بنفسك ورؤية المخرجات الكاملة. الأسباب المعتادة هي مشكلة في الشبكة أو البروكسي — حيث يتم جلب بيئة التشغيل باستخدام npm الخاص بك، لذا ينطبق npm config set proxy … وخادم المرآة للسجل (registry mirror) — أو تثبيت سابق غير مكتمل، والذي يزيله --reset-runtime.
شغّل zinnector dev --verbose لرؤية المخرجات الخاصة ببيئة التشغيل. المنفذ (port) المستخدم بالفعل هو السبب الشائع: شغّل zinnector dev --port 9401، أو اضبط port في zinnector.json. لبيئة تشغيل تم تثبيتها لكنها لا تقلع: استخدم zinnector dev --reset-runtime. يقوم الإقلاع الأول أيضاً بتنزيل WordPress نفسه، لذا يُرجى الانتظار لبضع دقائق إذا كان الاتصال بطيئاً؛ تنتظر واجهة سطر الأوامر لمدة تصل إلى خمس دقائق قبل الإبلاغ عن مهلة انتهاء الوقت بدلاً من التعليق.
تعتمد عمليات النشر على مستودع برمجي، لذا يتطلب zinnector push وجود مستودع متصل بمستودع بعيد (remote) يمكن للمنصة الوصول إليه. شغّل git init && git add -A && git commit -m initial، ثم أضف المستودع البعيد الخاص بك على GitHub أو GitLab، ثم شغّل zinnector link لربطه بالموقع.
شغّل zinnector check. في تسع حالات من أصل عشر، يكون السبب فارقاً في إصدار PHP — حيث قمت بالبناء على إصدار PHP أحدث مما يعمل به المكان المخصص (slot) — ويوضح التقرير الإصدار الذي يجب تحويل المكان المخصص إليه عبر zinnector php <version>، أو الإصدار الذي يجب التطوير باستخدامه عبر zinnector dev --php <version>. يعرض zinnector logs --error الخطأ الفادح (fatal error) نفسه.
ما كتبناه حول الاستضافة، وتحسين محركات البحث (SEO)، وإدارة المواقع على نطاق واسع.
كيف تؤثر الاستضافة على الفهرسة وقيمة الروابط في عام 2026: الحفاظ على فهرسة الصفحات، وفحص النطاقات القديمة قبل البناء عليها، وبناء الروابط دون ترك أثر لمحركات البحث، ونظرة صادقة حول ما يمكن للبنية التحتية تقديمه لتهيئة محركات البحث (SEO) وما لا يمكنها فعله.
قراءة المنشور ←قائمة تحقق عملية للحصول على WordPress سريع وآمن: التخزين المؤقت على مستوى الخادم، وذاكرة تخزين مؤقت للكائنات لكل موقع، ومجموعة المكونات الإضافية القليلة التي تستحق التشغيل، والحفاظ على حداثة الحزمة البرمجية، وصفحات WooCommerce التي يجب ألا تخزنها مؤقتًا أبدًا.
قراءة المنشور ←ما الذي يميز فعلياً الاستضافة المدارة الجيدة عن خادم رخيص مع لوحة تحكم — عمليات النقل، والنسخ الاحتياطي، والعزل، والتخزين المؤقت الحقيقي، وقابلية التوسع الصادقة — وكيفية الحكم عليها قبل الالتزام.
قراءة المنشور ←الدعم مشمول في كل خطة، ومكتب الدعم مفتوح 24 ساعة في اليوم، ويمكنك مراسلتنا بأي لغة من لغاتنا البالغ عددها 58 لغة — وسنرد عليك بلغتك.
الاتصال بالدعم → جميع المقالات →