إنشاء وتشغيل مشروع Laravel

ما هو Laravel؟

Laravel هو إطار عمل ويب PHP مفتوح المصدر أنشأه المطور Taylor Otwell. يهدف إلى تقديم مجموعة أدوات أنيقة للمطورين لبناء تطبيقات ويب حديثة. يوفر Laravel مجموعة واسعة من الميزات مثل التوجيه، الجلسات، التخزين المؤقت، التوثيق، وغيرها، مما يبسط المهام العامة لتطوير الويب.

الميزات الرئيسية والمزايا في Laravel

• بسيط وأنيق: يتميز Laravel بتركيبه البسيط الأنيق، مما يجعل الكود أكثر قابلية للقراءة والصيانة.
• مجموعة ميزات غنية: تتضمن التوجيه، التوثيق، إدارة الجلسات والتخزين المؤقت، مما يبسط العمل التطويري.
• ORM قوي: يوفر Eloquent ORM تنفيذًا بسيطًا لـ ActiveRecord، مما يسهل العمليات على قاعدة البيانات.
• تصميم نمطي: يسهل إدارة المكتبات والإضافات التابعة للجهات الخارجية عبر مدير الحزم Composer.
• دعم مجتمعي قوي: يمتلك مجتمع مطورين كبير ونظام بيئي غني.

يساعد Laravel المطورين في بناء تطبيقات ويب عالية الجودة وواجهات برمجة التطبيقات بسرعة، ويُستخدم في مشاريع بكل الأحجام من التطبيقات الصغيرة حتى الأنظمة المؤسسية الكبيرة.

استخدام ServBay لإنشاء وتشغيل مشروع Laravel

في هذه المقالة، سنستخدم بيئة PHP المقدمة من ServBay لإنشاء وتشغيل مشروع Laravel. سنستخدم وظيفة "استضافة" الخاصة بـ ServBay لإعداد خادم الويب وتكوين المشروع بسهولة.

انتباه: إذا كنت مستخدمًا سابقًا لـ NGINX أو Apache

يستخدم ServBay بشكل افتراضي خادم الويب Caddy. هناك بعض النقاط الرئيسية الواجب الانتباه إليها عند الانتقال من NGINX وApache إلى ServBay:

1. اعدادات Caddy

   يحتوي ServBay مسبقًا على Caddy والإعدادات المحسنة بشكل افتراضي. يمكن للمطورين إدارة المواقع عبر وظيفة "استضافة" في ServBay دون الحاجة إلى تعديل ملفات إعدادات Caddy يدويًا.

2. قواعد إعادة الكتابة و .htaccess

   في NGINX وApache، يحتاج المطورون عادةً إلى كتابة قواعد إعادة الكتابة وملفات .htaccess بأنفسهم. ولكن، تحتوي اعدادات Caddy في ServBay على قواعد مسبقة الإعداد ما لم تكن هناك حاجة خاصة لذلك.

3. المزيد من المعلومات

   لمزيد من المعلومات، راجع: Rewrite و htaccess، كيفية نقل موقع Apache إلى ServBay، كيفية نقل موقع NGINX إلى ServBay.

إنشاء مشروع Laravel

TIP

يوصي ServBay المطورين بوضع مواقع الويب في الدليل /Applications/ServBay/www لتسهيل الإدارة.

1. تثبيت Composer

   يأتي ServBay مزوداً بـ Composer بشكل افتراضي، لذا لا توجد حاجة لتثبيته منفصلًا.

2. إنشاء مشروع Laravel

   استخدم Composer لإنشاء مشروع Laravel جديد:

   cd /Applications/ServBay/www
   mkdir servbay-laravel-app
   cd servbay-laravel-app
   composer create-project --prefer-dist laravel/laravel .

3. الدخول إلى دليل المشروع

   انتقل إلى الدليل الذي يحتوي على المشروع الجديد:

   cd /Applications/ServBay/www/servbay-laravel-app

التهيئة الأولية

1. توليد مفتاح التطبيق

   يحتاج Laravel إلى مفتاح تطبيق لضمان أمان جلسات المستخدم والبيانات الأخرى المشفرة. يمكن توليد مفتاح التطبيق باستخدام الأمر Artisan:

   php artisan key:generate

2. تكوين متغيرات البيئة

   قم بتكوين معلومات اتصال قاعدة البيانات والمتغيرات البيئة الأخرى في ملف .env. تأكد من إعداد التكوينات التالية بشكل صحيح:

   APP_NAME=Laravel
   APP_ENV=local
   APP_KEY=base64:...
   APP_DEBUG=true
   APP_URL=https://servbay-laravel-test.local
   
   LOG_CHANNEL=stack
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=servbay_laravel_app
   DB_USERNAME=root
   DB_PASSWORD=password

تكوين خادم الويب

باستخدام وظيفة "استضافة" في ServBay، يمكنك الوصول إلى مشروع Laravel عبر خادم الويب. في إعدادات "الاستضافة" في ServBay، قم بإضافة موقع جديد:

