كيفية تثبيت Magento 2 على Localhost

تم التحديث في 13 أبريل 2021 : قد يواجه المستخدمون خطأ 404 غير موجود عند محاولة تثبيت Magento 2.4.2. اتبع الحل المقترح في المقالة للحصول على أفضل نتيجة.

لقد مر وقت طويل منذ أن قدمت Magento نسختها 2.0. مع واجهة مستخدم أكثر ودية وأداء محسّن ، من المحتمل أن ينتقل العديد من مستخدمي Magento 1 الحاليين إلى Magento 2 عاجلاً أم آجلاً. تمشيا مع هذا الاتجاه ، أصدر SimiCart أيضًا تطبيق Magento 2 للجوال في ديسمبر 2016.

اليوم ، سنوضح لك كيفية تثبيت Magento 2.4 محليًا على Windows باستخدام خادم XAMPP. يستهدف هذا البرنامج التعليمي مستخدمي Magento 2 الحاليين وكذلك المستخدمين الجدد تمامًا على Magento. الآن ، لنبدأ!

الجزء 1: تثبيت XAMPP وتكوينه

الخطوة 1 : تنزيل XAMPP

رابط التنزيل: https://www.apachefriends.org/download.html

نوصي بتثبيت XAMPP مع إصدار PHP 7.4.x ، والذي يوصى به Magento لـ M2.4. أيضًا وفقًا لـ Magento ، يمكنك تثبيت Magento 2.4 مع PHP 7.3 ، لكن لم يتم اختباره أو التوصية به.

الخطوة الثانية : تثبيت XAMPP

بعد تنزيل XAMPP ، انقر نقرًا مزدوجًا فوق الملف لتثبيته على جهاز الكمبيوتر الخاص بك.

انقر فوق التالي .

اترك التحديد الافتراضي كما في الصورة. انقر فوق التالي .

اختر مجلد التثبيت الخاص بك. الموقع الافتراضي هو C: \ xampp . بعد ذلك ، انقر فوق التالي .

انقر فوق التالي .

انقر فوق التالي .

سيقوم برنامج الإعداد الآن بتثبيت xampp على جهاز الكمبيوتر الخاص بك. يرجى الانتظار لبعض الوقت.

بعد انتهاء الإعداد ، سترى الخيار "هل تريد بدء تشغيل لوحة التحكم الآن؟". اجعله محددًا. انقر فوق " إنهاء " للخروج من الإعداد وأدخل لوحة تحكم XAMPP.

الخطوة 3 : تكوين XAMPP

في لوحة تحكم XAMPP ، انقر فوق الزر " تكوين " في صف "Apache" ، ثم انقر فوق " PHP (php.ini) ".

في ملف php.ini ، ابحث عن هذه الصفوف وقم بإزالتها ; قبل كل صف:

 ؛ التمديد = intl
؛ التمديد = الصابون
؛ التمديد = المقابس
؛ التمديد = الصوديوم
؛ التمديد = xsl

قم بتوسيع memory_limit إلى 4G:

 memory_limit = 4G

بعد الانتهاء ، احفظ وأغلق الملف. بعد ذلك ، انقر فوق الزر " ابدأ " في صفين من صفين Apache و MySQL لبدء تشغيلهما. لا تترك XAMPP بعد هذه الخطوة ، فقط اتركها تعمل.

الخطوة 4 : تكوين ملف المضيفين

افتح C:\Windows\System32\drivers\etc\hosts . أضف السطر التالي إلى الصف الأخير:

 127.0.0.1 www.localhost.com

الخطوة 5 : إنشاء قاعدة بيانات

تصفح URL http://localhost/phpmyadmin/ للوصول إلى صفحة phpMyAdmin. أدخل اسم قاعدة البيانات (على سبيل المثال "Magento2") وانقر فوق إنشاء .

قم بتدوين اسم قاعدة البيانات الخاصة بك ، حيث سترغب في تثبيت Magento عليها لاحقًا (باستخدام المستخدم root ).

