adamb / database
A simple PDO Wrapper to connect to a database
Installs: 7 468
Dependents: 20
Suggesters: 0
Security: 0
Stars: 17
Watchers: 2
Forks: 5
Open Issues: 0
Requires (Dev)
This package is auto-updated.
Last update: 2024-10-30 01:53:42 UTC
README
PDO Database Abstraction Layer
A simple database abstraction layer for MySQL PDO
Installation
Installation is available via Composer/Packagist, you can add the following line to your composer.json
file:
"adamb/database": "^1.0"
or
composer require adamb/database
Class Features
- Optional cache support with Memcache / Memcached / Redis / XCache
- Optional connection to secondary database incase the no connection to the primary MySQL server is available
- Connects to a MySQL database via PDO
- Simplify queries to SELECT / INSERT / UPDATE and DELETE
- Built in prepared statements
- Compatible with PHP5.6 and later
License
This software is distributed under the MIT license. Please read LICENSE for information on the software availability and distribution.
Usage
Example of usage can be found below with what queries they would result in (For security all queries are run using prepared statements with values added on execute() after the prepare() has been run)
1. Connect
<?php $hostname = '127.0.0.1'; $username = 'root'; $password = ''; $database = 'my_db'; $backup_server = '127.0.0.2'; // Connect to a single MySQL server $db = new DBAL\Database($hostname, $username, $password, $database); // Connect to MySQL server and is primary server is down connect to secondary server $db = new DBAL\Database($hostname, $username, $password, $database, $backup_server);
2. Select
$db->select('test_table'); // Query Run = "SELECT * FROM `test_table` LIMIT 1;" $db->select('test_table', array('id' => 3)); // Query Run = "SELECT * FROM `test_table` WHERE `id` = 3 LIMIT 1;" $db->select('test_table', array('id' => array('>=', 3))); // Query Run = "SELECT * FROM `test_table` WHERE `id` >= 3 LIMIT 1;" $db->select('test_table', array('id' => array('>=', 3)), array('name', 'email')); // Query Run = "SELECT `name`, `email` FROM `test_table` WHERE `id` >= 3 LIMIT 1;" $db->select('test_table', array('id' => array('>=', 3)), array('name', 'email'), array('id' => 'DESC')); // Query Run = "SELECT `name`, `email` FROM `test_table` WHERE `id` >= 3 ORDER BY `id` DESC LIMIT 1;" // Usage of IN or NOT IN operator $db->select('test_table', array('id' => array('IN' => array(1, 2, 3)))); // Query Run = "SELECT * FROM `test_table` WHERE `id` IN (1,2,3) LIMIT 1;" $db->select('test_table', array('id' => array('NOT IN' => array(2, 3)))); // Query Run = "SELECT * FROM `test_table` WHERE `id` NOT IN (2,3) LIMIT 1;" // Usage of BETWEEN or NOT BETWEEN operator $db->select('test_table', array('id' => array('BETWEEN' => array(1, 3)))); // Query Run = "SELECT * FROM `test_table` WHERE `id` BETWEEN 1 AND 3 LIMIT 1;" $db->select('test_table', array('id' => array('NOT BETWEEN' => array(2, 10)))); // Query Run = "SELECT * FROM `test_table` WHERE `id` NOT BETWEEN 2 AND 10 LIMIT 1;" // The same functions can be run using selectAll() rather than select() $db->selectAll('test_table', array('id' => array('>=', 3)), array('name', 'email'), array('id' => 'DESC'), 150); // Query Run = "SELECT `name`, `email` FROM `test_table` WHERE `id` >= 3 ORDER BY `id` DESC LIMIT 150;" // Usage // select($table, $where = array('field_name' => $value), $selectfield = array('field_1', 'field_2'), $order = array('field_name' => 'ASC' or 'DESC') or RAND()); // selectAll($table, $where = array('field_name' => $value), $selectfield = array('field_1', 'field_2'), $order = array('field_name' => 'ASC' or 'DESC') or RAND(), $limit(default = no limit));
3. Insert
$db->insert('test_table', array('name' => 'Bob', 'email' => 'bob@gmail.com')); // Query Run = "INSERT INTO `test_table` (`name`, `email`) VALUES ('Bob', 'bob@gmail.com');" // Usage // insert($table, array('field_name' => $value));
4. Update
$db->update('test_table', array('name' => 'Ken', 'email' => 'ken@gmail.com'), array('id' => 12345)); // Query Run = "UPDATE `test_table` SET (`name` => 'Ken', `email` => 'ken@gmail.com') WHERE `id` = 12345;" $db->update('test_table', array('name' => 'Ken'), array('name' => 'Bob'), 50); // Query Run = "UPDATE `test_table` SET (`name` => 'Ken') WHERE `name` = 'Bob' LIMIT 50;" // Usage // update($table, $updatevalues = array('field_name' => $value), $where = array('field' => $value));
5. Delete
$db->delete('test_table', array('id' => 1)); // Query Run = "DELETE FROM `test_table` WHERE `id` = 1;" $db->delete('test_table', array('name' => 'Ted'), 50); // Query Run = "DELETE FROM `test_table` WHERE `name` = 'Ted' LIMIT 50;" // Usage // delete($table, $where = array('field' => $value), $limit);
6. Count
$db->count('test_table'); // Query Run = "SELECT COUNT(*) FROM `test_table`;"; $db->count('test_table', array('name' => 'Bob')); // Query Run = "SELECT COUNT(*) FROM `test_table` WHERE `name` => 'Bob';"; // Usage // count($table, $where = array('field' => $value));
7. Query
Any other queries can be run using the query command by passing the SQL query and values
$db->query("SELECT * FROM `test_table` WHERE `name` = ? OR `name` => ?;", array('John', 'Phil')); // Query Run = "SELECT * FROM `test_table` WHERE `name` = 'John' OR `name` => 'Phil';"; $db->query("UPDATE `test_table` SET `name` = 'Karl' WHERE `name` = ? OR `name` => ?;", array('John', 'Phil')); // Query Run = "UPDATE `test_table` SET `name` = 'Karl' WHERE `name` = 'John' OR `name` => 'Phil';"; $db->query("SELECT * FROM `test_table` WHERE `field1` = ? AND (`field2` => ? OR `field3` => ?);", array('value1', 'value2', 'value3')); // Query Run = "SELECT * FROM `test_table` WHERE `field1` = 'value1' AND (`field2` => 'value2' OR `field3` => 'value3');"; # UNION $db->query("SELECT * FROM `test_table` WHERE `field1` = ? UNION SELECT * FROM `another_table` WHERE `another_field` = ?;", array('value1', 'value2')); // Query Run = SELECT * FROM `test_table` WHERE `field1` = 'value1' UNION SELECT * FROM `another_table` WHERE `another_field` = 'value2';"; $db->query("SELECT * FROM `test_table` WHERE `field1` = :search UNION SELECT * FROM `another_table` WHERE `another_field` = :search;", array(':search' => 'value1')); // Query Run = SELECT * FROM `test_table` WHERE `field1` = 'value1' UNION SELECT * FROM `another_table` WHERE `another_field` = 'value1';"; # JOIN $db->query("SELECT `test_table`.`field1`, `test_table`.`field2`, `another_table`.`field1` FROM `test_table` INNER JOIN `another_table` ON `test_table`.`reference_field` = `another_table`.`some_field`;"); // Query Run = SELECT `test_table`.`field1`, `test_table`.`field2`, `another_table`.`field1` FROM `test_table` INNER JOIN `another_table` ON `test_table`.`reference_field` = `another_table`.`some_field`;"; $db->query("SELECT `test_table`.`field1`, `test_table`.`field2`, `another_table`.`field1` FROM `test_table` INNER JOIN `another_table` ON `test_table`.`reference_field` = `another_table`.`some_field` AND `test_table`.`field1` <= ? LIMIT 100;", array('value')); // Query Run = SELECT `test_table`.`field1`, `test_table`.`field2`, `another_table`.`field1` FROM `test_table` INNER JOIN `another_table` ON `test_table`.`reference_field` = `another_table`.`some_field` AND `test_table`.`field1` <= 'value' LIMIT 100;";
8. FetchColumn
// This is similar to the select method except return the column value rather than an array of all of the fields $column = $db->fetchColumn('test_table', array('id' => 3), array('name', 'email')); // Query Run = "SELECT `name`, `email` FROM `test_table` WHERE `id` = 3 LIMIT 1;" echo($column[0]); // will return the name field echo($column[1]); // will return the email field $column = $db->fetchColumn('test_table', array('id' => 3), array('name', 'email'), 1); echo($column); // will return email as the field number of 1 has been set
9. NumRows
$db->numRows(); $db->rowCount(); // Running either of these methods after executing a query will show you how many rows have been affected e.g. $db->update('test_table', array('name' => 'Ken'), array('name' => 'Bob')); echo($db->numRows()); // Returns number of results updated e.g. 12
10. LastInsertId
$db->insert('test_table', array('name' => 'Bob', 'email' => 'bob@gmail.com')); echo($db->lastInsertId()); // Returns the key field value number normally the the auto increment field value
11. isConnected
$db->isConnected(); // Returns true of false depending on if the connection is active to the server
12. Caching
Database caching can be added to queries with support for Memcache / Memcached / Redis and XCache
$caching = new DBAL\Caching\Memcached(); $db = new DBAL\Database($hostname, $username, $password, $database, $backup_server, $caching); // OR $caching = new DBAL\Caching\Memcached(); $db = new DBAL\Database($hostname, $username, $password, $database); $db->setCaching($caching);