PHP Класс rex_sql, redaxo

Показать файл Открыть проект Примеры использования класса

Защищенные свойства (Protected)

Свойство Тип Описание
$DBID Die Abfrage-Parameter
$counter anzahl der treffer
$debug
$fieldnames Werte von setRawValue
$lastRow Tabelle im ResultSet
$params Die Abfrage
$pdo PDO[]
$query pointer
$rawFieldnames Spalten im ResultSet
$rawValues Werte von setValue
$rows WHERE parameter array
$stmt PDOStatement
$table Wert der zuletzt gefetchten zeile
$tablenames
$values debug schalter
$whereParams WHERE Bediengung
$wherevar Tabelle setzen

Открытые методы

Метод Описание
addGlobalCreateFields ( string $user = null )
addGlobalUpdateFields ( string $user = null )
checkDbConnection ( $host, $login, $pw, $dbname, $createDb = false ) Prueft die uebergebenen Zugangsdaten auf gueltigkeit und legt ggf. die Datenbank an.
current ( )
datetime ( integer | null $timestamp = null ) : string Returns a datetime string in sql datetime format (Y-m-d H:i:s) using the given timestamp or the current time if no timestamp (or null) is given.
delete ( ) Setzt eine Delete-Anweisung auf die angegebene Tabelle mit den angegebenen WHERE Parametern ab.
escape ( string $value ) : string Escaped den uebergeben Wert fuer den DB Query.
escapeIdentifier ( string $name ) : string Escapes and adds backsticks around.
execute ( array $params = [] ) Executes the prepared statement with the given input parameters.
factory ( integer $DBID = 1 ) : static Creates a rex_sql instance.
flushValues ( ) Stellt alle Values, die mit setValue() gesetzt wurden, zurueck.
getArray ( string $query = null, array $params = [], integer $fetchType = PDO::FETCH_ASSOC ) : array Laedt das komplette Resultset in ein Array und gibt dieses zurueck.
getArrayValue ( string $colName ) : array Returns the array value of a (json encoded) column.
getDBArray ( string $query = null, array $params = [], integer $fetchType = PDO::FETCH_ASSOC ) : array Laedt das komplette Resultset in ein Array und gibt dieses zurueck und wechselt die DBID falls vorhanden.
getDateTimeValue ( string $colName ) : integer | null Returns the unix timestamp of a datetime column.
getErrno ( ) Gibt die zuletzt aufgetretene Fehlernummer zurueck.
getError ( ) Gibt den zuletzt aufgetretene Fehler zurueck.
getFieldnames ( ) Gibt die Spaltennamen des ResultSets zurueck.
getFields ( ) Gibt die Anzahl der Felder/Spalten zurueck.
getLastId ( ) Gibt die letzte InsertId zurueck.
getQueryType ( string $qry ) : boolean | string Gibt den Typ der Abfrage (SQL) zurueck, oder false wenn die Abfrage keinen Typ enthaelt.
getRow ( $fetch_type = PDO::FETCH_ASSOC ) Gibt den Wert der aktuellen Zeile im ResultSet zurueck und bewegt den internen Zeiger auf die naechste Zeile.
getRows ( ) Gibt die Anzahl der Zeilen zurueck.
getServerVersion ( $DBID = 1 ) Gibt die Serverversion zurueck.
getTablenames ( )
getValue ( string $colName ) : mixed Returns the value of a column.
getWhere ( )
hasError ( ) Prueft, ob ein Fehler aufgetreten ist.
hasNext ( ) * Prueft ob das Resultset weitere Datensaetze enthaelt
hasValue ( string $feldname ) : boolean Prueft, ob eine Spalte im Resultset vorhanden ist.
hasValues ( ) : boolean Returns whether values are set inside this rex_sql object.
insert ( ) Setzt eine Insert-Anweisung auf die angegebene Tabelle mit den angegebenen Werten ab.
isNull ( $feldname ) Prueft, ob das Feld mit dem Namen $feldname Null ist.
key ( )
next ( )
prepareQuery ( string $qry ) : PDOStatement Prepares a PDOStatement.
replace ( ) Setzt eine Replace-Anweisung auf die angegebene Tabelle mit den angegebenen Werten ab.
reset ( ) Setzt den Cursor des Resultsets zurueck zum Anfang.
rewind ( )
select ( string $fields = '*' ) Setzt eine Select-Anweisung auf die angegebene Tabelle mit den WHERE Parametern ab.
setArrayValue ( string $colName, array $value ) Set the array value of a column (json encoded).
setDBQuery ( string $query, array $params = [] ) Setzt eine Abfrage (SQL) ab, wechselt die DBID falls vorhanden.
setDateTimeValue ( string $colName, integer | null $timestamp ) Sets the datetime value of a column.
setDebug ( boolean $debug = true ) Setzt Debugmodus an/aus.
setNewId ( string $field, integer $start_id ) : integer Setzt eine Spalte auf den naechst moeglich auto_increment Wert.
setQuery ( string $query, array $params = [] ) Executes the given sql-query.
setRawValue ( string $colName, string $value ) Sets the raw value of a column.
setTable ( string $table ) Setzt den Tabellennamen.
setValue ( string $colName, mixed $value ) Set the value of a column.
setValues ( array $valueArray ) Setzt ein Array von Werten zugleich.
setWhere ( string $where, array $whereParams = null ) Setzt die WHERE Bedienung der Abfrage.
showColumns ( string $table, integer $DBID = 1 ) : array Sucht Spalteninformationen der Tabelle $table der Datenbankverbindung $DBID.
showCreateTable ( string $table, integer $DBID = 1 ) : string Erstellt das CREATE TABLE Statement um die Tabelle $table der Datenbankverbindung $DBID zu erstellen.
showTables ( integer $DBID = 1, string $tablePrefix = null ) : array Sucht alle Tabellen der Datenbankverbindung $DBID.
update ( ) Setzt eine Update-Anweisung auf die angegebene Tabelle mit den angegebenen Werten und WHERE Parametern ab.
valid ( )

