php 8.6记录结构化日志前,可递归处理数组,对明确的敏感字段名替换为固定标记,并限制层数及每层条目数。字段名脱敏不等于自动识别所有秘密:自由文本中的令牌、url查询参数和未知字段仍需按日志设计另外控制。

PHP手册中的PHP: array_walk_recursive - Manual
实现有边界的数组处理器
<?php
function redact(mixed $value,int $depth=0): mixed {
if ($depth>=6) return '[DEPTH_LIMIT]';
if (!is_array($value)) {
if (is_string($value)) {
return strlen($value)>2000 ? '[LONG_STRING]' : $value;
}
return is_scalar($value)||$value===null ? $value : '[UNSUPPORTED]';
}
$secrets=['password','token','authorization','cookie','secret','api_key'];
$out=[]; $count=0;
foreach ($value as $key=>$item) {
if (++$count>100) { $out['__limit']='[ITEM_LIMIT]'; break; }
$name=is_string($key) ? strtolower($key) : '';
$out[$key]=in_array($name,$secrets,true)
? '[REDACTED]' : redact($item,$depth+1);
}
return $out;
}
$context=['user_id'=>25,'request'=>['token'=>'示例敏感值','action'=>'save']];
error_log(json_encode(redact($context),
JSON_UNESCAPED_UNICODE|JSON_INVALID_UTF8_SUBSTITUTE|JSON_THROW_ON_ERROR));
PHP手册中的PHP: json_encode - Manual
为什么不只调用array_walk_recursive
array_walk_recursive主要访问叶子值,不适合直接承担容器层级判断和递归深度限制。这里使用显式递归,使截断规则和字段名判断在同一处完成;对象不自动遍历,避免意外触发序列化或记录内部属性。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
接入所有日志出口
将处理器放在统一日志入口,并测试嵌套敏感键、大小写、超深数组和长字符串。调用者不要在脱敏前再打印原数据;即便已脱敏,日志仍需合理访问控制与保留期限。


















