> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/2.x/ar/dlyl-alidarh/admin-guide/installation/upgrading.md).

# الترقية

ملاحظة: في هذه الصفحة، نستخدم 2.0.0 كرقم إصدار صارم و2.x لتحديد جميع الإصدارات التي تبدأ بالرقم 2 (2.0.0، 2.0.1، 2.1.0، إلخ).

يتم وصف عملية الترقية من 1.11.x إلى 2.x في ملف `public/documentation/installation_guide.html` الخاص بك، داخل كود Chamilo. المعلومات هنا متكررة إلى حد كبير. يمكنك رؤيتها عبر الإنترنت على `https://campus.chamilo.net/documentation/installation_guide.html`. على الرغم من إجراء اختبارات واسعة على هجرات مشابهة، إلا أن بعض إعدادات 1.11.x لم تكن مدعومة بعد في 2.0.0، لذا نوصي بالانتظار حتى الإصدار 2.1 قبل ترقية نظام 1.11.x، أو الاستعانة بمرافقة مهنية من [مزودي Chamilo الرسميين](https://chamilo.org/providers) في هذه العملية.

## الترقية من 1.11.x إلى 2.x

الترقية من Chamilo 1.11.x إلى 2.x هي **هجرة رئيسية**، وليست تحديثًا بسيطًا. تم إعادة بناء Chamilo 2.0 على إطار Symfony مع هيكل قاعدة بيانات معاد هيكلتها، وAPI جديد، وتنظيم ملفات مختلف. خطط لهذه الهجرة بعناية وجربها في بيئة اختبار قبل نشرها في الإنتاج.

### قبل البدء

1. **اقرأ ملاحظات الإصدار** لـ Chamilo 2.x لفهم ما تغير، وما هو الجديد، وما هي الميزات من 1.11.x التي قد لا تكون متاحة بعد.
2. **قم بعمل نسخ احتياطي لكل شيء**:
   * تصدير كامل لقاعدة البيانات (`mysqldump` أو ما يعادله).
   * جميع الملفات في دليل تثبيت Chamilo 1.11.x، خاصة `app/upload/`، `app/courses/`، و`main/`.
   * ملف `configuration.php` الخاص بك.
3. **اختبر على خادم تجريبي أولاً.** لا تقم أبدًا بتشغيل الهجرة مباشرة على خادم الإنتاج.
4. **تحقق من متطلبات الخادم.** لدى Chamilo 2.x متطلبات مختلفة عن 1.11.x (خاصة PHP 8.2+). انظر [متطلبات الخادم](/2.x/ar/dlyl-alidarh/admin-guide/installation/server-requirements.md).

### ما قد يتطلب تدخلاً يدويًا

| المنطقة                                  | الملاحظات                                                                                                                                                               |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **الإضافات المخصصة**                     | الإضافات في 1.11.x غير متوافقة مع 2.x. يجب إعادة كتابتها أو استبدالها، وقد تم ذلك جزئيًا في 2.0 ويجب أن يكتمل بحلول 2.1 للإضافات الرسمية.                               |
| **السمات المخصصة**                       | سمات 1.11.x لا تعمل في 2.x. أعد إنشاء علامتك التجارية باستخدام نظام السمات في 2.x.                                                                                      |
| **التعديلات المخصصة على قاعدة البيانات** | أي تعديلات مباشرة على قاعدة البيانات خارج Chamilo قد لا تُهاجر.                                                                                                         |
| **حزم SCORM**                            | يجب أن تهاجر محتويات SCORM، لكن اختبر الحزم بشكل فردي للتحقق من التشغيل.                                                                                                |
| **التكاملات الخارجية**                   | أي تكاملات تستخدم API أو خدمات الويب في 1.11.x تحتاج إلى التحديث لاستخدام API الـREST فقط في 2.x باستخدام [API Platform](https://github.com/api-platform/api-platform). |

## تحديث Chamilo 2.0.x

التحديثات الثانوية داخل فرع 2.0 أكثر بساطة.

### عملية التحديث

#### باستخدام حزمة

1. **قم بعمل نسخة احتياطية** لقاعدة البيانات والملفات.
2. **حمّل أحدث إصدار 2.0.x** من [chamilo.org](https://chamilo.org/download):
3. **فك الضغط محليًا**

على سبيل المثال (قم بتكييفها مع الإصدار المحمل)

```bash
unzip chamilo-2.0.1.zip
```

4. **انسخ الملفات فوق تثبيت Chamilo الحالي**

   ```bash
   cp -r chamilo/* [your-chamilo-installation-path]/
   cp -r chamilo/.* [your-chamilo-installation-path]/
   ```
5. **شغّل هجرات قاعدة البيانات:**

   ```bash
   php bin/console doctrine:migrations:migrate --no-interaction
   ```
6. **امسح الذاكرة المؤقتة:**

   ```bash
   php bin/console cache:clear --env=prod
   php bin/console cache:warmup --env=prod
   ```
7. **غيّر الأذونات**

قم بتكييفها مع مستخدم خادم الويب:

```bash
sudo chown -R www-data: [your-chamilo-installation-path]/var
```

8. **تحقق** من تحميل المنصة بشكل صحيح وفحص الوظائف الرئيسية عينيًا.

#### باستخدام Git

إذا قمت بتثبيت Chamilo باستخدام Git، يمكنك اتباع هذه التعليمات بدلاً من ذلك.

1. **قم بعمل نسخة احتياطية** لقاعدة البيانات والملفات.
2. **سحب أحدث كود** (أو حمّل الإصدار الجديد):

   ```bash
   git pull origin 2.0
   ```
3. **حدّث تبعيات PHP:**

   ```bash
   composer install --no-dev --optimize-autoloader
   ```
4. **حدّث تبعيات JavaScript وأعد بناء الأصول:**

   ```bash
   yarn install && yarn build
   ```
5. **شغّل هجرات قاعدة البيانات:**

   ```bash
   php bin/console doctrine:migrations:migrate --no-interaction
   ```
6. **امسح الذاكرة المؤقتة:**

   ```bash
   php bin/console cache:clear --env=prod
   php bin/console cache:warmup --env=prod
   ```
7. **غيّر الأذونات**

قم بتكييفها مع مستخدم خادم الويب:

```bash
sudo chown -R www-data: [your-chamilo-installation-path]/var
```

8. **تحقق** من تحميل المنصة بشكل صحيح وفحص الوظائف الرئيسية عينيًا.

### أتمتة التحديثات

بالنسبة للمنظمات التي تدير عدة نسخ من Chamilo، فكّر في كتابة سكريبت لعملية التحديث:

```bash
#!/bin/bash
set -e

# Pull code
git pull origin 2.0

# Dependencies
composer install --no-dev --optimize-autoloader
yarn install && yarn build

# Database
php bin/console doctrine:migrations:migrate --no-interaction

# Cache
php bin/console cache:clear --env=prod
php bin/console cache:warmup --env=prod

echo "Update complete."
```

***

## نصائح

* **قم دائمًا بعمل نسخة احتياطية قبل الترقية.** عمليات نقل قاعدة البيانات غير قابلة للعكس من خلال واجهة Chamilo.
* **اختبر على بيئة تجريبية أولاً** -- خاصة لنقل البيانات من 1.11.x إلى 2.0، والتي تشمل تحويلًا كبيرًا للبيانات.
* **جدول الترقيات خلال نوافذ الصيانة** عندما لا يكون المستخدمون يستخدمون المنصة بنشاط.
* **اشترك في إصدارات GitHub** على [Github](https://github.com/chamilo/chamilo-lms/releases) باستخدام أيقونة الجرس لتلقي إشعارات بالإصدارات الجديدة وتصحيحات الأمان.
* **التحديثات عبر الويب** غير متوفرة بعد في Chamilo 2.0، لكن هذا مشروع مستمر نأمل في إصداره قريبًا.