Защищенные методы

Метод Описание
__construct ( $DBID = 1 )
buildPreparedValues ( ) Baut den SET bestandteil mit der verfuegbaren values zusammen und gibt diesen zurueck.
createConnection ( $host, $database, $login, $password, $persistent = false )
fetchValue ( $feldname )
getQueryDBID ( string $qry ) : boolean Gibt die DatenbankId der Abfrage (SQL) zurueck, oder false wenn die Abfrage keine DBID enthaelt.
isValueOf ( string $feld, string $prop ) : boolean Prueft den Wert einer Spalte der aktuellen Zeile ob ein Wert enthalten ist.
printError ( $qry, $params ) Gibt die letzte Fehlermeldung aus.
selectDB ( $DBID ) Stellt die Verbindung zur Datenbank her.
stripQueryDBID ( string &$qry ) : string Entfernt die DBID aus einer Abfrage (SQL) und gibt die DBID zurueck falls vorhanden, sonst false.

Приватные методы

Метод Описание
buildWhereArg ( array $arrFields, integer $level ) : string Concats the given array to a sql condition using bound parameters.
fetchMeta ( )
flush ( ) Stellt alle Werte auf den Ursprungszustand zurueck.

Описание методов

__construct() защищенный Метод

protected __construct ( $DBID = 1 )

addGlobalCreateFields() публичный Метод

public addGlobalCreateFields ( string $user = null )
$user string the name of the user who updated the dataset. Defaults to the current user

addGlobalUpdateFields() публичный Метод

public addGlobalUpdateFields ( string $user = null )
$user string the name of the user who created the dataset. Defaults to the current user

buildPreparedValues() защищенный Метод

Baut den SET bestandteil mit der verfuegbaren values zusammen und gibt diesen zurueck.
См. также: setValue
protected buildPreparedValues ( )

checkDbConnection() публичный статический Метод

Prueft die uebergebenen Zugangsdaten auf gueltigkeit und legt ggf. die Datenbank an.
public static checkDbConnection ( $host, $login, $pw, $dbname, $createDb = false )

createConnection() защищенный статический Метод

protected static createConnection ( $host, $database, $login, $password, $persistent = false )

