mirror of
https://github.com/dg/dibi.git
synced 2025-02-22 18:02:25 +01:00
140 lines
4.1 KiB
Markdown
140 lines
4.1 KiB
Markdown
[Dibi](https://dibiphp.com) - smart database layer for PHP [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=9XXL5ZJHAYQUN)
|
|
=========================================================
|
|
|
|
[](https://packagist.org/packages/dibi/dibi)
|
|
[](https://travis-ci.org/dg/dibi)
|
|
[](https://ci.appveyor.com/project/dg/dibi/branch/master)
|
|
[](https://github.com/dg/dibi/releases)
|
|
[](https://github.com/dg/dibi/blob/master/license.md)
|
|
|
|
|
|
Introduction
|
|
------------
|
|
|
|
Database access functions in PHP are not standardised. This library
|
|
hides the differences between them, and above all, it gives you a very handy interface.
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
The recommended way to install Dibi is via Composer (alternatively you can [download package](https://github.com/dg/dibi/releases)):
|
|
|
|
```bash
|
|
composer require dibi/dibi
|
|
```
|
|
|
|
The Dibi 4.0 requires PHP version 7.1 and supports PHP up to 7.2. Older Dibi 3.x requires PHP 5.4 and supports PHP up to 7.2.
|
|
|
|
|
|
Usage
|
|
-----
|
|
|
|
Refer to the `examples` directory for examples. Dibi documentation is
|
|
available on the [homepage](https://dibiphp.com).
|
|
|
|
Connect to database:
|
|
|
|
```php
|
|
$dibi = new Dibi\Connection([
|
|
'driver' => 'mysqli',
|
|
'host' => 'localhost',
|
|
'username' => 'root',
|
|
'password' => '***',
|
|
]);
|
|
|
|
|
|
// or static way; in all other examples use dibi:: instead of $dibi->
|
|
dibi::connect($options);
|
|
```
|
|
|
|
SELECT, INSERT, UPDATE
|
|
|
|
```php
|
|
$dibi->query('SELECT * FROM users WHERE id = ?', $id);
|
|
|
|
$arr = [
|
|
'name' => 'John',
|
|
'is_admin' => true,
|
|
];
|
|
$dibi->query('INSERT INTO users', $arr);
|
|
// INSERT INTO users (`name`, `is_admin`) VALUES ('John', 1)
|
|
|
|
$dibi->query('UPDATE users SET', $arr, 'WHERE `id`=?', $x);
|
|
// UPDATE users SET `name`='John', `is_admin`=1 WHERE `id` = 123
|
|
|
|
$dibi->query('UPDATE users SET', [
|
|
'title' => array('SHA1(?)', 'tajneheslo'),
|
|
]);
|
|
// UPDATE users SET 'title' = SHA1('tajneheslo')
|
|
```
|
|
|
|
Getting results
|
|
|
|
```php
|
|
$result = $dibi->query('SELECT * FROM users');
|
|
|
|
$value = $result->fetchSingle(); // single value
|
|
$all = $result->fetchAll(); // all rows
|
|
$assoc = $result->fetchAssoc('id'); // all rows as associative array
|
|
$pairs = $result->fetchPairs('customerID', 'name'); // all rows as key => value pairs
|
|
|
|
// iterating
|
|
foreach ($result as $n => $row) {
|
|
print_r($row);
|
|
}
|
|
```
|
|
|
|
Modifiers for arrays:
|
|
|
|
```php
|
|
$dibi->query('SELECT * FROM users WHERE %and', [
|
|
array('number > ?', 10),
|
|
array('number < ?', 100),
|
|
]);
|
|
// SELECT * FROM users WHERE (number > 10) AND (number < 100)
|
|
```
|
|
|
|
<table>
|
|
<tr><td> %and </td><td> </td><td> `[key]=val AND [key2]="val2" AND ...` </td></tr>
|
|
<tr><td> %or </td><td> </td><td> `[key]=val OR [key2]="val2" OR ...` </td></tr>
|
|
<tr><td> %a </td><td> assoc </td><td> `[key]=val, [key2]="val2", ...` </td></tr>
|
|
<tr><td> %l %in </td><td> list </td><td> `(val, "val2", ...)` </td></tr>
|
|
<tr><td> %v </td><td> values </td><td> `([key], [key2], ...) VALUES (val, "val2", ...)` </td></tr>
|
|
<tr><td> %m </td><td> multivalues </td><td> `([key], [key2], ...) VALUES (val, "val2", ...), (val, "val2", ...), ...` </td></tr>
|
|
<tr><td> %by </td><td> ordering </td><td> `[key] ASC, [key2] DESC ...` </td></tr>
|
|
<tr><td> %n </td><td> identifiers </td><td> `[key], [key2] AS alias, ...` </td></tr>
|
|
<tr><td> other </td><td> - </td><td> `val, val2, ...` </td></tr>
|
|
</table>
|
|
|
|
|
|
Modifiers for LIKE
|
|
|
|
```php
|
|
$dibi->query("SELECT * FROM table WHERE name LIKE %like~", $query);
|
|
```
|
|
|
|
<table>
|
|
<tr><td> %like~ </td><td> begins with </td></tr>
|
|
<tr><td> %~like </td><td> ends with </td></tr>
|
|
<tr><td> %~like~ </td><td> contains </td></tr>
|
|
</table>
|
|
|
|
DateTime:
|
|
|
|
```php
|
|
$dibi->query('UPDATE users SET', [
|
|
'time' => new DateTime,
|
|
]);
|
|
// UPDATE users SET ('2008-01-01 01:08:10')
|
|
```
|
|
|
|
Testing:
|
|
|
|
```php
|
|
echo dibi::$sql; // last SQL query
|
|
echo dibi::$elapsedTime;
|
|
echo dibi::$numOfQueries;
|
|
echo dibi::$totalTime;
|
|
```
|