fix: 图标文件名按「整条网址」命名,同域名不同路径不再互相覆盖
https://nas.yangyq.net/calendar 与 https://nas.yangyq.net/ 这类「同域名、 不同路径」的条目,图标文件名原先只由域名决定(md5(域名)),两条记录指向 同一个文件:改其中一个的自定义图标,另一个跟着变;保存时还会 unlink / 覆盖掉对方的文件,直接把对方搞成破图。 - 新增 icon_key($url):按整条网址取键(协议与主机名转小写、空路径补 /、 查询串与锚点保留),语义是「不同网址 → 不同图标文件」。 - 4 处调用点全部改用它:site_save(上传图标 / 自定义地址)、fetch_meta、 update_all;键一律取自「记录里存的那条 URL」,不用跳转后的 final_url, 保证同一个网站每次算出来的键都一样(否则每次重下 + 留下孤儿文件)。 - download_best_icon() / save_custom_icon() 增加空键保护,避免键为空时 所有图标都落到同一个文件名上。 - README 新增「图标文件的命名规则」一节。 - .gitattributes 统一按 LF 存放,防止 Windows 的 core.autocrlf 在下次 checkout 时把 PHP/JS/CSS 换成 CRLF。 - e2e 新增「同域名不同路径」回归场景:用三张颜色不同的图,比对两条记录 落盘图标的内容,验证改 A 不会波及 B;并已做反向验证(把 icon_key 改回 按域名取键后,这些断言确实失败)。
This commit is contained in:
+61
-2
@@ -26,7 +26,12 @@ function norm_url(string $url): string
|
||||
return $url;
|
||||
}
|
||||
|
||||
/** 取主域名(用于图标文件名与首字母回退) */
|
||||
/**
|
||||
* 取主域名(用于首字母回退、标题回退等展示用途)。
|
||||
*
|
||||
* ⚠️ 不要再拿它当图标文件名!图标文件请一律用 icon_key($url) ——
|
||||
* 同一域名下不同路径是两个不同的网站条目,用域名做键会互相覆盖。
|
||||
*/
|
||||
function domain_of(string $url): string
|
||||
{
|
||||
$host = parse_url(norm_url($url), PHP_URL_HOST);
|
||||
@@ -301,14 +306,61 @@ function attr_value(string $tag, string $attr): string
|
||||
* 图标下载与规范化
|
||||
* ========================================================================= */
|
||||
|
||||
/**
|
||||
* 图标文件的命名键:**按整条网址**算,而不是只按域名。
|
||||
*
|
||||
* 为什么不能只用域名(2026-09-28 修的真实 bug):
|
||||
* 同一域名下不同路径往往是两个独立的网站条目,例如
|
||||
* https://nas.yangyq.net/calendar 与 https://nas.yangyq.net/
|
||||
* 若键只取域名,两条记录会指向**同一个图标文件** —— 改其中一个的自定义图标,
|
||||
* 另一个跟着变;更糟的是保存时会 `unlink` 那个文件名,直接把对方**搞成破图**。
|
||||
*
|
||||
* 归一化规则(尽量少,只抹掉「同一个网址的不同写法」带来的差异):
|
||||
* - 协议与主机名转小写;主机名**不**去 www(`www.a.com` 与 `a.com` 是两个条目)
|
||||
* - 空路径补成 `/`(`https://a.com` 与 `https://a.com/` 视为同一个)
|
||||
* - 查询串、锚点(`#/calendar` 这类 SPA 路由)**保留**,它们是区分条目的信息
|
||||
* 一句话:**不同网址 → 不同图标文件**。
|
||||
*
|
||||
* 注意:调用方要用「记录里存的那条 URL」来算,不要用跳转后的 final_url,
|
||||
* 否则同一个网站在不同次请求里会算出不同的键(每次重下 + 留下孤儿文件)。
|
||||
*
|
||||
* 返回的是键(md5 十六进制串);实际文件名会再哈希一次(历史遗留,只是让文件名长度固定,
|
||||
* 不影响任何行为)。
|
||||
*/
|
||||
function icon_key(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);
|
||||
}
|
||||
|
||||
/**
|
||||
* 按候选顺序抓取图标,返回质量最佳的一张的本地文件名(失败返回 '')。
|
||||
* 规则:min(宽,高) 越大越优;达到 $minGood 即停止;另有总耗时预算,避免批量更新超时。
|
||||
*
|
||||
* @param string[] $urls 候选图标地址(已按优先级排序)
|
||||
* @param string $key 图标文件的命名键,**请传 icon_key($url)**(不要传域名)
|
||||
*/
|
||||
function download_best_icon(array $urls, string $key, int $minGood = 120, float $budget = 10.0): string
|
||||
{
|
||||
if ($key === '') { // 没有键就不写文件,避免全部落到 md5('') 上互相覆盖
|
||||
return '';
|
||||
}
|
||||
if (!is_dir(ICON_PATH)) {
|
||||
@mkdir(ICON_PATH, 0755, true);
|
||||
}
|
||||
@@ -500,9 +552,16 @@ function grab_icon(string $iconUrl): ?array
|
||||
return ['tmp' => $tmp, 'ext' => 'png', 'w' => $w, 'h' => $h];
|
||||
}
|
||||
|
||||
/** 保存用户上传/指定的自定义图标(文件内容直接给),返回本地文件名 */
|
||||
/**
|
||||
* 保存用户上传/指定的自定义图标(文件内容直接给),返回本地文件名。
|
||||
*
|
||||
* @param string $key 图标文件的命名键,**请传 icon_key($url)**(不要传域名)
|
||||
*/
|
||||
function save_custom_icon(string $binary, string $key): string
|
||||
{
|
||||
if ($key === '') {
|
||||
return '';
|
||||
}
|
||||
if (!is_dir(ICON_PATH)) {
|
||||
@mkdir(ICON_PATH, 0755, true);
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user