Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ellisgl/geeklab-glpdo2
PHP >= 8.1 PDO Wrapper for Easy and Proper Bindings.
https://github.com/ellisgl/geeklab-glpdo2
binding bindings database db escape mysql pdo pdo-mysql pdo-php pdo-wrapper php php8-1 php81 sql
Last synced: about 1 month ago
JSON representation
PHP >= 8.1 PDO Wrapper for Easy and Proper Bindings.
- Host: GitHub
- URL: https://github.com/ellisgl/geeklab-glpdo2
- Owner: ellisgl
- License: bsd-3-clause
- Created: 2017-11-19T06:57:51.000Z (about 7 years ago)
- Default Branch: release
- Last Pushed: 2022-11-25T21:43:09.000Z (almost 2 years ago)
- Last Synced: 2024-09-29T20:04:21.085Z (about 2 months ago)
- Topics: binding, bindings, database, db, escape, mysql, pdo, pdo-mysql, pdo-php, pdo-wrapper, php, php8-1, php81, sql
- Language: PHP
- Homepage:
- Size: 197 KB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.BSD
Awesome Lists containing this project
README
[](https://opensource.org/licenses/BSD-3-Clause)
[](https://github.com/phpstan/phpstan)
[](https://scrutinizer-ci.com/g/ellisgl/GeekLab-GLPDO2/build-status/)
[](https://scrutinizer-ci.com/g/ellisgl/GeekLab-GLPDO2/?branch=release)
[](https://scrutinizer-ci.com/g/ellisgl/GeekLab-GLPDO2/?branch=release)
GeekLab\GLPDO2
============
Easy to use PDO Wrapper for PHP >= 8.1
### Latest
2022-11-25 (4.0.9)
* Style fixes.
### Features
* Bind value by the correct type. E.g. Don't bind as a string where an integer bind should be.
* Bindings are injected, so you can create your own!
* Help prevent injections.
* PSR1/2/4 Compliant.
### Installation
composer require geeklab/glpdo2
### Todo
* More tests, since we can test at many levels and implementations.
* Better schema for testing.
* Better docs.
* More of a real wold example.
* Reduce the complexity?
### Basic Usage (Quick-N-Dirty)
```
PDO::ERRMODE_EXCEPTION]);
$db = new \GeekLab\GLPDO2\GLPDO2($dbConn);
$Statement = new \GeekLab\GLPDO2\Statement(GLPDO2\Bindings\MySQL\MySQLBindingFactory::build());
$start = 0;
$limit = 5;
$Statement->sql('SELECT *')
->sql('FROM (')
->sql(' SELECT *')
->sql(' FROM `mock_data`')
->sql(' LIMIT ?, ?')->bInt($start)->bInt($limit)
->sql(' ) SUBQ')
->sql('ORDER BY `id` DESC;');
// Show computedSQL statement
print_r($Statement->getComputed());
$res = $db->selectRows($Statement);
print_r($res);
```
### Data Binding Methods
Statement->bBool($value, optional boolean $null)
Binds a value as bool(true, false), with optional NULL value return.
Statement->bBoolInt($value, optional boolean $null)
Binds a value as int(0, 1), with optional NULL value return.
Statement->bDate($value, optional boolean $null)
Binds a value as a date (string - validated for YYYY-MM-DD), with optional NULL return.
Statement->bDateTime($value, optional boolean $null)
Binds a value as a date time (string - validated for YYYY-MM-DD HH:MM:SS), with optional NULL return.
Statement->bFloat($value, optional integer $decimals, optional boolean $null)
Binds a value aa a float, with decimal place (default of 3) and optional NULL return. Use '%%' instead of '?'.
Statement->bInt($value, optional boolean $null)
Bind a value as an integer, whith optional NULL return.
Statement->bIntArray(array $data, integer $default)
Converts an array of integers to a comma separated values. Will output $default (which is 0) if $data is not an array. Used with IN() statements. Use '%%' instead of '?'.
Statement->bJSON($data, optional boolean $null)
Binds a JSON object or string as a string, with optional NULL value. Throws JsonException.
Statement->bLike($value, boolean $ends, boolean $starts)
Binds a value as a string for LIKE queries. $ends = "ends with", $starts = "starts with"
Statement->bStr($value, optional boolean $null, optional \PDO::PARAM_* $type)
Binds a value as a string, with optional NULL value return and optional PDO binding type (default \PDO::PARAM_STR).
Statement->bStrArr(array $values, optional string $default)
Binds a string converted array for use with IN statements. $default is used when value isn't an array, which the default is NULL. Use '%%' instead of '?'.
Statement->bind($name, $value, \PDO::PARAM_* $type)
Binds a value to a named parameter with option PDO binding type (default \PDO::PARAM_STR)
Statement->bRaw($value)
Binds a raw value to '%%' in the sql statement. This is unquoted and unescaped. Good for tables names and functions. Can be dangerous if not handled correctly.
### Query Methods
GLPDO->queryDelete(Statement $SQL)
Runs a delete query and returns numbers of affected rows.
GLPDO->queryInsert(Statement $SQL)
Runs an insert query and returns the primary ID.
GLPDO->queryUpdate(Statement $SQL)
Runs an update query and returns number of affect rows
GLPDO->selectRows(Statement $SQL)
Run a normal query, returns multiple rows as an array of associative arrays, or false.
GLPDO->selectRow(Statement $SQL)
Runs a normal query, returns a single row as an array, or false.
GLPDO->selectValue(Statement $SQL, $column, $default)
Runs a normal query, returns a single column ($column) and can return a default (mixed $default = null) value is no value is in the column.
GLPDO->selectRow(Statement $SQL)
Runs a normal query, returns a single row as an array.
GLPDO->beginTransaction()
Begins an SQL Transaction.
GLPDO->commit()
Commits an SQL Transaction.
GLPDO->inTransaction()
Is there a transaction in progress, returns bool.
### Misc Methods
Statement->sql(string $text)
Used to build up the SQL parameterized statement.
Statement->reset()
Used to reset Statement private variables. Usefully for creating multiple queries without having to create a new Statement object.
Statement->execute(\PDO $PDO)
Prepares and executes the statement
Statement->getComputed()
Returns what the compiled SQL query string might look like for debugging purposes.
### Alternative Packages
* https://github.com/nkt/flame