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

لتشغيل مشاريعنا ننصح باستخدام البيئة نفسها التي نعمل عليها: 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 Linux لأنها تأتي بالكثير من الأدوات وتدعم بيئتنا.

1. نزّل صورة ISO من رابط BackBox.
2. انسخها إلى ذاكرة USB باستخدام Rufus.
3. أقلع جهازك من ذاكرة USB وثبّت النظام.

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

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

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

sudo apt-get upgrade

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

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

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

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

sudo apt install php8.2-fpm

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

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. ثبّت الخادم:

sudo apt-get -y install mysql-server

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

sudo mysql_secure_installation

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

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

sudo mysql

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

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

mysql> FLUSH PRIVILEGES;

mysql> exit;

تثبيت Composer

sudo apt install curl

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

تثبيت Valet+

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

composer global require genesisweb/valet-linux-plus

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

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

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

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

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

valet install

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

تثبيت phpMyAdmin

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

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

cd ~
mkdir Sites
cd Sites

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

valet park

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

3. نزّل phpMyAdmin من phpmyadmin.net، وفك ضغطه داخل مجلد Sites، وأعد تسمية المجلد إلى PHPMyAdmin.

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

cp config.sample.inc.php config.inc.php
nano config.inc.php

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

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

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

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

valet link
valet secure
valet open

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

الخلاصة

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