图片可裁剪 · 名册按关系分组 · 个人设置独立 · 顶栏下拉菜单
① 上传图片一律可裁剪，比例由图位决定
新增 app/ImageSlot.php 统一配置（头像 1:1/512×512；题图 16:9 只留注释，
将来启用只加一行）。前端只挑区域、写回归一化矩形 "x,y,w,h"，真正裁剪在服务端
Upload::fitRegion()：夹回图内 → 在框内居中收缩到目标比例（不外扩）→ 钉住 sx+sw ≤ w。
比例解析单独写 parseRatioAttr()：parseFloat('16:9') 得 16，会把题图裁成细长条且不报错。
② 名册按关系分组，顺序每人可自定
分类全家共用（person_groups，另一个人可以自己加分类）；「自己的」只体现在顺序上
（user_settings.group_order，每人一份）。persons.group_id 故意不加外键（老库只能
ADD COLUMN），完整性由 PersonGroup 保证：删分类把人置回未分类，人不会从名册消失。
③ 设置分两级：系统设置 / 个人设置
个人设置拆成 templates/settings/me.php + _profile.php + _nicknames.php，
取代 templates/people/me.php（旧路由与旧表单仍兼容）。
④ 右上角「姓名/头像 + 下拉菜单」
原来是两个裸链接，窄屏会被 CSS 藏掉导致改密码/退出不可达；改成 <details> 零 JS 菜单
（app.js 只补「点外面 / Esc」）。菜单项：个人设置 / 系统设置（管理员）/ 修改密码 / 退出登录。
Schema 版本 3 → 4；安装与老库升级共用 PersonGroup::backfillMissing() 一条回填路径。
验证：php -l 全量；e2e 202/0（新增「关系分组」与「图片裁剪」两节）；老库升级 49/0；
桌面几何 108/0；移动端几何 192/0（360/375/390/414）；交互 76/0；
反向验证 31/31（逐条把修复改回旧写法，指定的目标断言必须变红）；
部署后本地↔线上 72 个文件 sha256 逐字节一致。
This commit is contained in:
@@ -0,0 +1,82 @@
|
||||
<?php
|
||||
/**
|
||||
* 上传位置（「槽位」）的声明式配置。
|
||||
*
|
||||
* 为什么要有这个类：**比例是由「这张图显示出来是什么形状」决定的**，不是由上传者决定的。
|
||||
* 头像在页面上永远是圆的/圆角方的 → 1:1；宽幅题图是横的 → 16:9。
|
||||
* 把这些写在一处，前端拿它去做裁剪框的锁定比例、服务端拿它去做最终裁切，
|
||||
* 两边就不会各写一个数字然后慢慢漂移。
|
||||
*
|
||||
* 加一个新位置（比如题图）只需要在 SLOTS 里加一行，前端与服务端都不用改：
|
||||
* 'cover' => ['label' => '题图', 'ratio' => '16:9', 'w' => 1920, 'h' => 1080,
|
||||
* 'dir' => 'covers', 'hint' => '宽屏横幅，显示在详情页顶部'],
|
||||
*/
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace App;
|
||||
|
||||
final class ImageSlot
|
||||
{
|
||||
/** 上传体积上限（前端也会提示，但以这里为准） */
|
||||
public const MAX_BYTES = 5 * 1024 * 1024;
|
||||
|
||||
/**
|
||||
* 位置 → 比例与输出尺寸。
|
||||
*
|
||||
* `dir` 是**存储前缀**：本地就是 uploads/<dir>/，云端就是桶里的 <prefix>/<dir>/。
|
||||
* `w`/`h` 是**输出**尺寸（不是要求上传者提供的尺寸）——
|
||||
* 裁剪之后统一缩到这个大小，所以原图多大都不影响页面上的加载量。
|
||||
*
|
||||
* ratio 写成字符串是为了让人一眼看懂，也方便直接拿去当 CSS 的 aspect-ratio。
|
||||
*/
|
||||
public const SLOTS = [
|
||||
'avatar' => [
|
||||
'label' => '头像',
|
||||
'ratio' => '1:1',
|
||||
'w' => 512,
|
||||
'h' => 512,
|
||||
'dir' => 'avatars',
|
||||
'hint' => '正方形。页面上显示成圆形或圆角方形，所以按 1:1 裁。',
|
||||
],
|
||||
// 题图按 16:9 —— 宽屏横幅。现在还没有位置用它，需要时把它启用即可：
|
||||
// 'cover' => ['label' => '题图', 'ratio' => '16:9', 'w' => 1920, 'h' => 1080,
|
||||
// 'dir' => 'covers', 'hint' => '宽屏横幅，显示在详情页顶部。'],
|
||||
];
|
||||
|
||||
public static function exists(string $key): bool
|
||||
{
|
||||
return isset(self::SLOTS[$key]);
|
||||
}
|
||||
|
||||
/** @return array<string,mixed>|null */
|
||||
public static function get(string $key): ?array
|
||||
{
|
||||
return self::SLOTS[$key] ?? null;
|
||||
}
|
||||
|
||||
/** 宽高比（宽 / 高）。'1:1' → 1.0，'16:9' → 1.777… */
|
||||
public static function ratio(array $slot): float
|
||||
{
|
||||
[$a, $b] = self::parseRatio((string)($slot['ratio'] ?? '1:1'));
|
||||
return $b > 0 ? $a / $b : 1.0;
|
||||
}
|
||||
|
||||
/** 给前端用的 CSS aspect-ratio 写法：'1 / 1'、'16 / 9' */
|
||||
public static function ratioCss(array $slot): string
|
||||
{
|
||||
[$a, $b] = self::parseRatio((string)($slot['ratio'] ?? '1:1'));
|
||||
return $a . ' / ' . $b;
|
||||
}
|
||||
|
||||
/** @return array{0:int,1:int} */
|
||||
private static function parseRatio(string $ratio): array
|
||||
{
|
||||
if (preg_match('/^\s*(\d+)\s*[:/]\s*(\d+)\s*$/', $ratio, $m)) {
|
||||
$a = max(1, (int)$m[1]);
|
||||
$b = max(1, (int)$m[2]);
|
||||
return [$a, $b];
|
||||
}
|
||||
return [1, 1];
|
||||
}
|
||||
}
|
||||
+19
-3
@@ -91,8 +91,8 @@ final class Person
|
||||
(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, note,
|
||||
is_placeholder, sort_order)
|
||||
VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)';
|
||||
is_placeholder, group_id, sort_order)
|
||||
VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)';
|
||||
$st = Database::get()->prepare($sql);
|
||||
$st->execute([
|
||||
$familyId,
|
||||
@@ -113,6 +113,7 @@ final class Person
|
||||
($d['address'] ?? '') !== '' ? $d['address'] : null,
|
||||
($d['note'] ?? '') !== '' ? $d['note'] : null,
|
||||
!empty($d['is_placeholder']) ? 1 : 0,
|
||||
!empty($d['group_id']) ? (int)$d['group_id'] : null,
|
||||
(int)($d['sort_order'] ?? 1000),
|
||||
]);
|
||||
return (int)Database::get()->lastInsertId();
|
||||
@@ -126,7 +127,7 @@ final class Person
|
||||
name = ?, gender = ?, birth_rank = ?, birthday = ?,
|
||||
birthday_id_card = ?, birthday_lunar = ?, birthday_lunar_leap = ?, slogan = ?, avatar = ?,
|
||||
phone_hash = ?, phone_encrypted = ?, id_card_encrypted = ?,
|
||||
email = ?, address = ?, note = ?, is_placeholder = ?, sort_order = ?
|
||||
email = ?, address = ?, note = ?, is_placeholder = ?, group_id = ?, sort_order = ?
|
||||
WHERE id = ?';
|
||||
Database::get()->prepare($sql)->execute([
|
||||
$d['name'],
|
||||
@@ -145,11 +146,26 @@ final class Person
|
||||
($d['address'] ?? '') !== '' ? $d['address'] : null,
|
||||
($d['note'] ?? '') !== '' ? $d['note'] : null,
|
||||
!empty($d['is_placeholder']) ? 1 : 0,
|
||||
// ⚠️ 这里不能用 `!empty($d['group_id'])` 之外的花样：
|
||||
// "清空分组"（改成未分类）也是一个合法意图，所以 0/'' 一律落成 NULL。
|
||||
!empty($d['group_id']) ? (int)$d['group_id'] : null,
|
||||
(int)($d['sort_order'] ?? 1000),
|
||||
$id,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 只改「这个人属于哪一组」（名册上的快捷归类用）。
|
||||
*
|
||||
* 单独一个方法，是为了让名册那一小块表单**不必**把整条记录回传 ——
|
||||
* 否则一次归类提交就要带上姓名/生日/身份证号，任何一处没带全就会把数据改坏。
|
||||
*/
|
||||
public static function setGroup(int $id, ?int $groupId): void
|
||||
{
|
||||
Database::get()->prepare('UPDATE persons SET group_id = ? WHERE id = ?')
|
||||
->execute([$groupId ?: null, $id]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 自助改自己的资料（个人信息页用）。
|
||||
*
|
||||
|
||||
@@ -0,0 +1,288 @@
|
||||
<?php
|
||||
/**
|
||||
* 关系分组：一个人属于哪一组（家人 / 亲戚 / 同事 / 朋友 …），名册按它分组展示。
|
||||
*
|
||||
* 三条刻意的设计：
|
||||
* ① **分类是全家共用的，顺序是各人各定的。**
|
||||
* 老杨的同事，对全家来说都是同事 —— 所以分类只存一份（persons.group_id）。
|
||||
* 但「哪一组排前面」纯属个人习惯，存在 user_settings.group_order 里，
|
||||
* 每个人可以不一样（爸爸把「家人」排第一，妈妈把「亲戚」排第一）。
|
||||
* ② **分类可以由用户自己加。** 所以是表而不是 ENUM —— 预置的七个只是初始值，
|
||||
* 觉得不够就自己加，加错了可以改名或删掉。
|
||||
* ③ **不用外键约束 group_id。** 老库升级只能 ADD COLUMN，加不上外键，
|
||||
* 新装的又加了就会两边结构不一致；索性统一由程序保证 ——
|
||||
* 删除分组时把挂靠的人置为「未分类」（NULL），不留悬空 id。
|
||||
*/
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace App;
|
||||
|
||||
final class PersonGroup
|
||||
{
|
||||
/** 预置分组的来源在 Schema::DEFAULT_GROUPS（安装与升级共用一份，避免两处漂移） */
|
||||
|
||||
/**
|
||||
* 给一个家庭补齐预置分组。幂等 —— 靠 uk_group_name 唯一键，重跑不会重复插入。
|
||||
* 也不覆盖用户改过的名字（同名才算重复，改名后重跑会**补回**那个默认名，
|
||||
* 这正是想要的：删掉的默认分组下次升级会回来，用户自定义的则不受影响）。
|
||||
*/
|
||||
public static function seedDefaults(int $familyId): void
|
||||
{
|
||||
if ($familyId <= 0) {
|
||||
return;
|
||||
}
|
||||
$st = Database::get()->prepare(
|
||||
'INSERT IGNORE INTO person_groups (family_id, name, position, is_builtin) VALUES (?, ?, ?, 1)'
|
||||
);
|
||||
foreach (Schema::DEFAULT_GROUPS as $name => $pos) {
|
||||
$st->execute([$familyId, $name, $pos]);
|
||||
}
|
||||
}
|
||||
|
||||
/** 全部分组，id => 行（按默认顺序） */
|
||||
public static function byId(int $familyId): array
|
||||
{
|
||||
$st = Database::get()->prepare(
|
||||
'SELECT * FROM person_groups WHERE family_id = ? ORDER BY position ASC, id ASC'
|
||||
);
|
||||
$st->execute([$familyId]);
|
||||
$out = [];
|
||||
foreach ($st->fetchAll() as $r) {
|
||||
$out[(int)$r['id']] = $r;
|
||||
}
|
||||
return $out;
|
||||
}
|
||||
|
||||
/**
|
||||
* 按**当前用户自定义的顺序**返回分组（用户没自定义过就按默认位置）。
|
||||
*
|
||||
* 自定义顺序里没提到的分组（用户排序之后才新建的）一律追加到最后 ——
|
||||
* 这样「新建一个分组」不会因为它不在旧顺序里就消失不见。
|
||||
*/
|
||||
public static function orderFor(int $familyId, int $viewerId = 0): array
|
||||
{
|
||||
$rest = self::byId($familyId);
|
||||
if (!$rest) {
|
||||
return [];
|
||||
}
|
||||
if ($viewerId > 0) {
|
||||
$raw = (string)UserSetting::get($viewerId, 'group_order', '');
|
||||
$saved = $raw === '' ? null : json_decode($raw, true);
|
||||
if (is_array($saved) && $saved) {
|
||||
$ordered = [];
|
||||
foreach ($saved as $id) {
|
||||
$id = (int)$id;
|
||||
if (isset($rest[$id])) {
|
||||
$ordered[$id] = $rest[$id];
|
||||
unset($rest[$id]);
|
||||
}
|
||||
}
|
||||
foreach ($rest as $id => $g) {
|
||||
$ordered[$id] = $g;
|
||||
}
|
||||
return array_values($ordered);
|
||||
}
|
||||
}
|
||||
return array_values($rest);
|
||||
}
|
||||
|
||||
/** 保存「我」的分组顺序（只影响我自己） */
|
||||
public static function saveOrder(int $familyId, int $viewerId, array $ids): void
|
||||
{
|
||||
$valid = self::byId($familyId);
|
||||
$clean = [];
|
||||
foreach ($ids as $id) {
|
||||
$id = (int)$id;
|
||||
if (isset($valid[$id]) && !in_array($id, $clean, true)) {
|
||||
$clean[] = $id;
|
||||
}
|
||||
}
|
||||
// 没提到的补齐到末尾 —— 保存完整顺序，读回来才不会因为"缺项"而错位
|
||||
foreach (array_keys($valid) as $id) {
|
||||
if (!in_array($id, $clean, true)) {
|
||||
$clean[] = $id;
|
||||
}
|
||||
}
|
||||
UserSetting::set($viewerId, 'group_order', json_encode($clean, JSON_UNESCAPED_UNICODE));
|
||||
}
|
||||
|
||||
/** 分组名（找不到就返回空串，调用方自己决定回退文案） */
|
||||
public static function name(int $familyId, ?int $id): string
|
||||
{
|
||||
if (!$id) {
|
||||
return '';
|
||||
}
|
||||
$st = Database::get()->prepare('SELECT name FROM person_groups WHERE family_id = ? AND id = ?');
|
||||
$st->execute([$familyId, $id]);
|
||||
return (string)($st->fetchColumn() ?: '');
|
||||
}
|
||||
|
||||
/**
|
||||
* 新增一个分组。
|
||||
* @return array{ok:bool,id?:int,error?:string}
|
||||
*/
|
||||
public static function add(int $familyId, string $name): array
|
||||
{
|
||||
$name = trim($name);
|
||||
$bad = self::validateName($name);
|
||||
if ($bad !== '') {
|
||||
return ['ok' => false, 'error' => $bad];
|
||||
}
|
||||
$st = Database::get()->prepare(
|
||||
'SELECT COUNT(*) FROM person_groups WHERE family_id = ? AND name = ?'
|
||||
);
|
||||
$st->execute([$familyId, $name]);
|
||||
if ((int)$st->fetchColumn() > 0) {
|
||||
return ['ok' => false, 'error' => '已经有叫「' . $name . '」的分组了。'];
|
||||
}
|
||||
// ⚠️ 别写成 `$max = (int)$db->prepare(...)->execute([...])`：
|
||||
// PDOStatement::execute() 返回 bool，强转永远是 1 —— 位置会算错。
|
||||
$st2 = Database::get()->prepare('SELECT COALESCE(MAX(position), 0) FROM person_groups WHERE family_id = ?');
|
||||
$st2->execute([$familyId]);
|
||||
$max = (int)$st2->fetchColumn();
|
||||
Database::get()->prepare(
|
||||
'INSERT INTO person_groups (family_id, name, position, is_builtin) VALUES (?, ?, ?, 0)'
|
||||
)->execute([$familyId, $name, max($max + 10, 80)]);
|
||||
return ['ok' => true, 'id' => (int)Database::get()->lastInsertId()];
|
||||
}
|
||||
|
||||
/** @return array{ok:bool,error?:string} */
|
||||
public static function rename(int $familyId, int $id, string $name): array
|
||||
{
|
||||
$name = trim($name);
|
||||
$bad = self::validateName($name);
|
||||
if ($bad !== '') {
|
||||
return ['ok' => false, 'error' => $bad];
|
||||
}
|
||||
$st = Database::get()->prepare(
|
||||
'SELECT COUNT(*) FROM person_groups WHERE family_id = ? AND name = ? AND id <> ?'
|
||||
);
|
||||
$st->execute([$familyId, $name, $id]);
|
||||
if ((int)$st->fetchColumn() > 0) {
|
||||
return ['ok' => false, 'error' => '已经有叫「' . $name . '」的分组了。'];
|
||||
}
|
||||
$st = Database::get()->prepare('UPDATE person_groups SET name = ? WHERE family_id = ? AND id = ?');
|
||||
$st->execute([$name, $familyId, $id]);
|
||||
if ($st->rowCount() === 0) {
|
||||
return ['ok' => false, 'error' => '找不到这个分组。'];
|
||||
}
|
||||
return ['ok' => true];
|
||||
}
|
||||
|
||||
/**
|
||||
* 删除一个分组。挂在这个分组下的人**不会消失**，只是变成「未分类」——
|
||||
* 名册上会多出一个「未分类」组提醒去归类。
|
||||
* 最后一个分组不给删：全删光就没有任何分类可用了，那是死路。
|
||||
*
|
||||
* @return array{ok:bool,error?:string,moved?:int}
|
||||
*/
|
||||
public static function delete(int $familyId, int $id): array
|
||||
{
|
||||
$all = self::byId($familyId);
|
||||
if (!isset($all[$id])) {
|
||||
return ['ok' => false, 'error' => '找不到这个分组。'];
|
||||
}
|
||||
if (count($all) <= 1) {
|
||||
return ['ok' => false, 'error' => '至少要留一个分组 —— 全删光就没法给成员归类了。'];
|
||||
}
|
||||
$db = Database::get();
|
||||
$st = $db->prepare('SELECT COUNT(*) FROM persons WHERE family_id = ? AND group_id = ?');
|
||||
$st->execute([$familyId, $id]);
|
||||
$moved = (int)$st->fetchColumn();
|
||||
|
||||
$db->prepare('UPDATE persons SET group_id = NULL WHERE family_id = ? AND group_id = ?')
|
||||
->execute([$familyId, $id]);
|
||||
$db->prepare('DELETE FROM person_groups WHERE family_id = ? AND id = ?')
|
||||
->execute([$familyId, $id]);
|
||||
|
||||
// 各人自定义顺序里可能留着这个 id，清掉免得越积越脏
|
||||
self::pruneOrder($familyId, $id);
|
||||
return ['ok' => true, 'moved' => $moved];
|
||||
}
|
||||
|
||||
/** 分组名规则：1–20 字、不许只剩空白 */
|
||||
private static function validateName(string $name): string
|
||||
{
|
||||
if ($name === '') {
|
||||
return '分组名不能为空。';
|
||||
}
|
||||
if (mb_strlen($name, 'UTF-8') > 20) {
|
||||
return '分组名请控制在 20 字以内。';
|
||||
}
|
||||
return '';
|
||||
}
|
||||
|
||||
/** 从所有人的自定义顺序里剔除某个分组 id（删组之后调用） */
|
||||
private static function pruneOrder(int $familyId, int $removedId): void
|
||||
{
|
||||
$db = Database::get();
|
||||
$st = $db->prepare(
|
||||
'SELECT us.person_id, us.v FROM user_settings us
|
||||
JOIN persons p ON p.id = us.person_id
|
||||
WHERE p.family_id = ? AND us.k = ?'
|
||||
);
|
||||
$st->execute([$familyId, 'group_order']);
|
||||
foreach ($st->fetchAll() as $row) {
|
||||
$ids = json_decode((string)$row['v'], true);
|
||||
if (!is_array($ids)) {
|
||||
continue;
|
||||
}
|
||||
$keep = array_values(array_filter($ids, fn($x) => (int)$x !== $removedId));
|
||||
$db->prepare('UPDATE user_settings SET v = ? WHERE person_id = ? AND k = ?')
|
||||
->execute([json_encode(array_map('intval', $keep)), (int)$row['person_id'], 'group_order']);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 老库升级：把还没有分组的人按名册类型补一个合理默认。
|
||||
* 家庭成员 → 家人；外部联系人 → 认识。
|
||||
* 只补 NULL，用户自己改过的一律不动（幂等）。
|
||||
*/
|
||||
public static function backfillMissing(\PDO $db): void
|
||||
{
|
||||
foreach ($db->query('SELECT id FROM families')->fetchAll() as $fam) {
|
||||
$fid = (int)$fam['id'];
|
||||
// 家庭可能还没套用预置分组（ensure 的 seed 在表建好之后才跑）
|
||||
$st = $db->prepare('SELECT COUNT(*) FROM person_groups WHERE family_id = ?');
|
||||
$st->execute([$fid]);
|
||||
if ((int)$st->fetchColumn() === 0) {
|
||||
self::seedDefaults($fid);
|
||||
}
|
||||
foreach ([['member', '家人'], ['contact', '认识']] as [$kind, $name]) {
|
||||
$gid = self::idByName($fid, $name);
|
||||
if ($gid === 0) {
|
||||
continue;
|
||||
}
|
||||
$db->prepare(
|
||||
'UPDATE persons SET group_id = ?
|
||||
WHERE family_id = ? AND kind = ? AND group_id IS NULL'
|
||||
)->execute([$gid, $fid, $kind]);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/** 按名字找分组 id（找不到返回 0） */
|
||||
public static function idByName(int $familyId, string $name): int
|
||||
{
|
||||
$st = Database::get()->prepare('SELECT id FROM person_groups WHERE family_id = ? AND name = ?');
|
||||
$st->execute([$familyId, $name]);
|
||||
return (int)($st->fetchColumn() ?: 0);
|
||||
}
|
||||
|
||||
/** 每个分组里有多少人（没分组的人记在键 0 上） */
|
||||
public static function counts(int $familyId, string $kind = 'member'): array
|
||||
{
|
||||
$st = Database::get()->prepare(
|
||||
'SELECT COALESCE(group_id, 0) AS g, COUNT(*) AS n
|
||||
FROM persons WHERE family_id = ? AND kind = ?
|
||||
GROUP BY COALESCE(group_id, 0)'
|
||||
);
|
||||
$st->execute([$familyId, $kind]);
|
||||
$out = [];
|
||||
foreach ($st->fetchAll() as $r) {
|
||||
$out[(int)$r['g']] = (int)$r['n'];
|
||||
}
|
||||
return $out;
|
||||
}
|
||||
}
|
||||
+53
-1
@@ -24,8 +24,10 @@ final class Schema
|
||||
* 1 → 初始（families/persons/accounts/settings/relations）
|
||||
* 2 → birth_rank、is_placeholder、accounts.role 加 guest
|
||||
* 3 → 三个生日（birthday 升 DATETIME + id_card/lunar/leap）、slogan、nicknames 表
|
||||
* 4 → person_groups（关系分组，全家统一但可自定义）、persons.group_id、
|
||||
* user_settings（「我的」维度设置：分组顺序等）
|
||||
*/
|
||||
public const VERSION = '3';
|
||||
public const VERSION = '4';
|
||||
|
||||
/** @return string[] */
|
||||
public static function statements(): array
|
||||
@@ -58,12 +60,14 @@ CREATE TABLE IF NOT EXISTS `persons` (
|
||||
`address` VARCHAR(200) DEFAULT NULL,
|
||||
`note` TEXT DEFAULT NULL COMMENT '备注',
|
||||
`is_placeholder` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '虚拟人物：还没弄清真实身份的占位（如「我的父亲」）',
|
||||
`group_id` INT UNSIGNED DEFAULT NULL COMMENT '关系分组（人属于哪一组：家人/同事/朋友…），全家人共用一套分类',
|
||||
`sort_order` INT NOT NULL DEFAULT 1000 COMMENT '名册排序，小的在前',
|
||||
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_phone_hash` (`phone_hash`),
|
||||
KEY `idx_family_kind` (`family_id`, `kind`, `sort_order`),
|
||||
KEY `idx_person_group` (`group_id`),
|
||||
CONSTRAINT `fk_persons_family` FOREIGN KEY (`family_id`) REFERENCES `families` (`id`) ON DELETE CASCADE
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='家庭名册'
|
||||
SQL,
|
||||
@@ -123,10 +127,45 @@ CREATE TABLE IF NOT EXISTS `nicknames` (
|
||||
CONSTRAINT `fk_nick_viewer` FOREIGN KEY (`viewer_id`) REFERENCES `persons` (`id`) ON DELETE CASCADE,
|
||||
CONSTRAINT `fk_nick_target` FOREIGN KEY (`target_id`) REFERENCES `persons` (`id`) ON DELETE CASCADE
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='称呼是视角属性：每个人各自决定怎么称呼别人，不挂在被称呼者身上'
|
||||
SQL,
|
||||
<<<'SQL'
|
||||
CREATE TABLE IF NOT EXISTS `person_groups` (
|
||||
`id` INT UNSIGNED NOT NULL AUTO_INCREMENT,
|
||||
`family_id` INT UNSIGNED NOT NULL,
|
||||
`name` VARCHAR(20) NOT NULL COMMENT '分组名，如「家人」「同事」',
|
||||
`position` INT NOT NULL DEFAULT 100 COMMENT '默认顺序（用户没自定义顺序时按它排）',
|
||||
`is_builtin` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '1=安装时预置的分组',
|
||||
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
PRIMARY KEY (`id`),
|
||||
UNIQUE KEY `uk_group_name` (`family_id`, `name`),
|
||||
KEY `idx_group_family` (`family_id`, `position`),
|
||||
CONSTRAINT `fk_group_family` FOREIGN KEY (`family_id`) REFERENCES `families` (`id`) ON DELETE CASCADE
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='关系分组：全家人共用一套（一个人只属于一个分组），但每个人可以各自决定分组的先后'
|
||||
SQL,
|
||||
<<<'SQL'
|
||||
CREATE TABLE IF NOT EXISTS `user_settings` (
|
||||
`person_id` INT UNSIGNED NOT NULL COMMENT '这条设置属于谁（登录者本人）',
|
||||
`k` VARCHAR(64) NOT NULL,
|
||||
`v` TEXT DEFAULT NULL,
|
||||
`updated_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
|
||||
PRIMARY KEY (`person_id`, `k`),
|
||||
CONSTRAINT `fk_uset_person` FOREIGN KEY (`person_id`) REFERENCES `persons` (`id`) ON DELETE CASCADE
|
||||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='「我自己的」设置：只影响我自己看到的样子'
|
||||
SQL,
|
||||
];
|
||||
}
|
||||
|
||||
/** 安装时预置的关系分组（用户可自行增删改名，这里只是初始值） */
|
||||
public const DEFAULT_GROUPS = [
|
||||
'家人' => 10,
|
||||
'亲戚' => 20,
|
||||
'同事' => 30,
|
||||
'朋友' => 40,
|
||||
'合作伙伴' => 50,
|
||||
'认识' => 60,
|
||||
'不熟' => 70,
|
||||
];
|
||||
|
||||
/**
|
||||
* 幂等结构升级：建表 + 补齐后加的列/枚举值。
|
||||
*
|
||||
@@ -175,6 +214,19 @@ SQL,
|
||||
foreach ($db->query('SELECT id FROM families')->fetchAll() as $fam) {
|
||||
\App\Nickname::migrateLegacy((int)$fam['id']);
|
||||
}
|
||||
|
||||
// ---- 关系分组（版本 4）----
|
||||
// persons 新增 group_id。这里**不加外键**：老库只能 ADD COLUMN，加不上约束，
|
||||
// 新装的加了就会两边结构不一致；统一由 PersonGroup 保证不留悬空 id。
|
||||
self::addColumn($db, 'persons', 'group_id',
|
||||
"ADD COLUMN `group_id` INT UNSIGNED DEFAULT NULL COMMENT '关系分组（人属于哪一组：家人/同事/朋友…），全家人共用一套分类' AFTER `is_placeholder`");
|
||||
// 每个家庭都要有一套预置分组（新装的由 install.php 建，老的在这里补）
|
||||
foreach ($db->query('SELECT id FROM families')->fetchAll() as $fam) {
|
||||
\App\PersonGroup::seedDefaults((int)$fam['id']);
|
||||
}
|
||||
// 老库的人还没有分组 → 按名册类型补：家庭成员=家人、外部联系人=认识。
|
||||
// 只补空的，用户自己改过的一律不动。
|
||||
\App\PersonGroup::backfillMissing($db);
|
||||
}
|
||||
|
||||
/** 老库已有阳历生日但没有农历生日 → 补算一次。用「为空」作条件，天然幂等。 */
|
||||
|
||||
+171
-27
@@ -1,13 +1,20 @@
|
||||
<?php
|
||||
/**
|
||||
* 头像上传：裁成正方形、缩到 512×512、转成 JPEG，然后交给 Storage 落盘。
|
||||
* 图片上传：按**位置的显示形状**裁切（头像 1:1、题图 16:9…）→ 缩到固定尺寸 → 转 JPEG
|
||||
* → 交给 Storage 落盘。落盘位置由「设置」决定（本地 或 阿里云 OSS），本类不关心。
|
||||
*
|
||||
* 落盘位置由「设置」决定（本地 或 阿里云 OSS），本类不关心。
|
||||
* 裁剪为什么是**服务端**在裁（前端只是给用户挑区域）：
|
||||
* · 服务端是唯一能保证「不管前端发来什么，落库的图一定是 1:1」的地方。
|
||||
* 如果只靠前端 canvas 裁好再传，绕过前端（或 JS 没跑到）就会存进一张不是 1:1 的图，
|
||||
* 页面上要么变形、要么被 object-fit 二次裁掉一半脸。
|
||||
* · 前端只传一个**归一化的矩形**（相对原图的比例，如 "0.2,0.1,0.5,0.5"），
|
||||
* 与原图分辨率无关 —— 用户换台设备、原图被压缩过，这个矩形照样对得上。
|
||||
* · 没有这个矩形（用户没裁 / 没 JS）→ 退回**居中裁切**，与老行为一致，不报错。
|
||||
*
|
||||
* 安全要点：
|
||||
* - 用 finfo 判断真实 MIME，不信浏览器给的扩展名
|
||||
* - 文件名随机，绝不使用用户提供的名字（防路径穿越与扩展名绕过）
|
||||
* - 本地落盘时进 uploads/，该目录有 .htaccess 禁止执行脚本
|
||||
* · 用 finfo 判断真实 MIME，不信浏览器给的扩展名
|
||||
* · 文件名随机，绝不使用用户提供的名字（防路径穿越与扩展名绕过）
|
||||
* · 内存先设上限：超大图直接判错，别把 PHP 进程撑爆
|
||||
*/
|
||||
|
||||
declare(strict_types=1);
|
||||
@@ -18,13 +25,21 @@ use App\Storage\Storage;
|
||||
|
||||
final class Upload
|
||||
{
|
||||
private const MAX_BYTES = 5 * 1024 * 1024;
|
||||
private const SIZE = 512;
|
||||
|
||||
/** @return array{ok:bool,file?:string,error?:string} */
|
||||
public static function avatar(int $familyId, array $file): array
|
||||
/**
|
||||
* 图片类上传的统一入口。
|
||||
*
|
||||
* @param string $slotKey ImageSlot::SLOTS 里的键（决定比例与输出尺寸）
|
||||
* @param string $cropRaw 前端挑的裁剪区域，归一化 "x,y,w,h"（相对原图 0..1）；留空=居中裁
|
||||
* @return array{ok:bool,file?:string,error?:string,note?:string,slot?:string,crop?:array}
|
||||
*/
|
||||
public static function image(int $familyId, array $file, string $slotKey, string $cropRaw = ''): array
|
||||
{
|
||||
// 「表单里压根没有这个字段」= 用户没打算换头像，不是错误。
|
||||
$slot = ImageSlot::get($slotKey);
|
||||
if ($slot === null) {
|
||||
return ['ok' => false, 'error' => '上传位置配置不正确（' . $slotKey . '）'];
|
||||
}
|
||||
|
||||
// 「表单里压根没有这个字段」= 用户没打算换图，不是错误。
|
||||
// ⚠️ 早先这里一律报「上传参数不对」，于是任何**不带 enctype 多部分**的
|
||||
// 调用（或没有该字段的表单）都会被判成校验失败，整条新增/编辑被挡下，
|
||||
// 表现却是「表单提交后又回到表单、什么都没说」—— 很难查。
|
||||
@@ -41,13 +56,13 @@ final class Upload
|
||||
return ['ok' => false, 'error' => ''];
|
||||
case UPLOAD_ERR_INI_SIZE:
|
||||
case UPLOAD_ERR_FORM_SIZE:
|
||||
return ['ok' => false, 'error' => '图片太大了（上限 5MB）'];
|
||||
return ['ok' => false, 'error' => '图片太大了（上限 ' . self::maxMbWord() . '）'];
|
||||
default:
|
||||
return ['ok' => false, 'error' => '上传失败（错误码 ' . (int)$file['error'] . '）'];
|
||||
}
|
||||
|
||||
if ($file['size'] > self::MAX_BYTES) {
|
||||
return ['ok' => false, 'error' => '图片太大了（上限 5MB）'];
|
||||
if ((int)$file['size'] > ImageSlot::MAX_BYTES) {
|
||||
return ['ok' => false, 'error' => '图片太大了（上限 ' . self::maxMbWord() . '）'];
|
||||
}
|
||||
|
||||
$finfo = new \finfo(FILEINFO_MIME_TYPE);
|
||||
@@ -58,26 +73,45 @@ final class Upload
|
||||
return ['ok' => false, 'error' => '只支持 JPG / PNG / GIF / WebP 图片'];
|
||||
}
|
||||
|
||||
$src = $allow[$mime]($file['tmp_name']);
|
||||
// 先用 getimagesize 拿到尺寸 —— 像素数太大就直接拒，避免 imagecreatefrom* 把内存吃光
|
||||
$info = @getimagesize($file['tmp_name']);
|
||||
if (!$info || $info[0] < 1 || $info[1] < 1) {
|
||||
return ['ok' => false, 'error' => '图片读不出来'];
|
||||
}
|
||||
if ($info[0] * $info[1] > 40_000_000) {
|
||||
return ['ok' => false, 'error' => '图片像素太多（超过 4000 万），请先压缩再传'];
|
||||
}
|
||||
|
||||
$src = @$allow[$mime]($file['tmp_name']);
|
||||
if (!$src) {
|
||||
return ['ok' => false, 'error' => '图片读不出来'];
|
||||
}
|
||||
|
||||
$w = imagesx($src);
|
||||
$h = imagesy($src);
|
||||
$side = min($w, $h);
|
||||
$sx = (int)(($w - $side) / 2);
|
||||
$sy = (int)(($h - $side) / 2);
|
||||
|
||||
$canvas = imagecreatetruecolor(self::SIZE, self::SIZE);
|
||||
// 先按目标比例、在「用户挑的区域」里定位 —— 区域非法时退回整图居中
|
||||
$region = self::readCrop($cropRaw, $w, $h);
|
||||
[$sx, $sy, $sw, $sh] = self::fitRegion($region ?? [0.0, 0.0, 1.0, 1.0], $w, $h, ImageSlot::ratio($slot));
|
||||
// 「框小到没有意义」要明确拒绝（放大之后就是一坨马赛克）。
|
||||
// ⚠️ 只在**用户真的给了裁剪框**时判：源图本身很小（比如 8×8 的老头像、
|
||||
// 或者是张一像素级的测试图）时，居中裁出来的区域自然也小 ——
|
||||
// 那种情况必须照常接受，否则一张本来能用的图会被"太小"挡在外面。
|
||||
if ($region !== null && ($sw < 16 || $sh < 16)) {
|
||||
imagedestroy($src);
|
||||
return ['ok' => false, 'error' => '裁剪区域太小了，请把框放大一点'];
|
||||
}
|
||||
|
||||
$outW = (int)$slot['w'];
|
||||
$outH = (int)$slot['h'];
|
||||
$canvas = imagecreatetruecolor($outW, $outH);
|
||||
// PNG/GIF 的透明区转成纸白，不然头像会是黑底
|
||||
$bg = imagecolorallocate($canvas, 253, 251, 245);
|
||||
imagefilledrectangle($canvas, 0, 0, self::SIZE, self::SIZE, $bg);
|
||||
imagecopyresampled($canvas, $src, 0, 0, $sx, $sy, self::SIZE, self::SIZE, $side, $side);
|
||||
imagefilledrectangle($canvas, 0, 0, $outW, $outH, $bg);
|
||||
imagecopyresampled($canvas, $src, 0, 0, $sx, $sy, $outW, $outH, $sw, $sh);
|
||||
imagedestroy($src);
|
||||
|
||||
// 先在临时目录生成，再整体交给 Storage —— 这样本地与 OSS 是同一条路径
|
||||
$tmpOut = tempnam(sys_get_temp_dir(), 'fbav');
|
||||
$tmpOut = tempnam(sys_get_temp_dir(), 'fbimg');
|
||||
if ($tmpOut === false || !imagejpeg($canvas, $tmpOut, 88)) {
|
||||
imagedestroy($canvas);
|
||||
@unlink((string)$tmpOut);
|
||||
@@ -85,21 +119,131 @@ final class Upload
|
||||
}
|
||||
imagedestroy($canvas);
|
||||
|
||||
$key = Storage::AVATAR_DIR . '/' . bin2hex(random_bytes(12)) . '.jpg';
|
||||
$key = (string)$slot['dir'] . '/' . bin2hex(random_bytes(12)) . '.jpg';
|
||||
$res = Storage::putFile($familyId, $tmpOut, $key, 'image/jpeg');
|
||||
@unlink($tmpOut);
|
||||
|
||||
if (empty($res['ok'])) {
|
||||
return ['ok' => false, 'error' => '保存失败：' . (string)($res['error'] ?? '')];
|
||||
}
|
||||
$out = ['ok' => true, 'file' => $key];
|
||||
$out = ['ok' => true, 'file' => $key, 'slot' => $slotKey,
|
||||
'crop' => ['x' => $sx, 'y' => $sy, 'w' => $sw, 'h' => $sh]];
|
||||
if (!empty($res['note'])) {
|
||||
$out['note'] = (string)$res['note'];
|
||||
}
|
||||
return $out;
|
||||
}
|
||||
|
||||
/** 头像访问地址（无头像时回退内置剪影，保证永远不出现破图） */
|
||||
/**
|
||||
* 头像（= avatar 位置）。保留这个入口，调用方不必关心槽位名。
|
||||
* @return array{ok:bool,file?:string,error?:string,note?:string}
|
||||
*/
|
||||
public static function avatar(int $familyId, array $file, string $cropRaw = ''): array
|
||||
{
|
||||
return self::image($familyId, $file, 'avatar', $cropRaw);
|
||||
}
|
||||
|
||||
/**
|
||||
* 解析归一化裁剪矩形 "x,y,w,h"（各 0..1，相对原图）。
|
||||
* 任何一项非法（不是数字、越界、宽高为 0）→ 返回 null，调用方退回居中裁切。
|
||||
*
|
||||
* ⚠️ 只做**解析与粗筛**，不做"像素级贴合"：真正的定位在 fitRegion() 里，
|
||||
* 它会再把区域夹回图内、并调成目标比例。这里如果直接把非法值夹成合法值，
|
||||
* 就会出现"用户拖了个空框却莫名得到一张图"的怪事 —— 宁可退回居中。
|
||||
*/
|
||||
private static function readCrop(string $raw, int $w, int $h): ?array
|
||||
{
|
||||
$raw = trim($raw);
|
||||
if ($raw === '') {
|
||||
return null;
|
||||
}
|
||||
$parts = explode(',', $raw);
|
||||
if (count($parts) !== 4) {
|
||||
return null;
|
||||
}
|
||||
$vals = [];
|
||||
foreach ($parts as $p) {
|
||||
$p = trim($p);
|
||||
if (!is_numeric($p)) {
|
||||
return null;
|
||||
}
|
||||
$vals[] = (float)$p;
|
||||
}
|
||||
[$x, $y, $cw, $ch] = $vals;
|
||||
if ($cw <= 0 || $ch <= 0) {
|
||||
return null;
|
||||
}
|
||||
// 允许 -0.001 这种浮点毛刺，但明显越界的直接判非法
|
||||
if ($x < -0.001 || $y < -0.001 || $x > 1.001 || $y > 1.001
|
||||
|| $cw > 1.001 || $ch > 1.001) {
|
||||
return null;
|
||||
}
|
||||
return [max(0.0, $x), max(0.0, $y), min(1.0, $cw), min(1.0, $ch)];
|
||||
}
|
||||
|
||||
/**
|
||||
* 把归一化区域变成**像素级、且比例等于 $ratio** 的裁切框。
|
||||
*
|
||||
* 三步，缺一不可：
|
||||
* ① 夹回图内（区域右/下边可能超出）；
|
||||
* ② 调成目标比例（前端要是被绕过、或报了稍有不同的比例，这里纠正）；
|
||||
* 做法是**在给定区域内居中收缩**，绝不外扩 —— 用户挑的地方一定还在框里；
|
||||
* ③ 取整并对齐边界，保证 sx+sw ≤ w。
|
||||
*
|
||||
* @param array{0:float,1:float,2:float,3:float} $region
|
||||
* @return array{0:int,1:int,2:int,3:int}
|
||||
*/
|
||||
private static function fitRegion(array $region, int $w, int $h, float $ratio): array
|
||||
{
|
||||
[$nx, $ny, $nw, $nh] = $region;
|
||||
|
||||
// ① 夹回图内
|
||||
$nx = min(max(0.0, $nx), 1.0);
|
||||
$ny = min(max(0.0, $ny), 1.0);
|
||||
$nw = min($nw, 1.0 - $nx);
|
||||
$nh = min($nh, 1.0 - $ny);
|
||||
if ($nw <= 0 || $nh <= 0) {
|
||||
$nx = $ny = 0.0;
|
||||
$nw = $nh = 1.0;
|
||||
}
|
||||
|
||||
$sx = $nx * $w;
|
||||
$sy = $ny * $h;
|
||||
$sw = $nw * $w;
|
||||
$sh = $nh * $h;
|
||||
|
||||
// ② 在区域内居中收缩到目标比例
|
||||
if ($ratio > 0 && $sh > 0) {
|
||||
$cur = $sw / $sh;
|
||||
if ($cur > $ratio + 1e-6) { // 太宽 → 收窄
|
||||
$newW = $sh * $ratio;
|
||||
$sx += ($sw - $newW) / 2;
|
||||
$sw = $newW;
|
||||
} elseif ($cur < $ratio - 1e-6) { // 太高 → 收矮
|
||||
$newH = $sw / $ratio;
|
||||
$sy += ($sh - $newH) / 2;
|
||||
$sh = $newH;
|
||||
}
|
||||
}
|
||||
|
||||
// ③ 取整 + 保证不越界
|
||||
$ix = (int)round($sx);
|
||||
$iy = (int)round($sy);
|
||||
$iw = (int)round($sw);
|
||||
$ih = (int)round($sh);
|
||||
$ix = max(0, min($ix, $w - 1));
|
||||
$iy = max(0, min($iy, $h - 1));
|
||||
$iw = max(1, min($iw, $w - $ix));
|
||||
$ih = max(1, min($ih, $h - $iy));
|
||||
return [$ix, $iy, $iw, $ih];
|
||||
}
|
||||
|
||||
private static function maxMbWord(): string
|
||||
{
|
||||
return (int)round(ImageSlot::MAX_BYTES / 1024 / 1024) . 'MB';
|
||||
}
|
||||
|
||||
/** 图片访问地址（无图时回退内置剪影，保证永远不出现破图） */
|
||||
public static function avatarUrl(int $familyId, ?string $rel): string
|
||||
{
|
||||
$rel = trim((string)$rel);
|
||||
@@ -121,4 +265,4 @@ final class Upload
|
||||
{
|
||||
return Storage::effectiveDriver($familyId);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,41 @@
|
||||
<?php
|
||||
/**
|
||||
* 「我自己的」设置 —— 键值对，挂在 person 上而不是 family 上。
|
||||
*
|
||||
* 为什么要有它（而不是复用 settings 表加个 person_id 列）：
|
||||
* `settings` 是**家庭级**的（系统 slogan、附件存储这些，改一次全家变），
|
||||
* `user_settings` 是**个人级**的（我的分组顺序、以后可能还有我的界面偏好），
|
||||
* 两者的作用范围完全不同。分开存，"改一个人的偏好"就不可能误伤到全家 ——
|
||||
* 混在一张表里迟早有人忘了带 family 条件。
|
||||
*
|
||||
* 与 App\Setting 的关系：同构（都是 k/v），只是作用域不同。
|
||||
*/
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace App;
|
||||
|
||||
final class UserSetting
|
||||
{
|
||||
public static function get(int $personId, string $key, $default = null)
|
||||
{
|
||||
if ($personId <= 0) {
|
||||
return $default;
|
||||
}
|
||||
$st = Database::get()->prepare('SELECT v FROM user_settings WHERE person_id = ? AND k = ?');
|
||||
$st->execute([$personId, $key]);
|
||||
$v = $st->fetchColumn();
|
||||
return $v === false ? $default : $v;
|
||||
}
|
||||
|
||||
public static function set(int $personId, string $key, string $value): void
|
||||
{
|
||||
if ($personId <= 0) {
|
||||
return;
|
||||
}
|
||||
Database::get()->prepare(
|
||||
'INSERT INTO user_settings (person_id, k, v) VALUES (?, ?, ?)
|
||||
ON DUPLICATE KEY UPDATE v = VALUES(v)'
|
||||
)->execute([$personId, $key, $value]);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user