PDOStatement::bindValue
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 1.0.0)
PDOStatement::bindValue — 값을 매개변수에 바인딩
설명
public PDOStatement::bindValue(string|int $param
, mixed $value
, int $type
= PDO::PARAM_STR): bool
명령문을 준비하는 데 사용된 SQL 문의 해당 명명된 또는 물음표 자리 표시자에 값을 바인딩합니다.
매개변수
param
- 매개변수 식별자. 명명된 자리 표시자를 사용하는 준비된 명령문의 경우 이것은 :name 형식의 매개변수 이름이 됩니다. 물음표 자리 표시자를 사용하는 준비된 명령문의 경우 이는 매개변수의 1-인덱싱된 위치가 됩니다.
value
- 매개변수에 바인딩할 값입니다.
type
- PDO::PARAM_* 상수를 사용하는 매개변수의 명시적 데이터 유형입니다.
반환 값
성공하면 true
를, 실패하면 false
를 반환합니다.
Examples
예제 #1 명명된 자리 표시자를 사용하여 준비된 명령문 실행
<?php
/* Execute a prepared statement by binding PHP variables */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < :calories AND colour = :colour');
$sth->bindValue('calories', $calories, PDO::PARAM_INT);
/* Names can be prefixed with colons ":" too (optional) */
$sth->bindValue(':colour', $colour, PDO::PARAM_STR);
$sth->execute();
?>
예제 #2 물음표 자리 표시자가 있는 준비된 명령문 실행
<?php
/* Execute a prepared statement by binding PHP variables */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < ? AND colour = ?');
$sth->bindValue(1, $calories, PDO::PARAM_INT);
$sth->bindValue(2, $colour, PDO::PARAM_STR);
$sth->execute();
?>
기타
- PDO::prepare() - 실행할 명령문을 준비하고 명령문 개체를 반환합니다.
- PDOStatement::execute() - 준비된 명령문을 실행합니다.
- PDOStatement::bindParam() - 매개변수를 지정된 변수 이름에 바인딩합니다.