downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

pg_fetch_all_columns> <pg_escape_string
[edit] Last updated: Fri, 18 Sep 2009

view this page in

pg_execute

(PHP 5 >= 5.1.0)

pg_executeИзпраща заявка за изпълнение на подготвен израз с подадени параметри и чака за резултата.

Описание

resource pg_execute ([ resource $connection ], string $stmtname , array $params )

Изпраща заявка за изпълнение на подготвен израз (prepared statement) с подадени параметри и чака за резултата.

pg_execute() е подобна на pg_query_params(), но командата, която ще бъде изпълнена, се указва поименно чрез предварително-подготвен израз, вместо с подаване на заявков низ. Това позволява команди, които ще бъдат използвани повторно, да бъдат анализирани и планирани само веднъж, вместо при всяко изпълнение. Изразът трябва да е бил подготвен предварително в текущата сесия. pg_execute() се поддържа единствено от връзки към PostgreSQL 7.4 и по-късни, като ще пропадне при по-ранни версии.

Параметрите са идентични на pg_query_params(), с тази разлика, че се подава името на подготвения израз, вместо низ-заявка.

Параметри

connection

Ресурс на връзката към базата от данни в PostgreSQL. Когато connection не е наличен, се използва връзката по подразбиране - последната връзка, отворена от pg_connect() или pg_pconnect().

stmtname

Името на подготвения израз, който да бъде изпълнен. При подаване на "", ще се изпълни безименният израз. Името трябва да е било подготвено предварително посредством pg_prepare(), pg_send_prepare() или командата PREPARE в SQL.

params

Масив с параметрични стойности, които да бъдат поместени на местата на $1, $2, и т.н. в оригиналния подготвен заявков низ. Броят на елементите в масива трябва да съвпада с броя на местата за поместване.

Предупреждение

Елементите се преобразуват в низове при извикването на тази функция.

Връщани стойности

Резултатен ресурс от заявка, или FALSE при неуспех.

Примери

Example #1 Употреба на pg_execute()

<?php
// Свързване с база от данни "mary"
$dbconn pg_connect("dbname=mary");

// Подготвяне на заявка за изпълнение
$result pg_prepare($dbconn"my_query"'SELECT * FROM shops WHERE name = $1');

// Изпълняване на подготвената заявка. Забележете, че не е необходимо да екранирате
// низа "Joe's Widgets" по какъвто и да било начин
$result pg_execute($dbconn"my_query", array("Joe's Widgets"));

// Изпълняване на същата подготвена заявка, този път - с различен параметър
$result pg_execute($dbconn"my_query", array("Clothes Clothes Clothes"));

?>

Вж. също

  • pg_prepare() - Submits a request to create a prepared statement with the given parameters, and waits for completion.
  • pg_send_prepare() - Sends a request to create a prepared statement with the given parameters, without waiting for completion.
  • pg_query_params() - Submits a command to the server and waits for the result, with the ability to pass parameters separately from the SQL command text.



add a note add a note User Contributed Notes pg_execute
nmmm at nmmm dot nu 05-May-2006 12:11
I am not 100% sure in this, but pg_exec() could return 0 as Connection ID.

because of that i change some of my code like this:

$dbres = pg_exec($SQL);

if ($dbres === false){
        echo "DB is down";
        exit;
}else{
        //do something
}

 
show source | credits | stats | sitemap | contact | advertising | mirror sites