시작하기

요구사항

• PHP 7.3+(PDO 확장이 설치됨)
• MySQL, MSSQL, SQLite 등 지원되는 SQL 데이터베이스
• 해당 PDO 드라이버가 설치되어 활성화되어 있는지 확인하세요.
• 기본 SQL 지식.

PHP PDO 확장 목록

PHP PDO 드라이버 설치

// php.ini를 편집하고 활성화하려는 데이터베이스 확장 앞의 세미콜론을 제거합니다.

// .dll은 Windows에서, .so는 Linux/UNIX에서 사용합니다.

// 변경 전
;extension=php_pdo_mysql.dll
;extension=php_pdo_mysql.so

// 변경 후
extension=php_pdo_mysql.dll
extension=php_pdo_mysql.so

// 파일을 저장한 뒤 PHP 또는 Apache/Nginx를 다시 시작하세요.

// PDO가 올바르게 설치되면 phpinfo()에 표시됩니다.

Composer 설치

수동 설치

require 'Medoo.php';

연결 설정

// Composer의 오토로더를 불러옵니다.
require 'vendor/autoload.php';

// Medoo 네임스페이스를 가져옵니다.
use Medoo\Medoo;

$database = new Medoo([
	// 필수.
	'type' => 'mysql',
	'host' => 'localhost',
	'database' => 'name',
	'username' => 'your_username',
	'password' => 'your_password',

	// 선택 사항.
	'charset' => 'utf8mb4',
	'collation' => 'utf8mb4_general_ci',
	'port' => 3306,

	// 선택 사항: 테이블 프리픽스. 모든 테이블 이름이 PREFIX_table 형식이 됩니다.
	'prefix' => 'PREFIX_',

	// 선택 사항: 쿼리 로그를 활성화합니다. 성능을 위해 기본값은 비활성화입니다.
	'logging' => true,

	// 선택 사항.
	// 오류 모드.
	// PDO가 오류를 보고하는 방식을 정의합니다.
	// PDO::ERRMODE_SILENT (기본값) | PDO::ERRMODE_WARNING | PDO::ERRMODE_EXCEPTION
	// 참고: https://www.php.net/manual/en/pdo.error-handling.php.
	'error' => PDO::ERRMODE_SILENT,

	// 선택 사항.
	// 연결에 사용할 드라이버 옵션입니다.
	// 참고: https://www.php.net/manual/en/pdo.setattribute.php.
	'option' => [
		PDO::ATTR_CASE => PDO::CASE_NATURAL
	],

	// 선택 사항: 데이터베이스 연결이 완료된 뒤 실행할 명령입니다.
	'command' => [
		'SET SQL_MODE=ANSI_QUOTES'
	]
]);

사용자 정의 DSN 연결

DSN 연결 문자열 형식

$database = new Medoo([
	'dsn' => [
		// DSN에 사용할 PDO 드라이버 이름입니다.
		'driver' => 'mydb',
		// DSN 매개변수를 키-값 쌍으로 지정합니다.
		'server' => '12.23.34.45',
		'port' => '8886'
	],
	// 선택 사항: Medoo가 사용할 데이터베이스별 동작을 지정합니다.
	'type' => 'mysql',

	'username' => 'your_username',
	'password' => 'your_password'
]);

// 최종적으로 생성되는 DSN 문자열:
mydb:server=12.23.34.45;port=8886

PDO 인스턴스로 초기화

$pdo = new PDO('mysql:dbname=test;host=127.0.0.1', 'user', 'password');

$database = new Medoo([
	// 이미 초기화되고 연결된 PDO 인스턴스를 재사용합니다.
	'pdo' => $pdo,

	// 선택 사항: Medoo가 사용할 데이터베이스별 동작을 지정합니다.
	'type' => 'mysql'
]);

MySQL의 경우

$database = new Medoo([
	// 선택 사항: MySQL 소켓. server, port와 함께 사용하지 마세요.
	'socket' => '/tmp/mysql.sock',
]);

MariaDB의 경우

$database = new Medoo([
	'type' => 'mariadb',
	'host' => 'localhost',
	'database' => 'name',
	'username' => 'your_username',
	'password' => 'your_password',
]);

MSSQL의 경우

$database = new Medoo([
	'type' => 'mssql',
	'host' => 'localhost',
	'database' => 'name',
	'username' => 'your_username',
	'password' => 'your_password',

	// 선택 사항: 애플리케이션 이름.
	'appname' => 'test',

	// 선택 사항.
	// MSSQL에서 dblib 드라이버를 강제로 사용합니다.
	// 기본값: sqlsrv.
	'driver' => 'dblib'
]);

$database = new Medoo([
	'type' => 'mssql',
	'host' => 'localhost',
	'database' => 'name',
	'username' => 'your_username',
	'password' => 'your_password',

	// 선택 사항: MSSQL 연결 옵션.
	'application_intent' => 'ReadOnly',
	'attach_db_file_name' => './database.sql',
	'authentication' => 'SqlPassword',
	'column_encryption' => 'Enabled',
	'connection_pooling' => 1,
	'encrypt' => 1,
	'failover_partner' => 'MultiSubnetFailover',
	'key_store_authentication' => 'KeyVaultPassword',
	'key_store_principal_id' => 'AzureName',
	'key_store_secret' => 'AzurePass',
	'login_timeout' => '20',
	'multiple_active_result_sets' => 1,
	'multi_subnet_failover' => 'Yes',
	'scrollable' => 'buffered',
	'trace_file' => './path',
	'trace_on' => 1,
	'transaction_isolation' => PDO::SQLSRV_TXN_SNAPSHOT,
	'transparent_network_ip_resolution' => 'Enabled',
	'trust_server_certificate' => 1,
	'wsid' => 'Computer1'
]);

SQLite의 경우

파일 데이터베이스

$database = new Medoo([
	'type' => 'sqlite',
	'database' => 'my/database/path/database.db'
]);

메모리 데이터베이스

$database = new Medoo([
	'type' => 'sqlite',
	'database' => ':memory:'
]);

임시 데이터베이스

$database = new Medoo([
	'type' => 'sqlite',
	'database' => ''
]);

// 또는 database 옵션 자체를 생략할 수도 있습니다.
$database = new Medoo([
	'type' => 'sqlite'
]);

DSN 문자열 디버그

$database = new Medoo([
	'type' => 'mysql',
	'host' => '127.0.0.1',
	'database' => 'test',
	'username' => 'your_username',
	'password' => 'your_password',
]);

echo $database->info()['dsn'];

// mysql:dbname=test;host=127.0.0.1

테스트 모드

$database = new Medoo([
	'testMode' => true
]);

// 데이터베이스 유형을 설정합니다.
$database->type = 'mysql';

$database->select("account", ["user_name"], ["user_id[>]" => 10]);

echo $database->queryString;