الجزء 2: تثبيت Elasticsearch

اعتبارًا من الإصدار 2.4 ، يتطلب Magento Elasticsearch ليكون محرك بحث الكتالوج.

تنزيل Elasticsearch 7.6.0: https://www.elastic.co/downloads/past-releases/elasticsearch-7-6-0 (تم اختبار Magento 2.4.x باستخدام Elasticsearch 7.6.x فقط. يمكنك استخدام الإصدار 7.x الآخر الإصدارات وفقًا لتقديرك ، لكننا نوصي باستخدام الإصدار الذي تم اختباره من Elasticsearch.)

قم باستخراج ملف .zip الذي قمت بتنزيله للتو. في نافذة طرفية ، cd إلى الدليل المستخرج ، وقم بتشغيل هذا الأمر:

 . \ bin \ elasticsearch.bat

عند اكتمال التثبيت ، يمكنك التحقق مما إذا كان Elasticsearch مثبتًا بشكل صحيح على http://localhost:9200 ، والذي يجب أن يمنحك شيئًا كالتالي:

 {
   "الاسم": "Cp8oag6"،
   "اسم المجموعة": "elasticsearch" ،
   "cluster_uid": "AT69_T_DTp-1qgIJlatQqA" ،
   "إصدار" : {
     "الرقم": "7.6.0"،
     "build_flavor": "افتراضي"،
     "build_type": "القطران"،
     "build_hash": "f27399d"،
     "تاريخ الإنشاء": "2016-03-30T09: 51: 41.449Z" ،
     "build_snapshot": خطأ ،
     "lucene_version": "8.7.0"،
     "الحد الأدنى للإصدار": "1.2.3"،
     "الإصدار_الحد الأدنى من الفهرس_التوافقية": "1.2.3"
   } ،
   "tagline": "أنت تعرف ، للبحث"
 }

الجزء 3: تنزيل Magento باستخدام Composer

نظرًا لأن بعض المكونات الإضافية من Magento 2 لا تعمل مع الملحن 2.x ، فستحتاج إلى استخدام إصدار ثابت من الملحن 1.x لتنزيل Magento. أفضل طريقة للقيام بذلك هي تثبيت Composer-Setup.exe.

سيقوم هذا الإعداد بتثبيت أحدث إصدار من الملحن وإعداد متغيرات بيئة PATH بحيث يمكنك استدعاء الملحن بسهولة من أي دليل. بعد الانتهاء من تثبيت الملحن ، يلزمك الرجوع إلى إصدار 1.x سابق باستخدام composer self-update --1 لضمان أفضل توافق.

بعد ذلك ، cd to C:\xampp\htdocs وقم بتشغيل الأمر التالي:

 الملحن create-project --repository-url = https: //repo.magento.com/ magento / project-community-edition = 2.4.2 <install-directory-name>

من المفترض أن يستغرق الملحن بعض الوقت لتنزيل جميع الوحدات الضرورية وتثبيتها. عندما ينتهي كل شيء ، هذا ما يجب أن تراه:

الجزء 4: تثبيت Magento باستخدام سطر الأوامر

بدءًا من Magento 2.4 ، تعد واجهة سطر الأوامر هي طريقة التثبيت الافتراضية (والوحيدة) لـ Magento.

أثناء تثبيت Magento 2.4 ، قد تواجه بعض الأخطاء. لمنع مثل هذه الأخطاء ، تحتاج أولاً إلى إجراء بعض التعديلات على ملفات Magento.

لمنع هذا الخطأ:

ابحث عن وظيفة validateURLScheme في \vendor\magento\framework\Image\Adapter\Gd2.php بـ:

 دالة خاصة ValidateURLScheme (سلسلة $ filename): bool
   {
       $ allow_schemes = ['ftp'، 'ftps'، 'http'، 'https']؛
       $ url = parse_url ($ filename) ؛
       إذا ($ url && isset ($ url ['مخطط']) &&! in_array ($ url ['مخطط']، $ allowed_schemes) &&! file_exists ($ filename)) {
           عودة كاذبة؛
       }
       العودة صحيح
 }

