Postgresql php обращение к схеме
В случае возникновения ошибки. Функция вернет строку ( string

Содержание
- Список параметров
- Pg_Close
- Pg_cmdTuples
- Pg_Connect
- Pg_DBname
- Pg_ErrorMessage
- Pg_Exec
- Pg_Fetch_Array
- Pg_Fetch_Object
- Pg_Fetch_Row
- Pg_FieldIsNull
- Pg_FieldName
- Pg_FieldNum
- Pg_FieldPrtLen
- Pg_FieldSize
- Pg_FieldType
- Pg_FreeResult
- Pg_locreate
- Pg_loopen
- Pg_loread
- Pg_loreadall
- Pg_lounlink
- Pg_lowrite
- Pg_NumFields
- Pg_NumRows
- Pg_Port
- Pg_Result
- Pg_tty
pg_update
( resource
$connection
, string
$table_name
, array
$data
, array
$condition
[, int
$options = PGSQL_DML_EXEC
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
), если константа
PGSQL_DML_STRING
Содержится в options .
Примеры
Пример #1 Пример использования pg_update()
<?php
$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()
<?php
$dbconn
=
pg_connect
("dbname=foo"
$tmp
= array(
"author"
=>
"Joe Thackery"
"year"
=>
"title"
=>
"My Life, by Joe Thackery"
$vals
=
pg_convert
($dbconn
"authors"
$tmp
?>
pg_update
( resource
$connection
, string
$table_name
, array
$data
, array
$condition
[, int
$options = PGSQL_DML_EXEC
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()
<?php
$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"
?>
С версии 6.3 (от 2 марта 1998 года) PostgreSQL использует сокеты домена UNIX.
Этот сокет может быть найден в каталоге /tmp/.s.PGSQL.5432 . Это свойство может быть включено с помощью флага "-i" в
postmaster
И это означает "прослушивание сокетов TCP/IP", аналогично сокетам
Домена UNIX.
Таблица 1. Postmaster and PHP
Можно также установить соединение с помощью команды:
$conn = pg_Connect("host=localhost port=5432 dbname=chris");
Для использования интерфейса больших объектов (large objects) необходимо
Заключить их в блок транзакции. Блок транзакции начинается
begin
И, если транзакция прошла успешно, завершается
commit
И end
. Если транзакция дала сбой, то транзакция должна быть закрыта с помощью
abort
И rollback
Pg_Close
pg_Close -- закрывает соединение PostgreSQL
bool pg_close (int connection);
Возвращает false, если connection - не правильный номер соединения.
Закрывает соединение с базой PostgreSQL, связанное с указанным номером соединения.
Pg_cmdTuples
pg_cmdTuples -- возвращает число вызванных tuples
int pg_cmdtuples (int result_id);
pg_cmdTuples() возвращает число tuples (требований), вызванных
Запросами INSERT, UPDATE, и DELETE. Если нет вызванных tuple, то функция вернет 0.
Пример 1. pg_cmdtuples
<?php
$result = pg_exec($conn, "INSERT INTO verlag VALUES ("Autor")");
$cmdtuples = pg_cmdtuples($result);
echo $cmdtuples . " <- cmdtuples affected.";
?>
Pg_Connect
pg_Connect -- открывает соединение
int pg_connect (string host, string port, string options, string tty, string dbname);
Возвращает номер соединения при успехе или false, если соединение
Не может быть установлено. Открывает соединение с базой PostgreSQL.
Каждый из аргументов должен быть в кавычках, включая номер порта.
Аргементы options и tty являются дополнительными и могут быть опущены.
Эта функция возвращает номер соединения, который необходим другим функциям PostgreSQL.
Вы можете иметь одновременно несколько открытых соединений.
Соединение может быть также установлено следующей командой:
$conn = pg_connect("dbname=marliese port=5432");
Дополнительные параметры (кроме dbname
И
port
) - это host
tty
И options
Pg_DBname
pg_DBname -- имя базы данных
string pg_dbname (int connection);
Возвращает имя базы данных, с которой соединен указанный номер соединения PostgreSQL,
Или возвращает false, если указан не правильный номер соединения.
Pg_ErrorMessage
pg_ErrorMessage -- сообщение об ошибке
string pg_errormessage (int connection);
Возвращает строку, содержащую сообщение об ошибке, или false при сбое.
Детали об ошибке, вероятно, не могут быть получены с помощью pg_errormessage(),
Если ошибка произошла при последнем обращении к базе данных, для которой существует
Верный номер соединения, то функция вернет строку, содержащую сообщение об ошибке,
Выданное сервером.
Pg_Exec
pg_Exec -- запускает запрос
int pg_exec (int connection, string query);
Возвращает признак результата, если запрос может быть запущен, false при
Ошибке или при неверном номере соединения. Детали об ошибке могут
Получены с помощью функции
, если номер соединения верный. Функция посылает SQL запрос базе данных PostgreSQL,
Определяемой номером соединения. Connection должен быть верным номером соединения,
Который возвращается функцией . Возвращаемое этой функцией значение является необходимым для
Доступа к результатам других функций PostgreSQL.
Замечание:
PHP2 возвращает 1, если запрос не должен возвращать данных (например, при вставке или обновлении)
И больше 1, даже при выборках, которые ничего не возвращают. Таких допущений нет в PHP3.
Pg_Fetch_Array
pg_Fetch_Array -- возвращает запись как массив
array pg_fetch_array (int result, int row);
Возвращает массив, который ссылается на полученную запись, или false
Если больше нет записей.
pg_fetch_array()
Является расширенной версией
. В дополнение к хранению данных под числовыми индексами в результирующем массиве,
Функция также хранит данные под ассоциативными индексами, используя номера полей
В качестве ключей.
Функция
pg_fetch_array()
Практически одинакова по скорости с , хотя и предоставляет дополнительные возможности.
Для дополнительной информации см.
Пример 1. Массив записи PostgreSQL
<?php
if (!$conn) {
echo "An error occured.\n";
exit;
$result = pg_Exec ($conn, "SELECT * FROM authors");
if (!$result) {
echo "An error occured.\n";
exit;
$arr = pg_fetch_array ($result, 0);
echo $arr . " <- array\n";
$arr = pg_fetch_array ($result, 1);
echo $arr["author"] . " <- array\n";
?>
Pg_Fetch_Object
pg_Fetch_Object -- возвращает запись как объект
object pg_fetch_object (int result, int row);
Возвращает объект со свойствами, которые ссылаются на полученную запись, или
false если нет больше записей.
Пример 1. Полученние объекта Postgres
<?php
$database = "verlag";
$db_conn = pg_connect ("localhost", "5432", "", "", $database);
if (!$db_conn): ?>
<H1>Ошибка соединения с базой <? echo $database ?></H1> <?
exit;
endif;
$qu = pg_exec ($db_conn, "SELECT * FROM verlag ORDER BY autor");
$row = 0; // postgres необходим счетчик записей, в отличие от других СУБД
while ($data = pg_fetch_object ($qu, $row)):
echo $data->autor." (";
echo $data->jahr ."): ";
echo $data->titel."<BR>";
$row++;
endwhile; ?>
<?
$fields = Array ("autor", "Author");
$fields = Array ("jahr", " Year");
$fields = Array ("titel", " Title");
$row= 0; // postgres необходим счетчик записей, в отличие от других
while ($data = pg_fetch_object ($qu, $row)):
echo "----------\n";
reset ($fields);
while (list (,$item) = each ($fields)):
echo $item.": ".$data->$item."\n";
endwhile;
$row++;
endwhile;
echo "----------\n"; ?>
Pg_Fetch_Row
pg_Fetch_Row -- получает запись как нумерованный массив
array pg_fetch_row (int result, int row);
Возвращает массив, который ссылается на полученную запись, или false, если
Больше нет записей.
pg_fetch_row()
Возвращает одну запись данных из результата, определяемого указанным идентификатором результата.
Запись возвращается как массив. Каждый столбец результата храниться в элементе массива, начиная с 0.
Последующий вызов функции pg_fetch_row()
Возвратит следующую запись в результирующем наборе, или false, если записей больше нет.
Pg_FieldIsNull
pg_FieldIsNull -- Проверяет поле на нулевое значение
int pg_fieldisnull (int result_id, int row, mixed field);
Проверяет нулевое (NULL) значение у поля или нет. Возвращает 0, если поле в указанной записи
Не нулевое. Возвращает 1, если поле ы указанное записи нулевое. Поле может определяться
Номером или именем. Нумерация записей начинается с 0.
Pg_FieldName
pg_FieldName -- возвращает имя поля
string pg_fieldname (int result_id, int field_number);
pg_FieldName() возвращет имя поля, соответствующее указанному номеру столбца в
Указанном идентификаторе результата PostgreSQL.
Нумерация полей начинается с 0.
Pg_FieldNum
pg_FieldNum -- возвращает номер столбца
int pg_fieldnum (int result_id, string field_name);
pg_FieldNum() возвращает номер столбца, соответствующий указанному имени поля в
Указанном идентификаторе результата PosgreSQL. Нумерация полей начинается с 0.
Функция вернет -1 при ошибке.
Pg_FieldPrtLen
pg_FieldPrtLen -- Возвращает печатную длину
int pg_fieldprtlen (int result_id, int row_number, string field_name);
pg_FieldPrtLen() возвращает действительную печатную длину (число символов)
Указанных данных в результате PosgreSQL. Нумерация записей начинается с 0.
При ошибке функция вернет -1.
Pg_FieldSize
pg_FieldSize -- возвращает внутренний размер хранения именованного поля
int pg_fieldsize (int result_id, string field_name);
pg_FieldSize() возвращает внутренний размер хранения указанного именованного поля
В указанном результате PosgreSQL. Размер поля -1 говорит о переменной длине поля.
Эта функция вернет false при ошибке.
Pg_FieldType
pg_FieldType -- возвращает тип соответствующего именованного поля
int pg_fieldtype (int result_id, int field_number);
pg_FieldType() возвращает строку, содержащую имя типа указанного поля в
Указанном идентификаторе результата PosgreSQL. Нумерация полей начинается с 0.
Pg_FreeResult
pg_FreeResult -- освобождает память
int pg_freeresult (int result_id);
Pg_locreate
pg_locreate -- создает большой объект
int pg_locreate (int conn);
pg_locreate()
Создает отображение большого объекта (ILO) и возвращает идентификатор большого объекта.
conn
Определяет верное соединение с базой данных. Режимы доступа PostgreSQL
INV_READ, INV_WRITE, и INV_ARCHIVE не поддерживаются, объект создается всегда
И для чтения и для записи. INV_ARCHIVE был удален из самой PostgreSQL (версии
6.3 и выше).
Pg_loopen
pg_loopen -- открывает большой объект
int pg_loopen (int conn, int objoid, string mode);
pg_loopen()
Открывает отображение большого объекта (ILO) и возвращает дескриптор файла
Большого объекта. Дескриптор файла содержит информацию о соединении. Не закрывайте
Соединение до закрытия дескриптора файла большого объекта.
objoid
Определяет верный идентификатор большого объекта и mode
Может быть одним из "r", "w", or "rw".
Pg_loread
pg_loread -- считывает большой объект
string pg_loread (int fd, int len);
pg_loread()
Считывает
len
Байтов из большого объекта и возвращает их в виде строки.
fd
Определяет верный декскриптор файла большого объекта len
Определяет максимально возможный размер сегмента большого объекта.
Pg_loreadall
pg_loreadall -- считывает весь большой объект
void pg_loreadall (int fd);
pg_loreadall()
Считывает большой объект и отправляет его прямо в броузер, после всех необходимых заголовков.
В основном применяется для отправки двоичных данных, таких как изображения и звуковые файлы.
Pg_lounlink
pg_lounlink -- удаляет большой объект
void pg_lounlink (int conn, int lobjid);
pg_lounlink()
Удаляет большой объект с идентификатором большого объекта
lobjid
Pg_lowrite
pg_lowrite -- записывает в большой объект
int pg_lowrite (int fd, string buf);
pg_lowrite()
Записывает данные в большой объект из переменной buf
И возвращает число записанных данных или false при ошибке.
fd
Является дескриптором файла большого объекта из функции .
Pg_NumFields
pg_NumFields -- возвращает количество полей
int pg_numfields (int result_id);
pg_NumFields() возвращает количестов полей (столбцов) в результате PostgreSQL.
Параметр является верным идентификатором результата, полученным функцией . Эта функция вернет -1 при ошибке.
Pg_NumRows
pg_NumRows -- возвращает число записей
int pg_numrows (int result_id);
Соединение может также быть установлено следующей командой:
$conn = pg_pconnect("dbname=marliese port=5432");
Остальные параметры, кроме dbname
И
port
, - это host
tty
И options
Pg_Port
pg_Port -- возвращает номер порта
int pg_port (int connection_id);
pg_Port() возвращает номер порта, с которым соединен указанный идентификатор
Соединения PostgreSQL.
Pg_Result
pg_Result -- возвращает данные из идентификатора результата
mixed pg_result (int result_id, int row_number, mixed fieldname);
pg_Result() возвращает данные из идентификатора результата, полученного . Параметры
row_number
И
fieldname
Определяют, из какой ячейки таблицы будут взяты данные.
Нумерация записей и полей начинается с 0. Вместо имени поля вы можете использовать
Номер поля (без кавычек).
PostgreSQL имеет много видов данных, но здесь поддерживаются только основные.
Все виды целых и логических типов, типов идентификаторов возвращаются как целые числа.
Все виды типов с плавающей точкой и действительных чисел возвращаются как тип double.
Все осталные типы, включая массивы возвращаются как строки, отформатированные в том же
Виде, какой вы видели в программе
psql
Pg_tty
pg_tty -- возвращает имя tty
string pg_tty (int connection_id);
pg_tty() возвращает имя tty, которое сервер дает указанному идентификатору
Соединения PostgreSQL.
Как сделать постраничный вывод из mysql "как в яндексе"?
По 10 записей на страницу, внизу - ссылки на остальные страницы?
Сначала научимся получать из базы нужные записи.
Их получение в mysql обеспечивается оператором LIMIT, который вызывается с двумя параметрами - с какой записи начинать, и сколько выводить (внимание! Не по какую, а сколько!)
SELECT * FROM table LIMIT 0,10
Этот запрос вернет записи с первой по 10, поскольку нумерация начинается с 0
Соответственно, запрос для третьей страницы будет выглядеть, как
SELECT * FROM table LIMIT 20,10
Получается, что нам всего лишь надо передать в скрипт число, которое потом подставить в запрос.
Этим будет заниматься код, который выводит ссылки на страницы.
Естественно, в цикле.
Для цикла нам понадобится количество записей, которое возвращает запрос без лимита.
Это число можно получить двумя путями. Либо отдельным запросом, в котором отсутствует оператор LIMIT, а вместо перечисления полей после оператора SELECT запрашивается только count(*):
$q
=
"SELECT count(*) FROM table"
$res
=
mysql_query
($q
$row
=
mysql_fetch_row
($res
$total_rows
=
$row
[
Либо, если версия mysql больше 4.0, то общее количество строк можно запросить в том же запросе. См. Документацию mysql по функции FOUND_ROWS()
Однако, первый сособ представляется более удобным, хотя и немного более медленным.
Для тех, кто предпочитает думать самостоятельно, этой информации достаточно.
Вывод ссылок - это простейшая арифметическая операция и никаких особенных знаний для нее не требуется.
Для тех, же, кто ищет готовый код, продолжим.
Для начала определим, сколько всего получится страниц. Для этого надо поделить общее число записей на количество оных на одной странице и округлить результат в большую сторону. Таким округлением занимается в пхп функция ceil()
$num_pages
=
ceil
($total_rows
/
$per_page
В этом выражении участвует переменная $per_page
, в которую мы положим количество выводимых на странице записей.
Ведь, если это количество изменится, мы же не хотим ползать по всему коду и исправлять цифры? Проще сделать это один раз в начале скрипта при объявлении переменной. В запрос, вторым параметром LIMIT, подставлять нужно, конечно же, тоже ее.
Ну, а дальше, собственно, вывод ссылок.
for($i
=
$i
<=
$num_pages
$i
++) {
echo
""
$i
"\n"
В цикле от 1 до $num_pages выводим ссылку с параметром num, равным числу, которое надо передать в LIMIT, а в тексте ссылки пишем номер страницы, поскольку людям понятнее видеть номер страницы, а не записи. На код это не влияет, а людям приятно.
Дальше пойдут украшения.
Во-первых, некрасиво, что номер страницы не совпадает с тем, что видно в адресной строке. Эту проблему можно решить, передавая по ссылке номер страницы в человекопонятном формате, а в скрипте вычислять первый операнд для LIMIT.
Во-вторых, мы явно захотим выделить текущую страницу, не оформляя ее ссылкой.
В-третьих, мы захотим нумеровать записи
Разумеется, вышеприведённый код подходит только как учебное пособие. С его помощью становится понятным принцип, но в реальных условиях мы сразу же столкнемся, как минимум, с двумя проблемами:
Во-первых, кроме переменной $page нашему крипту явно будут переданы и другие переменные, да и адрес может совсем не совпадать с именем скрипта. А мы это при формировании ссылок не учитываем.
Во-вторых, нормальный современный сайт немыслим без шаблонов. И такая ужасная лапша из SQL запросов, PHP кода и HTML тегов никуда не годится.
Плюс надо избавляться от устаревшего расширения mysql и организовывать работу с БД более интеллектуально.
Займемся решением этих проблем.
Первая решается очень просто при использовании функции http_build_query()
Вторая - тоже несложно. Шаблонизаторов много, но мы воспользуемся самым универсальным - PHP.
Что же у нас получилось? А получился у нас - рефакторинг
! Переделка старого кода в соответствии с требованиями современности, плюс мелкое причесывание:
<?php
include
"safemysql.class.php"
$db
= new
safeMysql
$per_page
=
//получаем номер страницы и значение для лимита
$cur_page
=
if (isset($_GET
[
"page"
]) &&
$_GET
[
"page"
] >
$cur_page
=
$_GET
[
"page"
$start
= ($cur_page
) *
$per_page
//выполняем запрос и получаем данные для вывода
$sql
=
"SELECT SQL_CALC_FOUND_ROWS * FROM Board LIMIT ?i, ?i"
$data
=
$db
->
getAll
($sql
$start
$per_page
$rows
=
$db
->
getOne
("SELECT FOUND_ROWS()"
//узнаем общее количество страниц и заполняем массив со ссылками
$num_pages
=
ceil
($rows
/
$per_page
// зададим переменную, которую будем использовать для вывода номеров страниц
$page
=
//а дальше выводим в шаблоне днные и навигацию:
?>
Найдено сообщений: <?=$rows?>
<?
foreach ($data
as
$row
?>
<?=
++
$start?>
<?=$row
[
"title"
?>
<?
endforeach
?>
Страницы:
<?
while ($page
++ <
$num_pages
?>
<?
if ($page
==
$cur_page
?>
<?
else:
?>
<?
endif
?>
<?
endwhile
?>
Рубрика: Новичкам и программирование