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

ما هو FuelPHP؟

FuelPHP هو إطار عمل PHP مرن ومركب، مصمم لتطوير تطبيقات الويب الحديثة. يتبع نمط التصميم HMVC (متحكم العرض الطراز الهرمي)، ويوفر مجموعة كبيرة من الميزات والأدوات التي تُمكّن المطورين من بناء تطبيقات ويب عالية الجودة بسرعة. يشتهر FuelPHP بمرونته، وأدائه العالي، وسهولة تمديده، وهو إطار العمل المفضل لدى العديد من المطورين.

الميزات والفوائد الرئيسية لـ FuelPHP

• بنية HMVC: يدعم نمط التصميم MVC الهرمي، مما يسهل إعادة استخدام الكود والتطوير المركب.
• أداء عالي: يُعرف FuelPHP بأدائه العالي وسرعته الفائقة في معالجة الطلبات المتزامنة العالية.
• سهولة التمديد: يوفر آليات تمديد متعددة، مما يسهل على المطورين إضافة وظائف مخصصة بسهولة.
• أمان: يتضمن ميزات أمان متعددة مثل التحقق من المدخلات، تصفية الإخراج، وحماية CSRF.
• دعم مجتمعي قوي: يحتوي على مجتمع مطورين نشط وملحقات طرف ثالث غنية.

يمكن لـ FuelPHP مساعدة المطورين في بناء تطبيقات ويب عالية الأداء والجودة بسرعة، مما يجعله مناسباً لمشاريع بأحجام مختلفة.

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

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

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

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

1. تكوين Caddy

   يتضمن ServBay خادم Caddy بذاته، وتم تهيئته وضبطه بشكل مثالي. يمكن للمطورين إدارة المواقع عبر ميزة "المضيف" في ServBay دون الحاجة لتعديل ملفات تكوين Caddy يدوياً.

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

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

3. معرفة المزيد

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

إنشاء مشروع FuelPHP

TIP

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

1. تثبيت Composer

   يأتي ServBay مع Composer مثبتاً مسبقًا، لذا لا حاجة لتثبيته بشكل منفصل.

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

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

   cd /Applications/ServBay/www
   mkdir servbay-fuelphp-app
   cd servbay-fuelphp-app
   composer create-project fuel/fuel .

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

   انتقل إلى دليل مشروع FuelPHP الذي تم إنشاؤه حديثًا:

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

إعداد التكوين

1. تكوين اتصال قاعدة البيانات

   قم بتكوين معلومات اتصال قاعدة البيانات في ملف fuel/app/config/development/db.php:

   return [
       'default' => [
           'connection' => [
               'dsn'      => 'mysql:host=localhost;dbname=fuel_dev',
               'username' => 'root',
               'password' => 'root',
           ],
       ],
   ];

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

استخدم ميزة "المضيف" في ServBay للوصول إلى مشروع FuelPHP عبر خادم الويب. في إعدادات "المضيف" في ServBay، أضف مضيفًا جديدًا:

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

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

إضافة كود نموذجي

في ملف fuel/app/classes/controller/welcome.php، قم بإضافة الكود التالي:

use Fuel\Core\Controller;
use Fuel\Core\Response;
use Fuel\Core\Cache;

class Controller_Welcome extends Controller
{
    public function action_index()
    {
        return Response::forge('Hello ServBay!');
    }

    public function action_memcached()
    {
        Cache::set('key', 'Hello Memcached!', 60);
        $value = Cache::get('key');

        return Response::forge($value);
    }

    public function action_redis()
    {
        $redis = \Redis::instance();
        $redis->set('key', 'Hello Redis!');
        $value = $redis->get('key');
        return Response::forge($value);
    }

    public function action_mysql_add()
    {
        \DB::insert('users')->set([
            'name' => 'ServBay',
            'email' => '[email protected]',
        ])->execute();
        return Response::forge('User added');
    }

    public function action_mysql()
    {
        $users = \DB::select()->from('users')->execute()->as_array();
        return Response::forge(json_encode($users));
    }
}

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

افتح المتصفح وانتقل إلى URL التالي:

• https://servbay-fuelphp-test.local: ستشاهد صفحة تعرض الرسالة Hello ServBay!.

