Laravel هو إطار PHP شهير معروف ببنيته الأنيقة وميزاته القوية. في هذا البرنامج التعليمي، سنرشدك خلال عملية تثبيت Laravel على Ubuntu 20.04/22.04، باستخدام كل من Apache و Nginx كخوادم ويب. سنقدم تعليمات خطوة بخطوة لضمان التثبيت السلس. دعونا نبدأ!
متطلبات
قبل أن نبدأ، تأكد من وجود الشروط الأساسية التالية:
- خادم Ubuntu 20.04/22.04 مع حساب مستخدم غير جذري مع امتيازات سودو.
- تم تثبيت خادم الويب Apache أو Nginx وإعداداته بشكل صحيح على خادم Ubuntu الخاص بك.
- تم تثبيت PHP على خادم Ubuntu الخاص بك.
- Composer مثبت على خادم Ubuntu الخاص بك.
الخطوة 1: تحديث حزم النظام
أولاً، دعنا نقوم بتحديث حزم النظام للتأكد من أن لدينا أحدث الإصدارات. افتح terminal وقم بتشغيل الأمر التالي:
$ sudo apt update
$ sudo apt upgrade
الخطوة 2: تثبيت PHP والإضافات المطلوبة
يتطلب Laravel PHP جنبًا إلى جنب مع بعض الامتدادات المحددة. سنقوم بتثبيت PHP والإضافات المطلوبة باستخدام الأوامر التالية:
$ sudo apt install php php-cli php-common php-mbstring php-xml php-zip php-mysql php-pgsql php-sqlite3 php-json php-bcmath php-gd php-tokenizer php-xmlwriter
بمجرد اكتمال التثبيت، تحقق من إصدار PHP عن طريق تشغيل الأمر:
$ php -v
الخطوة 3: تثبيت Composer
Composer أداة لإدارة التبعية. سنستخدم الملحن لتثبيت Laravel وتوابعها. قم بتشغيل الأوامر التالية لتثبيت الملحن على مستوى العالم:
$ sudo apt install curl php-cli php-mbstring git unzip
$ curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
للتحقق من التركيب، قم بتشغيل الأمر التالي:
$ composer --version
الخطوة 4: تثبيت Laravel
الآن بعد أن تم تثبيت الملحن، يمكننا استخدامه لتثبيت Laravel. افتح طرفًا وانتقل إلى جذر المستند لخادم الويب الخاص بك. For Apache, يقع جذر المستند عادةً at /var/www/html
, وبالنسبة لـ Nginx، عادة ما يكون في /var/www
.
لتركيب Laravel، قم بتشغيل الأمر التالي:
$ composer create-project --prefer-dist laravel/laravel your-project-name
استبدال your-project-name
مع الاسم المطلوب لمشروع لارافيل الخاص بك. سيحضر الملحن إطار عمل Laravel وتوابعه، والذي قد يستغرق بضع دقائق.
بمجرد اكتمال التثبيت، انتقل إلى دليل المشروع:
$ cd your-project-name
الخطوة 5: ضبط أباتشي
إذا كنت تستخدم Apache كخادم ويب، فاتبع هذه الخطوات لتهيئته لـ Laravel.
قم بإنشاء ملف إعدادات Apache جديد لمشروع Laravel الخاص بك:
$ sudo nano /etc/apache2/sites-available/your-project-name.conf
استبدال your-project-name
بالاسم الفعلي لمشروعك
أضف المحتوى التالي إلى ملف التهيئة:
<VirtualHost *:80>
ServerName your-domain-or-ip
DocumentRoot /var/www/html/your-project-name/public
<Directory /var/www/html/your-project-name>
AllowOverride All
</Directory>
</VirtualHost>
استبدالyour-domain-or-ip
مع اسم النطاق الفعلي أو عنوان IP الخادم.
تشغيب إعادة كتابة وحدة أباتشي:
$ sudo a2enmod rewrite
تمكين المضيف الافتراضي:
$ sudo a2ensite your-project-name.conf
أعد تشغيل Apache حتى تدخل التغييرات حيز التنفيذ:
$ sudo systemctl restart apache2
الخطوة 6: ضبط Nginx
إذا كنت تستخدم Nginx كخادم ويب، فاتبع هذه الخطوات لتهيئته لـ Laravel.
قم بإنشاء إعدادات خادم Nginx جديدة لمشروع Laravel الخاص بك:
$ sudo nano /etc/nginx/sites-available/your-project-name
استبدال your-project-name
بالاسم الفعلي لمشروعك
أضف المحتوى التالي إلى إعدادات الخادم:
server {
listen 80;
server_name your-domain-or-ip;
root /var/www/html/your-project-name/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
}
location ~ /\.ht {
deny all;
}
}
استبدال your-domain-or-ip
مع اسم النطاق الفعلي أو عنوان IP الخادم.
تشغيل كتلة خادم Nginx:
$ sudo ln -s /etc/nginx/sites-available/your-project-name /etc/nginx/sites-enabled/
اختبر إعدادات Nginx لأي أخطاء في البناء:
$ sudo nginx -t
إعادة تشغيل Nginx حتى تدخل التغييرات حيز التنفيذ:
$ sudo systemctl restart nginx
الخطوة 7: ضبط Laravel
الآن بعد أن تم إعدادات خادم الويب الخاص بك، دعونا نعد Laravel.
نسخ مثال الملف .env
:
$ cp .env.example .env
توليد مفتاح تطبيق جديد:
$ php artisan key:generate
ضع الأذونات المناسبة على أدلة Laravel:
$ sudo chown -R www-data:www-data /var/www/html/your-project-name/storage
$ sudo chmod -R 775 /var/www/html/your-project-name/storage
أنت مستعد لاستخدام لارافيل! قم بالوصول إلى تطبيق Laravel الخاص بك في متصفح الويب عن طريق زيارة اسم النطاق أو عنوان IP الخاص بك.
مهم: يحتوي ملف.env
في Laravel على معلومات إعدادات حساسة، بما في ذلك بيانات اعتماد قاعدة البيانات ومفاتيح واجهة برمجة التطبيقات. يعد تأمين هذا الملف أمرًا بالغ الأهمية لحماية طلبك من الوصول غير المصرح به وخروقات الأمان. لتعزيز الأمان، يمكنك نقل ملف.env
خارج جذر المستند، وتقييد أذونات الملفات، وتعطيل تصفح الدليل، وتشفير المعلومات الحساسة، وتجنب تخزين بيانات اعتماد الإنتاج في التحكم في الإصدار. يساعد تنفيذ هذه الإجراءات في حماية البيانات الحساسة لتطبيقك والحفاظ على أمانه. من المهم استعراض وتحديث الممارسات الأمنية بانتظام للبقاء استباقيًا ضد التهديدات المحتملة.
خلاصة
تهانينا! لقد نجحت في تثبيت Laravel على Ubuntu 20.04/22.04 باستخدام كل من Apache و Nginx كخوادم ويب. الآن يمكنك البدء في بناء تطبيقات ويب قوية باستخدام إطار عمل Laravel. استمتع بالترميز مع لارافيل!