PDO::quote

(no version information, might be only in CVS)

PDO::quote --  Quotes a string for use in a query.

Beskrivelse

string PDO::quote ( string string [, int parameter_type] )

Advarsel

Denne funktion er EKSPERIMENTABEL. Virkemåden af denne funktion, navnet på funktionen, og andet ellers dokumenteret om denne funktion, ændres muligvis uden advarsel i en fremtidig version af PHP. Brug af denne funktion er på ejet ansvar.

PDO::quote() places quotes around the input string and escapes and single quotes within the input string, using a quoting style appropriate to the underlying driver.

If you're using this function to build SQL, it is recommended that you using prepared statements and bound parameters instead, as it is not only more convenient, but often much faster.

Not all PDO drivers implement this method (notably PDO_ODBC). Consider using prepared statements instead.

Parameterliste

string

The string to be quoted.

parameter_type

Provides a data type hint for drivers that have alternate quoting styles. The default value is PDO_PARAM_STR.

Returneringsværdier

Returns a quoted string that is theoretically safe to pass into an SQL statement. Returns FALSE if the driver does not support quoting in this way.

Eksempler

Eksempel 1. Quoting a normal string

<?php
$conn
= new PDO('sqlite:/home/lynn/music.sql3');

/* Simple string */
$string = 'Nice';
print
"Unquoted string: $string\n";
print
"Quoted string: " . $conn->quote($string) . "\n";
?>

Ovenstående eksempel vil udskrive:

Unquoted string: Nice
Quoted string: 'Nice'

Eksempel 2. Quoting a dangerous string

<?php
$conn
= new PDO('sqlite:/home/lynn/music.sql3');

/* Dangerous string */
$string = 'Naughty \' string';
print
"Unquoted string: $string\n";
print
"Quoted string:" . $conn->quote($string) . "\n";
?>

Ovenstående eksempel vil udskrive:

Unquoted string: Naughty ' string
Quoted string: 'Naughty '' string'

Eksempel 3. Quoting a complex string

<?php
$conn
= new PDO('sqlite:/home/lynn/music.sql3');

/* Complex string */
$string = "Co'mpl''ex \"st'\"ring";
print
"Unquoted string: $string\n";
print
"Quoted string: " . $conn->quote($string) . "\n";
?>

Ovenstående eksempel vil udskrive:

Unquoted string: Co'mpl''ex "st'"ring
Quoted string: 'Co''mpl''''ex "st''"ring'

Se også

PDO::prepare()
PDOStatement::execute()