array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.taint.php', 1 => 'taint', 2 => 'Marque des chaînes comme corrompues', ), 'up' => array ( 0 => 'ref.taint.php', 1 => 'Fonctions Taint', ), 'prev' => array ( 0 => 'function.is-tainted.php', 1 => 'is_tainted', ), 'next' => array ( 0 => 'function.untaint.php', 1 => 'untaint', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/taint/functions/taint.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

taint

(PECL taint >=0.1.0)

taint — Marque des chaînes comme corrompues

Description

function taint(string &$string, string &...$strings): bool

Marque manuellement les chaînes données comme corrompues, comme si elles provenaient d'une entrée utilisateur. Les variables sont passées par référence, mais la marque elle-même est stockée sur la chaîne plutôt que sur la variable : chaque variable partageant la même chaîne devient corrompue à la fois.

Ceci est principalement utile pour les tests et pour simuler des entrées utilisateur dans des scripts CLI où les superglobales $_GET, $_POST et $_COOKIE ne sont pas peuplées.

Liste de paramètres

string

Une variable contenant la chaîne à marquer.

strings

D'autres variables à marquer.

Valeurs de retour

Retourne toujours true. Lorsque taint.enable est désactivé, la fonction ne fait rien et retourne quand même true.

Exemples

Exemple #1 Exemple avec taint()

<?php
$name = "world";
taint($name);
var_dump(is_tainted($name));
?>

Résultat de l'exemple ci-dessus est similaire à :

bool(true)

Notes

Note:

Seules les chaînes non vides sont marquées ; les variables contenant d'autres types, ou des chaînes vides, sont silencieusement ignorées.

Note:

Les chaînes internées, persistantes et permanentes (littéraux de chaînes, chaînes partagées d'opcache) ne peuvent jamais porter la marque et sont silencieusement ignorées.

Voir aussi