# تثبيت Laravel Valet+ على Ubuntu

> جهّز بيئة Laravel المحلية التي نستخدمها: Nginx وPHP 8.2 وMySQL وComposer وValet+ على Ubuntu، مع phpMyAdmin على نطاق .test آمن.

*2026-09-17T03:23:45Z*

لتشغيل مشاريعنا ننصح باستخدام البيئة نفسها التي نعمل عليها: Ubuntu Linux مع Laravel Valet+. يأخذك هذا الدليل من جهاز جديد إلى بيئة محلية جاهزة تضم Nginx وPHP 8.2 وMySQL وComposer وValet+ وphpMyAdmin يعمل على نطاق `.test` آمن.

_ملاحظة: كُتب هذا الدليل في أكتوبر 2023 لـ PHP 8.2 وحزمة `genesisweb/valet-linux-plus`، وقد تحتاج إصدارات Ubuntu وPHP الأحدث إلى إصدارات حزم مختلفة._

## اختر توزيعة Linux: BackBox (موصى بها)

أحب استخدام [BackBox](https://www.backbox.org/download/) Linux لأنها تأتي بالكثير من الأدوات وتدعم بيئتنا.

1. نزّل صورة ISO من رابط BackBox.
2. انسخها إلى ذاكرة USB باستخدام [Rufus](https://rufus.ie/en/).
3. أقلع جهازك من ذاكرة USB وثبّت النظام.

## تثبيت الحزم المطلوبة

افتح الطرفية وابدأ بإضافة مستودعي Nginx وPHP وتحديث النظام:

```bash
sudo add-apt-repository -y ppa:nginx/stable
sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt-get update
```

```bash
sudo apt-get upgrade
```

بعد انتهاء التحديث أعد تشغيل جهازك، ثم ثبّت الحزم التي يعتمد عليها Valet+:

```bash
sudo apt-get install network-manager libnss3-tools jq xsel
```

## تثبيت PHP وإضافاته

ثبّت PHP-FPM أولًا:

```bash
sudo apt install php8.2-fpm
```

ثم واجهة سطر الأوامر والإضافات التي يحتاجها تطبيق Laravel:

```bash
sudo apt install php8.2-cli php8.2-common php8.2-curl php8.2-mbstring php8.2-opcache php8.2-readline php8.2-xml php8.2-zip php8.2-mysql php8.2-gd
```

## تثبيت MySQL Server

1. ثبّت الخادم:

```bash
sudo apt-get -y install mysql-server
```

2. شغّل سكربت التثبيت الآمن:

```bash
sudo mysql_secure_installation
```

عندما يسألك عن مستوى التحقق من كلمة المرور اختر `0`، ثم استخدم أي كلمة مرور، مثل `12345678`.

3. بعد انتهاء التثبيت افتح طرفية MySQL:

```bash
sudo mysql
```

4. داخل طرفية MySQL اضبط كلمة مرور المستخدم root لتتمكن التطبيقات من الدخول بها، ثم أعد تحميل الصلاحيات واخرج:

```sql
mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '12345678';
```

```sql
mysql> FLUSH PRIVILEGES;
```

```sql
mysql> exit;
```

## تثبيت Composer

```bash
sudo apt install curl
```

```bash
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
```

## تثبيت Valet+

1. ثبّت حزمة Valet+ بشكل عام عبر Composer:

```bash
composer global require genesisweb/valet-linux-plus
```

2. عليك الآن إضافة مجلد `bin` العام الخاص بـ Composer إلى `PATH` ليتعرف النظام على الأمر `valet`:

```bash
PATH="$PATH:$HOME/.composer/vendor/bin"
```

أو استخدم هذا الأمر، بحسب المكان الذي يحفظ فيه Composer حزمه العامة:

```bash
PATH="$PATH:$HOME/.config/composer/vendor/bin"
```

3. أصبح تثبيت Valet سهلًا الآن:

```bash
valet install
```

سيطلب منك كلمة مرور، فأدخل `12345678`، وهي كلمة مرور MySQL التي ضبطتها سابقًا.

## تثبيت phpMyAdmin

بعد تثبيت Valet لنُعدّ phpMyAdmin ونشغّله على نطاق `.test`.

1. أنشئ مجلدًا لمواقعك داخل المجلد الرئيسي `~`:

```bash
cd ~
mkdir Sites
cd Sites
```

2. من داخل `Sites` نفّذ الأمر park ليصبح هذا المجلد موطن مشاريعك:

```bash
valet park
```

أصبح كل مشروع داخل هذا المجلد يعمل تلقائيًا على نطاق `.test`.

3. نزّل phpMyAdmin من [phpmyadmin.net](https://www.phpmyadmin.net/)، وفك ضغطه داخل مجلد `Sites`، وأعد تسمية المجلد إلى `PHPMyAdmin`.

4. ادخل إلى المجلد، وانسخ ملف الإعدادات النموذجي وافتحه:

```bash
cp config.sample.inc.php config.inc.php
nano config.inc.php
```

_ملاحظة: نسخ المقال الأصلي الملف باسم `config.sample.php`، وهو ملف لا يقرؤه phpMyAdmin. يحمّل phpMyAdmin الملف `config.inc.php`، لذا استُخدم هذا الاسم هنا._

5. غيّر سطر `blowfish_secret` إلى:

```php
$cfg['blowfish_secret'] = 'YK07LhNSe50vrj,HwBfb.l3gpbv;u8b7';
```

6. اضغط `CTRL + X` وأجب بـ `Y` للحفظ، ثم استخدم Valet لربط phpMyAdmin وتأمينه بشهادة SSL وفتحه:

```bash
valet link
valet secure
valet open
```

أصبح phpMyAdmin يعمل الآن. سجّل الدخول باسم المستخدم `root` وكلمة مرور MySQL التي أنشأتها.

## الخلاصة

أصبحت لديك الآن البيئة التي نستخدمها لمشاريعنا: Nginx وPHP 8.2 يديرهما Valet+، وMySQL بكلمة مرور root تستخدمها تطبيقاتك، وComposer، وphpMyAdmin على نطاق `.test` آمن. ضع أي مشروع جديد داخل `~/Sites` وسيشغّله Valet فورًا.

---

Source: https://fadymondy.com/ar/blog/install-laravel-valet-ubuntu
