pg_update() заменяет записи в таблице, удовлетворяющие условиям condition данными data . Если задан аргумент options , данные будут преобразованы функцией pg_convert() , которой будут переданы параметры из этого аргумента.
Список параметров
Ресурс соединения с базой данных PostgreSQL.
Table_name
Имя таблицы, в которой обновляются записи.
Массив (array ), ключи которого соответствуют именам колонок таблицы table_name , а значения заменят данные в этих колонках.
Condition
Массив (array ), ключи которого соответствуют именам колонок таблицы table_name . Будут обновлены только те строки, значения полей которых совпадут со значениями массива.
Options
Одна из констант PGSQL_CONV_OPTS , PGSQL_DML_NO_CONV , PGSQL_DML_ESCAPE , PGSQL_DML_EXEC , PGSQL_DML_ASYNC или PGSQL_DML_STRING , либо их комбинация. Если options содержит PGSQL_DML_STRING , функция вернет строку. Если установлены PGSQL_DML_NO_CONV или PGSQL_DML_ESCAPE , то функция pg_convert() внутренне не вызывается.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки. Функция вернет строку (string ), если константа PGSQL_DML_STRING содержится в options .
Примеры
Пример #1 Пример использования pg_update()
$db
=
pg_connect
("dbname=foo"
);
$data
= array("field1"
=>
"AA"
,
"field2"
=>
"BB"
);
// Это безопасно с тех пор как $_POST преобразуется автоматически
$res
=
pg_update
($db
,
"post_log"
,
$_POST
,
$data
);
if ($res
) {
echo
"Данные обновлены:
$res
\n"
;
} else {
echo
"Должно быть переданы неверные данные\n"
;
}
?>
pg_update() заменяет записи в таблице, удовлетворяющие условиям condition данными data . Если задан аргумент options , данные будут преобразованы функцией pg_convert() , которой будут переданы параметры из этого аргумента.
Список параметров
Ресурс соединения с базой данных PostgreSQL.
Table_name
Имя таблицы, в которой обновляются записи.
Массив (array ), ключи которого соответствуют именам колонок таблицы table_name , а значения заменят данные в этих колонках.
Condition
Массив (array ), ключи которого соответствуют именам колонок таблицы table_name . Будут обновлены только те строки, значения полей которых совпадут со значениями массива.
Options
Одна из констант PGSQL_CONV_OPTS , PGSQL_DML_NO_CONV , PGSQL_DML_ESCAPE , PGSQL_DML_EXEC , PGSQL_DML_ASYNC или PGSQL_DML_STRING , либо их комбинация. Если options содержит PGSQL_DML_STRING , функция вернет строку. Если установлены PGSQL_DML_NO_CONV или PGSQL_DML_ESCAPE , то функция pg_convert() внутренне не вызывается.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки. Функция вернет строку (string ), если константа PGSQL_DML_STRING содержится в options .
Примеры
Пример #1 Пример использования pg_update()
$db
=
pg_connect
("dbname=foo"
);
$data
= array("field1"
=>
"AA"
,
"field2"
=>
"BB"
);
// Это безопасно с тех пор как $_POST преобразуется автоматически
$res
=
pg_update
($db
,
"post_log"
,
$_POST
,
$data
);
if ($res
) {
echo
"Данные обновлены:
$res
\n"
;
} else {
echo
"Должно быть переданы неверные данные\n"
;
}
?>
(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".
Список параметров
Ресурс соединения с базой данных PostgreSQL.
Table_name
Имя таблицы базы данных.
Assoc_array
Данные для преобразования.
Options
Одна из констант PGSQL_CONV_IGNORE_DEFAULT , PGSQL_CONV_FORCE_NULL или PGSQL_CONV_IGNORE_NOT_NULL , либо их комбинация.
Возвращаемые значения
Массив (array ), содержащий преобразованные данные, либо FALSE в случае ошибки.
Примеры
Пример #1 Пример использования pg_convert()
$dbconn = pg_connect ("dbname=foo" );
$tmp
= array(
"author"
=>
"Joe Thackery"
,
"year"
=>
2005
,
"title"
=>
"My Life, by Joe Thackery"
);
$vals
=
pg_convert
($dbconn
,
"authors"
,
$tmp
);
?>
Postgres, разработанный в оригинале департаментом UC Berkeley Computer Science Department, был пионером многих объектно-ориентированных концепций, ставших теперь доступными в некоторых коммерческих БД. Он предоставляет поддержку языка SQL92/SQL99, целостности транзакций и расширяемости типов. PostgreSQL это открытый ресурс, потомок оригинального Berkeley-кода.
PostgreSQL это продукт, доступный бесплатно. Для использования поддержки PostgreSQL вам необходим PostgreSQL 6.5 или новее. PostgreSQL 7.0 или новее - для всех возможностей модуля PostgreSQL. PostgreSQL поддерживает многие кодировки символов, включая кодировку многобайтных символов. Текущая версия и информация о PostgreSQL находятся на http://www.postgresql.org/ .
Чтобы включить поддержку PostgreSQL, необходима опция --with-pgsql[=DIR] при компиляции PHP. Если модуль совместно используемых/shared объектов доступен, PostgreSQL-модуль может быть загружен с использованием директивы extension в файле php.ini или функции dl() . Поддерживаемые ini-директивы описаны в файле php.ini-dist , поставляемом вместе с исходным кодом дистрибутива.
Таблица 1. Изменения имён функций
| Старое имя | Новое имя |
|---|---|
| pg_exec() | pg_query() |
| pg_getlastoid() | pg_last_oid() |
| pg_cmdtuples() | pg_affected_rows() |
| pg_numrows() | pg_num_rows() |
| pg_numfields() | pg_num_fields() |
| pg_fieldname() | pg_field_name() |
| pg_fieldsize() | pg_field_size() |
| pg_fieldnum() | pg_field_num() |
| pg_fieldprtlen() | pg_field_prtlen() |
| pg_fieldisnull() | pg_field_is_null() |
| pg_freeresult() | pg_free_result() |
| pg_result() | pg_fetch_result() |
| pg_loreadall() | pg_lo_read_all() |
| pg_locreate() | pg_lo_create() |
| pg_lounlink() | pg_lo_unlink() |
| pg_loopen() | pg_lo_open() |
| pg_loclose() | pg_lo_close() |
| pg_loread() | pg_lo_read() |
| pg_lowrite() | pg_lo_write() |
| pg_loimport() | pg_lo_import() |
| pg_loexport() | pg_lo_export() |
Не все функции поддерживаются во всех построениях/builds. Это зависит от версии вашей libpq (The PostgreSQL C Client interface) и от того, как libpq скомпилирована. Если имеется отсутствующая функция, libpq не поддерживает возможности, требуемые для этой функции.
Важно также, чтобы вы использовали libpq более новую, чем PostgreSQL Server, с которым соединяетесь. Если вы используете libpq более старую, чем ожидает PostgreSQL Server, у вас будут проблемы.
Начиная с версии 6.3 (03/02/1998), PostgreSQL использует по умолчанию сокет домена unix. TCP-порт НЕ открывается по умолчанию. В таблице описаны эти новые возможности соединений. Этот сокет можно найти в in /tmp/.s.PGSQL.5432 . Данная опция может быть включена флагом "-i" для postmaster , и его значением будет: "прослушивать TCP/IP-сокеты, а также сокеты Unix-домена".
Таблица 2. Postmaster и PHP
Соединение с PostgreSQL-сервером может быть установлено следующими парами значений в командной строке: $conn = pg_connect("host=myHost port=myPort tty=myTTY options=myOptions dbname=myDB user=myUser password=myPassword ") ;
Предыдущий синтаксис: $conn = pg_connect ("host", "port", "options", "tty", "dbname") теперь не рекомендуется.
Переменные окружения влияют на поведение PostgreSQL server/client. Например, PostgreSQL-модуль будет искать переменную окружения PGHOST, если hostname отсутствует в строке соединения. Поддерживаемые переменные окружения отличаются в разных версиях. См. детали в PostgreSQL Programmer"s Manual (libpq - Environment Variables).
Убедитесь, что вы установили переменные окружения для соответствующего пользователя. Используйте $_ENV или getenv() для проверки того, какие переменные окружения доступны текущему процессу.
Начиная работу с PostgreSQL 7.1.0, вы можете сохранять 1GB в поле типа text. В более старых версиях могут быть ограничения на размер блоков (по умолчанию было 8KB, максимум был 32KB, определяемые на этапе компиляции).
Для использования интерфейса больших объектов/large object (lo) необходимо включать lo-функции внутри блока транзакции. Блок транзакции начинается с SQL-оператора BEGIN , и, если транзакция была верной, заканчивается COMMIT или END . Если транзакция терпит неудачу, она должна быть закрыта с помощью ROLLBACK или ABORT .
Вы не должны закрывать соединение с PostgreSQL-сервером до закрытия large-объекта.
Содержание pg_affected_rows - возвращает количество задействованных записей (пар/tuples) pg_cancel_query - отменяет async-запрос pg_client_encoding - получает клиентскую кодировку pg_close - закрывает PostgreSQL-соединение pg_connect - открывает PostgreSQL-соединение pg_connection_busy - получает, закрыто соединение или нет pg_connection_reset - восстанавливает соединение (reconnect) pg_connection_status - получает статус соединения pg_convert - конвертирует значение ассоциативного массива в значение, подходящее для оператора SQL pg_copy_from - вставляет записи в таблицу из массива pg_copy_to - копирует таблицу в массив pg_dbname - получает имя базы данных pg_delete - удаляет записи pg_end_copy - синхронизирует с PostgreSQL backend pg_escape_bytea - мнемонизирует/еscape binary для типа bytea pg_escape_string - мнемонизирует string для типа text/char pg_fetch_array - извлекает ряд как массив pg_fetch_object - извлекает ряд как объект pg_fetch_result - возвращает значения из результирующего ресурса pg_fetch_row - получает ряд как перечислимый массив pg_field_is_null - проверяет, является ли поле NULL pg_field_name - возвращает имя поля pg_field_num - возвращает номер именованного поля pg_field_prtlen - возвращает печатаемый размер pg_field_size - возвращает внутренний размер хранения именованного поля pg_field_type - возвращает имя типа для соответствующего номера поля
