البدء باستخدام Zinnector®، واجهة سطر الأوامر للمطورين

Zinnector® هي أداة سطر الأوامر المجانية المرخصة بموجب ترخيص MIT والمرخصة لـ WordPress مطوري Zinn Digital®. تقوم بإنشاء هيكل للموقع، وتشغيل WordPress حقيقي على جهازك الخاص مع عدم تثبيت أي شيء سوى Node — بدون Docker أو MAMP أو PHP على مسار النظام (PATH) — ثم تفحص ما قمت ببنانه مقابل مساحة الاستضافه التي توشك على النشر إليها وتدفع التغييرات. يأخذك هذا الدليل من الصفر إلى موقع قيد التشغيل في غضون دقيقتين تقريبًا، ويخبرك بما يبدو عليه النجاح في كل خطوة حتى تعرف متى حدث خطأ ما.

ما تحتاجه

• Node 24 أو أحدث. قم بتشغيل node --version؛ يجب أن يطبع v24 أو أعلى. قم بتثبيت إصدار الدعم طويل الأمد (LTS) الحالي من nodejs.org — على نظام Windows باستخدام الأمر winget install OpenJS.NodeJS.LTS، وعلى نظام macOS باستخدام الأمر brew install node@24.
• npm، والذي يأتي مع Node. تستخدم Zinnector® أداة npm مرة واحدة لتنزيل وقت تشغيل 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، وشجرة مجلدات wp-content تحتوي على plugins/ و themes/ ومساعد mu-plugins/، وملف .gitignore وملف README — يليها الأوامر التالية المراد تشغيلها. ليس هناك أي عنصر نائب؛ يبدأ المشروع في العمل كما هو. يؤدي استخدام --template plugin أو --template theme إلى إنشاء هيكل ملحق (plugin) أو سمة كتل (block theme) يتم تنشيطهما فور وجودهما.

الخطوة 5 — التشغيل

cd my-site
zinnector dev

في المرة الأولى، تسأل Zinnector® مرة واحدة قبل تنزيل وقت تشغيل WordPress — حوالي 570 ميجابايت، لأنه يحمل كل إصدارات PHP من 5.2 إلى 8.5 — في دليل التخزين المؤقت الخاص بها، وليس في مشروعك أبدًا. أجب بـ Y، أو مرر --yes لتخطي السؤال. على الإصدار Node 26 أو أحدث، يقوم أيضًا جلب إصدار Node 24 لوقت التشغيل وحده (حوالي 30 ميجابايت، تم التحقق منه مقابل المجاميع الاختبارية لموقع nodejs.org)، لأن الوحدة النمطية الأصلية لوقت التشغيل تحتوي على ثنائيات مسبقة البناء لإصدارات Node 24 و 25 فقط؛ لست بحاجة إلى مترجم برمجي (compiler) أو Visual Studio.

النجاح: كتلة تحدد اسم المشروع، وإصدار PHP، وإصدار WordPress، ثم:

✔ running at http://127.0.0.1:9400
  admin: http127.0.0.1:9400/wp-admin  (already signed in)

الخطوة 6 — فتحه

قم بزيارة http://127.0.0.1:9400 في متصفح. النجاح: موقع WordPress جديد يحمل عنوان My WordPress Website، ويتم خدمته بواسطة إصدار PHP الذي طلبته. يفتح الرابط 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® — تسجيل الدخول، ربط المشروع بمساحة استضافة، إجراء فحص ما قبل الإقلاع، الدفع.
• مرجع الأوامر — كل أمر وعلامة ومثال.
• استكشاف الأخطاء وإصلاحها — الأخطاء التي يواجهها المستخدمون بالفعل، وإصلاح كل منها.

توجد نفس وثائق التوثيق في ملف README الخاص بالحزمة على موقع npm وعلى GitHub، حيث نرحب بالمشكلات (issues) وطلبات السحب (pull requests).