prepare($sql); $st->execute($args); return $st->fetchAll(); } public static function find(int $id): ?array { $st = Database::get()->prepare('SELECT * FROM persons WHERE id = ?'); $st->execute([$id]); $row = $st->fetch(); return $row ?: null; } /** 带账号信息的详情(详情页用) */ public static function findWithAccount(int $id): ?array { $st = Database::get()->prepare( 'SELECT p.*, a.id AS account_id, a.role AS account_role, a.status AS account_status, a.last_login_at FROM persons p LEFT JOIN accounts a ON a.person_id = p.id WHERE p.id = ?' ); $st->execute([$id]); $row = $st->fetch(); return $row ?: null; } public static function findByPhoneHash(string $hash): ?array { $st = Database::get()->prepare('SELECT * FROM persons WHERE phone_hash = ? LIMIT 1'); $st->execute([$hash]); $row = $st->fetch(); return $row ?: null; } /** * 新增。手机号是敏感字段,进来就加密 + 哈希。 * @return int 新 id */ public static function create(int $familyId, array $d): int { $phone = $d['phone'] ?? ''; $sql = 'INSERT INTO persons (family_id, kind, name, nickname, gender, birth_rank, birthday, avatar, phone_hash, phone_encrypted, id_card_encrypted, email, address, note, is_placeholder, sort_order) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)'; $st = Database::get()->prepare($sql); $st->execute([ $familyId, $d['kind'] ?? 'member', $d['name'], $d['nickname'] !== '' ? $d['nickname'] : null, $d['gender'] !== '' ? $d['gender'] : null, !empty($d['birth_rank']) ? (int)$d['birth_rank'] : null, $d['birthday'] !== '' ? $d['birthday'] : null, $d['avatar'] !== '' ? $d['avatar'] : null, $phone !== '' ? Crypto::hash($phone) : null, $phone !== '' ? Crypto::encrypt($phone) : null, ($d['id_card'] ?? '') !== '' ? Crypto::encrypt($d['id_card']) : null, $d['email'] !== '' ? $d['email'] : null, $d['address'] !== '' ? $d['address'] : null, $d['note'] !== '' ? $d['note'] : null, !empty($d['is_placeholder']) ? 1 : 0, (int)($d['sort_order'] ?? 1000), ]); return (int)Database::get()->lastInsertId(); } public static function update(int $id, array $d): void { $phone = $d['phone'] ?? ''; $sql = 'UPDATE persons SET name = ?, nickname = ?, gender = ?, birth_rank = ?, birthday = ?, avatar = ?, phone_hash = ?, phone_encrypted = ?, id_card_encrypted = ?, email = ?, address = ?, note = ?, is_placeholder = ?, sort_order = ? WHERE id = ?'; Database::get()->prepare($sql)->execute([ $d['name'], $d['nickname'] !== '' ? $d['nickname'] : null, $d['gender'] !== '' ? $d['gender'] : null, !empty($d['birth_rank']) ? (int)$d['birth_rank'] : null, $d['birthday'] !== '' ? $d['birthday'] : null, $d['avatar'] !== '' ? $d['avatar'] : null, $phone !== '' ? Crypto::hash($phone) : null, $phone !== '' ? Crypto::encrypt($phone) : null, ($d['id_card'] ?? '') !== '' ? Crypto::encrypt($d['id_card']) : null, $d['email'] !== '' ? $d['email'] : null, $d['address'] !== '' ? $d['address'] : null, $d['note'] !== '' ? $d['note'] : null, !empty($d['is_placeholder']) ? 1 : 0, (int)($d['sort_order'] ?? 1000), $id, ]); } /** 只改头像(上传后单独调用,避免整条记录被表单覆盖) */ public static function setAvatar(int $id, ?string $avatar): void { Database::get()->prepare('UPDATE persons SET avatar = ? WHERE id = ?') ->execute([$avatar, $id]); } public static function delete(int $id): void { Database::get()->prepare('DELETE FROM persons WHERE id = ?')->execute([$id]); } /** 全部家庭成员,以 id 为键 —— 家谱推导要按 id 频繁取人,这样最省事 */ public static function map(int $familyId, string $kind = 'member'): array { $st = Database::get()->prepare('SELECT * FROM persons WHERE family_id = ? AND kind = ?'); $st->execute([$familyId, $kind]); $out = []; foreach ($st->fetchAll() as $r) { $out[(int)$r['id']] = $r; } return $out; } /** 只给「选人」用的精简列表(下拉框、关系选择器) */ public static function options(int $familyId, int $exceptId = 0): array { $st = Database::get()->prepare( 'SELECT id, name, nickname, gender, is_placeholder FROM persons WHERE family_id = ? AND kind = "member" AND id <> ? ORDER BY sort_order ASC, id ASC' ); $st->execute([$familyId, $exceptId]); return $st->fetchAll(); } /** * 最近要过生日的人(首页用)。 * 直接算「今天是今年的第几天」与生日的差值,跨年自动处理。 */ public static function upcomingBirthdays(int $familyId, int $withinDays = 60): array { $st = Database::get()->prepare( "SELECT id, name, avatar, birthday FROM persons WHERE family_id = ? AND kind = 'member' AND birthday IS NOT NULL ORDER BY DAYOFYEAR(birthday)" ); $st->execute([$familyId]); $rows = $st->fetchAll(); $out = []; foreach ($rows as $r) { $days = days_until_birthday($r['birthday']); if ($days !== null && $days <= $withinDays) { $r['days_left'] = $days; $out[] = $r; } } usort($out, function ($a, $b) { return $a['days_left'] <=> $b['days_left']; }); return $out; } /** 校验表单,返回错误数组(空数组表示通过) */ public static function validate(array $d): array { $err = []; if (trim((string)($d['name'] ?? '')) === '') { $err['name'] = '姓名不能为空'; } $phone = trim((string)($d['phone'] ?? '')); if ($phone !== '' && !preg_match('/^\+?[0-9\-]{6,20}$/', $phone)) { $err['phone'] = '手机号格式看起来不对'; } $email = trim((string)($d['email'] ?? '')); if ($email !== '' && !filter_var($email, FILTER_VALIDATE_EMAIL)) { $err['email'] = '邮箱格式看起来不对'; } $b = trim((string)($d['birthday'] ?? '')); if ($b !== '' && !preg_match('/^\d{4}-\d{2}-\d{2}$/', $b)) { $err['birthday'] = '生日请按 年-月-日 填写'; } // 身份证号只做很松的校验:家庭场景里要不要存它,本来就值得三思 $idc = trim((string)($d['id_card'] ?? '')); if ($idc !== '' && !preg_match('/^[0-9Xx]{15,18}$/', $idc)) { $err['id_card'] = '身份证号应为 15 或 18 位'; } $rank = $d['birth_rank'] ?? ''; if ($rank !== '' && $rank !== null && (!ctype_digit((string)$rank) || (int)$rank < 1 || (int)$rank > 99)) { $err['birth_rank'] = '排行请填 1-99 的整数(老大填 1)'; } return $err; } /** 角色与人物的中文名 */ public static function genderWord(string $g): string { return ['m' => '男', 'f' => '女'][$g] ?? ''; } }