بعد ذلك ، cd إلى دليل Magento الخاص بك وقم بتشغيل هذا الأمر:

 php bin / magento setup: install --base-url = http: // localhost / magento24 / --db-host = localhost --db-name = yourdbname --db-user = yourdbuser --db-password = yourdbpassword - -admin-firstname = admin --admin-lastname = admin [email protected] --admin-user = admin --admin-password = admin123 --language = en_US --currency = USD - المنطقة الزمنية = أمريكا / شيكاغو - إعادة الكتابة = 1 - backend-frontname = admin --search-engine = elasticsearch7 --elasticsearch-host = localhost --elasticsearch-port = 9200 

عند التثبيت بنجاح ، سترى هذه الرسالة:

 فحص أذونات ملف التثبيت بعد ...
 للأمان ، قم بإزالة أذونات الكتابة من هذه الأدلة: "C: / xampp / htdocs / magento24 / app / etc"
 [التقدم: 1270/1270]
 [نجاح]: اكتمل تثبيت Magento.
 [نجاح]: عنوان URI للوحة المشرف: / admin
لا شيء للاستيراد.

بعد ذلك ، سيتعين علينا إجراء بعض التعديلات الإضافية لجعل Magento يعمل مع Windows ، مثل:

في app\etc\di.xml ، Symlink بـ Copy

 <virtualType name = "developerMaterialization" type = "Magento \ Framework \ App \ View \ Asset \ MaterializationStrategy \ Factory">
    <الحجج>
        <اسم الوسيطة = "StrategList" xsi: type = "array">
            <item name = "view_preprocessed" xsi: type = "object"> Magento \ Framework \ App \ View \ Asset \ MaterializationStrategy \ Symlink </item>
            <item name = "default" xsi: type = "object"> Magento \ Framework \ App \ View \ Asset \ MaterializationStrategy \ Copy </item>
        </argument>
    </ الحجج>
</virtualType>

في vendor\magento\framework\View\Element\Template\File\Validator.php ، استبدل السطر 138 بما يلي:

 $ realPath = str_replace ('\\'، '/'، $ this-> fileDriver-> getRealPath ($ path)) ؛

أخيرًا ، قم بتشغيل هذه الأوامر:

 ملف php bin / magento indexer: reindex
php bin / magento setup: ترقية
إعداد php bin / magento: محتوى ثابت: نشر -f
php bin / magento cache: flush

تعديلات إضافية لـ Magento 2.4.2 وما فوق

بدءًا من Magento 2.4.2 ، أصبح الآن إلزاميًا تقديم المحتوى من المجلد /pub/ لضمان أمان أفضل. هذا هو السبب في الحاجة إلى تعديلات إضافية لجعل إصدار Magento 2.4.2 يعمل بشكل صحيح.

الخطوة 1 : انسخ ملفات index.php و .htaccess من /pub/ إلى المجلد الجذر.

الخطوة 2 : ابحث عن السطر أدناه في index.php (في المجلد الجذر):

 تتطلب __DIR__. "/../app/bootstrap.php" ؛

واستبدله بـ

 تتطلب __DIR__. "/app/bootstrap.php" ؛

