laoyang
a5e559b2b3
名册点击看详情拖动才排序 / 任务复选框与状态 / 财务标签多选 / 微信读书同步与统计 /
导航线上数据与图标
用户本轮 9 条需求（原话见 templates/ 与 app/ 内的逐条注释）：
1. 名册：列表里给某人分组改为 AJAX 就地挪卡片（不再整页刷新）。
2. 纪念日：关联人改**多选**（复用 _person_picker，字段 person_ids[]）；
自建纪念日的按钮与其它模块统一（改=蓝 .btn、删=黄 .btn-warn）；
列表新增「关联人」列并给人名前加头像。
3. 首页：日程/任务两块**完全等高**（align-items:stretch + 固定总高 + flex 子项
min-height:0）；修「0 件待办」——数字与右侧列表同源（原来各算各的）。
4. 🔴 名册里被移出的人过一阵又回来：根因是 PersonRoster::seedFromPersons()
**每次 Schema::ensure() 都无条件重灌**（线上实测每跑一次 +1 行）。
修：给它加自守卫（只有在 persons 还留着 group_id/sort_order 的**老库**才跑）。
5. 名册：点击=看详情、**只有拖 ⠿ 手柄**才是排序（原来整行既能点又能拖，语义混乱）。
6. 任务：所有任务前加复选框，任何位置点勾即完成；
状态语义照业界整理为 To Do / Doing / Done 并写出说明（用户要求参考别人的做法）。
7. 财务：类别标签改**多选非互斥**（再点一次取消该类别），上下两图 + 图例 + 表格
全部按同一个集合联动；高亮条刻意不给「合计」（多选下各类金额不能相加）。
8. 微信读书：新增**懒同步**（访问时顺手做，6h TTL，只补空字段不覆盖用户填的）、
封面图**拉下来存本站存储**（原来只存外链 → 看不到）、接官方 /readdata/detail 统计。
9. 导航：线上数据只搬了一半（5 板块 29 站 → 7 板块 67 站 + 67 图标）、
展示页头像不显示 / 搜索按钮错位 / 点登录 404。三个真根因：
· 相对地址在 /nav/ 下全 404 → 新增 Nav::abs()；
· 搜索容器丢了 id="search"（CSS 是 #search button.submit 绝对定位）；
· Nav::iconKey() 与 SimpleNav 的 icon_key() **算法不一致**（少一次 md5 归一化）
→ 搬来的图标文件名对不上；且 uploads/ 整目录 Require all denied。
新增两个**免登录公开出口** nav_icon.php / nav_avatar.php。
顺带修掉一个「数据损坏级」的真 bug（做第 4 条线上反证时发现的，之前一直没人注意）：
app/Region.php 三处用中文标点当 trim/ltrim 的 charlist，而 PHP 的 charlist 是
**按字节**匹配的 —— 「。」= E3 80 **82** → 字节 82 进了可剥集合 →
「层」= E5 B1 **82** 被切掉尾字节 → 非法 UTF-8 → backfillAddress 的 UPDATE 报
`1366 Incorrect string value` → **地址拆分升级从上线起一直在失败被跳过**（每请求报一次）。
改成字符级 preg_replace('/…/u')；线上实测 ensure() 现在无报错、待拆行数真的在下降。
验证战绩：
- e2e 1289/0（新增 Region 字节级用例等）
- 真机探针：选人 19/0 · 首页/导航 24/0 · 导航模块 34/0 · b18 暂存+确定 10/0 ·
第23批 52/0
- 桌面几何 428/0 · 移动端几何 680/0 · 交互 92/0 · 窄屏 24/0
- 老库升级 153/0（含 anniversary_people 迁移 + 「再跑 ensure() 名册行数不变」）
- 部署静态断言 180 OK / 0 FAIL · 反向验证 3/3 + Region 三变体各被两条断言同时抓住
- 线上 26 个文件与本地**逐字节一致**；展示页 200、图标 66/66 200、登录 200、
越权/不存在均 404、签发短语后 ensure() 不再报错。
837 lines
38 KiB
PHP
837 lines
38 KiB
PHP
<?php
|
||
/**
|
||
* 个人导航（v24 第 24 批 用户第 4 条）—— 从用户自己的 SimpleNav 项目**完整搬运**。
|
||
*
|
||
* 用户原话：
|
||
* 「你去读一下个人导航，就是我之前有一个个人导航的项目，把这个项目完整的搬过来
|
||
* 放在导航条里，就是说增加一下个人导航的这个模块就放在读书的后面，每个用户
|
||
* 都可以添加自己的导航，所有的功能模块就完全照搬原来的导航的那个系统里面的功能。
|
||
* 但是这里面有一个问题需要注意现在的系统，每一个功能模块都是需要登录的。
|
||
* 但是导航展示页面却不需要登录。这就意味着我们需要给他一个非常特殊的地址。
|
||
* 地址后面可以跟着用户添加的一个短语，就跟类似于一个密钥一样，他可以给自己
|
||
* 起一个短语。然后这个地址后面跟着问号带上这个短语的形式去进行展示。这样的话
|
||
* 我们是为了区分不同的用户，他的不同的导航页面，用户选了一个短语之后，通过
|
||
* 这个短语，我们就能知道要访问的是哪一个用户的面板，这个页面是不需要登录的。
|
||
* 在这个页面里面要增加一个功能，右上角增加一个功能，就是登录点击这个页面之后
|
||
* 再进入到我们现在这个系统就是家书的这个系统的登录页面。否则的话，那个导航的
|
||
* 展示的页面是跟之前的一样，是不需要进行登录的。这样的话，导航的展示页面，
|
||
* 导航页的展示页面上面的那个头像就变成用户自己的头像就可以了。」
|
||
*
|
||
* ────────────────────────────────────────────────────────────────
|
||
* **搬运时改了什么、没改什么**（这是唯一需要判断的地方）
|
||
*
|
||
* 没改（照搬）：板块/站点/引擎/设置四张表的字段语义、稀疏排序 SORT_STEP、
|
||
* 拖拽整组归一化、图标抓取与 GD 生成站点图标、联想词接口、打开方式、
|
||
* 合集 tabs/flat 两种布局 —— 用户要的是「完全照搬」。
|
||
*
|
||
* 改了两处（不改会坏）：
|
||
* ① **存储**：原项目是独立 SQLite（data/nav.db）+ 自己的 users 表。
|
||
* 搬进来改成家书的 MySQL（`nav_*` 表）+ **家书的 person_id**。
|
||
* ② **归属维度**：原项目只有一份全局数据（单用户系统）；
|
||
* 现在是「每个用户都可以添加自己的导航」→ 所有查询都带上 `person_id`。
|
||
* ⚠️ 这正是"照搬"里唯一不能照抄的部分：漏掉这一维，全家人会共用同一份导航，
|
||
* 而且一个人加一条链接，全家人的导航页里都会冒出来。
|
||
* ③ 原来的 `url()` / `asset()` / `e()` 等与家书重名，**一律改用家书自己的**
|
||
* （家书已有 `e()` / `asset()` / `url()`），不再搬一份进来 ——
|
||
* 两份同名函数会直接 Fatal（函数重定义）。
|
||
*/
|
||
declare(strict_types=1);
|
||
|
||
namespace App;
|
||
|
||
final class Nav
|
||
{
|
||
/** 排序步长（与 SimpleNav 一致） */
|
||
public const SORT_STEP = 1000;
|
||
|
||
/** 图标目录（相对站点根，Web 可访问；与 SimpleNav 的 uploads/icons 同构） */
|
||
public const ICON_DIR = 'uploads/nav-icons';
|
||
public const ICON_URL = 'uploads/nav-icons';
|
||
|
||
/**
|
||
* 导航短语的合法形式：4~32 位，字母/数字/下划线/连字符。
|
||
*
|
||
* ⚠️ 为什么限这么死：这个短语是**免登录地址**上的唯一凭据
|
||
* （`/nav/?yangyq`）。允许中文/符号会让复制粘贴时出现"看起来一样但实际不同"
|
||
* 的重码（中文空格、全角下标…），而这种错误排查起来极烦。
|
||
* 长度下限 4 是因为 1~3 位太容易被穷举（这页面是公开的）。
|
||
*/
|
||
public const PHRASE_RE = '/^[A-Za-z0-9_-]{4,32}$/';
|
||
|
||
/** 保留短语：不能与真实路由/常见词撞（否则地址会有歧义） */
|
||
public const PHRASE_RESERVED = [
|
||
'nav', 'login', 'logout', 'index', 'admin', 'api', 'static', 'assets',
|
||
'help', 'about', 'null', 'undefined', 'true', 'false', 'test',
|
||
];
|
||
|
||
// ================================================================
|
||
// 设置（原 SimpleNav 的 settings 表 → 这里按人一份）
|
||
// ================================================================
|
||
|
||
/** 设置的默认值（照搬 SimpleNav 的 seed_settings） */
|
||
public const SETTING_DEFAULTS = [
|
||
'site_name' => '我的导航',
|
||
'subtitle' => '',
|
||
'default_engine' => 'bing',
|
||
'primary_color' => '#2F6BF7',
|
||
// '1' = 站点链接与搜索框都在**新标签页**打开（与引入该设置前的旧行为一致）
|
||
'open_blank' => '1',
|
||
// 'both' = ↓/↑ 与 , . 两组都认（SimpleNav 的默认，也是"严格超集"）
|
||
'suggest_keys' => 'both',
|
||
// tabs = 合集标签页折叠（默认）；flat = 全部平铺
|
||
'collections_layout' => 'tabs',
|
||
];
|
||
|
||
public static function setting(int $personId, string $k, ?string $default = null): string
|
||
{
|
||
if ($default === null) {
|
||
$default = self::SETTING_DEFAULTS[$k] ?? '';
|
||
}
|
||
$st = Database::get()->prepare('SELECT v FROM nav_settings WHERE person_id = ? AND k = ?');
|
||
$st->execute([$personId, $k]);
|
||
$v = $st->fetchColumn();
|
||
return $v === false ? $default : (string)$v;
|
||
}
|
||
|
||
public static function setSetting(int $personId, string $k, string $v): void
|
||
{
|
||
Database::get()->prepare(
|
||
'INSERT INTO nav_settings (person_id, k, v) VALUES (?,?,?)
|
||
ON DUPLICATE KEY UPDATE v = VALUES(v)'
|
||
)->execute([$personId, $k, $v]);
|
||
}
|
||
|
||
/** 一次取全部设置（渲染页面时省 N 次查询） */
|
||
public static function settings(int $personId): array
|
||
{
|
||
$out = self::SETTING_DEFAULTS;
|
||
$st = Database::get()->prepare('SELECT k, v FROM nav_settings WHERE person_id = ?');
|
||
$st->execute([$personId]);
|
||
foreach ($st->fetchAll() as $r) {
|
||
$out[(string)$r['k']] = (string)$r['v'];
|
||
}
|
||
return $out;
|
||
}
|
||
|
||
// ================================================================
|
||
// 板块
|
||
// ================================================================
|
||
|
||
/** 我的板块（可按显示方式筛） */
|
||
public static function groups(int $personId, string $display = '', bool $visibleOnly = false): array
|
||
{
|
||
$sql = 'SELECT * FROM nav_groups WHERE person_id = ?';
|
||
$arg = [$personId];
|
||
if ($display !== '') {
|
||
$sql .= ' AND display = ?';
|
||
$arg[] = $display;
|
||
}
|
||
if ($visibleOnly) {
|
||
$sql .= ' AND is_visible = 1';
|
||
}
|
||
$sql .= ' ORDER BY sort_order, id';
|
||
$st = Database::get()->prepare($sql);
|
||
$st->execute($arg);
|
||
return $st->fetchAll();
|
||
}
|
||
|
||
public static function group(int $personId, int $id): ?array
|
||
{
|
||
$st = Database::get()->prepare('SELECT * FROM nav_groups WHERE id = ? AND person_id = ?');
|
||
$st->execute([$id, $personId]);
|
||
$r = $st->fetch();
|
||
return $r ?: null;
|
||
}
|
||
|
||
public static function saveGroup(int $personId, array $d, int $id = 0): int
|
||
{
|
||
$name = trim((string)($d['name'] ?? ''));
|
||
$display = ((string)($d['display'] ?? 'grid')) === 'tabs' ? 'tabs' : 'grid';
|
||
$vis = !empty($d['is_visible']) ? 1 : 0;
|
||
if ($name === '') {
|
||
return 0;
|
||
}
|
||
if ($id > 0) {
|
||
// ⚠️ 带 person_id 校验：不能凭一个 id 改别人家的板块
|
||
Database::get()->prepare(
|
||
'UPDATE nav_groups SET name = ?, display = ?, is_visible = ? WHERE id = ? AND person_id = ?'
|
||
)->execute([$name, $display, $vis, $id, $personId]);
|
||
return $id;
|
||
}
|
||
$sort = self::nextSort('nav_groups', $personId);
|
||
Database::get()->prepare(
|
||
'INSERT INTO nav_groups (person_id, name, slug, display, sort_order, is_visible)
|
||
VALUES (?,?,?,?,?,?)'
|
||
)->execute([$personId, $name, self::slugify($name), $display, $sort, $vis]);
|
||
return (int)Database::get()->lastInsertId();
|
||
}
|
||
|
||
public static function removeGroup(int $personId, int $id): void
|
||
{
|
||
// 站点靠外键 ON DELETE CASCADE 一起走
|
||
Database::get()->prepare('DELETE FROM nav_groups WHERE id = ? AND person_id = ?')
|
||
->execute([$id, $personId]);
|
||
}
|
||
|
||
public static function toggleGroup(int $personId, int $id): void
|
||
{
|
||
Database::get()->prepare(
|
||
'UPDATE nav_groups SET is_visible = 1 - is_visible WHERE id = ? AND person_id = ?'
|
||
)->execute([$id, $personId]);
|
||
}
|
||
|
||
// ================================================================
|
||
// 站点
|
||
// ================================================================
|
||
|
||
public static function sites(int $personId, int $groupId, bool $visibleOnly = true): array
|
||
{
|
||
$sql = 'SELECT * FROM nav_sites WHERE person_id = ? AND group_id = ?'
|
||
. ($visibleOnly ? ' AND is_visible = 1' : '') . ' ORDER BY sort_order, id';
|
||
$st = Database::get()->prepare($sql);
|
||
$st->execute([$personId, $groupId]);
|
||
return $st->fetchAll();
|
||
}
|
||
|
||
/** 我的全部站点（管理页用；按板块归好组） */
|
||
public static function sitesByGroup(int $personId): array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
'SELECT * FROM nav_sites WHERE person_id = ? ORDER BY group_id, sort_order, id'
|
||
);
|
||
$st->execute([$personId]);
|
||
$out = [];
|
||
foreach ($st->fetchAll() as $r) {
|
||
$out[(int)$r['group_id']][] = $r;
|
||
}
|
||
return $out;
|
||
}
|
||
|
||
public static function site(int $personId, int $id): ?array
|
||
{
|
||
$st = Database::get()->prepare('SELECT * FROM nav_sites WHERE id = ? AND person_id = ?');
|
||
$st->execute([$id, $personId]);
|
||
$r = $st->fetch();
|
||
return $r ?: null;
|
||
}
|
||
|
||
/**
|
||
* 存一条站点（新增或编辑）。
|
||
*
|
||
* ⚠️ `icon_custom` 的语义照搬 SimpleNav：「全部更新」抓图标时**不动**
|
||
* 用户自己传的图标。漏掉这一条，用户精心挑的图标会被下一次批量更新冲掉。
|
||
*/
|
||
public static function saveSite(int $personId, array $d, int $id = 0): int
|
||
{
|
||
$url = self::normUrl((string)($d['url'] ?? ''));
|
||
$name = trim((string)($d['name'] ?? ''));
|
||
$short = trim((string)($d['short_name'] ?? ''));
|
||
$gid = (int)($d['group_id'] ?? 0);
|
||
$vis = !empty($d['is_visible']) ? 1 : 0;
|
||
if ($url === '' || $gid <= 0 || self::group($personId, $gid) === null) {
|
||
return 0;
|
||
}
|
||
if ($name === '') {
|
||
$name = self::domainOf($url);
|
||
}
|
||
$now = date('Y-m-d H:i:s');
|
||
if ($id > 0) {
|
||
Database::get()->prepare(
|
||
'UPDATE nav_sites SET group_id = ?, url = ?, name = ?, short_name = ?, is_visible = ?,
|
||
updated_at = ? WHERE id = ? AND person_id = ?'
|
||
)->execute([$gid, $url, $name, $short, $vis, $now, $id, $personId]);
|
||
return $id;
|
||
}
|
||
// ⚠️ 新增一律排**最后**（SimpleNav 的明确行为：不插进用户已排好的顺序里）
|
||
$sort = self::nextSort('nav_sites', $personId, 'group_id', $gid);
|
||
Database::get()->prepare(
|
||
'INSERT INTO nav_sites (person_id, group_id, url, name, short_name, icon, icon_custom,
|
||
sort_order, is_visible, created_at, updated_at)
|
||
VALUES (?,?,?,?,?,\'\',0,?,?,?,?)'
|
||
)->execute([$personId, $gid, $url, $name, $short, $sort, $vis, $now, $now]);
|
||
return (int)Database::get()->lastInsertId();
|
||
}
|
||
|
||
public static function removeSite(int $personId, int $id): void
|
||
{
|
||
$s = self::site($personId, $id);
|
||
if ($s && (string)$s['icon'] !== '' && empty($s['icon_custom'])) {
|
||
self::deleteIconFile((string)$s['icon']);
|
||
}
|
||
Database::get()->prepare('DELETE FROM nav_sites WHERE id = ? AND person_id = ?')
|
||
->execute([$id, $personId]);
|
||
}
|
||
|
||
public static function toggleSite(int $personId, int $id): void
|
||
{
|
||
Database::get()->prepare(
|
||
'UPDATE nav_sites SET is_visible = 1 - is_visible WHERE id = ? AND person_id = ?'
|
||
)->execute([$id, $personId]);
|
||
}
|
||
|
||
/** 站点显示名（简称优先 → 抓来的名字 → 域名） */
|
||
public static function siteLabel(array $s): string
|
||
{
|
||
$short = trim((string)($s['short_name'] ?? ''));
|
||
if ($short !== '') {
|
||
return $short;
|
||
}
|
||
$n = trim((string)($s['name'] ?? ''));
|
||
return $n !== '' ? $n : self::domainOf((string)($s['url'] ?? ''));
|
||
}
|
||
|
||
// ================================================================
|
||
// 搜索引擎
|
||
// ================================================================
|
||
|
||
public static function engines(int $personId, bool $activeOnly = false): array
|
||
{
|
||
$st = Database::get()->prepare(
|
||
'SELECT * FROM nav_engines WHERE person_id = ?'
|
||
. ($activeOnly ? ' AND is_active = 1' : '') . ' ORDER BY sort_order, id'
|
||
);
|
||
$st->execute([$personId]);
|
||
return $st->fetchAll();
|
||
}
|
||
|
||
public static function saveEngine(int $personId, array $d, int $id = 0): int
|
||
{
|
||
$name = trim((string)($d['name'] ?? ''));
|
||
$slug = trim((string)($d['slug'] ?? ''));
|
||
$url = trim((string)($d['search_url'] ?? ''));
|
||
$par = trim((string)($d['param'] ?? 'q'));
|
||
if ($name === '' || $url === '') {
|
||
return 0;
|
||
}
|
||
if ($slug === '') {
|
||
$slug = self::slugify($name);
|
||
}
|
||
if ($par === '') { $par = 'q'; }
|
||
$color = self::safeColor((string)($d['color'] ?? ''), '#2F6BF7');
|
||
if ($id > 0) {
|
||
Database::get()->prepare(
|
||
'UPDATE nav_engines SET name=?, slug=?, search_url=?, param=?, suggest_url=?,
|
||
suggest_type=?, color=? WHERE id=? AND person_id=?'
|
||
)->execute([$name, $slug, $url, $par,
|
||
trim((string)($d['suggest_url'] ?? '')), trim((string)($d['suggest_type'] ?? '')),
|
||
$color, $id, $personId]);
|
||
return $id;
|
||
}
|
||
$sort = self::nextSort('nav_engines', $personId);
|
||
Database::get()->prepare(
|
||
'INSERT INTO nav_engines (person_id, name, slug, search_url, param, suggest_url,
|
||
suggest_type, color, is_active, sort_order)
|
||
VALUES (?,?,?,?,?,?,?,?,0,?)'
|
||
)->execute([$personId, $name, $slug, $url, $par,
|
||
trim((string)($d['suggest_url'] ?? '')), trim((string)($d['suggest_type'] ?? '')),
|
||
$color, $sort]);
|
||
return (int)Database::get()->lastInsertId();
|
||
}
|
||
|
||
public static function removeEngine(int $personId, int $id): void
|
||
{
|
||
Database::get()->prepare('DELETE FROM nav_engines WHERE id = ? AND person_id = ?')
|
||
->execute([$id, $personId]);
|
||
}
|
||
|
||
public static function toggleEngine(int $personId, int $id): void
|
||
{
|
||
Database::get()->prepare(
|
||
'UPDATE nav_engines SET is_active = 1 - is_active WHERE id = ? AND person_id = ?'
|
||
)->execute([$id, $personId]);
|
||
}
|
||
|
||
/** 默认引擎（设置里指定的那个；不在就取第一个启用的） */
|
||
public static function defaultEngine(int $personId, array $engines): ?array
|
||
{
|
||
$want = self::setting($personId, 'default_engine');
|
||
foreach ($engines as $e) {
|
||
if ((string)$e['slug'] === $want) {
|
||
return $e;
|
||
}
|
||
}
|
||
return $engines[0] ?? null;
|
||
}
|
||
|
||
// ================================================================
|
||
// 排序（稀疏 + 整组归一化）—— 照搬 SimpleNav 的两个函数
|
||
// ================================================================
|
||
|
||
/**
|
||
* 取「同组最后一条的 sort_order + SORT_STEP」——**新增条目专用**。
|
||
*
|
||
* ⚠️ 不要改回 `MAX+1`：SimpleNav 里已经写明过原因 ——
|
||
* 那只在"旧数据恰好是连续整数"时才等于"排最后"；一旦排序号之间有间隙
|
||
* （拖拽后必然如此），MAX+1 会**撞进已有间隙**里，让新条目落到用户排好的
|
||
* 中间，正是用户抱怨的"排序被打乱"。
|
||
*/
|
||
public static function nextSort(string $table, int $personId, string $groupCol = '', int $groupId = 0): int
|
||
{
|
||
if ($groupCol === '') {
|
||
$st = Database::get()->prepare(
|
||
"SELECT COALESCE(MAX(sort_order),0) FROM {$table} WHERE person_id = ?");
|
||
$st->execute([$personId]);
|
||
} else {
|
||
$st = Database::get()->prepare(
|
||
"SELECT COALESCE(MAX(sort_order),0) FROM {$table} WHERE person_id = ? AND {$groupCol} = ?");
|
||
$st->execute([$personId, $groupId]);
|
||
}
|
||
return (int)$st->fetchColumn() + self::SORT_STEP;
|
||
}
|
||
|
||
/**
|
||
* 按给定 id 顺序**整组重写**排序号（第 n 条 = n*SORT_STEP）。
|
||
*
|
||
* ⚠️ `$groupId` 非空时做**归属校验**：不属于该组（或不属于我）的 id 直接跳过 ——
|
||
* 照搬 SimpleNav 的原话：防止一个被篡改的请求把别的板块的条目拖进来。
|
||
* 这里额外再叠一层 `person_id`：否则能拖别人家的站点。
|
||
*/
|
||
public static function applySort(string $table, int $personId, array $ids,
|
||
string $groupCol = '', int $groupId = 0): int
|
||
{
|
||
$db = Database::get();
|
||
$upd = $db->prepare("UPDATE {$table} SET sort_order = ? WHERE id = ? AND person_id = ?");
|
||
$ck = null;
|
||
if ($groupCol !== '') {
|
||
$ck = $db->prepare("SELECT COUNT(*) FROM {$table} WHERE id = ? AND person_id = ? AND {$groupCol} = ?");
|
||
}
|
||
$n = 0;
|
||
$i = 0;
|
||
foreach ($ids as $rid) {
|
||
$rid = (int)$rid;
|
||
if ($rid <= 0) {
|
||
continue;
|
||
}
|
||
if ($ck !== null) {
|
||
$ck->execute([$rid, $personId, $groupId]);
|
||
if ((int)$ck->fetchColumn() === 0) {
|
||
continue; // 不属于本组 / 不是我家的 → 忽略
|
||
}
|
||
}
|
||
$i++;
|
||
$upd->execute([$i * self::SORT_STEP, $rid, $personId]);
|
||
$n++;
|
||
}
|
||
return $n;
|
||
}
|
||
|
||
/** 跨板块移动（拖到另一个板块） */
|
||
public static function moveSite(int $personId, int $id, int $toGroupId): bool
|
||
{
|
||
if (self::group($personId, $toGroupId) === null) {
|
||
return false;
|
||
}
|
||
$sort = self::nextSort('nav_sites', $personId, 'group_id', $toGroupId);
|
||
Database::get()->prepare(
|
||
'UPDATE nav_sites SET group_id = ?, sort_order = ?, updated_at = ? WHERE id = ? AND person_id = ?'
|
||
)->execute([$toGroupId, $sort, date('Y-m-d H:i:s'), $id, $personId]);
|
||
return true;
|
||
}
|
||
|
||
// ================================================================
|
||
// 短语（免登录展示页的地址后缀）
|
||
// ================================================================
|
||
|
||
/**
|
||
* 我的短语（没设过 → 空串，展示页就不可用）。
|
||
*
|
||
* ⚠️ 存在 `nav_settings` 的 `link_phrase` 键里，但**必须全局唯一** ——
|
||
* 它是免登录地址上的唯一凭据，两个人用同一个短语就等于互相串页。
|
||
* 唯一性由 `phraseTaken()` 在写入前校验（用 SQL 查，不靠应用层缓存）。
|
||
*/
|
||
public static function phrase(int $personId): string
|
||
{
|
||
return self::setting($personId, 'link_phrase', '');
|
||
}
|
||
|
||
/** 这个短语是否已被**别人**占用（$except 传自己，改自己的短语时不算冲突） */
|
||
public static function phraseTaken(string $phrase, int $except = 0): bool
|
||
{
|
||
$st = Database::get()->prepare(
|
||
"SELECT COUNT(*) FROM nav_settings WHERE k = 'link_phrase' AND v = ? AND person_id <> ?");
|
||
$st->execute([$phrase, $except]);
|
||
return (int)$st->fetchColumn() > 0;
|
||
}
|
||
|
||
/**
|
||
* 设短语。返回 ['ok'=>bool, 'error'=>string]。
|
||
*
|
||
* ⚠️ 三条校验缺一不可（少了任何一条都会出问题）：
|
||
* · 形式合法 → 否则地址复制粘贴时会出现"看着一样其实不同"的重码；
|
||
* · 未被占用 → 否则两个用户共用一个展示页；
|
||
* · 不是保留词 → 否则 `/nav/?nav` 这类地址会有歧义。
|
||
*/
|
||
public static function setPhrase(int $personId, string $phrase): array
|
||
{
|
||
$phrase = trim($phrase);
|
||
if ($phrase === '') {
|
||
self::setSetting($personId, 'link_phrase', '');
|
||
return ['ok' => true, 'error' => ''];
|
||
}
|
||
if (!preg_match(self::PHRASE_RE, $phrase)) {
|
||
return ['ok' => false, 'error' => '短语只能用 4~32 位的字母、数字、下划线或连字符。'];
|
||
}
|
||
if (in_array(strtolower($phrase), self::PHRASE_RESERVED, true)) {
|
||
return ['ok' => false, 'error' => '「' . $phrase . '」是系统保留词，请换一个。'];
|
||
}
|
||
if (self::phraseTaken($phrase, $personId)) {
|
||
return ['ok' => false, 'error' => '这个短语已经被别人用了，换一个吧。'];
|
||
}
|
||
self::setSetting($personId, 'link_phrase', $phrase);
|
||
return ['ok' => true, 'error' => ''];
|
||
}
|
||
|
||
/** 生成一个没被占用的随机短语（用户要的"一键换随机码"） */
|
||
public static function randomPhrase(): string
|
||
{
|
||
// 去掉容易读错的 0/O/1/l/I（与 DAV 口令同一套考量）
|
||
$abc = 'abcdefghjkmnpqrstuvwxyz23456789';
|
||
for ($try = 0; $try < 30; $try++) {
|
||
$s = '';
|
||
for ($i = 0; $i < 10; $i++) {
|
||
$s .= $abc[random_int(0, strlen($abc) - 1)];
|
||
}
|
||
if (!self::phraseTaken($s)) {
|
||
return $s;
|
||
}
|
||
}
|
||
return 'nav' . bin2hex(random_bytes(6));
|
||
}
|
||
|
||
/**
|
||
* 按短语找主人（展示页用，**免登录**）。
|
||
*
|
||
* ⚠️ 返回值只给"这个短语存在吗、属于谁"—— 绝不返回任何其它身份信息。
|
||
* 这页面是公开的，多一个字段就是多一处泄露面。
|
||
*/
|
||
public static function ownerByPhrase(string $phrase): int
|
||
{
|
||
if (!preg_match(self::PHRASE_RE, $phrase)) {
|
||
return 0;
|
||
}
|
||
$st = Database::get()->prepare(
|
||
"SELECT person_id FROM nav_settings WHERE k = 'link_phrase' AND v = ? LIMIT 1");
|
||
$st->execute([$phrase]);
|
||
return (int)($st->fetchColumn() ?: 0);
|
||
}
|
||
|
||
// ================================================================
|
||
// 小工具（照搬 SimpleNav 的同名函数，去掉与家书重名的）
|
||
// ================================================================
|
||
|
||
public static function normUrl(string $url): string
|
||
{
|
||
$url = trim($url);
|
||
if ($url === '') {
|
||
return '';
|
||
}
|
||
if (!preg_match('#^https?://#i', $url)) {
|
||
$url = 'http://' . $url;
|
||
}
|
||
return mb_substr($url, 0, 500, 'UTF-8');
|
||
}
|
||
|
||
/**
|
||
* 主域名（展示用途：首字母回退、标题回退）。
|
||
*
|
||
* ⚠️ SimpleNav 原文写明：**不要拿它当图标文件名**（用 iconKey($url)）——
|
||
* 同一域名下不同路径是两个不同的站点条目，用域名做键会互相覆盖。
|
||
*/
|
||
public static function domainOf(string $url): string
|
||
{
|
||
$host = parse_url(self::normUrl($url), PHP_URL_HOST);
|
||
return $host ? (string)preg_replace('/^www\./i', '', $host) : '';
|
||
}
|
||
|
||
/**
|
||
* 图标键（按 URL 取 md5）—— **必须与 SimpleNav 的 `icon_key()` 逐字一致**。
|
||
*
|
||
* 🔴🔴 v24 第 25 批 用户第 9 条修（搬运失真，导致"图标全都没有"）：
|
||
*
|
||
* 原实现写成了 `md5(self::normUrl($url))` —— 看起来"合理"，但 SimpleNav 的
|
||
* `icon_key()` 做的归一化比 `normUrl()` 多得多，两者算出来的键**不一样**：
|
||
* · SimpleNav：scheme/host **转小写**、**补上空路径为 `/`**、保留 port/query/fragment；
|
||
* · 原来这里：什么都不做（只用 normUrl 补 `http://` 前缀）。
|
||
* 于是 `https://otrust.ouc.edu.cn`（无路径）在两边分别得到
|
||
* `921cbff230c762f21ec5b6ffbfa1da63` 与 `0c4227cc33e0b0ab680aaf24031965f3`
|
||
* —— **只要 URL 里有一个大写字母或缺一个斜杠，文件名就对不上**。
|
||
*
|
||
* 后果（用户看到的现象）：从 SimpleNav 搬过来的站点，`icon` 列里存着的文件名
|
||
* 指向的文件其实叫另一个名字，`iconUrl()` 里 `is_file()` 判假 → 返回空串 →
|
||
* 前端退化成"首字母色块"，**一个图标都显示不出来**。
|
||
*
|
||
* ⚠️ 另外注意：**实际文件名是 `md5(本函数的结果)`（二次哈希）** ——
|
||
* 这是 SimpleNav 的历史遗留（只为让文件名定长），但它确实在文件名里，
|
||
* 所以搬迁 / 读写图标文件时**不要**自己再哈希或去掉这一层。
|
||
* 见 NavFetch::download_best_icon 的落盘处（它用的是 `md5($key)`）。
|
||
*/
|
||
public static function iconKey(string $url): string
|
||
{
|
||
$u = trim($url);
|
||
if ($u === '') {
|
||
return '';
|
||
}
|
||
if (!preg_match('#^https?://#i', $u)) {
|
||
$u = 'http://' . $u;
|
||
}
|
||
$p = @parse_url($u);
|
||
if (!is_array($p) || empty($p['host'])) {
|
||
return md5($u); // 解析不出来就整串兜底，至少不会跟别人撞
|
||
}
|
||
$norm = strtolower((string)($p['scheme'] ?? '')) . '://'
|
||
. strtolower((string)$p['host'])
|
||
. (empty($p['port']) ? '' : ':' . $p['port'])
|
||
. (isset($p['path']) && $p['path'] !== '' ? $p['path'] : '/')
|
||
. (isset($p['query']) ? '?' . $p['query'] : '')
|
||
. (isset($p['fragment']) ? '#' . $p['fragment'] : '');
|
||
return md5($norm);
|
||
}
|
||
|
||
/** 名称首字配色（无图标时的回退底色）—— 照搬 SimpleNav 的色板 */
|
||
public static function letterColor(string $s): string
|
||
{
|
||
$palette = ['#2F6BF7', '#5B8DEF', '#0EA5E9', '#10B981', '#F59E0B',
|
||
'#EF4444', '#8B5CF6', '#EC4899', '#14B8A6', '#F97316'];
|
||
return $palette[abs(crc32($s)) % count($palette)];
|
||
}
|
||
|
||
public static function slugify(string $s): string
|
||
{
|
||
$s = trim($s);
|
||
if (preg_match('/^[a-z0-9\-]+$/i', $s)) {
|
||
return strtolower($s);
|
||
}
|
||
return 'g' . substr(md5($s), 0, 6);
|
||
}
|
||
|
||
/** 颜色白名单：只接受 #rrggbb，其余一律回退（防手改表单塞进 CSS 注入） */
|
||
public static function safeColor(string $c, string $fallback): string
|
||
{
|
||
return preg_match('/^#[0-9a-fA-F]{6}$/', trim($c)) ? strtolower(trim($c)) : $fallback;
|
||
}
|
||
|
||
/**
|
||
* 图标显示地址（带版本号）。
|
||
*
|
||
* ⚠️ 版本号不能省：图标被重新抓取后**文件名不变**，没有版本号浏览器会一直用旧图 ——
|
||
* 用户点了"更新图标"却看不到变化，会以为功能坏了（SimpleNav 原文记过这一点）。
|
||
*/
|
||
public static function iconUrl(string $file): string
|
||
{
|
||
if ($file === '') {
|
||
return '';
|
||
}
|
||
$abs = FB_ROOT . '/' . self::ICON_DIR . '/' . $file;
|
||
if (!is_file($abs)) {
|
||
return '';
|
||
}
|
||
// 🔴 走 **nav_icon.php** 这个免登录公开出口，**不能**直接给 `uploads/…` 的地址：
|
||
// uploads/ 整个目录是 `Require all denied`（线上实测直接取会 403），
|
||
// 而展示页是免登录的、拿不到 media.php 需要的登录态。
|
||
// 详见 nav_icon.php 的文件头（两个约束为什么会撞在一起）。
|
||
// ⚠️ 管理页（登录态）也用同一条：一个图标地址两套出口，
|
||
// "管理页看得见、展示页看不见"这种半生效是最难查的。
|
||
return self::abs('/nav_icon.php') . '?f=' . rawurlencode($file) . '&v=' . filemtime($abs);
|
||
}
|
||
|
||
/**
|
||
* 把站内相对地址变成**绝对地址**（v24 第 25 批 用户第 9 条修）。
|
||
*
|
||
* 🔴🔴 为什么必须有这个函数（这是本批最要紧的一个根因）：
|
||
*
|
||
* 家书的 `url()` 产出的是 `index.php?r=xxx`、`avatar_url()` 产出 `media.php?k=…`
|
||
* —— 全是**相对**地址（只有 `asset()` 是 `/assets/…` 绝对路径）。
|
||
* 它们在站点根（`https://host/index.php?...`）上没问题，
|
||
* 但**导航展示页在 `/nav/` 这个子目录下**：浏览器会把相对地址拼在**当前目录**上，
|
||
* 于是变成 `/nav/index.php?r=…`、`/nav/media.php?k=…` —— **线上实测全 404**。
|
||
*
|
||
* 症状正是用户报的那三条一起出现（同一个根因）：
|
||
* · 展示页头像不显示（`/nav/media.php?k=avatar.jpg` → 404）
|
||
* · 点「登录」404（`/nav/index.php?r=auth/login` → 404）
|
||
* · 搜索联想请求打到 `/nav/…`（同样 404，下拉永远空）
|
||
*
|
||
* 修法：**凡是展示页要输出的自引用地址，一律经这里拼上 base_url**。
|
||
* ⚠️ 只在**免登录展示页**用得到（它是唯一不在站点根下的页面）——
|
||
* 不要拿它去替换全站的 `url()`：那会把所有站内链接都变成绝对地址，
|
||
* `?r=` 那套路由本来就不需要域名，改了反而多一处配置依赖。
|
||
*
|
||
* @param string $path 以 `/` 开头的站内路径，或 `index.php?r=…` 这种相对串
|
||
*/
|
||
public static function abs(string $path): string
|
||
{
|
||
$path = '/' . ltrim($path, '/');
|
||
|
||
/* 🔴 优先用**当前请求的 Host**，不要写死配置里的 base_url。
|
||
*
|
||
* 为什么（2026-10-07 第 25 批实测）：本地真机探针起的是**随机端口**的
|
||
* `php -S 127.0.0.1:<port>`，而 `config.php` 的 `base_url` 写的是
|
||
* `http://127.0.0.1:8791`。展示页把 CSS 拼成 `…:8791/assets/nav-show.css`
|
||
* → 与探针那个端口对不上 → **样式整份取不到** →
|
||
* 症状是"登录按钮落到左边、头像判据也跟着偏"，看起来像**布局坏了**，
|
||
* 其实是"资源地址指到了另一个端口"（最难查的一类：页面 200、HTML 全对）。
|
||
* ⇒ 绝对化要以"用户实际访问的那个 host"为准 —— 这也是**唯一正确**的口径：
|
||
* 线上有多个入口（域名 / IP / 宝塔测试域名）时，写死 base_url 会把
|
||
* 另外那些入口的静态资源全指到 base_url 那个域上去。
|
||
*
|
||
* ⚠️ 但 Host 头是**客户端可控**的（Host 注入）—— 所以只接受**形状合法**的
|
||
* host：字母数字点横线、可带端口。不合法就退回 base_url。
|
||
*/
|
||
$host = (string)($_SERVER['HTTP_HOST'] ?? '');
|
||
if ($host !== '' && preg_match('/^[A-Za-z0-9.\-]+(:\d+)?$/', $host)) {
|
||
$https = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off')
|
||
|| (string)($_SERVER['HTTP_X_FORWARDED_PROTO'] ?? '') === 'https'
|
||
|| (int)($_SERVER['SERVER_PORT'] ?? 0) === 443;
|
||
return ($https ? 'https://' : 'http://') . $host . $path;
|
||
}
|
||
|
||
$base = rtrim((string)fb_config('base_url', ''), '/');
|
||
if ($base === '') {
|
||
// 没配 base_url（极少数自建环境）→ 退化成"从站点根算"的绝对路径。
|
||
// 仍然比相对地址安全：相对地址在 /nav/ 下必错，而 /index.php 至少指对了。
|
||
return $path;
|
||
}
|
||
return $base . $path;
|
||
}
|
||
|
||
public static function deleteIconFile(string $file): void
|
||
{
|
||
if ($file === '' || strpos($file, '/') !== false || strpos($file, '..') !== false) {
|
||
return;
|
||
}
|
||
$abs = FB_ROOT . '/' . self::ICON_DIR . '/' . $file;
|
||
if (is_file($abs)) {
|
||
@unlink($abs);
|
||
}
|
||
}
|
||
|
||
public static function iconDirWritable(): bool
|
||
{
|
||
$dir = FB_ROOT . '/' . self::ICON_DIR;
|
||
if (!is_dir($dir)) {
|
||
@mkdir($dir, 0755, true);
|
||
}
|
||
return is_dir($dir) && is_writable($dir);
|
||
}
|
||
|
||
/** 打开方式：_blank（新标签页，默认）或 _self */
|
||
public static function openTarget(int $personId): string
|
||
{
|
||
return self::setting($personId, 'open_blank', '1') === '1' ? '_blank' : '_self';
|
||
}
|
||
|
||
/** 联想词按键（照搬 SimpleNav 的白名单回退） */
|
||
public static function suggestKeys(int $personId): string
|
||
{
|
||
$v = self::setting($personId, 'suggest_keys', 'both');
|
||
return in_array($v, ['arrows', 'punct', 'both'], true) ? $v : 'both';
|
||
}
|
||
|
||
/** 合集布局（tabs / flat） */
|
||
public static function collectionsLayout(int $personId): string
|
||
{
|
||
return self::setting($personId, 'collections_layout', 'tabs') === 'flat' ? 'flat' : 'tabs';
|
||
}
|
||
|
||
/**
|
||
* **首次进入时**给这个人一份默认导航（照搬 SimpleNav 的种子数据，精选了一部分）。
|
||
*
|
||
* ⚠️ 只在"这个人一条板块都没有"时调 —— 否则用户把板块删光后，
|
||
* 下一次进页面又会冒出默认的那几块（"我删了它怎么又回来了"）。
|
||
*/
|
||
public static function ensureSeed(int $personId): void
|
||
{
|
||
$st = Database::get()->prepare('SELECT COUNT(*) FROM nav_groups WHERE person_id = ?');
|
||
$st->execute([$personId]);
|
||
if ((int)$st->fetchColumn() > 0) {
|
||
return;
|
||
}
|
||
$db = Database::get();
|
||
$now = date('Y-m-d H:i:s');
|
||
$gs = $db->prepare(
|
||
'INSERT INTO nav_groups (person_id, name, slug, display, sort_order, is_visible) VALUES (?,?,?,?,?,1)');
|
||
$ss = $db->prepare(
|
||
'INSERT INTO nav_sites (person_id, group_id, url, name, short_name, icon, icon_custom,
|
||
sort_order, is_visible, created_at, updated_at) VALUES (?,?,?,?,?,\'\',0,?,1,?,?)');
|
||
$i = 0;
|
||
foreach (self::SEED as $row) {
|
||
[$gname, $display, $sites] = $row;
|
||
$i++;
|
||
$gs->execute([$personId, $gname, self::slugify($gname), $display, $i * self::SORT_STEP]);
|
||
$gid = (int)$db->lastInsertId();
|
||
$j = 0;
|
||
foreach ($sites as $site) {
|
||
$j++;
|
||
$ss->execute([$personId, $gid, $site[1], $site[0], $site[0],
|
||
$j * self::SORT_STEP, $now, $now]);
|
||
}
|
||
}
|
||
// 默认搜索引擎（照搬 SimpleNav 的引擎表：必应/百度启用，其余列出但未启用）
|
||
$es = $db->prepare(
|
||
'INSERT INTO nav_engines (person_id, name, slug, search_url, param, suggest_url,
|
||
suggest_type, color, is_active, sort_order) VALUES (?,?,?,?,?,?,?,?,?,?)');
|
||
$k = 0;
|
||
foreach (self::ENGINE_SEED as $e) {
|
||
$k++;
|
||
$es->execute([$personId, $e[0], $e[1], $e[2], $e[3], $e[4], $e[5], $e[6], $e[7],
|
||
$k * self::SORT_STEP]);
|
||
}
|
||
}
|
||
|
||
/** 默认板块（照搬 SimpleNav 的 seed_groups_and_sites，去掉纯广告位，保留通用工具） */
|
||
public const SEED = [
|
||
['常用', 'grid', [
|
||
['GitHub', 'https://github.com/'],
|
||
['阿里云', 'https://www.aliyun.com/'],
|
||
['知乎', 'https://www.zhihu.com/'],
|
||
['豆瓣', 'https://www.douban.com/'],
|
||
['少数派', 'https://sspai.com/'],
|
||
['bilibili', 'https://www.bilibili.com/'],
|
||
]],
|
||
['工具', 'grid', [
|
||
['腾讯文档', 'https://docs.qq.com/'],
|
||
['飞书', 'https://www.feishu.cn/'],
|
||
['Gitee', 'https://gitee.com/'],
|
||
['百度网盘', 'https://pan.baidu.com/'],
|
||
['draw.io', 'https://app.diagrams.net/'],
|
||
['Bitwarden', 'https://bitwarden.com/'],
|
||
['高德地图', 'https://gaode.com/'],
|
||
['微信读书', 'https://weread.qq.com/'],
|
||
]],
|
||
['常用软件', 'tabs', [
|
||
['WPS', 'https://www.wps.cn/'],
|
||
['VS Code', 'https://code.visualstudio.com/'],
|
||
['7-Zip', 'https://sparanoid.com/lab/7z/'],
|
||
['Everything', 'https://www.voidtools.com/zh-cn/'],
|
||
['DBeaver', 'https://github.com/dbeaver/dbeaver'],
|
||
['VLC', 'https://www.videolan.org/vlc/'],
|
||
['Zotero', 'https://www.zotero.org/'],
|
||
]],
|
||
['图片资源', 'tabs', [
|
||
['图标库', 'https://www.iconfont.cn/'],
|
||
['插画库', 'https://undraw.co/illustrations'],
|
||
['Pixabay', 'https://pixabay.com/zh/'],
|
||
['Pexels', 'https://www.pexels.com/'],
|
||
]],
|
||
['科研论文', 'tabs', [
|
||
['DeepL翻译', 'https://www.deepl.com/'],
|
||
['Semantic Scholar', 'https://www.semanticscholar.org/'],
|
||
['LaTeX Table', 'https://www.tablesgenerator.com/'],
|
||
['学堂在线', 'https://www.xuetangx.com/'],
|
||
]],
|
||
];
|
||
|
||
/** 默认搜索引擎（照搬 SimpleNav 的 seed_engines） */
|
||
public const ENGINE_SEED = [
|
||
// 名称, slug, 搜索地址, 参数, 联想地址, 联想类型, 颜色, 是否启用
|
||
['必应', 'bing', 'https://cn.bing.com/search', 'q',
|
||
'https://api.bing.com/osjson.aspx?query={q}', 'bing_osjson', '#60A504', 1],
|
||
['百度', 'baidu', 'https://www.baidu.com/s', 'wd',
|
||
'https://www.baidu.com/sugrec?prod=pc&wd={q}', 'baidu_sugrec', '#2100E0', 1],
|
||
['谷歌', 'google', 'https://www.google.com/search', 'q', '', '', '#3B83FA', 0],
|
||
['搜狗', 'sogou', 'https://www.sogou.com/web', 'query', '', '', '#FE6B14', 0],
|
||
['360', 'so360', 'https://www.so.com/s', 'q',
|
||
'https://sug.so.360.cn/suggest?encodein=utf-8&encodeout=utf-8&format=json&word={q}',
|
||
'so360', '#1BB04A', 0],
|
||
['DuckGo', 'ddg', 'https://duckduckgo.com/', 'q', '', '', '#DE5833', 0],
|
||
];
|
||
} |