mysqli_stmt::attr_set
mysqli_stmt::bind_result
MySQLi_STMT
PHP Manual

# mysqli_stmt::bind_param

# mysqli_stmt_bind_param

(PHP 5)

mysqli_stmt::bind_param -- mysqli_stmt_bind_param — Passa variáveis para um preparado comando como parâmetros

### Descrição

Modo orientado a objeto (método):

bool mysqli_stmt::bind_param ( string `$types` , mixed `&$var1` [, mixed `&$...` ] )

Modo procedural:

bool mysqli_stmt_bind_param ( mysqli_stmt `$stmt` , string `$types` , mixed `&$var1` [, mixed `&$...` ] )

Passa variáveis para marcadores de parâmetros no comando SQL que foi passado para mysqli_prepare().

> Nota: Se o tamanho da informação da variáveis excede o máximo permitido do tamanho de pacote (max_allowed_packet), você deve especificar b no `types` e usar mysqli_stmt_send_long_data() para enviar a informação em pacotes.

### Parâmetros

`stmt`

  Apenas para estilo de procedimento: Um identificador de statement retornado por mysqli_stmt_init().

`types`

  A string que contém um ou mais caracteres que especifica os tipos para as correspondente variáveis passadas:

  Caracteres de especificação de tipo
  Caractere | Descrição
  --- | ---
  i | corresponde a uma variável de tipo inteiro
  d | corresponde a uma variável de tipo double
  s | corresponde a uma variável de tipo string
  b | corresponde a uma variável que contém dados para um blob e enviará em pacotes

`var1`

  O número de variáveis e tamanho da string `types` precisa combinar com os parâmetros no comando.

### Valor Retornado

Retorna `TRUE` em caso de sucesso ou `FALSE` em falhas.

### Exemplos

Exemplo #1 Modo orientado a objeto

`<?php
$mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world');
/* check connection */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$stmt = $mysqli->prepare("INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)");
$stmt->bind_param('sssd', $code, $language, $official, $percent);
$code = 'DEU';
$language = 'Bavarian';
$official = "F";
$percent = 11.2;
/* execute prepared statement */
$stmt->execute();
printf("%d Row inserted.\n", $stmt->affected_rows);
/* close statement and connection */
$stmt->close();
/* Clean up table CountryLanguage */
$mysqli->query("DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d Row deleted.\n", $mysqli->affected_rows);
/* close connection */
$mysqli->close();
?>`

Exemplo #2 Modo procedural

`<?php
$link = mysqli_connect('localhost', 'my_user', 'my_password', 'world');
/* check connection */
if (!$link) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$stmt = mysqli_prepare($link, "INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)");
mysqli_stmt_bind_param($stmt, 'sssd', $code, $language, $official, $percent);
$code = 'DEU';
$language = 'Bavarian';
$official = "F";
$percent = 11.2;
/* execute prepared statement */
mysqli_stmt_execute($stmt);
printf("%d Row inserted.\n", mysqli_stmt_affected_rows($stmt));
/* close statement and connection */
mysqli_stmt_close($stmt);
/* Clean up table CountryLanguage */
mysqli_query($link, "DELETE FROM CountryLanguage WHERE Language='Bavarian'");
printf("%d Row deleted.\n", mysqli_affected_rows($link));
/* close connection */
mysqli_close($link);
?>`

O exemplo acima irá imprimir:

    1 Row inserted.
    1 Row deleted.

### Veja Também

- mysqli_stmt_bind_result() - Passa variáveis para um preparado comando por resultado armazenado
- mysqli_stmt_execute() - Executa uma preparada query
- mysqli_stmt_fetch() - Obtém resultados de um preparado comando e os coloca nas determinadas variáveis
- mysqli_prepare() - Prepare a SQL statement for execution
- mysqli_stmt_send_long_data() - Send data in blocks
- mysqli_stmt_errno() - Returns the error code for the most recent statement call
- mysqli_stmt_error() - Returns a string description for last statement error

mysqli_stmt::attr_set
mysqli_stmt::bind_result
MySQLi_STMT
PHP Manual