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

ما هو CodeIgniter؟

CodeIgniter هو إطار عمل PHP خفيف الوزن، يُستخدم لتطوير تطبيقات الويب بسرعة وكفاءة. يتبع نمط تصميم MVC (Model-View-Controller)، ويوفر مجموعة غنية من الميزات والأدوات، مما يمكّن المطورين من تطوير تطبيقات ويب عالية الجودة بسرعة. يتميز CodeIgniter ببساطته، أدائه العالي وسهولة تعلمه، وهو الخيار المفضل لدى العديد من المطورين.

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

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

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

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

في هذه المقالة، سنستخدم البيئة التي توفرها ServBay لإنشاء وتشغيل مشروع CodeIgniter. سنستفيد من ميزة "المضيف" الخاصة بـ 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.

إنشاء مشروع CodeIgniter

TIP

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

1. تثبيت Composer

   يأتي ServBay مزودًا بـ Composer ولا يحتاج إلى تثبيت منفصل.

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

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

   cd /Applications/ServBay/www
   mkdir servbay-codeigniter-app
   cd servbay-codeigniter-app
   composer create-project codeigniter4/appstarter .

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

   ادخل إلى دليل مشروع CodeIgniter الذي تم إنشاؤه للتو:

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

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

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

   قم بتكوين معلومات اتصال قاعدة البيانات في ملف app/Config/Database.php:

   public $default = [
       'DSN'      => '',
       'hostname' => '127.0.0.1',
       'username' => 'root',
       'password' => 'password',
       'database' => 'servbay_codeigniter_app',
       'DBDriver' => 'MySQLi',
       'DBPrefix' => '',
       'pConnect' => false,
       'DBDebug'  => (ENVIRONMENT !== 'production'),
       'charset'  => 'utf8mb4',
       'DBCollat' => 'utf8mb4_general_ci',
       'swapPre'  => '',
       'encrypt'  => false,
       'compress' => false,
       'strictOn' => false,
       'failover' => [],
       'port'     => 3306,
   ];

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

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

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

لتفاصيل خطوات الإعداد، يُرجى الرجوع إلى إضافة أول موقع ويب.

إضافة رمز مثال

أضف الكود التالي في ملف app/Controllers/Home.php:

namespace App\Controllers;

use CodeIgniter\Controller;

class Home extends Controller
{
    public function index()
    {
        return 'Hello ServBay!';
    }

    public function memcached()
    {
        $cache = \Config\Services::cache();
        $cache->save('key', 'Hello Memcached!', 60);
        $value = $cache->get('key');
        return $value;
    }

    public function redis()
    {
        $redis = \Config\Services::cache();
        $redis->set('key', 'Hello Redis!');
        $value = $redis->get('key');
        return $value;
    }

    public function mysqlAdd()
    {
        $db = \Config\Database::connect();
        $db->table('users')->insert([
            'name' => 'ServBay',
            'email' => '[email protected]',
        ]);
        return 'User added';
    }

    public function mysql()
    {
        $db = \Config\Database::connect();
        $users = $db->table('users')->get()->getResult();
        return json_encode($users);
    }
}

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

افتح المتصفح وقم بزيارة URL التالية:

• https://servbay-codeigniter-test.local: سترى أن الصفحة تعرض Hello ServBay!.

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

مثال Memcached

1. تثبيت إضافة Memcached

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

2. تكوين Memcached

   قم بتكوين معلومات اتصال Memcached في ملف app/Config/Cache.php:

   public $memcached = [
       'host'   => '127.0.0.1',
       'port'   => 11211,
       'weight' => 1,
   ];

3. استخدام Memcached

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

   public function memcached()
   {
       $cache = \Config\Services::cache();
       $cache->save('key', 'Hello Memcached!', 60);
       $value = $cache->get('key');
       return $value;
   }

4. أضف المسار في ملف app/Config/Routes.php:

   $routes->get('/memcached', 'Home::memcached');

5. افتح المتصفح وقم بزيارة: https://servbay-codeigniter-test.local/memcached

مثال Redis

1. تثبيت إضافة Redis

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

2. تكوين Redis

   قم بتكوين معلومات اتصال Redis في ملف app/Config/Cache.php:

   public string $handler = 'redis';
   
   public $default = [
       'host'     => '127.0.0.1',
       'password' => null,
       'port'     => 6379,
       'timeout'  => 0,
       'database' => 0,
   ];

3. استخدام Redis

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

   public function redis()
   {
       $redis = \Config\Services::cache();
       $redis->save('key', 'Hello Redis!');
       $value = $redis->get('key');
       return $value;
   }

4. أضف المسار في ملف app/Config/Routes.php:

   $routes->get('/redis', 'Home::redis');

