DB_common::quoteIdentifier()

DB_common::quoteIdentifier() – Formate une chaîne pour pouvoir l'utiliser en tant qu'identifiant

Synopsis

string quoteIdentifier ( string $str )

Description

Formate la chaîne d'entrée pour qu'elle puisse être utilisée en tant qu'identifiant délimité dans une requête. Les identifiants sont des objets tel que le nom d'une table, ou le nom de ses colonnes.

Le format retourné dépend du type de base de données utilisé.

Les identifiants délimités fonctionnent correctement avec les pilotes suivants :

  • mssql
  • mysql
  • mysqli
  • oci8
  • odbc(access)
  • odbc(db2)
  • pgsql
  • sqlite
  • sybase

InterBase ne supporte pas les identifiants délimités avec PHP 4. Cela fonctionne très bien avec PHP 5.

Parameter

string $str

la chaîne à formater

Return value

string - la chaîne formatée

Note

This function can not be called statically.

Cette fonction est disponible depuis la version 1.6.0.

Le fait de POUVOIR utiliser les identifiants délimités, ne signifie pas que vous DEVEZ les utiliser. En général, ils posent plus de problèmes qu'ils n'en résolvent.

La portabilitée ne fonctionne pas si vous utilisez les caractères suivants dans les identifiants délimités :

  • backtick (`) -- à cause de MySQL
  • double quote (") -- à cause de Oracle
  • brackets ([ or ]) -- à cause de Access

Example

Utilisation de quoteIdentifier()

<?php
// Once you have a valid DB object named $db...
$sql 'SELECT ' $db->quoteIdentifier('company name')
       . 
', address FROM clients';

$result =& $db->query($sql);
?>
Déconseillé : Protège une chaîne (Previous) Formatte une entrée pour être utilisée de façon sécurisée (Next)
Last updated: Sun, 29 Aug 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.