يعمل Eagle3D على استضافة الويب القياسية، بما في ذلك حسابات cPanel. تحقّق من هذه المتطلبات قبل تثبيته. ويتحقق معالج الإعداد من معظمها نيابةً عنك في خطوته الأولى.
الحد الأدنى للإصدارات
| المتطلب | الإصدار |
|---|---|
| PHP | 8.1 أو أحدث. PHP 8.5 مدعوم. |
| قاعدة البيانات | MySQL 5.7 أو أحدث، أو MariaDB 10.3 أو أحدث |
| HTTPS | شهادة SSL للاستخدام الفعلي (مثل AutoSSL في cPanel) |
لا يتابع معالج الإعداد مع إصدار أقدم من PHP أو قاعدة البيانات.
إضافات PHP
| الإضافة | مطلوبة من أجل | في حال عدم توفرها |
|---|---|---|
pdo_mysql | الاتصال بقاعدة البيانات | لا يمكن متابعة الإعداد |
mbstring | معالجة النصوص بجميع اللغات | لا يمكن متابعة الإعداد |
json | الإعدادات وتبادل البيانات | لا يمكن متابعة الإعداد |
openssl | تشفير المفاتيح المحفوظة، والاتصالات الآمنة | لا يمكن متابعة الإعداد |
curl | الترخيص، والتحديثات، والاتصال بالمتاجر | لا يمكن متابعة الإعداد |
zlib | النسخ الاحتياطية المضغوطة | لا يمكن متابعة الإعداد |
zip (ZipArchive) | تثبيت التحديثات | يعمل Eagle3D، لكن لا يمكن تثبيت التحديثات |
gd | تغيير حجم صور المنتجات | تُخزَّن صور المنتجات دون تغيير حجمها |
sodium | التحقق من توقيعات الترخيص | يستخدم Eagle3D البديل المرفق مع الحزمة |
يمكنك عادةً تفعيل الإضافات من لوحة الاستضافة (مثلاً ضمن إعدادات إصدار PHP أو إضافات PHP).
قاعدة البيانات
- أنشئ قاعدة بيانات فارغ ومستخدمًا لقاعدة البيانات في لوحة الاستضافة (مثلاً cPanel > MySQL Databases).
- أضف المستخدم إلى قاعدة البيانات مع ALL PRIVILEGES.
- يُثبَّت Eagle3D في قاعدة بيانات فارغة فقط. إذا كانت قاعدة البيانات تحتوي على جداول، يطلب منك المعالج إنشاء قاعدة جديدة.
المجلدات التي يجب أن تكون قابلة للكتابة
| المجلد | السبب |
|---|---|
| مجلد التطبيق | يكتب المعالج ملف الإعدادات .env هنا |
app/storage | حزم التحديث وملفات العمل الأخرى |
app/storage/logs | ملفات السجل |
app/storage/backups | النسخ الاحتياطية لقاعدة البيانات |
uploads | صور المنتجات (يُنشأ عند أول رفع) |
خادم الويب
- يمكن تثبيت Eagle3D في جذر نطاق أو نطاق فرعي (مثلاً
https://print.example.com/) أو في مجلد فرعي. - تتضمن الحزمة قواعد وصول لخادم Apache (
.htaccess) وIIS (web.config). وهي تحظر ملف الإعدادات والسجلات والنسخ الاحتياطية والمجلدات الداخلية. - على خادم ويب آخر، احظر الملفات والمجلدات نفسها بنفسك. في نهاية الإعداد يعرض المعالج ما إذا كان يمكن الوصول إلى الملفات الحساسة من الخارج.
النطاق والترخيص
يرتبط الترخيص بالنطاق الذي تُدخله في معالج الإعداد. يُعدّ www.print.example.com وprint.example.com نطاقين مختلفين، لذا حدّد العنوان الذي ستستخدمه قبل التثبيت. راجع تفعيل ترخيص Eagle3D.
الاتصالات الصادرة
يجب أن يتمكن خادمك من فتح اتصالات HTTPS إلى:
- خادم الترخيص والتحديثات لدى ARN Smart (فحوصات الترخيص والتحديثات)؛
- متجرك الإلكتروني إن ربطت واحدًا (راجع ربط متجرك الإلكتروني)؛
- خادم البريد لديك إذا كنت ترسل البريد عبر SMTP.
خلف Cloudflare أو وكيل عكسي
إذا كان موقعك يعمل خلف Cloudflare أو وكيل عكسي آخر، أضف عناوين الوكيل إلى ملف .env باسم TRUSTED_PROXIES حتى ترى حدود تسجيل الدخول والطلبات عنوان الزائر الحقيقي. راجع الأمان وملكية البيانات.
مقالات ذات صلة
ألم تُحل المشكلة بعد؟
اسأل المجتمع