إعداد قاعدة البيانات (أسلوب Laravel)

حالة دعم قاعدة البيانات والإصدارات لـ webman/database هي كما يلي:

• MySQL 5.6+
• PostgreSQL 9.4+
• SQLite 3.8.8+
• SQL Server 2017+

موقع ملف إعداد قاعدة البيانات هو config/database.php.

 return [
     // قاعدة البيانات الافتراضية
     'default' => 'mysql',
     // إعدادات قواعد البيانات المختلفة
     'connections' => [

         'mysql' => [
             'driver'      => 'mysql',
             'host'        => '127.0.0.1',
             'port'        => 3306,
             'database'    => 'webman',
             'username'    => 'webman',
             'password'    => '',
             'unix_socket' => '',
             'charset'     => 'utf8',
             'collation'   => 'utf8_unicode_ci',
             'prefix'      => '',
             'strict'      => true,
             'engine'      => null,
             'pool' => [ // إعدادات تجمع الاتصال، تدعم فقط برامج التشغيل swoole/swow
                'max_connections' => 5, // الحد الأقصى لعدد الاتصالات
                'min_connections' => 1, // الحد الأدنى لعدد الاتصالات
                'wait_timeout' => 3,    // الحد الأقصى لوقت الانتظار للحصول على اتصال من تجمع الاتصال، سيتم طرح استثناء بعد انتهاء الوقت
                'idle_timeout' => 60,   // الحد الأقصى لوقت الخمول للاتصال في تجمع الاتصال، سيتم إغلاقه واسترداده بعد انتهاء الوقت، حتى يكون عدد الاتصالات هو min_connections
                'heartbeat_interval' => 50, // وقت التحقق من صحة الاتصال في تجمع الاتصال، بالثواني، يُوصى بأن يكون أقل من 60 ثانية
            ],
         ],

         'sqlite' => [
             'driver'   => 'sqlite',
             'database' => '',
             'prefix'   => '',
             'pool' => [ // إعدادات تجمع الاتصال، تدعم فقط برامج التشغيل swoole/swow
                'max_connections' => 5, // الحد الأقصى لعدد الاتصالات
                'min_connections' => 1, // الحد الأدنى لعدد الاتصالات
                'wait_timeout' => 3,    // الحد الأقصى لوقت الانتظار للحصول على اتصال من تجمع الاتصال، سيتم طرح استثناء بعد انتهاء الوقت
                'idle_timeout' => 60,   // الحد الأقصى لوقت الخمول للاتصال في تجمع الاتصال، سيتم إغلاقه واسترداده بعد انتهاء الوقت، حتى يكون عدد الاتصالات هو min_connections
                'heartbeat_interval' => 50, // وقت التحقق من صحة الاتصال في تجمع الاتصال، بالثواني، يُوصى بأن يكون أقل من 60 ثانية
            ],
         ],

         'pgsql' => [
             'driver'   => 'pgsql',
             'host'     => '127.0.0.1',
             'port'     => 5432,
             'database' => 'webman',
             'username' => 'webman',
             'password' => '',
             'charset'  => 'utf8',
             'prefix'   => '',
             'schema'   => 'public',
             'sslmode'  => 'prefer',
             'pool' => [ // إعدادات تجمع الاتصال، تدعم فقط برامج التشغيل swoole/swow
                'max_connections' => 5, // الحد الأقصى لعدد الاتصالات
                'min_connections' => 1, // الحد الأدنى لعدد الاتصالات
                'wait_timeout' => 3,    // الحد الأقصى لوقت الانتظار للحصول على اتصال من تجمع الاتصال، سيتم طرح استثناء بعد انتهاء الوقت
                'idle_timeout' => 60,   // الحد الأقصى لوقت الخمول للاتصال في تجمع الاتصال، سيتم إغلاقه واسترداده بعد انتهاء الوقت، حتى يكون عدد الاتصالات هو min_connections
                'heartbeat_interval' => 50, // وقت التحقق من صحة الاتصال في تجمع الاتصال، بالثواني، يُوصى بأن يكون أقل من 60 ثانية
            ],
         ],

         'sqlsrv' => [
             'driver'   => 'sqlsrv',
             'host'     => 'localhost',
             'port'     => 1433,
             'database' => 'webman',
             'username' => 'webman',
             'password' => '',
             'charset'  => 'utf8',
             'prefix'   => '',
             'pool' => [ // إعدادات تجمع الاتصال، تدعم فقط برامج التشغيل swoole/swow
                'max_connections' => 5, // الحد الأقصى لعدد الاتصالات
                'min_connections' => 1, // الحد الأدنى لعدد الاتصالات
                'wait_timeout' => 3,    // الحد الأقصى لوقت الانتظار للحصول على اتصال من تجمع الاتصال، سيتم طرح استثناء بعد انتهاء الوقت
                'idle_timeout' => 60,   // الحد الأقصى لوقت الخمول للاتصال في تجمع الاتصال، سيتم إغلاقه واسترداده بعد انتهاء الوقت، حتى يكون عدد الاتصالات هو min_connections
                'heartbeat_interval' => 50, // وقت التحقق من صحة الاتصال في تجمع الاتصال، بالثواني، يُوصى بأن يكون أقل من 60 ثانية
            ],
         ],
     ],
 ];

استخدام قواعد بيانات متعددة

يمكنك استخدام Db::connection('اسم الإعداد') لاختيار أي قاعدة بيانات تريد استخدامها، حيث اسم الإعداد هو المفتاح المقابل في ملف الإعداد config/database.php.

على سبيل المثال، إعدادات قاعدة البيانات كما يلي:

 return [
     // قاعدة البيانات الافتراضية
     'default' => 'mysql',
     // إعدادات قواعد البيانات المختلفة
     'connections' => [

         'mysql' => [
             'driver'      => 'mysql',
             'host'        =>   '127.0.0.1',
             'port'        => 3306,
             'database'    => 'webman',
             'username'    => 'webman',
             'password'    => '',
             'unix_socket' =>  '',
             'charset'     => 'utf8',
             'collation'   => 'utf8_unicode_ci',
             'prefix'      => '',
             'strict'      => true,
             'engine'      => null,
         ],

         'mysql2' => [
              'driver'      => 'mysql',
              'host'        => '127.0.0.1',
              'port'        => 3306,
              'database'    => 'webman2',
              'username'    => 'webman2',
              'password'    => '',
              'unix_socket' => '',
              'charset'     => 'utf8',
              'collation'   => 'utf8_unicode_ci',
              'prefix'      => '',
              'strict'      => true,
              'engine'      => null,
         ],
         'pgsql' => [
              'driver'   => 'pgsql',
              'host'     => '127.0.0.1',
              'port'     =>  5432,
              'database' => 'webman',
              'username' =>  'webman',
              'password' => '',
              'charset'  => 'utf8',
              'prefix'   => '',
              'schema'   => 'public',
              'sslmode'  => 'prefer',
          ],
 ];

تبديل قواعد البيانات بهذا الشكل.

// استخدام قاعدة البيانات الافتراضية، مما يعادل Db::connection('mysql')->table('users')->where('name', 'John')->first();
$users = Db::table('users')->where('name', 'John')->first(); 
// استخدام mysql2
$users = Db::connection('mysql2')->table('users')->where('name', 'John')->first();
// استخدام pgsql
$users = Db::connection('pgsql')->table('users')->where('name', 'John')->first();