Compare commits
1 Commits
d4fecf977d
...
1.0.0
Author | SHA1 | Date | |
---|---|---|---|
9eef089b85 |
118
Readme.md
118
Readme.md
@ -1,118 +0,0 @@
|
|||||||
# QueryBuilder
|
|
||||||
|
|
||||||
## Requirements
|
|
||||||
+ PHP 8+ (Should work with 7+, but haven't tested it).
|
|
||||||
+ `Psr\Container\ContainerInterface` implementation like [`php-di/php-di`](https://packagist.org/packages/php-di/php-di).
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
```composer.json```
|
|
||||||
```
|
|
||||||
{
|
|
||||||
...
|
|
||||||
"repositories": [
|
|
||||||
{
|
|
||||||
"type": "git",
|
|
||||||
"path": "https://git.provm.cl/ProVM/query_builder.git"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"require": {
|
|
||||||
...
|
|
||||||
"provm/query_builder": "^1.0",
|
|
||||||
...
|
|
||||||
},
|
|
||||||
...
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Setup
|
|
||||||
|
|
||||||
```
|
|
||||||
$container->set(ProVM\Concept\Database\Query\Select::class, function(Psr\Container\ContainerInterface $container) {
|
|
||||||
return $container->get(ProVM\Database\Query\MySQL\Select::class);
|
|
||||||
});
|
|
||||||
$container->set(ProVM\Concept\Database\Query\Insert::class, function(Psr\Container\ContainerInterface $container) {
|
|
||||||
return $container->get(ProVM\Database\Query\MySQL\Insert::class);
|
|
||||||
});
|
|
||||||
$container->set(ProVM\Concept\Database\Query\Update::class, function(Psr\Container\ContainerInterface $container) {
|
|
||||||
return $container->get(ProVM\Database\Query\MySQL\Update::class);
|
|
||||||
});
|
|
||||||
$container->set(ProVM\Concept\Database\Query\Delete::class, function(Psr\Container\ContainerInterface $container) {
|
|
||||||
return $container->get(ProVM\Database\Query\MySQL\Delete::class);
|
|
||||||
});
|
|
||||||
```
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
QueryBuilder
|
|
||||||
```
|
|
||||||
include_once 'vendor/autoload.php';
|
|
||||||
$qb = new QueryBuilder();
|
|
||||||
|
|
||||||
$query = $qb->select(<*columns>);
|
|
||||||
$query = $qb->insert(<table>);
|
|
||||||
$query = $qb->update(<table>);
|
|
||||||
$query = $qb->delete(<table>);
|
|
||||||
```
|
|
||||||
|
|
||||||
### Queries
|
|
||||||
|
|
||||||
#### Select
|
|
||||||
`SELECT <columns> FROM <table>[ JOIN <table2> ON <table>.<column_1> = <table2>.<column_2>][ WHERE <expr1>[ AND|OR <expr2>]][ GROUP BY <column1>[, <column2>]][ HAVING <expr1>[ AND|OR <expr2>]][ ORDER BY <column1> ASC|DESC[, <column2> ASC|DESC]]`
|
|
||||||
|
|
||||||
Mysql also include `[ LIMIT <limit>[ OFFSET <offset>]]`
|
|
||||||
```
|
|
||||||
$query = $qb->select(); // use '*' for columns
|
|
||||||
or
|
|
||||||
$query = $qb->select()->select(['id', 'column1',]);
|
|
||||||
or
|
|
||||||
$query = $qb->select(['id', 'column1',]);
|
|
||||||
|
|
||||||
$query->from('table1');
|
|
||||||
$query->joins([['table2', 'table1.column1 = table2.column21'],]);
|
|
||||||
$query->where(['table2.column22 = 10',]);
|
|
||||||
$query->groupBy(['table1.column1',]);
|
|
||||||
$query->having(['table1.column1 < 10',]);
|
|
||||||
$query->orderBy(['table2.column22',]);
|
|
||||||
$query->limit(10, 10);
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Insert
|
|
||||||
`INSERT INTO <table>[ (<columns>)]`
|
|
||||||
with two options
|
|
||||||
`<select query>` or
|
|
||||||
` VALUES (<values>)`
|
|
||||||
```
|
|
||||||
$query = $qb->insert('table');
|
|
||||||
|
|
||||||
$query->columns(['column1',]);
|
|
||||||
$query->values(['value1',];
|
|
||||||
or
|
|
||||||
$query->select($select_query);
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Update
|
|
||||||
`UPDATE <table> SET <column1> = <value1>[, <column2> = <value2>][ WHERE <expr1>[ AND|OR <expr2>]]`
|
|
||||||
```
|
|
||||||
$query = $qb->update('table');
|
|
||||||
$query->set([['column1', 10],]); or $query->set([['column' => 'column1', 'value' => 10],]);
|
|
||||||
$query->where(['column2 = 10', ]);
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Delete
|
|
||||||
`DELETE FROM <table> WHERE <expr1>[ AND|OR <expr2>]`
|
|
||||||
```
|
|
||||||
$query = $qb->delete('table');
|
|
||||||
$query->where(['column1 = 10',]);
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
Pass the query to a string
|
|
||||||
```
|
|
||||||
$str = $query->build();
|
|
||||||
or
|
|
||||||
$str = "{$query}";
|
|
||||||
```
|
|
||||||
|
|
||||||
## TODO
|
|
||||||
Implement other databases
|
|
@ -12,6 +12,7 @@
|
|||||||
}
|
}
|
||||||
],
|
],
|
||||||
"require": {
|
"require": {
|
||||||
|
"psr/container": "^2.0"
|
||||||
},
|
},
|
||||||
"autoload": {
|
"autoload": {
|
||||||
"psr-4": {
|
"psr-4": {
|
||||||
|
@ -65,7 +65,7 @@ abstract class Insert extends Query implements InsertInterface
|
|||||||
}
|
}
|
||||||
public function addValue(int|string $value): InsertInterface
|
public function addValue(int|string $value): InsertInterface
|
||||||
{
|
{
|
||||||
if (!is_numeric($value) and $value !== '?') {
|
if (!is_numeric($value)) {
|
||||||
$value = "'{$value}'";
|
$value = "'{$value}'";
|
||||||
}
|
}
|
||||||
$this->values []= $value;
|
$this->values []= $value;
|
||||||
|
@ -51,10 +51,6 @@ abstract class Select extends Query implements SelectInterface
|
|||||||
}
|
}
|
||||||
public function addColumn(string $column, ?string $alias = null): SelectInterface
|
public function addColumn(string $column, ?string $alias = null): SelectInterface
|
||||||
{
|
{
|
||||||
if ($column === '*') {
|
|
||||||
$this->columns []= $column;
|
|
||||||
return $this;
|
|
||||||
}
|
|
||||||
$a = '';
|
$a = '';
|
||||||
if ($alias !== null) {
|
if ($alias !== null) {
|
||||||
$a = " AS '{$alias}'";
|
$a = " AS '{$alias}'";
|
||||||
|
@ -20,18 +20,18 @@ class QueryBuilder implements QBInterface
|
|||||||
|
|
||||||
public function select(array $columns = ['*']): Select
|
public function select(array $columns = ['*']): Select
|
||||||
{
|
{
|
||||||
return $this->getContainer()->make(Select::class)->select($columns);
|
return $this->getContainer()->get(Select::class)->select($columns);
|
||||||
}
|
}
|
||||||
public function insert(string $table): Insert
|
public function insert(string $table): Insert
|
||||||
{
|
{
|
||||||
return $this->getContainer()->make(Insert::class)->into($table);
|
return $this->getContainer()->get(Insert::class)->into($table);
|
||||||
}
|
}
|
||||||
public function update(string $table): Update
|
public function update(string $table): Update
|
||||||
{
|
{
|
||||||
return $this->getContainer()->make(Update::class)->table($table);
|
return $this->getContainer()->get(Update::class)->table($table);
|
||||||
}
|
}
|
||||||
public function delete(string $table): Delete
|
public function delete(string $table): Delete
|
||||||
{
|
{
|
||||||
return $this->getContainer()->make(Delete::class)->from($table);
|
return $this->getContainer()->get(Delete::class)->from($table);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
Reference in New Issue
Block a user