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}'");
?>
                  
                

기타