https://github.com/tomwright/extendedpdo

A simple PDO Wrapper and Query Builder made to shorten the time it takes to get results from basic SQL queries.
https://github.com/tomwright/extendedpdo

database database-access mysql pdo pdo-wrapper php php-7 query-builder singleton sql

Last synced: about 2 months ago
JSON representation

A simple PDO Wrapper and Query Builder made to shorten the time it takes to get results from basic SQL queries.

• Host: GitHub
• URL: https://github.com/tomwright/extendedpdo
• Owner: TomWright
• Created: 2016-11-10T16:45:55.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-11-21T12:26:01.000Z (about 8 years ago)
• Last Synced: 2025-01-19T18:44:00.346Z (about 1 year ago)
• Topics: database, database-access, mysql, pdo, pdo-wrapper, php, php-7, query-builder, singleton, sql
• Language: PHP
• Homepage:
• Size: 41 KB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Extended PDO

[![Build Status](https://travis-ci.org/TomWright/ExtendedPDO.svg?branch=master)](https://travis-ci.org/TomWright/ExtendedPDO)

[![Latest Stable Version](https://poser.pugx.org/tomwright/extended-pdo/v/stable)](https://packagist.org/packages/tomwright/extended-pdo)

[![Total Downloads](https://poser.pugx.org/tomwright/extended-pdo/downloads)](https://packagist.org/packages/tomwright/extended-pdo)

[![Monthly Downloads](https://poser.pugx.org/tomwright/extended-pdo/d/monthly)](https://packagist.org/packages/tomwright/extended-pdo)

[![Daily Downloads](https://poser.pugx.org/tomwright/extended-pdo/d/daily)](https://packagist.org/packages/tomwright/extended-pdo)

[![License](https://poser.pugx.org/tomwright/extended-pdo/license.svg)](https://packagist.org/packages/tomwright/extended-pdo)

## Installation

```

composer install tomwright/extended-pdo

```

## Connecting

ExtendedPDO implements the singleton design pattern using [tomwright/singleton](https://github.com/TomWright/Singleton).

For more information on how the following code works, see the [documentation](https://github.com/TomWright/Singleton).

```php

$db = ExtendedPDO::createConnection($dsn, $username, $password, 'my-main-db');

$db2 = ExtendedPDO::getInstance('my-main-db');

var_dump($db === $db2) // TRUE

```

## Usage

```php

// Returns an array of records

$db->queryAll('SELECT * FROM users WHERE username = :username', [':username' => 'Tom']);

// Returns the first record

$db->queryRow('SELECT * FROM users WHERE username = :username LIMIT 1', [':username' => 'Tom']);

```

## Query Return Types

You can set the return type of the `dbQuery()`, `queryAll()` and `queryRow()` methods using `$db->setReturnType($x)` where `$x` is the return type you'd like to use.

Available return types are as follows:

- `ExtendedPDO::RETURN_TYPE_OBJECT` - Your results will be returned as objects

- `ExtendedPDO::RETURN_TYPE_ASSOC` - Your results will be returned as associative arrays

- `ExtendedPDO::RETURN_TYPE_STMT` - The statement object will be returned directly

You can also set a return type of `\PDO::FETCH_ASSOC` for example and it will override any of the above. This makes all of the standard `PDO` fetch types usable.

## Query Builder

ExtendedPDO also comes with it's own [Query Builder](https://github.com/TomWright/QueryBuilderPHP).