current() публичный Метод

См. также: http://www.php.net/manual/en/iterator.current.php
public current ( )

datetime() публичный статический Метод

Returns a datetime string in sql datetime format (Y-m-d H:i:s) using the given timestamp or the current time if no timestamp (or null) is given.
public static datetime ( integer | null $timestamp = null ) : string
$timestamp integer | null
Результат string

delete() публичный Метод

Setzt eine Delete-Anweisung auf die angegebene Tabelle mit den angegebenen WHERE Parametern ab.
public delete ( )

escape() публичный Метод

Escaped den uebergeben Wert fuer den DB Query.
public escape ( string $value ) : string
$value string den zu escapenden Wert
Результат string

escapeIdentifier() публичный Метод

Escapes and adds backsticks around.
public escapeIdentifier ( string $name ) : string
$name string
Результат string

execute() публичный Метод

Executes the prepared statement with the given input parameters.
public execute ( array $params = [] )
$params array Array of input parameters

factory() публичный статический Метод

Creates a rex_sql instance.
public static factory ( integer $DBID = 1 ) : static
$DBID integer
Результат static Returns a rex_sql instance

fetchValue() защищенный Метод

protected fetchValue ( $feldname )

flushValues() публичный Метод

Stellt alle Values, die mit setValue() gesetzt wurden, zurueck.
public flushValues ( )

getArray() публичный Метод

Laedt das komplette Resultset in ein Array und gibt dieses zurueck.
public getArray ( string $query = null, array $params = [], integer $fetchType = PDO::FETCH_ASSOC ) : array
$query string The sql-query
$params array An optional array of statement parameter
$fetchType integer
Результат array

getArrayValue() публичный Метод

Returns the array value of a (json encoded) column.
public getArrayValue ( string $colName ) : array
$colName string Name of the column
Результат array

getDBArray() публичный Метод

Laedt das komplette Resultset in ein Array und gibt dieses zurueck und wechselt die DBID falls vorhanden.
public getDBArray ( string $query = null, array $params = [], integer $fetchType = PDO::FETCH_ASSOC ) : array
$query string The sql-query
$params array An optional array of statement parameter
$fetchType integer
Результат array

getDateTimeValue() публичный Метод

Returns the unix timestamp of a datetime column.
public getDateTimeValue ( string $colName ) : integer | null
$colName string Name of the column
Результат integer | null Unix timestamp or `null` if the column is `null` or not in sql datetime format

getErrno() публичный Метод

Gibt die zuletzt aufgetretene Fehlernummer zurueck.
public getErrno ( )

getError() публичный Метод

Gibt den zuletzt aufgetretene Fehler zurueck.
public getError ( )

getFieldnames() публичный Метод

Gibt die Spaltennamen des ResultSets zurueck.
public getFieldnames ( )

getFields() публичный Метод

Gibt die Anzahl der Felder/Spalten zurueck.
public getFields ( )

getLastId() публичный Метод

Gibt die letzte InsertId zurueck.
public getLastId ( )

getQueryDBID() защищенный статический Метод

Gibt die DatenbankId der Abfrage (SQL) zurueck, oder false wenn die Abfrage keine DBID enthaelt.
protected static getQueryDBID ( string $qry ) : boolean
$qry string
Результат boolean

getQueryType() публичный статический Метод

Moegliche Typen: - SELECT - SHOW - UPDATE - INSERT - DELETE - REPLACE - CREATE - CALL - OPTIMIZE
public static getQueryType ( string $qry ) : boolean | string
$qry string
Результат boolean | string

getRow() публичный Метод

Gibt den Wert der aktuellen Zeile im ResultSet zurueck und bewegt den internen Zeiger auf die naechste Zeile.
public getRow ( $fetch_type = PDO::FETCH_ASSOC )

getRows() публичный Метод

Gibt die Anzahl der Zeilen zurueck.
public getRows ( )

getServerVersion() публичный статический Метод

Die Versionsinformation ist erst bekannt, nachdem der rex_sql Konstruktor einmalig erfolgreich durchlaufen wurde.
public static getServerVersion ( $DBID = 1 )

