أوامر ماجنتو 2 CLI: دليل شامل للمطورين

تمثّل واجهة سطر أوامر ماجنتو 2 (Magento 2 CLI) الأداة المركزية لإدارة المنصة بكفاءة وسرعة، حيث تتيح تنفيذ عدد كبير من المهام التقنية بدءاً من تثبيت ماجنتو وترقية الإصدارات وحتى التهيئة والنشر.

في هذا المقال، نستعرض أهم أوامر Magento 2 CLI، تصنيفاتها، وكيفية استخدامها بفاعلية في البيئات الإنتاجية والتطويرية Production and Development Env.

الوصول إلى CLI لتشغيل أوامر ماجنتو 2

لتشغيل الأوامر -Commadns-، انتقل إلى مسار المشروع حيث توجد الأداة التنفيذية لـ CLI Magento:

cd <magento_root>

لإستعراض كافة الأوامر المُتاحة في ماجنتو CLI قم بتشغيل الأمر التالي:

php bin/magento list

أوامر إدارة الكاش في ماجنتو 2

هذه هي الأوامر التي تحتاجها لإدارة ذاكرة التخزين المؤقت -Cache- في ماجنتو، مع الأمر المختصر.

• cache:status (c:s) لعرض حالة الكاش
• cache:clean (c:c) لتنظيف الكاش المرتبط بماجنتو
• cache:flush (c:f) لإزالة الكاش المخزن بالكامل
• cache:enable (c:e) و cache:disable (c:d) لتشغيل أو إيقاف نوع محدد من الكاش.

إليك مثال على كيفية تنظيف الكاش المرتبط بماجنتو.

php bin/magento cache:clean

أو

php bin/magento c:c

إدارة الفهارس (Indexers)

لعرض قائمة الفهارس:

bin/magento indexer:info

لعرض حالة الفهارس:

bin/magento indexer:status

لتحديد وضع تحديث الفهارس:

bin/magento indexer:set-mode {schedule|realtime}

لإعادة فهرسة المحتوى:

bin/magento indexer:reindex

لإعادة تعيين حالة الفهرسة:

bin/magento indexer:reset

إعدادات النظام (Setup)

لتثبيت ماجنتو لأول مرة:

bin/magento setup:install

لترقية قاعدة البيانات وتطبيق التغييرات:

bin/magento setup:upgrade

لتجميع الفئات وإنشاء ملفات الـ DI:

bin/magento setup:di:compile

لنشر ملفات الستايل والثوابت مثل ملفات الjs وhtml، تأكد من إضافة اللغات المفعلة لديك عند تنفيذ هذا الأمر.

bin/magento setup:static-content:deploy

bin/magento setup:static-content:deploy ar_SA en_US

للعودة إلى إصدار سابق:

bin/magento setup:rollback

لإلغاء تثبيت ماجنتو:

bin/magento setup:uninstall

وضع المنصة (Deploy Mode)

• deploy:mode:show لعرض الوضع الحالي (developer, production أو default)
• deploy:mode:set <mode> لتبديل الوضع حسب الحاجة بين الوضع الإفتراضي، التطوير، الإنتاج.

لعرض الوضع الحالي:

bin/magento deploy:mode:show

لتعيين الوضع إلى “وضع التطوير”:

bin/magento deploy:mode:set developer

لتعيين الوضع إلى “وضع الإنتاج” Production:

bin/magento deploy:mode:set production

للتحكم بأوضاع الصيانة والتطوير

لتفعيل وضع الصيانة:

bin/magento maintenance:enable

لإيقاف وضع الصيانة:

bin/magento maintenance:disable

للسماح بعنوان IP محدد بالوصول للماجنتو أثناء الصيانة:

bin/magento maintenance:allow-ips <ip_address>

إدارة الإضافات (Modules)، المتاجر (Stores) والإعدادات

• أوامر module:enable/disable/status لإدارة الإضافات
• store:list و store:website:list لعرض المتاجر والمواقع الموجودة ضمن ماجنتو
• تعيين إعدادات النظام عبر config:set, sensitive:set.

