代码功能说明
- 对用户数组进行筛选（filter），规则如下：
- active 为 true（严格布尔值）
- last_login_at 在最近 N 天内（默认 30 天），且不晚于当前时间
- roles 至少包含 'editor' 或 'admin'
- 忽略缺失字段或字段类型不符合要求的项
- 过滤后保持原数组索引不变（不重新索引）
完整的PHP代码块
<?php
declare(strict_types=1);
/**
* 根据规则过滤用户数组：
* - active === true
* - last_login_at 在最近 $days 天内（含当天），且不晚于当前时间
* - roles 包含 'editor' 或 'admin'
* - 缺失字段或类型不符合的项被忽略
* - 保持原索引
*
* @param array $users
* @param int $days 最近天数，必须为非负数
* @param DateTimeZone|null $tz 可选时区（不指定则使用 php.ini 默认时区）
* @return array 过滤后的用户数组（保留原索引）
*/
function filterActiveRecentlyLoggedUsers(array $users, int $days = 30, ?DateTimeZone $tz = null): array
{
// 归一化 days，避免负值带来的意外逻辑
$days = max(0, $days);
// 当前时间（可选时区）
$now = $tz instanceof DateTimeZone
? new DateTimeImmutable('now', $tz)
: new DateTimeImmutable('now');
// 最近 $days 天的阈值（含边界）
$threshold = $now->sub(new DateInterval('P' . $days . 'D'));
// 允许的角色
$allowedRoles = ['editor', 'admin'];
return array_filter($users, function ($user) use ($now, $threshold, $allowedRoles): bool {
// 必须是数组
if (!is_array($user)) {
return false;
}
// 检查必需字段是否存在：active, last_login_at, roles
foreach (['active', 'last_login_at', 'roles'] as $key) {
if (!array_key_exists($key, $user)) {
return false; // 忽略缺失字段的项
}
}
// active 必须严格为 true
if ($user['active'] !== true) {
return false;
}
// roles 必须为数组，且包含 'editor' 或 'admin'
if (!is_array($user['roles']) || empty(array_intersect($allowedRoles, $user['roles']))) {
return false;
}
// 校验并解析 last_login_at（期望格式：Y-m-d）
$dateStr = (string)$user['last_login_at'];
$loginAt = DateTimeImmutable::createFromFormat('Y-m-d', $dateStr);
// 检查解析错误（避免宽松解析）
$errors = DateTime::getLastErrors();
$hasErrors = $errors && (($errors['warning_count'] ?? 0) > 0 || ($errors['error_count'] ?? 0) > 0);
if (!$loginAt || $hasErrors) {
return false;
}
// last_login_at 不得晚于现在，且需在最近 N 天内（含边界）
if ($loginAt > $now) {
return false;
}
if ($loginAt < $threshold) {
return false;
}
return true;
});
}
// ---------------- 使用示例 ----------------
$users = [
['id' => 1, 'name' => 'Lily', 'roles' => ['viewer','editor'], 'active' => true, 'last_login_at' => '2025-11-28'],
['id' => 2, 'name' => 'Max', 'roles' => ['viewer'], 'active' => true, 'last_login_at' => '2025-07-12'],
['id' => 3, 'name' => 'Chen', 'roles' => ['admin'], 'active' => false, 'last_login_at' => '2025-12-01'],
['id' => 4, 'name' => 'Iris', 'roles' => ['editor'], 'active' => true, 'last_login_at' => '2025-12-05'],
];
// 示例：过滤最近 30 天内的活跃且拥有 editor/admin 角色的用户（保留原索引）
$result = filterActiveRecentlyLoggedUsers($users, 30);
// 输出结果（注意保留了原索引 0 和 3）
echo var_export($result, true), PHP_EOL;
关键代码注释
- 使用 array_filter 进行筛选，默认会保留原有数组的键，不会重新索引，满足“保持原索引”的要求。
- 使用 DateTimeImmutable + DateInterval 计算“最近 N 天”的时间阈值，避免字符串时间操作的不确定性。
- 使用 DateTimeImmutable::createFromFormat('Y-m-d', $str) 严格解析日期，并通过 DateTime::getLastErrors() 防止宽松解析（如 2025-13-40 被自动修正）。
- 对 active 做严格布尔判断（=== true），防止 "1"/1 被误当作 true。
- 对 roles 使用 array_intersect 判断是否包含 'editor' 或 'admin' 中的任意一个。
使用示例和注意事项
- 以上示例在当前日期为 2025-12-10 时，结果将包含索引 0（Lily）和 3（Iris），因为这两项满足全部条件且在最近 30 天内。
- 注意事项：
- last_login_at 需要是 Y-m-d 格式，且不应晚于当前时间。
- roles 区分大小写，如果数据源可能大小写不一致，可在过滤前统一转为小写。
- 如需改变“最近天数”，修改函数第二个参数 $days 即可。
- 如需统一时区（避免服务器默认时区差异），可传入第三个参数 DateTimeZone，例如 new DateTimeZone('UTC')。
- 若需要在最终结果中重排索引，可在结果外层调用 array_values()；本实现默认保留原索引以满足题意。
示例输出（var_export）示意：
array (
0 =>
array (
'id' => 1,
'name' => 'Lily',
'roles' =>
array (
0 => 'viewer',
1 => 'editor',
),
'active' => true,
'last_login_at' => '2025-11-28',
),
3 =>
array (
'id' => 4,
'name' => 'Iris',
'roles' =>
array (
0 => 'editor',
),
'active' => true,
'last_login_at' => '2025-12-05',
),
)
相关函数说明
- array_filter(array $array, callable $callback = null, int $mode = 0): array
- 使用回调函数过滤数组元素；默认保留原有键名（索引）。
- array_intersect(array $array, array ...$arrays): array
- 计算数组的交集，用于判断 roles 是否包含指定角色之一。
- DateTimeImmutable::__construct(string $datetime = "now", ?DateTimeZone $timezone = null)
- DateInterval
- 表示时间间隔；配合 sub/add 计算阈值（如 P30D 表示 30 天）。
- DateTimeImmutable::createFromFormat(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTimeImmutable|false
- DateTime::getLastErrors(): array|false
- 获取最近一次日期时间解析的错误与警告，用于严格校验日期格式有效性。
