pg_select
Wählt Datensätze aus
&reftitle.description;
arraystringfalsepg_select
PgSql\Connectionconnection
stringtable_name
arrayconditions[]
intflagsPGSQL_DML_EXEC
intmodePGSQL_ASSOC
pg_select wählt die Datensätze aus der Tabelle
table_name aus, die den Elementen
(field=>value) in conditions
entsprechen. Wenn die Abfrage erfolgreich war, wird ein assoziatives Array
mit allen Datensätzen und Werten aus table_name
zurückgegeben, die mit den Datensätzen und Werten in
conditions identisch sind.
Falls flags gesetzt ist, wird
pg_convert mit den angegebenen Flags auf
conditions angewendet.
Wenn mode gesetzt ist, ist der Rückgabewert bei
PGSQL_NUM ein Array, bei
PGSQL_ASSOC (Standard) ein assoziatives Array und bei
PGSQL_BOTH beides.
Standardmäßig übergibt pg_select Rohwerte. Die Werte
müssen entweder maskiert werden oder es muss die Option PGSQL_DML_ESCAPE
angegeben werden. PGSQL_DML_ESCAPE maskiert Parameter und Bezeichner und
setzt sie in Anführungszeichen. Daher muss bei Tabellen- und Spaltennamen
zwischen Groß- und Kleinschreibung unterschieden werden.
Es ist zu beachten, dass weder die Maskierung noch eine vorbereitete
Abfrage LIKE-Abfragen, JSON, Array, Regex usw. schützen können. Diese
Parameter sollten im Kontext behandelt werden, &dh; Werte maskieren und
validieren.
&reftitle.parameters;
connection
&pgsql.parameter.connection;
table_name
Der Name der Tabelle, aus der die Datensätze ausgewählt werden.
conditions
Ein &array;, dessen Schlüssel Feldnamen von
table_name sind und dessen Werte mit den
entsprechenden Werten in table_name
übereinstimmen müssen, damit der Datensatz zurückgegeben werden kann.
Seit PHP 8.4.0 gelten keine Bedingungen mehr, wenn ein leeres Array
angegeben wird.
Zuvor schlug die Funktion fehl, wenn das Argument für
conditions leer war.
flags
Eine beliebige Kombination aus
PGSQL_CONV_FORCE_NULL,
PGSQL_DML_NO_CONV,
PGSQL_DML_ESCAPE,
PGSQL_DML_EXEC,
PGSQL_DML_ASYNC und
PGSQL_DML_STRING. Falls
PGSQL_DML_STRING in den
options enthalten ist, wird der Abfragestring
zurückgegeben. Werden PGSQL_DML_NO_CONV oder
PGSQL_DML_ESCAPE angegeben, wird
pg_convert intern nicht aufgerufen.
mode
Eine beliebige Kombination aus PGSQL_ASSOC,
PGSQL_NUM und PGSQL_BOTH.
Wenn PGSQL_ASSOC gesetzt ist, ist der Rückgabewert
ein assoziatives Array, bei PGSQL_NUM
ist es ein Array, und bei PGSQL_BOTH
ist es ein sowohl assoziativ als auch numerisch indiziertes
Array.
&reftitle.returnvalues;
Gibt einen &string; zurück, falls
PGSQL_DML_STRING im Parameter
flags übergeben wurde, andernfalls wird bei Erfolg
ein Array zurückgegeben. &return.falseforfailure;
&reftitle.changelog;
&Version;
&Description;
8.4.0
conditions ist nun optional.
&pgsql.changelog.connection-object;
7.1.0
Der Parameter mode wurde hinzugefügt.
&reftitle.examples;
pg_select-Beispiel
]]>
&reftitle.seealso;
pg_convert