(PHP 5 >= 5.3.11, PHP 7)
PDO::sqliteCreateCollation — Enregistre une fonction PHP ou définie par l'utilisateur pour l'utiliser comme une fonction de collecte dans les requêtes SQL.
Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et, concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS ! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.
nameNom de la fonction de collecte SQL à créer ou à re-définir
callbackLe nom d'une fonction PHP ou définie par l'utilisateur à appliquer comme fonction de rappel, définissant le comportement de la collecte. Elle doit accepter deux chaînes et retourner comme le fait la fonction strcmp(), i.e. elle doit retourner -1, 1, ou 0 si la première chaîne trie avant, après ou pareil que la seconde.
Cette fonction doit être définie comme ceci :
$string1
, string $string2
)
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
Exemple #1 Exemple avec PDO::sqliteCreateCollation()
<?php
$db = new PDO('sqlite::memory:');
$db->exec("CREATE TABLE test (col1 string)");
$db->exec("INSERT INTO test VALUES ('a1')");
$db->exec("INSERT INTO test VALUES ('a10')");
$db->exec("INSERT INTO test VALUES ('a2')");
$db->sqliteCreateCollation('NATURAL_CMP', 'strnatcmp');
foreach ($db->query("SELECT col1 FROM test ORDER BY col1") as $row) {
echo $row['col1'] . "\n";
}
echo "\n";
foreach ($db->query("SELECT col1 FROM test ORDER BY col1 COLLATE NATURAL_CMP") as $row) {
echo $row['col1'] . "\n";
}
?>
L'exemple ci-dessus va afficher :
a1 a10 a2 a1 a2 a10
Note:
Cette méthode n'est pas disponible avec le driver SQLite2. Utiliser l'ancien style API pour cela, à la place.