77 lines
2.0 KiB
PHP
77 lines
2.0 KiB
PHP
|
<?php
|
|||
|
|
/**
|
|||
|
|
* 远程 cloak API（byApi / byApiRisk）请求与响应审计，供 visitor_logs 落库与日志页展示。
|
|||
|
|
*/
|
|||
|
|
class VisitorApiAudit
|
|||
|
|
{
|
|||
|
|
const SESSION_BY_REQUEST = 'cloak_api_by_request';
|
|||
|
|
const SESSION_BY_RESPONSE = 'cloak_api_by_response';
|
|||
|
|
|
|||
|
|
public static function clearByApi()
|
|||
|
|
{
|
|||
|
|
unset($_SESSION[self::SESSION_BY_REQUEST], $_SESSION[self::SESSION_BY_RESPONSE]);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @param array|string $payload
|
|||
|
|
*/
|
|||
|
|
public static function recordByApiRequest($payload)
|
|||
|
|
{
|
|||
|
|
$_SESSION[self::SESSION_BY_REQUEST] = self::encode($payload);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @param array|string|null $payload
|
|||
|
|
*/
|
|||
|
|
public static function recordByApiResponse($payload)
|
|||
|
|
{
|
|||
|
|
if ($payload === null || $payload === '') {
|
|||
|
|
return;
|
|||
|
|
}
|
|||
|
|
$_SESSION[self::SESSION_BY_RESPONSE] = self::encode($payload);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 写入日志数组（仅合并当前请求内已调用的 byApi 审计数据）
|
|||
|
|
*
|
|||
|
|
* @param array $logs
|
|||
|
|
* @return array
|
|||
|
|
*/
|
|||
|
|
public static function mergeIntoLogs(array $logs)
|
|||
|
|
{
|
|||
|
|
$map = [
|
|||
|
|
'api_by_request' => self::SESSION_BY_REQUEST,
|
|||
|
|
'api_by_response' => self::SESSION_BY_RESPONSE,
|
|||
|
|
];
|
|||
|
|
foreach ($map as $col => $sessionKey) {
|
|||
|
|
if (empty($logs[$col]) && !empty($_SESSION[$sessionKey])) {
|
|||
|
|
$logs[$col] = (string) $_SESSION[$sessionKey];
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
return $logs;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @param mixed $data
|
|||
|
|
*/
|
|||
|
|
public static function encode($data)
|
|||
|
|
{
|
|||
|
|
if (is_string($data)) {
|
|||
|
|
return $data;
|
|||
|
|
}
|
|||
|
|
$json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
|
|||
|
|
return $json !== false ? $json : '';
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 日志表格展示：未调用时返回「-」
|
|||
|
|
*
|
|||
|
|
* @param mixed $raw
|
|||
|
|
*/
|
|||
|
|
public static function displayText($raw)
|
|||
|
|
{
|
|||
|
|
$raw = trim((string) $raw);
|
|||
|
|
return $raw === '' ? '-' : $raw;
|
|||
|
|
}
|
|||
|
|
}
|