أمثلة على قواعد بيانات NoSQL

مثال Memcached

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

   في ServBay، يتم تثبيت امتداد Memcached مسبقًا، ولا حاجة لتثبيت إضافي.

2. تكوين Memcached

   قم بتكوين معلومات اتصال Memcached في ملف fuel/app/config/cache.php:

   return [
       'driver' => 'memcached',
       'memcached' => [
           'cache_id' => 'fuel',
           'servers' => [
               'default' => [
                   'host'   => '127.0.0.1',
                   'port'   => 11211,
                   'weight' => 100,
               ],
           ],
       ],
   ];

3. إضافة مسارات

   أضف المسارات التالية في ملف fuel/app/config/routes.php:

   return array(
       'memcached' => 'welcome/memcached',
   );

4. استخدام Memcached

   استخدم التخزين المؤقت في وحدة التحكم:

   public function action_memcached()
   {
       Cache::set('key', 'Hello Memcached!', 60);
       $value = Cache::get('key');
   
       return Response::forge($value);
   }

5. افتح المتصفح وزر: https://servbay-fuelphp-test.local/memcached

مثال Redis

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

   في ServBay، يتم تثبيت امتداد Redis مسبقًا، ولا حاجة لتثبيت إضافي.

2. تكوين Redis

   قم بتكوين معلومات اتصال Redis في ملف fuel/app/config/redis.php:

   return [
       'driver' => 'redis',
       'redis' => [
           'database' => 'default',
       ],
   ];

3. إضافة مسارات

   أضف المسارات التالية في ملف fuel/app/config/routes.php:

   return array(
       'redis' => 'welcome/redis',
   );

4. استخدام Redis

   استخدم التخزين المؤقت في وحدة التحكم:

   public function action_redis()
   {
       $redis = \Redis::instance();
       $redis->set('key', 'Hello Redis!');
       $value = $redis->get('key');
   
       return Response::forge($value);
   }

5. افتح المتصفح وزر: https://servbay-fuelphp-test.local/redis

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

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

1. إنشاء ملف الترحيل

   استخدم أداة النفط من FuelPHP لإنشاء ملف الترحيل:

   php oil g migration create_users_table

2. تحرير ملف الترحيل

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

   <?php
   namespace Fuel\Migrations;
   
   use Fuel\Core\DBUtil;
   
   class Create_users_table
   {
       public function up()
       {
           DBUtil::create_table('users', [
               'id'          => ['type' => 'int', 'constraint' => 11, 'auto_increment' => true],
               'name'        => ['type' => 'varchar', 'constraint' => 100],
               'email'       => ['type' => 'varchar', 'constraint' => 100, 'unique' => true],
           ], ['id']);
       }
   
       public function down()
       {
           DBUtil::drop_table('users');
       }
   }

3. تشغيل الترحيل

   استخدم أداة النفط من FuelPHP لتشغيل الترحيل وإنشاء جدول قاعدة البيانات:

   php oil refine migrate

مثال MySQL

1. تكوين MySQL

   قم بتكوين معلومات اتصال MySQL في ملف fuel/app/config/development/db.php:

   return [
       'default' => [
           'connection' => [
               'dsn'      => 'mysql:host=localhost;dbname=fuel_dev',
               'username' => 'root',
               'password' => 'root',
           ],
       ],
   ];

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

   أدخل بيانات المستخدم في وحدة التحكم:

   public function action_mysql_add()
   {
       \DB::insert('users')->set([
           'name' => 'ServBay',
           'email' => '[email protected]',
       ])->execute();
   
       return Response::forge('User added');
   }

3. استخدام MySQL

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

   public function action_mysql()
   {
       $users = \DB::select()->from('users')->execute()->as_array();
       return Response::forge(json_encode($users));
   }

من خلال اتباع هذه الخطوات، تكون قد نجحت في إنشاء وتشغيل مشروع FuelPHP واستخدام الميزات التي يوفرها ServBay لإدارة والوصول إلى مشروعك، بالإضافة إلى الاتصال بأنواع متعددة من قواعد البيانات واستدعاء البيانات. نأمل أن تساعدك هذه المقالة على البدء بسرعة مع FuelPHP وتطبيقه في مشاريعك.