Select
extends AbstractPredicateClause
in package
Select class
Tags
Table of Contents
Constants
- BACKTICK = 'BACKTICK'
- Constants for id quote types
- BRACKET = 'BRACKET'
- DOUBLE_QUOTE = 'DOUBLE_QUOTE'
- MYSQL = 'MYSQL'
- Constants for database types
- NO_QUOTE = 'NO_QUOTE'
- PGSQL = 'PGSQL'
- SQLITE = 'SQLITE'
- SQLSRV = 'SQLSRV'
Properties
- $where : mixed
- $aggregateFunctions : array<string|int, mixed>
- Supported standard SQL aggregate functions
- $alias : string|null
- Alias
- $closeQuote : string|null
- ID close quote
- $db : AbstractAdapter|null
- Database object
- $dbType : string|null
- Database type
- $distinct : bool
- Distinct keyword
- $groupBy : string|null
- GROUP BY value
- $having : Having|null
- HAVING predicate object
- $idQuoteType : string
- ID quote type
- $joins : array<string|int, mixed>
- Joins
- $limit : mixed
- LIMIT value
- $mathFunctions : array<string|int, mixed>
- Supported standard SQL math functions
- $offset : int|null
- OFFSET value
- $openQuote : string|null
- ID open quote
- $orderBy : string|null
- ORDER BY value
- $parameterCount : int
- Parameter count
- $placeholder : string|null
- SQL placeholder
- $stringFunctions : array<string|int, mixed>
- Supported standard SQL string functions
- $table : mixed
- Table
- $values : array<string|int, mixed>
- Values
- $where : Where|null
- WHERE predicate object
Methods
- __construct() : mixed
- Constructor
- __get() : mixed
- Magic method to access $where and $having properties
- __toString() : string
- Render the SELECT statement
- addNamedValue() : AbstractClause
- Add a named value
- addValue() : AbstractClause
- Add a value
- andHaving() : Select
- Access the HAVING clause with AND
- andWhere() : AbstractPredicateClause
- Access the WHERE clause with AND
- asAlias() : Select
- Set table AS alias name
- db() : AbstractAdapter|null
- Get the current database adapter object (alias method)
- decrementParameterCount() : AbstractSql
- Decrement parameter count
- distinct() : Select
- Select distinct
- from() : Select
- Set from table
- fullInnerJoin() : Select
- Add a FULL INNER JOIN clause
- fullJoin() : Select
- Add a FULL JOIN clause
- fullOuterJoin() : Select
- Add a FULL OUTER JOIN clause
- getAlias() : string|null
- Get the alias
- getCloseQuote() : string|null
- Get close quote
- getDb() : AbstractAdapter|null
- Get the current database adapter object
- getDbType() : string|null
- Get the current database type
- getIdQuoteType() : string
- Get the quote ID type
- getOpenQuote() : string|null
- Get open quote
- getParameter() : string
- Get parameter placeholder value
- getParameterCount() : int
- Get parameter count
- getPlaceholder() : string|null
- Get the SQL placeholder
- getTable() : string|null
- Get the table
- getValue() : mixed
- Get a value
- getValues() : array<string|int, mixed>
- Get the values
- groupBy() : Select
- Set the GROUP BY value
- hasAlias() : bool
- Determine if there is an alias
- having() : Select
- Access the HAVING clause
- incrementParameterCount() : AbstractSql
- Increment parameter count
- innerJoin() : Select
- Add a INNER JOIN clause
- isMysql() : bool
- Determine if the DB type is MySQL
- isParameter() : bool
- Check if value is parameter placeholder
- isPgsql() : bool
- Determine if the DB type is PostgreSQL
- isSqlite() : bool
- Determine if the DB type is SQLite
- isSqlsrv() : bool
- Determine if the DB type is SQL Server
- isSupportedFunction() : bool
- Check if value contains a standard SQL supported function
- join() : Select
- Add a JOIN clause
- leftInnerJoin() : Select
- Add a LEFT INNER JOIN clause
- leftJoin() : Select
- Add a LEFT JOIN clause
- leftOuterJoin() : Select
- Add a LEFT OUTER JOIN clause
- limit() : Select
- Set the LIMIT value
- offset() : Select
- Set the OFFSET value
- orderBy() : Select
- Set the ORDER BY value
- orHaving() : Select
- Access the HAVING clause with OR
- orWhere() : AbstractPredicateClause
- Access the WHERE clause with OR
- outerJoin() : Select
- Add a OUTER JOIN clause
- quote() : float|int|string
- Quote the value (if it is not a numeric value)
- quoteId() : string
- Quote the identifier
- render() : string
- Render the SELECT statement
- rightInnerJoin() : Select
- Add a RIGHT INNER JOIN clause
- rightJoin() : Select
- Add a RIGHT JOIN clause
- rightOuterJoin() : Select
- Add a RIGHT OUTER JOIN clause
- setAlias() : AbstractClause
- Set the alias
- setIdQuoteType() : AbstractSql
- Set the quote ID type
- setPlaceholder() : AbstractSql
- Set the placeholder
- setTable() : AbstractClause
- Set the table
- setValues() : AbstractClause
- Set the values
- where() : AbstractPredicateClause
- Access the WHERE clause
- buildSqlSrvLimitAndOffset() : string
- Method to build SQL Server limit and offset sub-clause
- getLimitAndOffset() : array<string|int, mixed>
- Method to get the limit and offset
- init() : void
- Initialize SQL object
- initQuoteType() : void
- Initialize quite type
Constants
BACKTICK
Constants for id quote types
public
mixed
BACKTICK
= 'BACKTICK'
BRACKET
public
mixed
BRACKET
= 'BRACKET'
DOUBLE_QUOTE
public
mixed
DOUBLE_QUOTE
= 'DOUBLE_QUOTE'
MYSQL
Constants for database types
public
mixed
MYSQL
= 'MYSQL'
NO_QUOTE
public
mixed
NO_QUOTE
= 'NO_QUOTE'
PGSQL
public
mixed
PGSQL
= 'PGSQL'
SQLITE
public
mixed
SQLITE
= 'SQLITE'
SQLSRV
public
mixed
SQLSRV
= 'SQLSRV'
Properties
$where
public
mixed
$where
mixed
$aggregateFunctions
Supported standard SQL aggregate functions
protected
static array<string|int, mixed>
$aggregateFunctions
= ['AVG', 'COUNT', 'MAX', 'MIN', 'SUM']
$alias
Alias
protected
string|null
$alias
= null
$closeQuote
ID close quote
protected
string|null
$closeQuote
= null
$db
Database object
protected
AbstractAdapter|null
$db
= null
$dbType
Database type
protected
string|null
$dbType
= null
$distinct
Distinct keyword
protected
bool
$distinct
= false
$groupBy
GROUP BY value
protected
string|null
$groupBy
= null
$having
HAVING predicate object
protected
Having|null
$having
= null
$idQuoteType
ID quote type
protected
string
$idQuoteType
= 'NO_QUOTE'
$joins
Joins
protected
array<string|int, mixed>
$joins
= []
$limit
LIMIT value
protected
mixed
$limit
= null
$mathFunctions
Supported standard SQL math functions
protected
static array<string|int, mixed>
$mathFunctions
= ['ABS', 'RAND', 'SQRT', 'POW', 'POWER', 'EXP', 'LN', 'LOG', 'LOG10', 'GREATEST', 'LEAST', 'DIV', 'MOD', 'ROUND', 'TRUNC', 'CEIL', 'CEILING', 'FLOOR', 'COS', 'ACOS', 'ACOSH', 'SIN', 'SINH', 'ASIN', 'ASINH', 'TAN', 'TANH', 'ATANH', 'ATAN2']
$offset
OFFSET value
protected
int|null
$offset
= null
$openQuote
ID open quote
protected
string|null
$openQuote
= null
$orderBy
ORDER BY value
protected
string|null
$orderBy
= null
$parameterCount
Parameter count
protected
int
$parameterCount
= 0
$placeholder
SQL placeholder
protected
string|null
$placeholder
= null
$stringFunctions
Supported standard SQL string functions
protected
static array<string|int, mixed>
$stringFunctions
= ['CONCAT', 'FORMAT', 'INSTR', 'LCASE', 'LEFT', 'LENGTH', 'LOCATE', 'LOWER', 'LPAD', 'LTRIM', 'POSITION', 'QUOTE', 'REGEXP', 'REPEAT', 'REPLACE', 'REVERSE', 'RIGHT', 'RPAD', 'RTRIM', 'SPACE', 'STRCMP', 'SUBSTRING', 'SUBSTR', 'TRIM', 'UCASE', 'UPPER']
$table
Table
protected
mixed
$table
= null
$values
Values
protected
array<string|int, mixed>
$values
= []
$where
WHERE predicate object
protected
Where|null
$where
= null
Methods
__construct()
Constructor
public
__construct(AbstractAdapter $db) : mixed
Instantiate the SQL object
Parameters
- $db : AbstractAdapter
__get()
Magic method to access $where and $having properties
public
__get(string $name) : mixed
Parameters
- $name : string
Tags
__toString()
Render the SELECT statement
public
__toString() : string
Tags
Return values
stringaddNamedValue()
Add a named value
public
addNamedValue(string $name, mixed $value) : AbstractClause
Parameters
- $name : string
- $value : mixed
Return values
AbstractClauseaddValue()
Add a value
public
addValue(mixed $value) : AbstractClause
Parameters
- $value : mixed
Return values
AbstractClauseandHaving()
Access the HAVING clause with AND
public
andHaving([mixed $having = null ]) : Select
Parameters
- $having : mixed = null
Return values
SelectandWhere()
Access the WHERE clause with AND
public
andWhere([mixed $where = null ]) : AbstractPredicateClause
Parameters
- $where : mixed = null
Return values
AbstractPredicateClauseasAlias()
Set table AS alias name
public
asAlias(mixed $table) : Select
Parameters
- $table : mixed
Return values
Selectdb()
Get the current database adapter object (alias method)
public
db() : AbstractAdapter|null
Return values
AbstractAdapter|nulldecrementParameterCount()
Decrement parameter count
public
decrementParameterCount() : AbstractSql
Return values
AbstractSqldistinct()
Select distinct
public
distinct([bool $distinct = true ]) : Select
Parameters
- $distinct : bool = true
Return values
Selectfrom()
Set from table
public
from(mixed $table) : Select
Parameters
- $table : mixed
Return values
SelectfullInnerJoin()
Add a FULL INNER JOIN clause
public
fullInnerJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
SelectfullJoin()
Add a FULL JOIN clause
public
fullJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
SelectfullOuterJoin()
Add a FULL OUTER JOIN clause
public
fullOuterJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
SelectgetAlias()
Get the alias
public
getAlias() : string|null
Return values
string|nullgetCloseQuote()
Get close quote
public
getCloseQuote() : string|null
Return values
string|nullgetDb()
Get the current database adapter object
public
getDb() : AbstractAdapter|null
Return values
AbstractAdapter|nullgetDbType()
Get the current database type
public
getDbType() : string|null
Return values
string|nullgetIdQuoteType()
Get the quote ID type
public
getIdQuoteType() : string
Return values
stringgetOpenQuote()
Get open quote
public
getOpenQuote() : string|null
Return values
string|nullgetParameter()
Get parameter placeholder value
public
getParameter(mixed $value[, string|null $column = null ]) : string
Parameters
- $value : mixed
- $column : string|null = null
Return values
stringgetParameterCount()
Get parameter count
public
getParameterCount() : int
Return values
intgetPlaceholder()
Get the SQL placeholder
public
getPlaceholder() : string|null
Return values
string|nullgetTable()
Get the table
public
getTable() : string|null
Return values
string|nullgetValue()
Get a value
public
getValue(string $name) : mixed
Parameters
- $name : string
getValues()
Get the values
public
getValues() : array<string|int, mixed>
Return values
array<string|int, mixed>groupBy()
Set the GROUP BY value
public
groupBy(mixed $by) : Select
Parameters
- $by : mixed
Return values
SelecthasAlias()
Determine if there is an alias
public
hasAlias() : bool
Return values
boolhaving()
Access the HAVING clause
public
having([mixed $having = null ]) : Select
Parameters
- $having : mixed = null
Return values
SelectincrementParameterCount()
Increment parameter count
public
incrementParameterCount() : AbstractSql
Return values
AbstractSqlinnerJoin()
Add a INNER JOIN clause
public
innerJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
SelectisMysql()
Determine if the DB type is MySQL
public
isMysql() : bool
Return values
boolisParameter()
Check if value is parameter placeholder
public
isParameter(mixed $value[, string|null $column = null ]) : bool
Parameters
- $value : mixed
- $column : string|null = null
Return values
boolisPgsql()
Determine if the DB type is PostgreSQL
public
isPgsql() : bool
Return values
boolisSqlite()
Determine if the DB type is SQLite
public
isSqlite() : bool
Return values
boolisSqlsrv()
Determine if the DB type is SQL Server
public
isSqlsrv() : bool
Return values
boolisSupportedFunction()
Check if value contains a standard SQL supported function
public
static isSupportedFunction(string $value) : bool
Parameters
- $value : string
Return values
booljoin()
Add a JOIN clause
public
join(mixed $foreignTable, array<string|int, mixed> $columns[, string $join = 'JOIN' ]) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
- $join : string = 'JOIN'
Return values
SelectleftInnerJoin()
Add a LEFT INNER JOIN clause
public
leftInnerJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
SelectleftJoin()
Add a LEFT JOIN clause
public
leftJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
SelectleftOuterJoin()
Add a LEFT OUTER JOIN clause
public
leftOuterJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
Selectlimit()
Set the LIMIT value
public
limit(int $limit) : Select
Parameters
- $limit : int
Return values
Selectoffset()
Set the OFFSET value
public
offset(int $offset) : Select
Parameters
- $offset : int
Return values
SelectorderBy()
Set the ORDER BY value
public
orderBy(mixed $by[, string $order = 'ASC' ]) : Select
Parameters
- $by : mixed
- $order : string = 'ASC'
Return values
SelectorHaving()
Access the HAVING clause with OR
public
orHaving([mixed $having = null ]) : Select
Parameters
- $having : mixed = null
Return values
SelectorWhere()
Access the WHERE clause with OR
public
orWhere([mixed $where = null ]) : AbstractPredicateClause
Parameters
- $where : mixed = null
Return values
AbstractPredicateClauseouterJoin()
Add a OUTER JOIN clause
public
outerJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
Selectquote()
Quote the value (if it is not a numeric value)
public
quote([string|null $value = null ][, bool $force = false ]) : float|int|string
Parameters
- $value : string|null = null
- $force : bool = false
Return values
float|int|stringquoteId()
Quote the identifier
public
quoteId(string $identifier) : string
Parameters
- $identifier : string
Return values
stringrender()
Render the SELECT statement
public
render() : string
Tags
Return values
stringrightInnerJoin()
Add a RIGHT INNER JOIN clause
public
rightInnerJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
SelectrightJoin()
Add a RIGHT JOIN clause
public
rightJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
SelectrightOuterJoin()
Add a RIGHT OUTER JOIN clause
public
rightOuterJoin(mixed $foreignTable, array<string|int, mixed> $columns) : Select
Parameters
- $foreignTable : mixed
- $columns : array<string|int, mixed>
Return values
SelectsetAlias()
Set the alias
public
setAlias(string $alias) : AbstractClause
Parameters
- $alias : string
Return values
AbstractClausesetIdQuoteType()
Set the quote ID type
public
setIdQuoteType([string $type = self::NO_QUOTE ]) : AbstractSql
Parameters
- $type : string = self::NO_QUOTE
Return values
AbstractSqlsetPlaceholder()
Set the placeholder
public
setPlaceholder(string $placeholder) : AbstractSql
Parameters
- $placeholder : string
Return values
AbstractSqlsetTable()
Set the table
public
setTable(mixed $table) : AbstractClause
Parameters
- $table : mixed
Return values
AbstractClausesetValues()
Set the values
public
setValues(array<string|int, mixed> $values) : AbstractClause
Parameters
- $values : array<string|int, mixed>
Return values
AbstractClausewhere()
Access the WHERE clause
public
where([mixed $where = null ]) : AbstractPredicateClause
Parameters
- $where : mixed = null
Return values
AbstractPredicateClausebuildSqlSrvLimitAndOffset()
Method to build SQL Server limit and offset sub-clause
protected
buildSqlSrvLimitAndOffset() : string
Return values
stringgetLimitAndOffset()
Method to get the limit and offset
protected
getLimitAndOffset() : array<string|int, mixed>
Return values
array<string|int, mixed>init()
Initialize SQL object
protected
init(string $adapter) : void
Parameters
- $adapter : string
initQuoteType()
Initialize quite type
protected
initQuoteType() : void