# معالج التثبيت

يحتوي Chamilo 2.0 على معالج تثبيت قائم على الويب يرشدك خلال الإعداد الأولي. يعمل المعالج تلقائيًا عند الوصول إلى المنصة للمرة الأولى.

## قبل البدء

تأكد من تحقق المتطلبات التمهيدية التالية:

1. يلبي خادمك جميع [متطلبات الخادم](/2.x-ar/dlyl-alidarh/admin-guide/installation/server-requirements.md).
2. قمت بتحميل نسخة معبأة (zip أو tar.gz) من Chamilo.
3. تم تهيئة خادم الويب الخاص بك لخدمة دليل `public/` كجذر المستندات.
4. يوجد ملف `.env` الخاص بك وهو فارغ (سيرشد المعالج إعداد قاعدة البيانات).

## الخطوة 1: لغة التثبيت

![Installation wizard Step 1 — language selection](/files/BXnVheH70LHiu12vjV4p)

تتيح الخطوة الأولى اختيار اللغة لعملية التثبيت. اختر اللغة المفضلة لديك من القائمة المنسدلة.

إذا اكتشف Chamilo تثبيتًا موجودًا (للترقية)، فسيعرض حالة الترحيل ويقدم مسار ترقية بدلاً من تثبيت جديد.

## الخطوة 2: فحص المتطلبات

![Installation wizard Step 2 — requirements check showing PHP version, extensions, and directory permissions](/files/lgDS53NutPnIyGSPcUuS)

يفحص المعالج بيئة خادمك:

* **إصدار PHP** هو 8.2 أو أعلى
* **الامتدادات المطلوبة لـ PHP** مثبتة (intl، gd، curl، zip، mbstring، xml، إلخ)
* **إعدادات PHP الموصى بها** — `date.timezone` مُهيأ، حدود تحميل/ذاكرة كافية
* **أذونات الدليل والملف** — `var/`، `config/`، و `public/upload/` قابلة للكتابة بواسطة خادم الويب

إذا لم تتحقق أي من المتطلبات، يعرض المعالج تحذيرات أو أخطاء. قم بحلها قبل المتابعة.

## الخطوة 3: الترخيص

![Installation wizard Step 3 — license acceptance](/files/Tx1ubSXhQVD5aq7RmRxR)

تعرض هذه الخطوة رخصة GNU/GPLv3. يجب عليك تحديد خانة الاختيار **"أقبل"** للمتابعة.

اختياريًا، يمكنك توسيع قسم **معلومات الاتصال** لتقديم تفاصيل عن منظمتك (الاسم، البريد الإلكتروني، الشركة، البلد). هذا طوعي ويساعد مجتمع Chamilo على فهم من يستخدم المنصة، لكنه سيسمح لنا أيضًا بالاتصال بك *نادرًا جدًا* بشأن الفعاليات التي تحدث بالقرب منك.

## الخطوة 4: إعدادات قاعدة البيانات

![Installation wizard Step 4 — database connection configuration](/files/uGTdpZNI1DktJXBaiEGa)

أدخل تفاصيل اتصال قاعدة البيانات الخاصة بك:

| الحقل                        | الوصف                                                                        |
| ---------------------------- | ---------------------------------------------------------------------------- |
| **مضيف قاعدة البيانات**      | اسم المضيف أو عنوان IP لخادم قاعدة البيانات (مثل `localhost` أو `127.0.0.1`) |
| **منفذ قاعدة البيانات**      | الافتراضي: 3306 لـ MySQL/MariaDB                                             |
| **اسم قاعدة البيانات**       | اسم قاعدة البيانات المستخدمة (حروف وأرقام ورموز سفلية فقط)                   |
| **مستخدم قاعدة البيانات**    | مستخدم قاعدة بيانات لديه صلاحيات كاملة على قاعدة البيانات المحددة            |
| **كلمة مرور قاعدة البيانات** | كلمة المرور لمستخدم قاعدة البيانات                                           |

انقر على **فحص اتصال قاعدة البيانات** للاختبار. لن يسمح المعالج بالمتابعة حتى ينجح الاتصال. إذا كانت قاعدة البيانات موجودة بالفعل، يُعرض تحذير.

## الخطوة 5: إعدادات التكوين

![Installation wizard Step 5 — administrator account, portal settings, and email configuration](/files/9BgWMcWijH8L1A560fdH)

تجمع هذه الخطوة بين إنشاء حساب المسؤول، إعدادات البوابة، وتكوين البريد الإلكتروني.

### حساب المسؤول

| الحقل                 | الوصف                                                      |
| --------------------- | ---------------------------------------------------------- |
| **تسجيل الدخول**      | اسم مستخدم المسؤول                                         |
| **كلمة المرور**       | اختر كلمة مرور قوية — هذا الحساب لديه وصول كامل إلى المنصة |
| **الاسم الأول**       | الاسم الأول للمسؤول                                        |
| **الاسم الأخير**      | الاسم الأخير للمسؤول                                       |
| **البريد الإلكتروني** | يُستخدم لإشعارات النظام وإعادة تعيين كلمة المرور           |
| **الهاتف**            | رقم الاتصال الاختياري                                      |

