pg_convert

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

pg_convert Преобразует значения ассоциативного массива в приемлемые для использования в SQL-запросах

Описание

pg_convert ( resource $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() - Удаляет записи