Função PHP mysqli real_escape_string()
Exemplo - Estilo Orientado a Objetos
Caracteres especiais de escape em strings:
<?php
$mysqli = new mysqli("localhost","my_user","my_password","my_db");
if ($mysqli -> connect_errno) {
echo "Failed to connect to MySQL: " .
$mysqli -> connect_error;
exit();
}
// Escape special characters, if any
$firstname = $mysqli -> real_escape_string($_POST['firstname']);
$lastname = $mysqli -> real_escape_string($_POST['lastname']);
$age =
$mysqli -> real_escape_string($_POST['age']);
$sql="INSERT INTO Persons (FirstName, LastName, Age) VALUES ('$firstname', '$lastname', '$age')";
if (!$mysqli -> query($sql)) {
printf("%d Row inserted.\n", $mysqli->affected_rows);
}
$mysqli -> close();
?>
Veja o exemplo de estilo processual na parte inferior.
Definição e uso
A função real_escape_string() / mysqli_real_escape_string() escapa caracteres especiais em uma string para uso em uma consulta SQL, levando em consideração o conjunto de caracteres atual da conexão.
Esta função é usada para criar uma string SQL legal que pode ser usada em uma instrução SQL. Suponha que temos o seguinte código:
<?php
$lastname = "D'Ore";
$sql="INSERT INTO Persons (LastName) VALUES ('$lastname')";
// This query will fail, cause we didn't escape $lastname
if (!$mysqli -> query($sql)) {
printf("%d Row inserted.\n", $mysqli->affected_rows);
}
?>
Sintaxe
Estilo orientado a objetos:
$mysqli ->
real_escape_string(escapestring)
Estilo de procedimento:
mysqli_real_escape_string(connection, escapestring)
Valores de parâmetro
| Parameter | Description |
|---|---|
| connection | Required. Specifies the MySQL connection to use |
| escapestring | Required. The string to be escaped. Characters encoded are NUL (ASCII 0), \n, \r, \, ', ", and Control-Z. |
Detalhes técnicos
| Valor de retorno: | Retorna a string com escape |
|---|---|
| Versão do PHP: | 5+ |
Exemplo - Estilo de procedimento
Caracteres especiais de escape em strings:
<?php
$con = mysqli_connect("localhost","my_user","my_password","my_db");
if (mysqli_connect_errno())
{
echo "Failed to connect to MySQL: " . mysqli_connect_error();
exit();
}
// Escape special characters, if any
$firstname = mysqli_real_escape_string($con, $_POST['firstname']);
$lastname = mysqli_real_escape_string($con, $_POST['lastname']);
$age = mysqli_real_escape_string($con, $_POST['age']);
$sql="INSERT INTO Persons (FirstName, LastName, Age) VALUES ('$firstname', '$lastname', '$age')";
if (!mysqli_query($con, $sql))
{
printf("%d Row inserted.\n", mysqli_affected_rows($con));
}
mysqli_close($con);
?>
❮ Referência PHP MySQLi