# تثبيت حزم PEAR
Source: https://docs.webgee.com/ar/development/how-to-install-pear



ثبّت حزم PEAR على حساب استضافتك. ينطبق على الاستضافة المشتركة والموزِّعة
والمميّزة.

<Callout type="info">
  **PEAR متقادم إلى حد بعيد.** فقد حلّ محلّه
  [Composer](https://getcomposer.org/)، الذي تستخدمه معظم مكتبات PHP الحديثة
  والذي يحلّ الاعتماديات لكل مشروع لا لكل حساب. استخدم PEAR فقط لتطبيق قديم
  يشترطه تحديدًا.
</Callout>

## عبر cPanel [#عبر-cpanel]

1. في cPanel، افتح **PHP PEAR Packages** ضمن **Software**.
2. ابحث عن الحزمة.
3. اختر **Install**.

وتُثبَّت الحزم في مجلدك الرئيسي، ويعرض cPanel قيمة `include_path` التي تحتاجها
سكربتاتك.

## أضف مسار التضمين [#أضف-مسار-التضمين]

لا يُعثَر على حزم PEAR تلقائيًا. فإما أن تضبطه لكل سكربت:

```php
<?php
set_include_path('/home/cpaneluser/php:' . get_include_path());
require_once 'Package.php';
```

أو على مستوى الحساب، في **Select PHP Version ← Options**، بضبط `include_path` —
راجع [تغيير إصدار PHP وإعداداته](/ar/development/change-php-version).

والمسار الدقيق معروض في صفحة PHP PEAR Packages. وهو يختلف من حساب لآخر، فاستخدم
المعروض لا المثال أعلاه.

## استخدم Composer بدلًا منه حيثما أمكن [#استخدم-composer-بدلًا-منه-حيثما-أمكن]

Composer متاح عبر SSH وهو الأداة الصحيحة لأي شيء جديد:

```bash
cd ~/public_html
php -d allow_url_fopen=1 /usr/local/bin/composer require vendor/package
```

وتُثبَّت الاعتماديات في `vendor/` داخل مشروعك، مع مُحمِّل تلقائي — فلا
`include_path` تضبطه، ولا خطر تعارض متطلبات تطبيق مع آخر.

## إن تعذّر تثبيت حزمة [#إن-تعذّر-تثبيت-حزمة]

* **تتطلّب إضافة PHP غير مفعَّلة.** راجع
  **Select PHP Version ← Extensions**.
* **تحتاج تصريفًا.** فالحزم التي تتطلّب مصرِّفًا لا يمكن تثبيتها على الاستضافة
  المشتركة. أما [خادم VPS](/ar/servers/cloud-server-quick-start) فيستطيع.
* **مهجورة.** فكثير من حزم PEAR لم تُحدَّث منذ عقد. ابحث عن مكافئ في Composer
  أولًا.

## اقرأ أيضًا [#اقرأ-أيضًا]

* [تغيير إصدار PHP وإعداداته](/ar/development/change-php-version)
* [الاتصال عبر SSH](/ar/development/connect-via-ssh)