corneltek/sqlbuilder

Fast and Powerful SQLBuilder for PHP

Saturday, July 28, 2018
by c9s
Repository
10 Watchers
108 Stars
8,200 Installations

PHP
4 Dependents
0 Suggesters
15 Forks
28 Open issues
53 Versions
0 % Grown

The README.md

SQLBuilder for PHP

, _(*1)

If you're looking for something that is not an ORM but can generate SQL for you, you just found the right one., _(*2)

SQLBuilder is not an ORM (Object relational mapping) system, but a toolset that helps you generate cross-platform SQL queries in PHP., _(*3)

SQLBuilder is a stand-alone library, you can simply install it through composer or just require them (the class files) with your autoloader, and it has no dependencies., _(*4)

Features

Simple API, easy to remember.
Fast & Powerful.
Custom parameter marker support:
- Question-mark parameter marker.
- Named parameter marker.
Configurable quote handler.
Zero dependency.

Synopsis

Here is a short example of using Universal SelectQuery, _(*5)

use SQLBuilder\ArgumentArray;
use SQLBuilder\Universal\Query\SelectQuery;
use SQLBuilder\Driver\MySQLDriver;
use SQLBuilder\Driver\PgSQLDriver;
use SQLBuilder\Driver\SQLiteDriver;

$mysql = new MySQLDriver;
$args = new ArgumentArray;

$query = new SelectQuery;
$query->select(array('id', 'name', 'phone', 'address','confirmed'))
    ->from('users', 'u')
    ->partitions('u1', 'u2', 'u3')
    ->where()
        ->is('confirmed', true)
        ->in('id', [1,2,3])
    ;
$query
    ->join('posts')
        ->as('p')
        ->on('p.user_id = u.id')
    ;
$query
    ->orderBy('rand()')
    ->orderBy('id', 'DESC')
    ;

$sql = $query->toSql($mysql, $args);

var_dump($sql);
var_dump($args);

A More Detailed Description

Unlike other SQL utilities, SQLBuilder let you define the quote style and the parameter marker type. there are 2 parameter marker type you can choose:, _(*6)

Question mark parameter marker (?)
Named parameter. (:id, :name, :address, :p1)

The above two are supported by PDO directly, and the first one is also supported by mysqli, pgsql extension., _(*7)

The API is dead simple, easy to remember, you can just define one query, then pass different query driver to the query object to get a different SQL string for your targettting platform., _(*8)

It also supports cross-platform query generation, there are three types of query (currently): Universal, MySQL, PgSQL. The Universal queries are cross-platform, you can use them to create a cross-platform PHP API of your database system, and the supported platforms are: MySQL, PgSQL and SQLite., _(*9)

Universql Queries:, _(*10)

CreateDatabaseQuery
DropDatabaseQuery
SelectQuery
InsertQuery
UpdateQuery
DeleteQuery
UnionQuery
CreateIndexQuery
DropIndexQuery

To see the implementation details, you can check the source code inside Universal namespace: https://github.com/c9s/SQLBuilder/tree/master/SQLBuilder/Universal/Query, _(*11)

MySQL Queries:, _(*12)

CreateUserQuery
DropUserQuery
GrantQuery
SetPasswordQuery

For MySQL platform, the implementation is according to the specification of MySQL 5.6., _(*13)

For PostgreSQL platform, the implementation is according to the specification of PostgreSQL 9.2., _(*14)

Installation

Install through Composer

composer require corneltek/sqlbuilder

Getting Started

Documentation, _(*15)

Development

composer install

Copy the phpunit.xml file for your local configuration:, _(*16)

phpunit -c your-phpunit.xml tests

Contribution

To test with mysql database:, _(*17)

mysql -uroot -p
CREATE DATABASE sqlbuilder CHARSET utf8;
GRANT ALL PRIVILEGES ON sqlbuilder.* TO 'testing'@'localhost' identified by '';

--- or use this to remove password for testing account
SET PASSWORD FOR testing@localhost=PASSWORD('');

To test with pgsql database:, _(*18)

sudo -u postgres createdb sqlbuilder

Reference

http://dev.mysql.com/doc/refman/5.0/en/sql-syntax.html
http://www.postgresql.org/docs/8.2/static/sql-syntax.html
http://www.sqlite.org/optoverview.html

Author

Yo-An Lin (c9s) cornelius.howl@gmail.com, _(*19)

The Versions

28/07 2018

dev-master

9999999-dev

Fast and Powerful SQLBuilder for PHP

library sqlbuilder

Fast and Powerful SQLBuilder for PHP

corneltek/sqlbuilder

The README.md

SQLBuilder for PHP

Features

Synopsis

A More Detailed Description

Installation

Install through Composer

Getting Started

Development

Contribution

Reference

Author

The Versions

dev-master

The Development Requires

by c9s

4.0.0

The Development Requires

by c9s

3.2.x-dev

The Development Requires

by c9s

3.2.4

The Development Requires

by c9s

3.2.3

The Development Requires

by c9s

3.2.2

The Development Requires

by c9s

3.2.1

The Development Requires

by c9s

3.2.0

The Development Requires

by c9s

3.1.0

The Development Requires

by c9s

3.0.1

The Development Requires

by c9s

3.0.0

The Development Requires

by c9s

2.8.9

The Development Requires

by c9s

2.8.8

The Development Requires

by c9s

2.8.6

The Development Requires

by c9s

2.8.5

The Development Requires

by c9s

2.8.4

The Development Requires

by c9s

2.8.3

The Development Requires

by c9s

2.6.x-dev

The Development Requires

by c9s

2.6.3

The Development Requires

by c9s

2.8.2

The Development Requires

by c9s

2.8.1

The Development Requires

by c9s

2.8.0