https://github.com/turbopixel/phpdo-database
A simple php pdo database wrapper class with some helpers.
https://github.com/turbopixel/phpdo-database
database mysql pdo-mysql php php7
Last synced: 6 months ago
JSON representation
A simple php pdo database wrapper class with some helpers.
- Host: GitHub
- URL: https://github.com/turbopixel/phpdo-database
- Owner: turbopixel
- License: mit
- Created: 2018-01-17T12:02:59.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-02-17T12:46:50.000Z (over 3 years ago)
- Last Synced: 2026-01-14T14:43:38.573Z (6 months ago)
- Topics: database, mysql, pdo-mysql, php, php7
- Language: PHP
- Homepage:
- Size: 41 KB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PHPDO
[](https://github.com/turbopixel/PHPDO-Database/blob/master/LICENSE)
[](https://packagist.org/packages/turbopixel/phpdo-database)
A lightweight PHP PDO database singleton wrapper class.
Docs and examples: [github.com/turbopixel/PHPDO-Database](https://github.com/turbopixel/PHPDO-Database)
### Requirements
* PHP 7.2+
* MySQL/MariaDB
### Install via composer
```text
composer require turbopixel/phpdo-database
```
## Example
```php
PHPDO::connect("database-server.com", "database_name", "user_name", "myPassword123");
PHPDO::get()->query("SELECT stars FROM github")->fetchAll();
```
## class PHPDO
### Create database connection
```php
\PHPDO\PHPDO::connect("database-server.com", "database_name", "user_name", "myPassword123");
```
An existing PDO object can be set instead
```php
// $pdoObject = new PDO();
PHPDO::setPdo($pdoObject);
```
After this, you can use the PHPDO class from everywhere.
## Get instance
**\PHPDO\PHPDO::get()** returns the PHPDO instance
```php
\PHPDO\PHPDO::get()
```
Example: Select rows
```php
\PHPDO\PHPDO::get()->query("SELECT * FROM github")->fetchAll();
```
**Get PDO instance**
```php
\PHPDO\PHPDO::get()->getPdo()
```
## Run MySQL query
**query**
```php
\PHPDO\PHPDO::get()->query("SELECT id FROM user WHERE active = 1");
print_r( $pdoStmnt->fetch() );
```
**execute**
```php
\PHPDO\PHPDO::get()->execute("UPDATE user SET active = 0 WHERE mail IS NULL");
```
**Prepared Statement**
```php
\PHPDO\PHPDO::get()->prepare("UPDATE github SET stars = stars+1 WHERE id = :id", ["id" => 1234]);
```
## Helper
### fetch() - Select a single row
```php
\PHPDO\PHPDO::get()->fetch("SELECT id FROM github WHERE id = :repo", ["repo" => 553]);
```
`\PHPDO\PHPDO::get()->fetch()` is a helper method and replace this:
```php
$rows = [];
$stmnt = \PHPDO\PHPDO::get()->prepare("SELECT * FROM github WHERE id = ?", [
1234
]);
if($stmnt instanceof PDOStatement){
$rows = $stmnt->fetchAll();
}else{
die("QUERY ERROR");
}
print_r($rows);
```
### fetchAll() - Select multiple rows
```php
\PHPDO\PHPDO::get()->fetchAll("SELECT id FROM github WHERE id = :repo", ["repo" => 553]);
```
### rowCount() - Count rows
```php
\PHPDO\PHPDO::get()->rowCount("SELECT id FROM github WHERE id = :repo", ["repo" => 553]);
```
### isTable() - Check table exists (MySQL only)
```php
\PHPDO\PHPDO::get()->isTable("user_settings")
```
### findPrimaryIndexColumn() - Find table index column (MySQL only)
```php
\PHPDO\PHPDO::get()->findPrimaryIndexColumn("tablename", "databasename")
```
## Internal class logging
All SQL Queries stored in PHPDO::$logs (array). Attribute `\PHPDO\PHPDO::$logging` must be `true`
**Enable logging**
```php
\PHPDO\PHPDO::$logging = true;
```
**Get internal query logs**
Get query logs.
```php
\PHPDO\PHPDO::get()->getLog(); // returns an array
```