(PHP 4 >= 4.3.0, PHP 5, PHP 7)
pg_convert — Преобразует значения ассоциативного массива в приемлемые для использования в SQL запросах
$connection
, string $table_name
, array $assoc_array
[, int $options
= 0
] )
pg_convert() проверяет и преобразовывает значения из
assoc_array
в приемлемые для SQL сервера. Необходимо,
чтобы существовала таблица table_name
, а количество
колонок в ней должно быть не меньше, чем значений в массиве assoc_array
.
Имена колонок в таблице table_name
должны совпадать с
ключами массива assoc_array
, типы данных значений массива
также должны совпадать с типами данных соответствующих колонок. В случае удачной
конвертации функция возвращает массив преобразованных значений, иначе возвращает FALSE
.
Замечание:
С версии PHP 5.6.0, допускаются булевы значения. Они преобразуются в булев тип PostgreSQL. Строковые представления булевого значения также поддерживаются.
NULL
преобразуется в PostgreSQL NULL.До версии PHP 5.6.0, если таблица
table_name
содержит поля типа boolean, не используйте константуTRUE
в качестве значения массиваtable_name
для этих полей. Она будет преобразована в строку 'TRUE', которая является недопустимым значением для boolean полей в PostgreSQL. Используйте значения t, true, 1, y, yes.
connection
Ресурс соединения с базой данных PostgreSQL.
table_name
Имя таблицы базы данных.
assoc_array
Данные для преобразования.
options
Одна из констант PGSQL_CONV_IGNORE_DEFAULT
,
PGSQL_CONV_FORCE_NULL
или
PGSQL_CONV_IGNORE_NOT_NULL
, либо их комбинация.
Массив (array), содержащий преобразованные данные, либо FALSE
в случае ошибки.
Пример #1 Пример использования pg_convert()
<?php
$dbconn = pg_connect('dbname=foo');
$tmp = array(
'author' => 'Joe Thackery',
'year' => 2005,
'title' => 'My Life, by Joe Thackery'
);
$vals = pg_convert($dbconn, 'authors', $tmp);
?>
Версия | Описание |
---|---|
5.6.0 | Больше не является экспериментальной. Добавлена поддержка булевых/NULL значений. Неизвестные и неподдерживаемые типы данных экранируются без валидации. pg_convert() можно использовать с любыми типами данных. |