pg_send_query_params
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
pg_send_query_params — 결과를 기다리지 않고 명령과 별도의 매개변수를 서버에 제출합니다.
설명
pg_send_query_params(PgSql\Connection $connection
, string $query
, array $params
): int|bool
결과를 기다리지 않고 명령과 별도의 매개변수를 서버에 제출합니다.
query
매개변수를 쿼리 문자열과 별도로 지정할 수 있다는 점을 제외하면 pg_send_query()와 동일합니다. 함수의 매개변수는 pg_query_params()와 동일하게 처리됩니다. pg_query_params()와 마찬가지로 7.4 이전 PostgreSQL 연결에서는 작동하지 않으며 쿼리 문자열에서 하나의 명령만 허용합니다.
매개변수
connection
- PgSql\Connection 인스턴스.
query
- 매개변수화된 SQL 문. 하나의 문만 포함해야 합니다. (세미콜론으로 구분된 여러 문장은 허용되지 않습니다.) 매개변수를 사용하는 경우 $1, $2 등으로 지칭합니다.
params
- 원래 준비된 쿼리 문자열에서 $1, $2 등의 자리 표시자를 대체할 매개변수 값의 배열입니다. 배열의 요소 수는 자리 표시자의 수와 일치해야 합니다.
반환 값
성공하면 true
, 실패하면 false
또는 0
을 반환합니다. 쿼리 결과를 확인하려면 pg_get_result()를 사용하십시오.
변경 로그
버전 | 설명 |
---|---|
8.1.0 | connection 매개변수는 이제 PgSql\Connection 인스턴스를 필요로 합니다. 이전에는 resource가 필요했습니다. |
Examples
예제 #1 pg_send_query_params() 사용
<?php
$dbconn = pg_connect("dbname=publisher") or die("Could not connect");
// Using parameters. Note that it is not necessary to quote or escape
// the parameter.
pg_send_query_params($dbconn, 'select count(*) from authors where city = $1', array('Perth'));
// Compare against basic pg_send_query usage
$str = pg_escape_string('Perth');
pg_send_query($dbconn, "select count(*) from authors where city = '${str}'");
?>
기타
- pg_send_query() - 비동기 쿼리를 보냅니다.