لعرض حالة الإضافات Modules:

bin/magento module:status

لتفعيل إضافة:

bin/magento module:enable <Module_Name>

لتعطيل إضافة:

bin/magento module:disable <Module_Name>

لعرض المتاجر:

bin/magento store:list

لعرض المواقع (Websites):

bin/magento store:website:list

لتعيين إعدادات مخصصة:

bin/magento config:set <path> <value>

لعرض الإعدادات:

bin/magento config:show

لتعيين إعدادات حساسة:

bin/magento config:sensitive:set <path> <value>

معلومات النظام (Info)

تشمل: info:adminuri, currency:list, dependencies:show‑modules, وغيرها من الأوامر التي تعطي لمحة عن التكوين والمحتوى.

لعرض رابط دخول لوحة التحكم:

bin/magento info:adminuri

لعرض العملات المدعومة:

bin/magento info:currency:list

لعرض المناطق الزمنية المتاحة:

bin/magento info:timezone:list

تشغيل المهام المجدولة (Cron) والقوائم (Queue)

• cron:run لتشغيل المهام المجدولة يدويًا٫
• أوامر قائمة: queue:consumers:list, restart, start لإدارة queues.

لتنفيذ المهام المجدولة يدويًا:

bin/magento cron:run

لعرض قائمة المستهلكين:

bin/magento queue:consumers:list

لتشغيل مستهلك معين:

bin/magento queue:consumers:start <consumer_name>

لإعادة تشغيل مستهلك معين:

bin/magento queue:consumers:restart <consumer_name>

أوامر التطوير والإختبار DEV

• أوامر مفيدة مثل dev:tests:run, dev:xml:convert, dev:source-theme:deploy تساعد المطور في بيئة العمل.

لتشغيل الاختبارات:

bin/magento dev:tests:run

لتحويل ملفات XML:

bin/magento dev:xml:convert

لنشر ملفات الثيم:

bin/magento dev:source-theme:deploy

أوامر: Varnish، الوسائط، الترجمات والبيانات التجريبية

• لإعداد Varnish: varnish:vcl:generate.
• لمزامنة الوسائط أو التخزين البعيد: remote‑storage:sync, media-content:sync, media-gallery:sync.
• ترجمة المحتوى: i18n:collect-phrases, pack, uninstall.
• تثبيت، إزالة، أو إعادة تعيين البيانات التجريبية (sample data).

لإنشاء إعداد Varnish:

bin/magento varnish:vcl:generate

لمزامنة التخزين البعيد:

bin/magento remote-storage:sync

لمزامنة محتوى الوسائط:

bin/magento media-content:sync

لمزامنة مكتبة الوسائط:

bin/magento media-gallery:sync

لجمع عبارات الترجمة:

bin/magento i18n:collect-phrases

لإنشاء حزم الترجمة:

bin/magento i18n:pack

لتثبيت البيانات التجريبية:

bin/magento sampledata:deploy

لإزالة البيانات التجريبية:

bin/magento sampledata:remove

لإعادة تعيين البيانات التجريبية:

bin/magento sampledata:reset

إنشاء أوامر خاصة مخصصة (Custom CLI Commands)

يمكنك إضافة أوامر جديدة إلى CLI ضمن وحدات خاصة بك عبر تعريف اسم ووصف في configure() أو عبر di.xml. تدمج بسهولة ضمن بنية Symfony وتُدار حسب حالة الوحدة ارجع إلى الدليل من هنا developer.adobe.com.

---

الأسئلة الشائعة عن أوامر ماجنتو 2

---

الخاتمة

إتقان أوامر CLI لماجنتو 2 يمنحك سيطرة كاملة ومرونة عالية في إدارة متجرك الإلكتروني بكفاءة واحترافية. ومع خدمات الدعم الفني والصيانة التي تقدّمها Growsera، يمكنك الحفاظ على متجرك بأداء ممتاز وتحديثات دائمة.

هل تحتاج إلى دعم فني لمتجرك؟ [اضغط هنا لطلب استشارة مجانية]