pg_convert
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
pg_convert — Преобразует значения ассоциативного массива в приемлемые для использования в SQL-запросах
Описание
$connection
, string $table_name
, array $assoc_array
, int $options
= 0
) : array
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
содержит поля булева типа, не используйте константуtrue
в качестве значения массиваtable_name
для этих полей. Она будет преобразована в строку 'TRUE', которая является недопустимым значением для булевых полей в 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() можно использовать с любыми типами данных. |
Смотрите также
- pg_meta_data() - Получение метаданных таблицы
- pg_insert() - Заносит данные из массива в таблицу базы данных
- pg_select() - Выбирает записи из базы данных
- pg_update() - Обновление данных в таблице
- pg_delete() - Удаляет записи