المتطلبات الأساسية
1. الوصول إلى cPanel: تأكد من أنك تملك وصولاً إلى cPanel في حساب الاستضافة الخاص بك.
2. الوصول إلى SSH: تحقق مما إذا كان مزود الاستضافة يسمح بالوصول إلى SSH. هذا يجعل التثبيت أسهل.
3. Composer: تأكد من تثبيت Composer على الخادم الخاص بك.
الدليل خطوة بخطوة
الخطوة 1: الوصول إلى cPanel
1. تسجيل الدخول إلى cPanel: استخدم رابط تسجيل الدخول إلى cPanel المزود من مزود الاستضافة الخاص بك.
الخطوة 2: إعداد البيئة
1. إنشاء نطاق فرعي (اختياري): إذا كنت ترغب في تثبيت لارافيل في نطاق فرعي، اذهب إلى قسم 'Domains' وأنشئ نطاقًا فرعيًا.
2. إنشاء قاعدة بيانات: اذهب إلى 'MySQL Databases' وأنشئ قاعدة بيانات جديدة ومستخدم. قم بتعيين المستخدم إلى قاعدة البيانات مع كافة الامتيازات.
الخطوة 3: الوصول عبر SSH
1. فتح الطرفية: استخدم ميزة الطرفية في cPanel أو الوصول إلى الخادم عبر عميل SSH (مثل PuTTY).
2. الانتقال إلى الدليل المطلوب: استخدم أمر cd
للانتقال إلى الدليل الذي تريد تثبيت لارافيل فيه. على سبيل المثال:
cd public_html/subdomain
الخطوة 4: تثبيت Composer (إذا لم يكن مثبتًا بالفعل)
1. تنزيل Composer: قم بتشغيل الأوامر التالية لتنزيل وتثبيت Composer:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" php composer-setup.php php -r "unlink('composer-setup.php');"
2. نقل Composer: انقل Composer إلى دليل يمكن الوصول إليه عالميًا:
mv composer.phar /usr/local/bin/composer
الخطوة 5: تثبيت لارافيل
1. تثبيت لارافيل عبر Composer: قم بتشغيل الأمر التالي لإنشاء مشروع لارافيل جديد:
composer create-project --prefer-dist laravel/laravel myproject
استبدل myproject
باسم المشروع الذي تريده.
الخطوة 6: تكوين لارافيل
1. الانتقال إلى دليل المشروع الخاص بك:
cd myproject
2. إعداد متغيرات البيئة:
- إعادة تسمية .env.example
إلى .env
:
cp .env.example .env
- تعديل ملف .env
لمطابقة بيانات اعتماد قاعدة البيانات الخاصة بك:
DB_DATABASE=your_database_name DB_USERNAME=your_database_user DB_PASSWORD=your_database_password
3. إنشاء مفتاح تطبيق:
php artisan key:generate
الخطوة 7: إعداد خادم الويب
1. تعديل مجلد public: تأكد من أن تثبيت لارافيل يشير إلى دليل public
. في cPanel، قد تحتاج إلى ضبط الجذر المستند الخاص بالنطاق أو النطاق الفرعي للإشارة إلى myproject/public
.
2. تكوين ملف .htaccess: تأكد من أن ملف .htaccess
في دليل public
يحتوي على الإعدادات الصحيحة لـ mod_rewrite. يجب أن يبدو شيئًا مثل هذا:
<IfModule mod_rewrite.c> <IfModule mod_negotiation.c> Options -MultiViews -Indexes </IfModule> RewriteEngine On # Handle Authorization Header RewriteCond %{HTTP:Authorization} . RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}] # Redirect Trailing Slashes If Not A Folder... RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_URI} (.+)/$ RewriteRule ^ %1 [L,R=301] # Send Requests To Front Controller... RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L] </IfModule>
الخطوة 8: ضبط الأذونات
1. ضبط الأذونات الصحيحة: تأكد من أن دلائل storage
و bootstrap/cache
قابلة للكتابة:
chmod -R 775 storage chmod -R 775 bootstrap/cache
الخطوة 9: اختبار التثبيت
1. الوصول إلى تطبيق لارافيل الخاص بك: افتح متصفح الويب وانتقل إلى نطاقك أو نطاقك الفرعي. يجب أن ترى صفحة الترحيب الخاصة بلارافيل.
استكشاف الأخطاء وإصلاحها
- 500 Internal Server Error: تحقق من سجلات الخادم وتأكد من ضبط جميع الأذونات بشكل صحيح.
- مشاكل الاتصال بقاعدة البيانات: تحقق من ملف .env
الخاص بك للحصول على بيانات اعتماد قاعدة البيانات الصحيحة.
باتباع هذه الخطوات، يجب أن يكون لديك تثبيت لارافيل بنجاح على استضافة cPanel الخاصة بك. إذا واجهت أي مشاكل، استشر وثائق مزود الاستضافة أو فريق الدعم للحصول على مساعدة إضافية.