5. افتح المتصفح وقم بزيارة: https://servbay-codeigniter-test.local/redis

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

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

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

   استخدم أداة CLI الخاصة بـ CodeIgniter لإنشاء ملف هجرة:

   php spark make:migration create_users_table

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

   في دليل app/Database/Migrations، ابحث عن ملف الهجرة الذي أنشئته حديثًا وقم بتحريره لتعريف بنية الجدول:

   use CodeIgniter\Database\RawSql;
   
   public function up()
   {
       $this->forge->addField([
           'id'          => [
               'type'           => 'INT',
               'constraint'     => 5,
               'unsigned'       => true,
               'auto_increment' => true,
           ],
           'name'       => [
               'type'       => 'VARCHAR',
               'constraint' => '100',
           ],
           'email'      => [
               'type'       => 'VARCHAR',
               'constraint' => '100',
               'unique'     => true,
           ],
           'created_at' => [
               'type' => 'TIMESTAMP',
               'default' => new RawSql('CURRENT_TIMESTAMP'),
           ],
           'updated_at' => [
               'type' => 'TIMESTAMP',
               'default' => new RawSql('CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP'),
           ],
       ]);
       $this->forge->addKey('id', true);
       $this->forge->createTable('users');
   }

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

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

   php spark migrate

مثال MySQL

1. تكوين MySQL

   قم بتكوين معلومات اتصال MySQL في ملف app/Config/Database.php:

   public $default = [
       'DSN'      => '',
       'hostname' => '127.0.0.1',
       'username' => 'root',
       'password' => 'password',
       'database' => 'servbay_codeigniter_app',
       'DBDriver' => 'MySQLi',
       'DBPrefix' => '',
       'pConnect' => false,
       'DBDebug'  => (ENVIRONMENT !== 'production'),
       'charset'  => 'utf8',
       'DBCollat' => 'utf8_general_ci',
       'swapPre'  => '',
       'encrypt'  => false,
       'compress'  => false,
       'strictOn' => false,
       'failover' => [],
       'port'     => 3306,
   ];

2. إضافة المسار

   أضف المسارات التالية في ملف app/Config/Routes.php:

   $routes->get('/mysql-add', 'Home::mysqlAdd');
   $routes->get('/mysql', 'Home::mysql');

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

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

   public function mysqlAdd()
   {
       $db = \Config\Database::connect();
       $db->table('users')->insert([
           'name' => 'ServBay',
           'email' => '[email protected]',
       ]);
       return 'User added';
   }

4. استخدام MySQL

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

   public function mysql()
   {
       $db = \Config\Database::connect();
       $users = $db->table('users')->get()->getResult();
       return json_encode($users);
   }

   افتح المتصفح وقم بزيارة: https://servbay-codeigniter-test.local/mysql-add و https://servbay-codeigniter-test.local/mysql

مثال PostgreSQL

1. تكوين PostgreSQL

   قم بتكوين معلومات اتصال PostgreSQL في ملف app/Config/Database.php:

   public $default = [
       'DSN'      => '',
       'hostname' => '127.0.0.1',
       'username' => 'root',
       'password' => 'password',
       'database' => 'servbay_codeigniter_app',
       'DBDriver' => 'Postgre',
       'DBPrefix' => '',
       'pConnect' => false,
       'DBDebug'  => (ENVIRONMENT !== 'production'),
       'charset'  => 'utf8',
       'DBCollat' => 'utf8_general_ci',
       'swapPre'  => '',
       'encrypt'  => false,
       'compress'  => false,
       'strictOn' => false,
       'failover' => [],
       'port'     => 5432,
   ];

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

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

   php spark make:migration create_users_table

3. تحرير ملف الهجرة

   use CodeIgniter\Database\RawSql;
   
   public function up()
   {
       $this->forge->addField([
           'id'          => [
               'type'           => 'INT',
               'constraint'     => 5,
               'unsigned'       => true,
               'auto_increment' => true,
           ],
           'name'       => [
               'type'       => 'VARCHAR',
               'constraint' => '100',
           ],
           'email'      => [
               'type'       => 'VARCHAR',
               'constraint' => '100',
               'unique'     => true,
           ],
           'created_at' => [
               'type' => 'TIMESTAMP',
               'default' => new RawSql('NOW()'),
           ],
           'updated_at' => [
               'type' => 'TIMESTAMP',
               'default' => new RawSql('NOW()'),
           ],
       ]);
       $this->forge->addKey('id', true);
       $this->forge->createTable('users');
   }

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

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

   php spark migrate

5. إضافة المسار

   أضف المسارات التالية في ملف app/Config/Routes.php:

   $routes->get('/pgsql-add', 'Home::pgsqlAdd');
   $routes->get('/pgsql', 'Home::pgsql');

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

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

   public function pgsqlAdd()
   {
       $db = \Config\Database::connect();
       $db->table('users')->insert([
           'name' => 'ServBay',
           'email' => '[email protected]',
       ]);
       return 'User added';
   }

7. استخدام PostgreSQL

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

   public function pgsql()
   {
       $db = \Config\Database::connect();
       $users = $db->table('users')->get()->getResult();
       return json_encode($users);
   }

   افتح المتصفح وقم بزيارة: https://servbay-codeigniter-test.local/pgsql-add و https://servbay-codeigniter-test.local/pgsql

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