الخطوة 3 : انتقل إلى قاعدة بيانات Magento 2 التي أنشأتها مؤخرًا (في http://localhost/phpmyadmin ) وابحث عن الجدول core_config_data باستخدام استعلام SQL هذا:

 حدد * من core_config_data

في هذا الجدول ، سترغب في إدراج هذه الصفوف في:

• أدخل الصفوف يدويًا:

• إدراج صفوف باستخدام استعلامات SQL:

 INSERT INTO "core_config_data" ("config_id" ، "النطاق" ، "مدى_المسار" ، "المسار" ، "القيمة" ، "updated_at") VALUES (NULL، 'default'، '0'، 'web / secure / base_static_url'، 'http: // localhost / magento24 / pub / static /'، current_timestamp ()) ؛
INSERT INTO "core_config_data" ("config_id" ، "النطاق" ، "معرف_النطاق" ، "المسار" ، "القيمة" ، "updated_at") VALUES (NULL، 'default'، '0'، 'web / unsecure / base_static_url'، 'http: // localhost / magento24 / pub / static /'، current_timestamp ()) ؛
INSERT INTO "core_config_data" (`config_id` ،` النطاق` ، `معرف_النطاق` ،` المسار` ، `القيمة` ،` updated_at`) VALUES (NULL، 'default'، '0'، 'web / secure / base_media_url'، 'http: // localhost / magento24 / pub / media /'، current_timestamp ()) ؛
INSERT INTO "core_config_data" ("config_id" ، "النطاق" ، "معرف_النطاق" ، "المسار" ، "القيمة" ، "updated_at") VALUES (NULL، 'default'، '0'، 'web / unsecure / base_media_url'، 'http: // localhost / magento24 / pub / media /'، current_timestamp ()) ؛

يجب أن تبدو الصفوف المضافة حديثًا كما يلي:

الآن امسح ذاكرة التخزين المؤقت باستخدام:

 php bin / magento cache: flush

وقم بتحديث الواجهة الأمامية الخاصة بك. يجب أن تكون الآن قادرًا على رؤية صفحة فارغة مثل هذه عند الوصول إلى الواجهة الأمامية عبر base-url تكوينه:

يمكنك الآن الوصول إلى الواجهة الأمامية لـ Magento باستخدام base-url تكوينه. على سبيل المثال ، من خلال تثبيت Magento 2.4.2 الخاص بنا ، نصل إلى موقع Magento الجديد الخاص بنا على http://localhost/magento24/ الخلفي على http://localhost/magento24/admin .

* ملاحظة: إذا واجهت هذا الخطأ عند محاولة تسجيل الدخول إلى حساب Magento Admin الخاص بك: "تحتاج إلى تكوين Two Factor Authorization ..."

جرب تشغيل هذا الأمر:

 وحدة php bin / magento: قم بتعطيل Magento_TwoFactorAuth

الجزء 5: استيراد عينة البيانات (اختياري)

قم بتشغيل هذا الأمر لاستيراد عينة البيانات:

 php bin / magento sampledata: النشر

عند المطالبة ، أدخل مفاتيح مصادقة Magento الخاصة بك. يتم إنشاء المفاتيح العامة والخاصة وتكوينها في حساب Magento Marketplace الخاص بك.

بعد اكتمال استيراد البيانات ، قم بتشغيل:

 php bin / magento setup: ترقية
إعداد php bin / magento: محتوى ثابت: نشر -f
php bin / magento cache: نظيف

الآن ، قم بتحديث الواجهة الأمامية ويجب أن تكون قادرًا على رؤية متجر Magento الافتراضي مع سمة Luma وعينة من البيانات.

هذا هو! لقد انتهيت من تثبيت Magento 2 على مضيفك المحلي. يمكنك الآن الوصول إلى الواجهة الأمامية / الخلفية لـ Magento 2 والبدء في استكشاف ميزات Magento 2. نأمل أن تجد هذا المنشور مفيدًا!

قراءة متعمقة

أفضل 10 ثيمات وقوالب مجانية لـ Magento 2 في عام 2022

بيري 3 يناير 2022 8 دقائق للقراءة

12 من أفضل مقدمي خدمات استضافة Magento 2

هيلي نجوين 4 يونيو 2021 قراءة 9 دقائق

10 أفضل مواقع Magento 2

بيري 1 سبتمبر 2020 قراءة 9 دقائق

10 أفضل أمثلة Magento PWA

لوك فو 25 ديسمبر 2020 قراءة لمدة 11 دقيقة