pg_select
Wybiera wiersze
&reftitle.description;
arraystringfalsepg_select
PgSql\Connectionconnection
stringtable_name
arrayconditions[]
intflagsPGSQL_DML_EXEC
intmodePGSQL_ASSOC
pg_select wybiera wiersze określone przez tablicę
conditions która zawiera dane w postaci:
kolumna=>wartość. Jeśli zapytanie się powiedzie, zwraca tablicę
zawierającą wszystkie wiersze i kolumny spełniające warunek określony przez
conditions
Jeśli określono parametr flags to funkcja,
pg_convert zostanie zastosowana do tablicy
conditions z użyciem podanych flag.
Jeśli został ustawiony parametr mode,
to zwrócona zostanie wartość w postaci tablicy,
jeśli użyto PGSQL_NUM; tablicy asocjacyjnej,
jeśli użyto PGSQL_ASSOC (domyślnie); lub obu,
jeśli użyto PGSQL_BOTH.
Domyślnie pg_select przekazuje surowe wartości.
Wartości muszą mieć dodane znaki ucieczki lub należy podać flagę PGSQL_DML_ESCAPE.
PGSQL_DML_ESCAPE dodaje cudzysłowy i znaki ucieczki do parametrów/identyfikatorów.
W związku z tym nazwy tabeli i kolumn stają się wrażliwe na wielkość znaków.
Note that neither escape nor prepared query can protect LIKE query,
JSON, Array, Regex, etc. These parameters should be handled
according to their contexts. i.e. Escape/validate values.
&reftitle.parameters;
connection
&pgsql.parameter.connection;
table_name
Nazwa tabeli, z której będą wybrane wiersze.
conditions
Tablica (ang. array), której kluczami są nazwy pól w tabeli table_name,
oraz której wartości są warunkami, które muszą spełniać wyszukiwane wiersze.
Od PHP 8.4.0 kiedy podana jest pusta tablica, nie będą zaaplikowane żadne warunki.
Wcześniej funkcja zwracała błąd jeśli tablica w argumencie conditions była pusta.
flags
Any number of PGSQL_CONV_FORCE_NULL,
PGSQL_DML_NO_CONV,
PGSQL_DML_ESCAPE,
PGSQL_DML_EXEC,
PGSQL_DML_ASYNC or
PGSQL_DML_STRING combined. If PGSQL_DML_STRING is part of the
flags then the query string is returned. When PGSQL_DML_NO_CONV
or PGSQL_DML_ESCAPE is set, it does not call pg_convert internally.
mode
Dowolna kombinacja dowolnej ilości parametrów: PGSQL_ASSOC,
PGSQL_NUM or
PGSQL_BOTH
Jeśli użyto PGSQL_ASSOC, to zwrócona zostanie tablica asocjacyjna..
Jeśli użyto PGSQL_NUM, to zostanie zwrócona zwykła tablica array, a
jeśli PGSQL_BOTH, to zwrócona zostanie zarówno tablica asocjacyjna
oraz indeksowana numerycznie.
&reftitle.returnvalues;
Zwraca ciąg znaków (string) jeśli przekazano PGSQL_DML_STRING poprzez
parametr flags, w przeciwnym razie zwraca tablicę (array) w wypadku powodzenia &return.falseforfailure;.
&reftitle.changelog;
&Version;
&Description;
8.4.0
Parametr conditions jest teraz opcjonalny.
&pgsql.changelog.connection-object;
7.1.0
Dodano parametr mode.
&reftitle.examples;
Przykład użycia pg_select
]]>
&reftitle.seealso;
pg_convert