大网数据广告活动
PHP 语言与运行手册

taint · 将字符串标记为已污染

· 52CE 我爱测

手动把指定的字符串标记为已污染,效果如同它们来自用户输入。 变量以引用方式传入,但标记本身存储于字符串而非变量之上: 共享同一字符串的所有变量会同时变为已污染状态。

taint

(PECL taint >=0.1.0)

taint — 将字符串标记为已污染

说明

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

手动把指定的字符串标记为已污染,效果如同它们来自用户输入。 变量以引用方式传入,但标记本身存储于字符串而非变量之上: 共享同一字符串的所有变量会同时变为已污染状态。

该函数主要用于测试,以及在 $_GET、 $_POST 和 $_COOKIE 超全局变量没有数据的 CLI 脚本中模拟用户输入。

参数

string

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

strings

更多待标记的变量。

返回值

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

示例

示例 #1 taint() 示例

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

以上示例的输出类似于:

bool(true)

注释

注意:

只有非空字符串会被标记;持有其他类型或空字符串的变量会被静默忽略。

注意:

interned、persistent 和 permanent 字符串(字符串字面量、 opcache 共享的字符串)永远无法携带标记,会被静默跳过。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。