* Illuminate\Database 를 이용해 데이터 연결
* 다중 database 연결/Transaction 지원
* 각 package, plugin 에서 database connection 을 선택적으로 이용 할 수 있도록 지원
* xe.php 의 database config 설정
- laravel database config 를 이용해서 Database 연결
* Illuminate\Database 의 인터페이스 지원
- 다중 connection, proxy 처리를 위해 추가 인터페이스 지원
## app binding
* xe.db 로 바인딩 되어 있음
* XeDB facade 제공
## interception
* XeDB
## 사용법
### Database connection
* 기본 설정으로 되어 있는 database connect
* database.php 의 default 설정으로 연결
php
VirtualConnectionInterface
$connector = XeDB::connection();
* xe.php 의 database config 'configName' 설정으로 되어 있는 database connect
php
$connector = XeDB::connection('configName');
### Transaction
* VirtualConnection 통해 TransactionHandler 에서 처리
* 모든 Connection 에 transaction 처리됨
php
XeDB::beginTransaction();
XeDB::commit();
XeDB::rollBack();
### Query
* Database 에 query 하기 위해서 VirtualConnectionInterface 의 table(), dynamic() 메소드 사용
* table(), dynamic() 은 DynamicQuery 반환
* DynamicQuery 는 Illuminate\Database\Query\Builder 사용
* dynamic() 은 ProxyManager 를 사용하도록 함 (DynamicField 의 DatabaseProxy 참고)
php
$connector = app('xe.db');
$query = XeDB::table('user');
$result = XeDB::table('user')->first();
$proxyConfig = [... config for proxy ...];
$query = XeDB::dynamic('tableName', $proxyConfig);
/** * Execute the console command. * * @return mixed */ public function fire() { $tables = $this->input->getOption('tables'); if ($tables == false) { $this->error('캐시를 위한 테이블 이름이 없습니다.'); } $tables = explode(',', $tables); if (count($tables) == 0) { $this->error('캐시를 위한 테이블 이름이 없습니다.'); } $config = $this->databaseHandler->getConfig(); // 어떤 connection 에 table 이 있는지 알 수 없음 $connectors = []; foreach ($config as $name => $settings) { $connectors[] = $this->databaseHandler->connection($name); } $cacheNames = []; /** @var \Xpressengine\Database\VirtualConnectionInterface $connector */ foreach ($connectors as $connector) { foreach ($tables as $table) { if (in_array($table, $cacheNames) === true) { continue; } if ($connector->setSchemaCache($table, true) === true) { $cacheNames[] = $table; } } } if (count($cacheNames) === 0) { $this->error('캐시된 테이블이 없습니다. 테이블 이름을 확인하세요.'); } else { $this->info(implode(',', array_unique($cacheNames)) . ' 테이블을 캐시 했습니다.'); } }
/** * test database connect * * @return void */ public function testDatabaseConnect() { $defaultConnection = m::mock('Illuminate\\Database\\Connection'); $defaultConnection->shouldReceive('getName')->andReturn('default'); $databaseManager = m::mock('Illuminate\\Database\\DatabaseManager'); $databaseManager->shouldReceive('getDefaultConnection')->andReturn($defaultConnection); $databaseManager->shouldReceive('setDefaultConnection'); $queryBuilder = m::mock('Xpressengine\\Database\\DynamicQuery'); $defaultConnector = m::mock('Xpressengine\\Database\\VirtualConnection'); $defaultConnector->shouldReceive('getName')->andReturn('default'); $defaultConnector->shouldReceive('table')->andReturn($queryBuilder); $someConnector = m::mock('Xpressengine\\Database\\VirtualConnection'); $someConnector->shouldReceive('getName')->andReturn('some'); $coupler = m::mock('Xpressengine\\Database\\DatabaseCoupler'); $coupler->shouldReceive('getConnector')->with(DatabaseHandler::DEFAULT_CONNECTOR_NAME)->andReturn($defaultConnector); $coupler->shouldReceive('getConnector')->with('some')->andReturn($someConnector); $coupler->shouldReceive('addConnector')->with('default', $defaultConnector)->andReturn($defaultConnector); $coupler->shouldReceive('addConnector')->with('some', $someConnector)->andReturn($someConnector); $coupler->shouldReceive('databaseManager')->andReturn($databaseManager); /** @var \Xpressengine\Database\DatabaseCoupler $coupler */ $handler = new DatabaseHandler($coupler, $this->databaseConfig); // make default connector $connector = $handler->connection(); $this->assertInstanceOf('Xpressengine\\Database\\VirtualConnection', $connector); $this->assertEquals('default', $connector->getName()); $connection = $handler->getDefaultConnection(); $this->assertInstanceOf('Illuminate\\Database\\Connection', $connection); $this->assertEquals('default', $connection->getName()); $handler->setDefaultConnection('some1_con'); // test magic method $queryBuilder = $handler->table('table'); $this->assertInstanceOf('Xpressengine\\Database\\DynamicQuery', $queryBuilder); }