Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lincanbin/php-pdo-mysql-class
A PHP MySQL PDO class similar to the the Python MySQLdb, which supports iterator and parameter binding when using "WHERE IN" statement.
https://github.com/lincanbin/php-pdo-mysql-class
iterator iterator-pattern mysql pdo php
Last synced: about 17 hours ago
JSON representation
A PHP MySQL PDO class similar to the the Python MySQLdb, which supports iterator and parameter binding when using "WHERE IN" statement.
- Host: GitHub
- URL: https://github.com/lincanbin/php-pdo-mysql-class
- Owner: lincanbin
- License: apache-2.0
- Created: 2014-11-09T15:40:02.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2020-12-01T03:14:41.000Z (almost 4 years ago)
- Last Synced: 2024-11-13T02:41:49.527Z (4 days ago)
- Topics: iterator, iterator-pattern, mysql, pdo, php
- Language: PHP
- Homepage:
- Size: 62.5 KB
- Stars: 244
- Watchers: 27
- Forks: 113
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
PHP-PDO-MySQL-Class [](https://travis-ci.org/lincanbin/PHP-PDO-MySQL-Class)
===================
A PHP MySQL PDO class similar to the Python MySQLdb,
which supports iterator and parameter binding when using "WHERE IN" statement.
* [Install](#install)
* [Initialize](#initialize)
* [Preventing SQL Injection Attacks](#preventing-sql-injection-attacks)
* [Basic Usage](#basic-usage)
* [Transaction](#transaction)
* [Iterator](#iterator)
Install
------------
Copy the files under `src/` to your program
OR
```
composer require lincanbin/php-pdo-mysql-class
```
Initialize
------------
```php
```
Preventing SQL Injection Attacks
------------
#### Safety: Use parameter binding method
Safety Example:
```php
query("SELECT * FROM fruit WHERE name=?", array($_GET['name']));
?>
```
#### Unsafety: Split joint SQL string
Unsafety Example:
```php
query("SELECT * FROM fruit WHERE name=".$_GET['name']);
?>
```
Basic Usage
------------
#### table "fruit"
| id | name | color
|:-----------:|:------------:|:------------:|
| 1 | apple | red
| 2 | banana | yellow
| 3 | watermelon| green
| 4 | pear | yellow
| 5 | strawberry| red
#### Fetching with Bindings (ANTI-SQL-INJECTION):
```php
query("SELECT * FROM fruit WHERE name=? and color=?",array('apple','red'));
$DB->query("SELECT * FROM fruit WHERE name=:name and color=:color",array('name'=>'apple','color'=>'red'));
?>
```
Result:
```php
Array
(
[0] => Array
(
[id] => 1
[name] => apple
[color] => red
)
)
```
#### WHERE IN (needs named placeholder):
```php
query("SELECT * FROM fruit WHERE name IN (:fruits)",array(array('apple','banana')));
?>
```
Result:
```php
Array
(
[0] => Array
(
[id] => 1
[name] => apple
[color] => red
)
[1] => Array
(
[id] => 2
[name] => banana
[color] => yellow
)
)
```
```php
"red",
"fruits" => array(
"apple",
"banana"
)
);
$DB->query($query, $params);
?>
```
Result:
```php
Array
(
[0] => Array
(
[id] => 1
[name] => apple
[color] => red
)
)
```
#### Fetching Column:
```php
column("SELECT color FROM fruit WHERE name IN (:color)",array('apple','banana','watermelon'));
?>
```
Result:
```php
Array
(
[0] => red
[1] => yellow
[2] => green
)
```
#### Fetching Row:
```php
row("SELECT * FROM fruit WHERE name=? and color=?",array('apple','red'));
?>
```
Result:
```php
Array
(
[id] => 1
[name] => apple
[color] => red
)
```
#### Fetching single:
```php
single("SELECT color FROM fruit WHERE name=? ",array('watermelon'));
?>
```
Result:
```php
green
```
#### Delete / Update / Insert
These operations will return the number of affected result set. (integer)
```php
query("DELETE FROM fruit WHERE id = :id", array("id"=>"1"));
$DB->query("DELETE FROM fruit WHERE id = ?", array("1"));
// Update
$DB->query("UPDATE fruit SET color = :color WHERE name = :name", array("name"=>"strawberry","color"=>"yellow"));
$DB->query("UPDATE fruit SET color = ? WHERE name = ?", array("yellow","strawberry"));
// Insert
$DB->query("INSERT INTO fruit(id,name,color) VALUES(?,?,?)", array(null,"mango","yellow"));//Parameters must be ordered
$DB->query("INSERT INTO fruit(id,name,color) VALUES(:id,:name,:color)", array("color"=>"yellow","name"=>"mango","id"=>null));//Parameters order free
?>
```
#### Get Last Insert ID
```php
lastInsertId();
?>
```
#### Get the number of queries since the object initialization
```php
querycount;
?>
```
#### Close Connection
```php
closeConnection();
?>
```
Transaction
------------
```php
beginTransaction();
var_dump($DB->inTransaction()); // print "true"
$DB->commit();
} catch(Exception $ex) {
// handle Error
$DB->rollBack();
}
?>
```
Iterator
------------
**Use iterator** when you want to read thousands of data from the database for statistical or full update of Elastic Search or Solr indexes.
[Iterator](https://secure.php.net/manual/en/class.iterator.php) is a traversable object that does not read all the data queried from MySQL into memory.
So you can safely use `foreach` to handle millions of MySQL result sets without worrying about excessive memory usage.
Example:
```php
$iteratorInstance = $DB->iterator("SELECT * FROM fruit limit 0, 1000000;");
$colorCountMap = array(
'red' => 0,
'yellow' => 0,
'green' => 0
);
foreach($iteratorInstance as $key => $value) {
sendDataToElasticSearch($key, $value);
$colorCountMap[$value['color']]++;
}
var_export($colorCountMap);
```
Return:
```php
array(3) {
[red] => 2
[yellow] => 2
[green] => 1
}
```