getTablenames() публичный Метод

public getTablenames ( )

getValue() публичный Метод

Returns the value of a column.
public getValue ( string $colName ) : mixed
$colName string Name of the column
Результат mixed

getWhere() публичный Метод

public getWhere ( )

hasError() публичный Метод

Prueft, ob ein Fehler aufgetreten ist.
public hasError ( )

hasNext() публичный Метод

* Prueft ob das Resultset weitere Datensaetze enthaelt
public hasNext ( )

hasValue() публичный Метод

Prueft, ob eine Spalte im Resultset vorhanden ist.
public hasValue ( string $feldname ) : boolean
$feldname string Name der Spalte
Результат boolean

hasValues() публичный Метод

Returns whether values are set inside this rex_sql object.
public hasValues ( ) : boolean
Результат boolean True if value isset and not null, otherwise False

insert() публичный Метод

Setzt eine Insert-Anweisung auf die angegebene Tabelle mit den angegebenen Werten ab.
public insert ( )

isNull() публичный Метод

Falls das Feld nicht vorhanden ist, wird Null zurueckgegeben, sonst True/False
public isNull ( $feldname )

isValueOf() защищенный Метод

Prueft den Wert einer Spalte der aktuellen Zeile ob ein Wert enthalten ist.
protected isValueOf ( string $feld, string $prop ) : boolean
$feld string Spaltenname des zu pruefenden Feldes
$prop string Wert, der enthalten sein soll
Результат boolean

key() публичный Метод

См. также: http://www.php.net/manual/en/iterator.key.php
public key ( )

next() публичный Метод

См. также: http://www.php.net/manual/en/iterator.next.php
public next ( )

prepareQuery() публичный Метод

Prepares a PDOStatement.
public prepareQuery ( string $qry ) : PDOStatement
$qry string A query string with placeholders
Результат PDOStatement The prepared statement

printError() защищенный Метод

Gibt die letzte Fehlermeldung aus.
protected printError ( $qry, $params )

replace() публичный Метод

Setzt eine Replace-Anweisung auf die angegebene Tabelle mit den angegebenen Werten ab.
public replace ( )

reset() публичный Метод

Setzt den Cursor des Resultsets zurueck zum Anfang.
public reset ( )

rewind() публичный Метод

См. также: http://www.php.net/manual/en/iterator.rewind.php
public rewind ( )

select() публичный Метод

Setzt eine Select-Anweisung auf die angegebene Tabelle mit den WHERE Parametern ab.
public select ( string $fields = '*' )
$fields string

selectDB() защищенный Метод

Stellt die Verbindung zur Datenbank her.
protected selectDB ( $DBID )

setArrayValue() публичный Метод

Set the array value of a column (json encoded).
public setArrayValue ( string $colName, array $value )
$colName string Name of the column
$value array The value

setDBQuery() публичный Метод

Setzt eine Abfrage (SQL) ab, wechselt die DBID falls vorhanden.
public setDBQuery ( string $query, array $params = [] )
$query string The sql-query
$params array An optional array of statement parameter

setDateTimeValue() публичный Метод

Sets the datetime value of a column.
public setDateTimeValue ( string $colName, integer | null $timestamp )
$colName string Name of the column
$timestamp integer | null Unix timestamp (if `null` is given, the current time is used)

setDebug() публичный Метод

Setzt Debugmodus an/aus.
public setDebug ( boolean $debug = true )
$debug boolean Debug TRUE/FALSE

setNewId() публичный Метод

Setzt eine Spalte auf den naechst moeglich auto_increment Wert.
public setNewId ( string $field, integer $start_id ) : integer
$field string Name der Spalte
$start_id integer
Результат integer

setQuery() публичный Метод

If parameters will be provided, a prepared statement will be executed. example 1: $sql->setQuery('SELECT * FROM mytable where id=:id, 'array('id' => 3)); NOTE: named-parameters/?-placeholders are not supported in LIMIT clause!
public setQuery ( string $query, array $params = [] )
$query string The sql-query
$params array An optional array of statement parameter

setRawValue() публичный Метод

