array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.taint.php', 1 => 'taint', 2 => 'Marca strings como corrompidos', ), 'up' => array ( 0 => 'ref.taint.php', 1 => 'Funciones de taint', ), 'prev' => array ( 0 => 'function.is-tainted.php', 1 => 'is_tainted', ), 'next' => array ( 0 => 'function.untaint.php', 1 => 'untaint', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', '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 — Marca strings como corrompidos

Descripción

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

Marca manualmente los strings indicados como corrompidos, como si procedieran de la entrada del usuario. Las variables se pasan por referencia, pero la marca se almacena en el string y no en la variable: todas las variables que comparten el mismo string quedan corrompidas a la vez.

Resulta útil sobre todo para pruebas, y para simular la entrada del usuario en scripts CLI, donde las superglobales $_GET, $_POST y $_COOKIE no están pobladas.

Parámetros

string

Una variable que contiene el string que se va a marcar.

strings

Variables adicionales que se van a marcar.

Valores devueltos

Devuelve siempre true. Cuando taint.enable está deshabilitado, la función no hace nada y aun así devuelve true.

Ejemplos

Ejemplo #1 Ejemplo con taint()

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

Resultado del ejemplo anterior es similar a:

bool(true)

Notas

Nota:

Solo se marcan los strings no vacíos; las variables que contienen otros tipos, o strings vacíos, se ignoran silenciosamente.

Nota:

Los strings internados, persistentes y permanentes (literales de string, strings compartidos de opcache) no pueden llevar nunca la marca y se omiten silenciosamente.

Véase también