Configuración de la base de datos (Estilo Laravel)
La compatibilidad de la base de datos y las versiones de webman/database es la siguiente:
- MySQL 5.6+
- PostgreSQL 9.4+
- SQLite 3.8.8+
- SQL Server 2017+
La ubicación del archivo de configuración de la base de datos es config/database.php.
return [
// Base de datos por defecto
'default' => 'mysql',
// Configuraciones de diversas bases de datos
'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' => [ // Configuración del pool de conexiones, solo soporta los controladores swoole/swow
'max_connections' => 5, // Máximo número de conexiones
'min_connections' => 1, // Número mínimo de conexiones
'wait_timeout' => 3, // Tiempo máximo de espera para obtener una conexión del pool, lanzará una excepción si se agota el tiempo
'idle_timeout' => 60, // Tiempo máximo de inactividad de las conexiones en el pool, cerrará y recuperará conexiones si se agota el tiempo, hasta que el número de conexiones sea min_connections
'heartbeat_interval' => 50, // Tiempo de verificación de latido del pool de conexiones, en segundos, se recomienda que sea menos de 60 segundos
],
],
'sqlite' => [
'driver' => 'sqlite',
'database' => '',
'prefix' => '',
'pool' => [ // Configuración del pool de conexiones, solo soporta los controladores swoole/swow
'max_connections' => 5, // Máximo número de conexiones
'min_connections' => 1, // Número mínimo de conexiones
'wait_timeout' => 3, // Tiempo máximo de espera para obtener una conexión del pool, lanzará una excepción si se agota el tiempo
'idle_timeout' => 60, // Tiempo máximo de inactividad de las conexiones en el pool, cerrará y recuperará conexiones si se agota el tiempo, hasta que el número de conexiones sea min_connections
'heartbeat_interval' => 50, // Tiempo de verificación de latido del pool de conexiones, en segundos, se recomienda que sea menos de 60 segundos
],
],
'pgsql' => [
'driver' => 'pgsql',
'host' => '127.0.0.1',
'port' => 5432,
'database' => 'webman',
'username' => 'webman',
'password' => '',
'charset' => 'utf8',
'prefix' => '',
'schema' => 'public',
'sslmode' => 'prefer',
'pool' => [ // Configuración del pool de conexiones, solo soporta los controladores swoole/swow
'max_connections' => 5, // Máximo número de conexiones
'min_connections' => 1, // Número mínimo de conexiones
'wait_timeout' => 3, // Tiempo máximo de espera para obtener una conexión del pool, lanzará una excepción si se agota el tiempo
'idle_timeout' => 60, // Tiempo máximo de inactividad de las conexiones en el pool, cerrará y recuperará conexiones si se agota el tiempo, hasta que el número de conexiones sea min_connections
'heartbeat_interval' => 50, // Tiempo de verificación de latido del pool de conexiones, en segundos, se recomienda que sea menos de 60 segundos
],
],
'sqlsrv' => [
'driver' => 'sqlsrv',
'host' => 'localhost',
'port' => 1433,
'database' => 'webman',
'username' => 'webman',
'password' => '',
'charset' => 'utf8',
'prefix' => '',
'pool' => [ // Configuración del pool de conexiones, solo soporta los controladores swoole/swow
'max_connections' => 5, // Máximo número de conexiones
'min_connections' => 1, // Número mínimo de conexiones
'wait_timeout' => 3, // Tiempo máximo de espera para obtener una conexión del pool, lanzará una excepción si se agota el tiempo
'idle_timeout' => 60, // Tiempo máximo de inactividad de las conexiones en el pool, cerrará y recuperará conexiones si se agota el tiempo, hasta que el número de conexiones sea min_connections
'heartbeat_interval' => 50, // Tiempo de verificación de latido del pool de conexiones, en segundos, se recomienda que sea menos de 60 segundos
],
],
],
];Uso de múltiples bases de datos
Se utiliza Db::connection('nombre de configuración') para seleccionar qué base de datos usar, donde nombre de configuración es la clave correspondiente de la configuración en el archivo config/database.php.
Por ejemplo, la siguiente configuración de base de datos:
return [
// Base de datos por defecto
'default' => 'mysql',
// Configuraciones de diversas bases de datos
'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',
],
];Así se cambia de base de datos.
// Usando la base de datos por defecto, equivalente a Db::connection('mysql')->table('users')->where('name', 'John')->first();
$users = Db::table('users')->where('name', 'John')->first();;
// Usando mysql2
$users = Db::connection('mysql2')->table('users')->where('name', 'John')->first();
// Usando pgsql
$users = Db::connection('pgsql')->table('users')->where('name', 'John')->first();