سيتم استخدام هذه التفاصيل الخاصة بالمسؤول أيضًا من قبل Chamilo لملء تفاصيل الاتصال بالدعم، لذا تأكد من إعادة تهيئتها في الإعدادات بعد انتهاء التثبيت.

### إعدادات البوابة

| الحقل                            | الوصف                                                  |
| -------------------------------- | ------------------------------------------------------ |
| **اللغة**                        | اللغة الافتراضية لواجهة المستخدم                       |
| **اسم البوابة**                  | اسم المنصة الخاصة بك (مثل "نظام إدارة التعلم لمنظمتي") |
| **الاسم المختصر للشركة**         | الاسم المختصر لمنظمتك                                  |
| **رابط الشركة**                  | موقع منظمتك على الويب                                  |
| **طريقة التشفير**                | خوارزمية تشفير كلمات المرور — **bcrypt** موصى به       |
| **السماح بالتسجيل الذاتي**       | نعم / لا / بعد الموافقة                                |
| **السماح بالتسجيل الذاتي كمدرب** | نعم / لا                                               |

### تكوين البريد الإلكتروني

يسمح قسم إعدادات البريد الإلكتروني بتكوين وسيلة نقل البريد (SMTP، Amazon SES، Mailjet، إلخ) واختبار إرسال البريد الإلكتروني. انظر [تكوين البريد الإلكتروني](/2.x-ar/dlyl-alidarh/admin-guide/installation/email-configuration.md) للتفاصيل.

يمكن تغيير جميع هذه الإعدادات لاحقًا من لوحة الإدارة.

***

***

## الخطوة 6: التحقق النهائي قبل التثبيت

![Installation wizard Step 6 — review of all settings before installation](/files/IK4cskwlPHcJn8UxbPsM)

تعرض هذه الخطوة ملخصًا لكل ما أدخلته للمراجعة:

* بيانات مصادقة المسؤول (يتم إخفاء كلمة المرور افتراضيًا — انقر على أيقونة العين للكشف عنها)
* إعدادات البوابة
* تفاصيل اتصال قاعدة البيانات

راجع بعناية، ثم انقر على **تثبيت Chamilo** لتنفيذ التثبيت. يقوم المعالج بإنشاء جميع جداول قاعدة البيانات، وملء البيانات الأولية، وتكوين المنصة.

## الخطوة 7: اكتمل التثبيت

![Installation wizard Step 7 — completion with security advice and portal link](/files/GPjw5pHMtNITwhL3xV95)

بعد اكتمال التثبيت بنجاح، يعرض المعالج:

* **نصائح البدء** — يقترح إنشاء مساقك الأول لاستكشاف المنصة (كمسؤول، يجب عليك القيام بذلك من لوحة الإدارة)
* **توصيات الأمان**:
  * اجعل دليل `config/` للقراءة فقط (`chmod 0555`)
  * احذف دليل `public/main/install/`
* **رابط إلى بوابتك** لتسجيل الدخول ببيانات مصادقة المسؤول التي أنشأتها للتو

## ما بعد التثبيت

بعد إكمال المعالج:

* **إزالة أو تقييد الوصول إلى برنامج التثبيت** -- يجب ألا يكون المعالج متاحًا بعد التثبيت. يقوم Chamilo عادةً بقفله تلقائيًا، لكن تحقق من أن إعادة زيارة عنوان URL للتثبيت يعيد التوجيه إلى صفحة تسجيل الدخول.
* **تكوين إرسال البريد الإلكتروني** -- انظر [تكوين البريد الإلكتروني](/2.x-ar/dlyl-alidarh/admin-guide/installation/email-configuration.md).
* **إعداد النسخ الاحتياطي** -- قبل إضافة المحتوى، قم بتكوين نسخ احتياطي تلقائي لقاعدة البيانات والملفات (لا يوفر Chamilo حلاً لهذا، لكن نسخ مجلد var/ وقاعدة البيانات هما العنصران الأهم).
* **مراجعة إعدادات الأمان** -- انظر [إعدادات الأمان](/2.x-ar/dlyl-alidarh/admin-guide/platform-settings/security-settings.md).

## استكشاف الأخطاء وحل المشكلات

| المشكلة                         | الحل                                                                                                                         |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| صفحة فارغة في عنوان URL للتثبيت | تحقق من سجلات أخطاء PHP. غيّر إلى `APP_ENV=dev` في .env مؤقتًا لرؤية الأخطاء في المتصفح.                                     |
| فشل اتصال قاعدة البيانات        | تحقق من بيانات المصادقة، وتأكد من وجود قاعدة البيانات، وتحقق من أن خادم قاعدة البيانات يسمح بالاتصالات من مضيف الخادم الويب. |
| أخطاء رفض الصلاحية              | تأكد من أن `var/` قابل للكتابة بواسطة مستخدم الخادم الويب.                                                                   |
| عدم تحميل الموارد (لا CSS/JS)   | قم بتشغيل `yarn install && yarn build` لتجميع موارد الواجهة الأمامية.                                                        |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-ar/dlyl-alidarh/admin-guide/installation/installation-wizard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.