เริ่มต้นใช้งาน

ความต้องการ

• PHP 7.3+ พร้อมติดตั้งส่วนขยาย PDO
• ฐานข้อมูล SQL เช่น MySQL, MSSQL, SQLite หรือระบบฐานข้อมูลอื่นที่รองรับโดย PDO
• ตรวจสอบให้แน่ใจว่าได้ติดตั้งและเปิดใช้งานไดรเวอร์ PDO ที่เกี่ยวข้องแล้ว
• ความรู้พื้นฐาน SQL

รายการส่วนขยาย PHP PDO

การติดตั้งไดรเวอร์ PDO สำหรับ PHP

// แก้ไขไฟล์ 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';

การตั้งค่า

// โหลด autoloader ของ Composer
require 'vendor/autoload.php';

// นำเข้า namespace ของ 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' => [
		// ชื่อไดรเวอร์ PDO ที่ใช้ใน DSN
		'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 socket ห้ามใช้พร้อมกับ 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',

	// ไม่บังคับ
	// บังคับให้ Medoo ใช้ไดรเวอร์ dblib สำหรับ MSSQL
	// ค่าเริ่มต้น: 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;