Sets the raw value of a column.
public setRawValue ( string $colName, string $value )
$colName string Name of the column
$value string The raw value

setTable() публичный Метод

Setzt den Tabellennamen.
public setTable ( string $table )
$table string Tabellenname

setValue() публичный Метод

Set the value of a column.
public setValue ( string $colName, mixed $value )
$colName string Name of the column
$value mixed The value

setValues() публичный Метод

Setzt ein Array von Werten zugleich.
public setValues ( array $valueArray )
$valueArray array Ein Array von Werten

setWhere() публичный Метод

example 1: $sql->setWhere(array('id' => 3, 'field' => '')); // results in id = 3 AND field = '' $sql->setWhere(array(array('id' => 3, 'field' => ''))); // results in id = 3 OR field = '' example 2: $sql->setWhere('myid = :id OR anotherfield = :field', array('id' => 3, 'field' => '')); example 3 (deprecated): $sql->setWhere('myid="35" OR abc="zdf"');
public setWhere ( string $where, array $whereParams = null )
$where string
$whereParams array

showColumns() публичный статический Метод

Beispiel fuer den Rueckgabewert: Array ( [0] => Array ( [name] => pid [type] => int(11) [null] => NO [key] => PRI [default] => [extra] => auto_increment ) [1] => Array ( [name] => id [type] => int(11) [null] => NO [key] => MUL [default] => [extra] => ) )
public static showColumns ( string $table, integer $DBID = 1 ) : array
$table string Name der Tabelle
$DBID integer Id der Datenbankverbindung
Результат array Ein mehrdimensionales Array das die Metadaten enthaelt

showCreateTable() публичный статический Метод

Erstellt das CREATE TABLE Statement um die Tabelle $table der Datenbankverbindung $DBID zu erstellen.
public static showCreateTable ( string $table, integer $DBID = 1 ) : string
$table string Name der Tabelle
$DBID integer Id der Datenbankverbindung
Результат string CREATE TABLE Sql-Statement zu erstsellung der Tabelle

showTables() публичный статический Метод

Falls $tablePrefix gesetzt ist, werden nur dem Prefix entsprechende Tabellen gesucht.
public static showTables ( integer $DBID = 1, string $tablePrefix = null ) : array
$DBID integer Id der Datenbankverbindung
$tablePrefix string Zu suchender Tabellennamen-Prefix
Результат array Ein Array von Tabellennamen

stripQueryDBID() защищенный статический Метод

Entfernt die DBID aus einer Abfrage (SQL) und gibt die DBID zurueck falls vorhanden, sonst false.
protected static stripQueryDBID ( string &$qry ) : string
$qry string Abfrage
Результат string

update() публичный Метод

Setzt eine Update-Anweisung auf die angegebene Tabelle mit den angegebenen Werten und WHERE Parametern ab.
public update ( )

valid() публичный Метод

См. также: http://www.php.net/manual/en/iterator.valid.php
public valid ( )

Описание свойств

$DBID защищенное свойство

Die Abfrage-Parameter
protected $DBID

$counter защищенное свойство

anzahl der treffer
protected $counter

$debug защищенное свойство

protected $debug

$fieldnames защищенное свойство

Werte von setRawValue
protected $fieldnames

$lastRow защищенное свойство

Tabelle im ResultSet
protected $lastRow

$params защищенное свойство

Die Abfrage
protected $params

$pdo защищенное статическое свойство

protected static PDO[] $pdo
Результат PDO[]

$query защищенное свойство

pointer
protected $query

$rawFieldnames защищенное свойство

Spalten im ResultSet
protected $rawFieldnames

$rawValues защищенное свойство

Werte von setValue
protected $rawValues

$rows защищенное свойство

WHERE parameter array
protected $rows

$stmt защищенное свойство

protected PDOStatement $stmt
Результат PDOStatement

$table защищенное свойство

Wert der zuletzt gefetchten zeile
protected $table

$tablenames защищенное свойство

protected $tablenames

$values защищенное свойство

debug schalter
protected $values

$whereParams защищенное свойство

WHERE Bediengung
protected $whereParams

$wherevar защищенное свойство

Tabelle setzen
protected $wherevar