• الاسم: My First Laravel Dev Site
• اسم المجال: servbay-laravel-test.local
• نوع الموقع: PHP
• إصدار PHP: اختر 8.3
• دليل الجذر للموقع: /Applications/ServBay/www/servbay-laravel-app/public

لمزيد من التفاصيل حول خطوات الإعداد، راجع إضافة الموقع الأول.

أضف مثال كود

أضف الكود التالي في ملف routes/web.php لتظهر عبارة "Hello ServBay!":

Route::get('/', function () {
    return 'Hello ServBay!';
});

الوصول إلى الموقع

افتح المتصفح وزر https://servbay-laravel-test.local وستظهر الصفحة التي تعرض Hello ServBay!.

مثال NoSQL

مثال Memcached

1. تثبيت امتداد Memcached

   يتم تضمين امتداد Memcached في ServBay بشكل مسبق، وليس هناك حاجة لتثبيته بشكل منفصل.

2. تهيئة Memcached

   قم بتكوين معلومات اتصال Memcached في ملف .env:

   CACHE_STORE=memcached
   MEMCACHED_HOST=127.0.0.1

3. استخدام Memcached

   استخدام الكاش في المتحكم:

   use Illuminate\Support\Facades\Cache;
   
   Route::get('/memcached', function () {
       Cache::put('key', 'value', 600);
       return Cache::get('key');
   });

مثال Redis

1. تثبيت امتداد Redis

   يتم تضمين امتداد Redis في ServBay بشكل مسبق، وليس هناك حاجة لتثبيته بشكل منفصل.

2. تهيئة Redis

   قم بتكوين معلومات اتصال Redis في ملف .env:

   CACHE_STORE=redis
   REDIS_HOST=127.0.0.1
   REDIS_PASSWORD=null
   REDIS_PORT=6379

3. استخدام Redis

   استخدام الكاش في المتحكم:

   use Illuminate\Support\Facades\Redis;
   
   Route::get('/redis', function () {
       Redis::set('key', 'value');
       return Redis::get('key');
   });

مثال قواعد بيانات علائقية

إنشاء بنية قاعدة البيانات وملفات الهجرة

1. إنشاء ملف الهجرة

   استخدم الأمر Artisan لإنشاء ملف الهجرة:

   php artisan make:migration create_accounts_table

2. تعديل ملف الهجرة

   ابحث عن ملف الهجرة الجديد في مجلد database/migrations وقم بتعديله لتعريف بنية جدول قاعدة البيانات:

   public function up()
   {
       Schema::create('accounts', function (Blueprint $table) {
           $table->id();
           $table->string('name');
           $table->string('email')->unique();
           $table->timestamps();
       });
   }

3. تشغيل الهجرة

   استخدم الأمر Artisan لتشغيل الهجرة وإنشاء جدول قاعدة البيانات:

   php artisan migrate

مثال MySQL

1. تكوين MySQL

   قم بتكوين معلومات اتصال MySQL في ملف .env:

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=servbay_laravel_app
   DB_USERNAME=root
   DB_PASSWORD=password

2. كتابة بيانات المستخدم

   في المتحكم، قم بكتابة بيانات المستخدم:

   use Illuminate\Support\Facades\DB;
   
   Route::get('/mysql-add', function () {
       DB::table('accounts')->insert([
           'name' => 'ServBay',
           'email' => '[email protected]',
       ]);
       return 'Account added';
   });

3. استخدام MySQL

   في المتحكم، قم بتنفيذ استعلامات على قاعدة البيانات:

   use Illuminate\Support\Facades\DB;
   
   Route::get('/mysql', function () {
       $users = DB::table('accounts')->get();
       return $users;
   });

مثال PostgreSQL

1. تكوين PostgreSQL

   قم بتكوين معلومات اتصال PostgreSQL في ملف .env:

   DB_CONNECTION=pgsql
   DB_HOST=127.0.0.1
   DB_PORT=5432
   DB_DATABASE=servbay_laravel_app
   DB_USERNAME=root
   DB_PASSWORD=password

2. كتابة بيانات المستخدم

   في المتحكم، قم بكتابة بيانات المستخدم:

   use Illuminate\Support\Facades\DB;
   
   Route::get('/pgsql-add', function () {
       DB::table('accounts')->insert([
           'name' => 'ServBay',
           'email' => '[email protected]',
       ]);
       return 'Account added';
   });

3. استخدام PostgreSQL

   في المتحكم، قم بتنفيذ استعلامات على قاعدة البيانات:

   use Illuminate\Support\Facades\DB;
   
   Route::get('/pgsql', function () {
       $users = DB::table('accounts')->get();
       return $users;
   });

من خلال الخطوات الموضحة أعلاه، تكون قد أنشأت وشغلت مشروع Laravel بنجاح باستخدام الوظائف المقدمة من ServBay وأدرت مشروعك وأوصلته بعدة قواعد بيانات وسحبت البيانات.