laoyang
02f5d072a4
用户 2026-10-03 提的四条：
① 家谱卡片重做
· 去掉「⇄ 姻亲」按钮，改成**每个人**卡片右下角都有「以 TA 为中心」
（点了以他重画一张家谱，涵盖原来的姻亲场景）。
· 头像外框改**长方形**（96×72，宽度贴合头像），object-fit: contain 不裁切，
姓名/称呼在头像下方。
· 修「点右下角按钮误进成员页」：卡片不再整张是 <a>，
只有姓名是链接，右下角是独立的 <button>（物理上分开，不抢点击）。
② 家谱文案与按钮清理
· 去掉副标题与下方图例说明；整块去掉「看全部 / 回到我 / 回到我的家谱」
（顺带消掉"出现两个回到我的家谱"）。镜头由库自动 fit，拖拽/滚轮即可。
③ 首页控制台
· 标题下显示个人 slogan；去掉右侧三个统计；「我的资料/我的家谱」换成图标按钮；
去掉与导航条重复的「名册」按钮。
· 去掉「接下来的日子」（生日归到"未来七天"里，不再重复）。
· 新增统计信息块：按时段随机问候 + 今日天气（Open-Meteo，免 key，可留空不显示）
+ 近七天日程/待办/逾期数。
· 新增各模块小结卡（任务/日程/纪念日/观影/旅程/财务/名册/家谱/资源）。
· 个人设置新增「首页上的模块」：可勾选与拖动排序（每人一份，存 user_settings）。
· 保留「往年的今天」。
④ 名册改列表
· 卡片网格 → **竖向列表**：左头像、中间姓名+与我的关系+手机号+生日。
· 修拖动「只能往后不能往前」：落点改为显式记录"插到谁前面/后面"，
并排除被拖元素自身。
· 去掉那句拖动提示（能力保留）。
· 搜索新增**姓名首字母**检索（y / yy / yyq 都命中「杨永全」）：
新 app/Pinyin.php，intl 优先 + 内置常用字表兜底（本地无 intl 也能测）；
纯字母/数字查询词不走 SQL LIKE（拼音与加密手机号在库里都比不了）。
附带上两轮的收尾：
· 菜单点外部自动关闭（全局事件委托，覆盖所有 details.menu）。
· 旅程 is_public：列表与日历只显示公开的；详情页不拦（不丢数据）。
· 重复日程：新 app/Repeat.php（RRULE 解析/生成/展开，含"工作日"），
新表 calendar_event_skips（RFC 的 EXDATE）；日历按规则展开；
编辑支持三档「全部 / 这一次及以后 / 仅此一次」。
· 结束时间可添加/去掉，并随开始时间联动。
验证：端到端 772 项通过 / 0 失败；几何 368、交互 97、移动端 516、家谱 26、
升级 123 全绿；SQL 列名静态校验 0 处可疑；部署 11 条线上探针全过。
470 lines
22 KiB
PHP
470 lines
22 KiB
PHP
<?php
|
||
/**
|
||
* 家庭名册（家庭成员 + 外部联系人共用一张表）。
|
||
*
|
||
* 之所以不拆成两张表：两者字段几乎一样；而且需要互相转换 ——
|
||
* 一个「认识的人」随时可能变成家庭成员，一个家庭成员也可能只作为联系人存在。
|
||
*
|
||
* 三处刻意的设计（都是被纠正过的）：
|
||
* · **小名不在这里**。称呼是"谁在叫"的属性，存在 nicknames 表（见 Nickname 类）。
|
||
* · 生日不是一个字段，是三个（身份证 / 阳历 / 农历），见 Birthday 类。
|
||
* · 姓名与称呼的读取都要过 `Nickname::display()`，页面不要直接 echo name。
|
||
*/
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace App;
|
||
|
||
final class Person
|
||
{
|
||
/**
|
||
* 名册列表（连带账号信息与「我叫他什么」）。
|
||
*
|
||
* `my_nickname` 是**当前登录者**给这个人起的称呼 —— 同一份名册，
|
||
* 爸爸看到的是"儿子"，妈妈看到的是"小宝"，靠的就是这个字段。
|
||
*/
|
||
public static function all(int $familyId, string $q = '', string $kind = 'member', int $viewerId = 0): array
|
||
{
|
||
$sql = 'SELECT p.*, a.id AS account_id, a.role AS account_role, a.status AS account_status,
|
||
a.last_login_at, n.nickname AS my_nickname
|
||
FROM persons p
|
||
LEFT JOIN accounts a ON a.person_id = p.id
|
||
LEFT JOIN nicknames n ON n.target_id = p.id AND n.viewer_id = ?';
|
||
$args = [$viewerId];
|
||
$sql .= ' WHERE p.family_id = ? AND p.kind = ?';
|
||
$args[] = $familyId;
|
||
$args[] = $kind;
|
||
if ($q !== '') {
|
||
// ⚠️ 纯字母/数字的查询词**不能**交给 SQL 的 LIKE 过滤：
|
||
// 它是"姓名首字母"（如 yyq），SQL 里根本没法把汉字转拼音，
|
||
// 一 LIKE 就把结果筛成空 —— 后面的 PHP 精筛也就没东西可筛了，
|
||
// 表现为"搜 yyq 一个人都没有"（功能像没做）。
|
||
// 所以这种查询词直接跳过 SQL 条件，全量取回来之后在 PHP 里筛
|
||
// （名册是个人小列表，几十条，全取完全没问题）。
|
||
//
|
||
// ⚠️ **也不能**用 SQL 过滤纯数字（手机号）：手机号是**加密存的**，
|
||
// 库里只有密文，SQL 的 LIKE 永远匹配不到明文数字。
|
||
// 数字查询同样交给 PHP 精筛（那里会解密后再比）。
|
||
$needSql = (bool)preg_match('/[^A-Za-z0-9]/u', $q);
|
||
if ($needSql) {
|
||
$sql .= ' AND (p.name LIKE ? OR p.email LIKE ? OR n.nickname LIKE ?)';
|
||
$like = '%' . $q . '%';
|
||
$args[] = $like;
|
||
$args[] = $like;
|
||
$args[] = $like;
|
||
}
|
||
}
|
||
$sql .= ' ORDER BY p.id ASC';
|
||
$st = Database::get()->prepare($sql);
|
||
$st->execute($args);
|
||
return $st->fetchAll();
|
||
}
|
||
|
||
/**
|
||
* **我的名册**：只列我自己的名册里的家庭成员（带分组与顺序）。
|
||
*
|
||
* 与 all() 的分工（v5 起两者不再是一回事）：
|
||
* · all() —— 全家庭的成员，不管是谁的名册（首页徽标、邀请访客等内部用途）；
|
||
* · roster() —— 名册页该显示的那些：我加的人 + 别人分享给我的，顺序是我的。
|
||
*
|
||
* 分组与顺序都从 person_roster 取（列名故意与老库的 persons.group_id /
|
||
* persons.sort_order 保持一致，调用方几乎不用改）。
|
||
*/
|
||
public static function roster(int $familyId, int $viewerId, string $kind = 'member', string $q = ''): array
|
||
{
|
||
// 用户 2026-10-03 第 4 条：名册改成列表，每行要显示「手机号 / 生日 / 与我的关系」
|
||
// → 手机号是加密存的，得在这里一并取出密文（下面解密，避免逐行再查一次）。
|
||
// → 关系称呼走 Kinship（每人算一次），不在 SQL 里。
|
||
$sql = 'SELECT p.*, r.group_id, r.sort_order, r.source AS roster_source,
|
||
a.id AS account_id, a.role AS account_role, a.status AS account_status,
|
||
a.last_login_at, n.nickname AS my_nickname
|
||
FROM person_roster r
|
||
JOIN persons p ON p.id = r.person_id
|
||
LEFT JOIN accounts a ON a.person_id = p.id
|
||
LEFT JOIN nicknames n ON n.target_id = p.id AND n.viewer_id = ?';
|
||
$args = [$viewerId];
|
||
$sql .= ' WHERE r.family_id = ? AND r.owner_id = ? AND p.kind = ?';
|
||
$args[] = $familyId;
|
||
$args[] = $viewerId;
|
||
$args[] = $kind;
|
||
if ($q !== '') {
|
||
// ⚠️ SQL 只在**能帮忙**时才粗筛，两个反例：
|
||
// · 纯字母（yyq）—— 那是"姓名首字母"，SQL 里没法把汉字转拼音，
|
||
// 一旦 LIKE 就把结果筛成空，后面的 PHP 精筛也就没东西可筛了；
|
||
// · 纯数字（手机号）—— 手机号是**加密存的**，库里只有密文，
|
||
// LIKE 永远匹配不到明文数字。
|
||
// 这两类都交给下面的 PHP 精筛（它会解密、会算首字母）。
|
||
// 只含中文/邮箱这类"库里有明文可比"的查询词才加 SQL 条件。
|
||
$needSql = (bool)preg_match('/[^A-Za-z0-9]/u', $q);
|
||
if ($needSql) {
|
||
$sql .= ' AND (p.name LIKE ? OR p.email LIKE ? OR n.nickname LIKE ?)';
|
||
$like = '%' . $q . '%';
|
||
$args[] = $like;
|
||
$args[] = $like;
|
||
$args[] = $like;
|
||
}
|
||
}
|
||
$sql .= ' ORDER BY r.sort_order ASC, p.id ASC';
|
||
$st = Database::get()->prepare($sql);
|
||
$st->execute($args);
|
||
$rows = $st->fetchAll();
|
||
|
||
// 用户 2026-10-03 第 4 条：再加**姓名首字母**检索（y / yy / yyq 都命中「杨永全」）。
|
||
// ⚠️ 不在 SQL 里做：SQL 侧没法把汉字转拼音（线上也没有现成的函数），
|
||
// 硬塞进 SQL 只能靠一堆 LIKE OR，既慢又不可能穷尽。
|
||
// 名册是**一个人自己的**小列表（几十条），在 PHP 里过滤完全够快。
|
||
// 做法：SQL 只在能帮忙时粗筛（中文/邮箱这类），然后**一律**走这里精筛一次。
|
||
// 精筛覆盖：姓名 / 称呼 / 邮箱 / **解密后的手机号** / 姓名首字母。
|
||
if ($q !== '') {
|
||
$rows = array_values(array_filter($rows, static function (array $r) use ($q): bool {
|
||
// 手机号是加密的，Pinyin::matches 认 phone_plain；这里把它带上再判一次
|
||
if (!empty($r['phone_encrypted'])) {
|
||
try {
|
||
$r['phone_plain'] = Crypto::decrypt((string)$r['phone_encrypted']);
|
||
} catch (\Throwable $e) {
|
||
// 解不开就当没填（不影响其它字段的匹配）
|
||
}
|
||
}
|
||
return Pinyin::matches($r, $q);
|
||
}));
|
||
}
|
||
return $rows;
|
||
}
|
||
|
||
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;
|
||
}
|
||
|
||
/** 带账号信息的详情（详情页用；$viewerId 用来取「我叫他什么」） */
|
||
public static function findWithAccount(int $id, int $viewerId = 0): ?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, n.nickname AS my_nickname
|
||
FROM persons p
|
||
LEFT JOIN accounts a ON a.person_id = p.id
|
||
LEFT JOIN nicknames n ON n.target_id = p.id AND n.viewer_id = ?
|
||
WHERE p.id = ?'
|
||
);
|
||
$st->execute([$viewerId, $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;
|
||
}
|
||
|
||
/**
|
||
* 新增。手机号是敏感字段，进来就加密 + 哈希；三个生日由 Birthday 规范化。
|
||
* @return int 新 id
|
||
*/
|
||
public static function create(int $familyId, array $d): int
|
||
{
|
||
$phone = (string)($d['phone'] ?? '');
|
||
$bd = Birthday::normalize($d);
|
||
$sql = 'INSERT INTO persons
|
||
(family_id, kind, name, gender, birth_rank, birthday,
|
||
birthday_id_card, birthday_lunar, birthday_lunar_leap, slogan, avatar,
|
||
phone_hash, phone_encrypted, id_card_encrypted, email, address, org, title, note,
|
||
is_placeholder)
|
||
VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)';
|
||
$st = Database::get()->prepare($sql);
|
||
$st->execute([
|
||
$familyId,
|
||
$d['kind'] ?? 'member',
|
||
$d['name'],
|
||
($d['gender'] ?? '') !== '' ? $d['gender'] : null,
|
||
!empty($d['birth_rank']) ? (int)$d['birth_rank'] : null,
|
||
$bd['solar'],
|
||
$bd['id_birthday'],
|
||
$bd['lunar'],
|
||
$bd['lunar_leap'],
|
||
($d['slogan'] ?? '') !== '' ? $d['slogan'] : 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['org'] ?? '') !== '' ? mb_substr(trim((string)$d['org']), 0, 120, 'UTF-8') : null,
|
||
($d['title'] ?? '') !== '' ? mb_substr(trim((string)$d['title']), 0, 120, 'UTF-8') : null,
|
||
($d['note'] ?? '') !== '' ? $d['note'] : null,
|
||
!empty($d['is_placeholder']) ? 1 : 0,
|
||
]);
|
||
return (int)Database::get()->lastInsertId();
|
||
}
|
||
|
||
public static function update(int $id, array $d): void
|
||
{
|
||
$phone = (string)($d['phone'] ?? '');
|
||
$bd = Birthday::normalize($d);
|
||
$sql = 'UPDATE persons SET
|
||
name = ?, gender = ?, birth_rank = ?, birthday = ?,
|
||
birthday_id_card = ?, birthday_lunar = ?, birthday_lunar_leap = ?, slogan = ?, avatar = ?,
|
||
phone_hash = ?, phone_encrypted = ?, id_card_encrypted = ?,
|
||
email = ?, address = ?, org = ?, title = ?, note = ?, is_placeholder = ?
|
||
WHERE id = ?';
|
||
Database::get()->prepare($sql)->execute([
|
||
$d['name'],
|
||
($d['gender'] ?? '') !== '' ? $d['gender'] : null,
|
||
!empty($d['birth_rank']) ? (int)$d['birth_rank'] : null,
|
||
$bd['solar'],
|
||
$bd['id_birthday'],
|
||
$bd['lunar'],
|
||
$bd['lunar_leap'],
|
||
($d['slogan'] ?? '') !== '' ? $d['slogan'] : 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['org'] ?? '') !== '' ? mb_substr(trim((string)$d['org']), 0, 120, 'UTF-8') : null,
|
||
($d['title'] ?? '') !== '' ? mb_substr(trim((string)$d['title']), 0, 120, 'UTF-8') : null,
|
||
($d['note'] ?? '') !== '' ? $d['note'] : null,
|
||
!empty($d['is_placeholder']) ? 1 : 0,
|
||
$id,
|
||
]);
|
||
}
|
||
|
||
/**
|
||
* 自助改自己的资料。
|
||
*
|
||
* 与上面的 update() 分开是有意的：那个是"能写的人编名册"，字段全、权限高；
|
||
* 这个只允许改**属于自己的**东西 —— 姓名、性别、三个生日、一句话、头像、联系方式。
|
||
* 排行、虚拟人物标记、以及身份证号（会牵动身份证生日）都只能由管理员改名册时动。
|
||
*
|
||
* ⚠️ v5 起这里**不再有**分组：分组是「我和他的关系」，挂在 person_roster 上，
|
||
* 只能在名册里拖或者在那张卡片的「调整分组」里改（见 PersonRoster::assignGroup）。
|
||
*/
|
||
public static function updateSelf(int $id, array $d): void
|
||
{
|
||
$bd = Birthday::normalize($d);
|
||
Database::get()->prepare(
|
||
'UPDATE persons SET
|
||
name = ?, gender = ?, birthday = ?,
|
||
birthday_id_card = ?, birthday_lunar = ?, birthday_lunar_leap = ?, slogan = ?, avatar = ?,
|
||
email = ?, address = ?, org = ?, title = ?, note = ?
|
||
WHERE id = ?'
|
||
)->execute([
|
||
$d['name'],
|
||
($d['gender'] ?? '') !== '' ? $d['gender'] : null,
|
||
$bd['solar'],
|
||
$bd['id_birthday'],
|
||
$bd['lunar'],
|
||
$bd['lunar_leap'],
|
||
($d['slogan'] ?? '') !== '' ? $d['slogan'] : null,
|
||
($d['avatar'] ?? '') !== '' ? $d['avatar'] : null,
|
||
($d['email'] ?? '') !== '' ? $d['email'] : null,
|
||
($d['address'] ?? '') !== '' ? $d['address'] : null,
|
||
($d['org'] ?? '') !== '' ? mb_substr(trim((string)$d['org']), 0, 120, 'UTF-8') : null,
|
||
($d['title'] ?? '') !== '' ? mb_substr(trim((string)$d['title']), 0, 120, 'UTF-8') : null,
|
||
($d['note'] ?? '') !== '' ? $d['note'] : null,
|
||
$id,
|
||
]);
|
||
}
|
||
|
||
// ---------------- 补充联系方式（vCard 对齐，v6 起） ----------------
|
||
//
|
||
// 「主手机号」不在这里：它是登录凭据（phone_hash 唯一约束、按它找人），
|
||
// 永远留在 persons.phone_*。contacts 存的是**额外的**电话 / 邮箱 / 地址 / 网址。
|
||
// 电话与主手机号同一把钥匙加密存（value 是密文），展示时用 Crypto::maskPhone 打码。
|
||
|
||
/** 某个人的全部补充联系方式，按 kind 分组；kind=phone 的 value 是**密文** */
|
||
public static function contactsOf(int $personId): array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
'SELECT kind, label, value FROM person_contacts
|
||
WHERE person_id = ? ORDER BY kind, position, id'
|
||
);
|
||
$st->execute([$personId]);
|
||
$out = ['phone' => [], 'email' => [], 'address' => [], 'url' => []];
|
||
foreach ($st->fetchAll() as $r) {
|
||
$out[(string)$r['kind']][] = ['label' => (string)$r['label'], 'value' => (string)$r['value']];
|
||
}
|
||
return $out;
|
||
}
|
||
|
||
/**
|
||
* 整组替换一个人的补充联系方式（delete + insert，幂等且不留下悬旧行）。
|
||
*
|
||
* @param string[][][] $byKind kind => 行列表，每行 ['label' => .., 'value' => ..]
|
||
* value 一律传**明文**；kind=phone 在这里统一加密。
|
||
* value 为空的行直接丢弃（表单会带出一排空行）。
|
||
*/
|
||
public static function replaceContacts(int $personId, array $byKind): void
|
||
{
|
||
$db = Database::get();
|
||
$ins = $db->prepare(
|
||
'INSERT INTO person_contacts (person_id, kind, label, value, position) VALUES (?,?,?,?,?)'
|
||
);
|
||
$db->prepare('DELETE FROM person_contacts WHERE person_id = ?')->execute([$personId]);
|
||
foreach (['phone', 'email', 'address', 'url'] as $kind) {
|
||
$pos = 100;
|
||
foreach (($byKind[$kind] ?? []) as $row) {
|
||
$value = trim((string)($row['value'] ?? ''));
|
||
if ($value === '') {
|
||
continue; // 空行是表单带出来的占位，不是数据
|
||
}
|
||
$label = mb_substr(trim((string)($row['label'] ?? '')), 0, 20, 'UTF-8');
|
||
if ($kind === 'phone') {
|
||
$value = Crypto::encrypt(mb_substr($value, 0, 60, 'UTF-8'));
|
||
} else {
|
||
$value = mb_substr($value, 0, 500, 'UTF-8');
|
||
}
|
||
$ins->execute([$personId, $kind, $label, $value, $pos]);
|
||
$pos += 10;
|
||
}
|
||
}
|
||
}
|
||
|
||
/** 只改头像（上传后单独调用，避免整条记录被表单覆盖） */
|
||
public static function setAvatar(int $id, ?string $avatar): void
|
||
{
|
||
Database::get()->prepare('UPDATE persons SET avatar = ? WHERE id = ?')
|
||
->execute([$avatar, $id]);
|
||
}
|
||
|
||
/**
|
||
* 只改头像主色。
|
||
*
|
||
* ⚠️ 空串**不写库**：算不出主色（灰片/纯色证件照）时应该让它保持 NULL，
|
||
* 让 AvatarColor::for() 落到「按姓名取色」的兜底上 ——
|
||
* 这时候才不会每次换图颜色乱跳。
|
||
*/
|
||
public static function setAvatarColor(int $id, ?string $hex): void
|
||
{
|
||
$hex = AvatarColor::normalize($hex);
|
||
if ($hex === '') {
|
||
return;
|
||
}
|
||
Database::get()->prepare('UPDATE persons SET avatar_color = ? WHERE id = ?')
|
||
->execute([$hex, $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, int $viewerId = 0): array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
'SELECT p.id, p.name, p.gender, p.avatar, p.is_placeholder, n.nickname AS my_nickname
|
||
FROM persons p
|
||
LEFT JOIN nicknames n ON n.target_id = p.id AND n.viewer_id = ?
|
||
WHERE p.family_id = ? AND p.kind = "member" AND p.id <> ?
|
||
ORDER BY p.id ASC'
|
||
);
|
||
$st->execute([$viewerId, $familyId, $exceptId]);
|
||
return $st->fetchAll();
|
||
}
|
||
|
||
/**
|
||
* 最近要过生日的人（首页用）。
|
||
*
|
||
* ⚠️ 这里返回的是「**一个生日事件**」而不是「一个人」：
|
||
* 一个人可能同时有身份证生日与农历生日两条（不重合时），
|
||
* 也可能它们正好落在同一天（那就是 1 条，kinds 里有两个）。
|
||
* 早先按"人"来算，于是农历生日完全不会被提醒 —— 而家里老人过的正是农历。
|
||
*/
|
||
public static function upcomingBirthdays(int $familyId, int $withinDays = 60): array
|
||
{
|
||
$today = date('Y-m-d');
|
||
$out = [];
|
||
foreach (self::map($familyId) as $p) {
|
||
foreach (Birthday::nextOccurrences($p, $today, $withinDays) as $occ) {
|
||
$out[] = [
|
||
'id' => (int)$p['id'],
|
||
'name' => (string)$p['name'],
|
||
'avatar' => $p['avatar'],
|
||
'date' => $occ['date'],
|
||
'days_left' => $occ['days'],
|
||
'kinds' => $occ['kinds'],
|
||
'kind_words' => array_map(fn($k) => Birthday::KINDS[$k] ?? $k, $occ['kinds']),
|
||
'lunar_label' => $occ['lunar_label'],
|
||
'age' => $occ['age'],
|
||
];
|
||
}
|
||
}
|
||
usort($out, function ($a, $b) {
|
||
return $a['days_left'] <=> $b['days_left'] ?: strcmp($a['date'], $b['date']);
|
||
});
|
||
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'] = '邮箱格式看起来不对';
|
||
}
|
||
// 生日现在是「日期 + 时分秒」，但要宽松：只填日期也必须收下
|
||
foreach (['birthday_solar' => '阳历生日', 'birthday_lunar' => '农历生日'] as $key => $word) {
|
||
$v = trim((string)($d[$key] ?? ''));
|
||
if ($v === '') {
|
||
continue;
|
||
}
|
||
if (!preg_match('/^\d{4}-\d{2}-\d{2}([ ]\d{2}:\d{2}(:\d{2})?)?$/', $v)) {
|
||
$err[$key] = $word . '格式不对';
|
||
continue;
|
||
}
|
||
[$yy, $mm, $dd] = array_map('intval', explode('-', substr($v, 0, 10)));
|
||
if (!checkdate($mm, $dd, $yy) || $yy < Lunar::MIN_YEAR || $yy > Lunar::MAX_YEAR) {
|
||
$err[$key] = $word . '看起来不是一个真实的日子';
|
||
}
|
||
}
|
||
// 身份证号只做很松的校验：家庭场景里要不要存它，本来就值得三思
|
||
$idc = trim((string)($d['id_card'] ?? ''));
|
||
if ($idc !== '' && !preg_match('/^\d{17}[\dXx]$|^\d{15}$/', $idc)) {
|
||
$err['id_card'] = '身份证号应为 18 位（或 15 位老证）';
|
||
}
|
||
$rank = $d['birth_rank'] ?? '';
|
||
if ($rank !== '' && $rank !== null && (!ctype_digit((string)$rank) || (int)$rank < 1 || (int)$rank > 99)) {
|
||
$err['birth_rank'] = '排行请填 1-99 的整数（老大填 1）';
|
||
}
|
||
$slogan = trim((string)($d['slogan'] ?? ''));
|
||
if (mb_strlen($slogan, 'UTF-8') > 200) {
|
||
$err['slogan'] = '一句话请控制在 200 字以内';
|
||
}
|
||
return $err;
|
||
}
|
||
|
||
/** 角色与人物的中文名 */
|
||
public static function genderWord(string $g): string
|
||
{
|
||
return ['m' => '男', 'f' => '女'][$g] ?? '';
|
||
}
|
||
}
|