array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.untaint.php', 1 => 'untaint', 2 => '清除字符串上的污点标记', ), 'up' => array ( 0 => 'ref.taint.php', 1 => 'Taint 函数', ), 'prev' => array ( 0 => 'function.taint.php', 1 => 'taint', ), 'next' => array ( 0 => 'book.ds.php', 1 => 'Data Structures', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/taint/functions/untaint.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

untaint

(PECL taint >=0.1.0)

untaint — 清除字符串上的污点标记

说明

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

清除指定字符串上的污点标记。

标记存储于字符串本身而非变量之上，因此一次调用即可同时清除 所有共享同一字符串的变量上的标记。可用它来为已经自行校验过的值 放行，例如在严格的白名单检查之后。

参数

string

持有待清除标记的字符串的变量。

strings

更多待清除标记的变量。

返回值

始终返回 true。当 taint.enable 未开启时， 该函数不做任何事，但仍然返回 true。

示例

示例 #1 untaint() 示例

<?php
$id = "42";
taint($id);
if (preg_match('/^\d+$/', $id)) {
    // strictly validated as digits: safe to trust
    untaint($id);
}
var_dump(is_tainted($id));
?>

以上示例的输出类似于：

bool(false)

注释

注意:

只有字符串能携带标记；传入非字符串值时不做任何事。

参见