https://github.com/solution10/sql
Completely standalone, expressive SQL query creator. No database or ORM needed.
https://github.com/solution10/sql
composer-packages database php sql
Last synced: 7 months ago
JSON representation
Completely standalone, expressive SQL query creator. No database or ORM needed.
- Host: GitHub
- URL: https://github.com/solution10/sql
- Owner: solution10
- License: mit
- Created: 2015-06-29T15:16:53.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2015-07-26T09:30:47.000Z (over 10 years ago)
- Last Synced: 2025-07-25T03:48:39.258Z (8 months ago)
- Topics: composer-packages, database, php, sql
- Language: PHP
- Size: 234 KB
- Stars: 8
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Solution10\SQL
Completely standalone, expressive SQL query creator. No database or ORM needed.
[](https://travis-ci.org/Solution10/sql)
[](https://coveralls.io/r/Solution10/sql)
[](https://packagist.org/packages/solution10/sql)
[](https://packagist.org/packages/solution10/sql)
[](https://packagist.org/packages/solution10/sql)
## Features
- No database connection required, entirely standalone
- Return SQL string and params in order for PDO queries
- Support for MySQL and ANSI SQL variations
- Complex queries (nested where, having etc)
- Simple, expressive syntax
- Can return query parts at any point
## Installation
Installation is via composer, in the usual manner:
```json
{
"require": {
"solution10/sql": "~1.0"
}
}
```
## Documentation
### Simple Examples
For more detailed documentation, please check the /docs folder in the repo, or the Wiki.
#### Select
```php
$query = (new Solution10\SQL\Select())
->select(['users.name', 'locations.name'])
->from('users')
->join('locations', 'users.location_id', '=', 'locations.id')
->where('users.id', '>', 15)
->limit(25)
->offset(10)
->orderBy('name', 'DESC');
// Make use of an existing PDO object to actually run the query:
$stmt = $pdo->prepare((string)$query);
$stmt->execute($query->params());
$rows = $stmt->fetchAll();
```
#### Insert
```php
$query = (new Solution10\SQL\Insert())
->table('users')
->values([
'name' => 'Alex',
'location_id' => 27
]);
// Use with PDO in exactly the same way as SELECT:
$stmt = $pdo->prepare((string)$query);
$stmt->execute($query->params());
```
#### Update
```php
$query = (new Solution10\SQL\Update())
->table('users')
->where('id', '=', 15)
->values([
'name' => 'Alex',
'location_id' => 27
]);
// Use with PDO in exactly the same way as SELECT:
$stmt = $pdo->prepare((string)$query);
$stmt->execute($query->params());
```
#### Delete
```php
$query = (new Solution10\SQL\Delete())
->table('users')
->where('id', '=', 27)
->limit(1);
// Use with PDO in exactly the same way as SELECT:
$stmt = $pdo->prepare((string)$query);
$stmt->execute($query->params());
```
#### Using other dialects
By default, S10\SQL will assume that you're using an ANSI SQL compatible database. If you're using something
else, MySQL for instance, simply pass into the constructor the Dialect instance:
```php
$query = (new Solution10\SQL\Select(new Solution10\SQL\Dialect\MySQL()))
->select('*')
->from('users')
->limit(10);
```
You can also write your own dialects by implementing `Solution10\SQL\DialectInterface`.
### Userguide
[Check out the Wiki](https://github.com/Solution10/sql/wiki)
(or the /docs folder in the repo)
### API Docs
From a checkout of this project, run:
$ make
This will create an api/ folder for you to peruse.
## PHP Requirements
- PHP >= 5.4
## Author
Alex Gisby: [GitHub](http://github.com/alexgisby), [Twitter](http://twitter.com/alexgisby)
## License
[MIT](http://github.com/solution10/sql/tree/master/LICENSE.md)
## Contributing
[Contributors Notes](http://github.com/solution10/sql/tree/master/CONTRIBUTING.md)