Files
YwxAppThink/addon/haonav/controller/trait/SnapshotTrait.php
T
yangwx 18101cf11a feat: 上线前安全加固与发布工程化;appmall 由插件迁移为独立应用
安全(P0)
- 发布包签名:新增 scripts/package_keygen.php、scripts/package_verify.php、
  ywxapp\service\PackageVerifier;FrameworkService::apply() 解压前强制验签
  (ywxapp.framework_package_verify,默认开启)
- JWT 收紧:config/jwt.php 移除公开默认密钥,JwtService::assertStrongSecret()
  校验非空 / 长度≥32 / 已知弱值;.env.production.example 键名由 JWT_SECRET_KEY 修正为 JWT_SECRET
- /api/v1/Article:免登录白名单收窄为只读接口,写操作字段白名单 + assertOwner() 越权校验
- 开发者令牌:查找接口不再回显明文、统一失败文案 + 限流
- TemplateInstaller:文件名白名单 + realpath 归一化 + 目录内断言,修复 Zip Slip;补 use ZipArchive
- 后台登录:接入验证码、失败锁定与登录限流(config/ratelimit.php)
- 缓存 / Session 驱动可由 .env 覆盖(CACHE_DRIVER / SESSION_TYPE),集群部署改 redis
- paycenter 支付日志开关改为 PAY_LOG,不再跟随 APP_DEBUG

工程化 / 交付
- 新增 CHANGELOG.md 与 .env.production.example;composer.lock 入库锁定依赖版本
- 插件离线安装 CLI 增加 --uid,后台上传安装透传 uid,付费插件授权校验可通过
- 授权拒绝文案区分「未携带 uid」与「未找到有效授权」,便于排障
- .gitignore 放行 .env.production.example / .env.addon.example / .gitattributes / public/.htaccess

结构
- appmall 由 addon/appmall 迁移为独立应用 app/appmall(市场 / 开发者中心 / 审核 / 分润)
2026-10-22 00:53:39 +08:00

78 lines
2.7 KiB
PHP

<?php
declare(strict_types=1);
namespace addon\haonav\controller\trait;
use addon\haonav\model\Links as LinksModel;
/**
* 网站截图缩略图(mshots 代理 + 7 天缓存 + 负缓存)
* 输出由 BaseTrait::serveFile / serveDefault 统一处理
*/
trait SnapshotTrait
{
/**
* 网站截图缩略图代理 + 缓存
* 请求 /haonav/snapshot.html?id=链接ID(以 id 换 url,避免 SSRF),
* 服务端经 WordPress mshots 免费截图服务生成,缓存 7 天到
* public/static/haonav/snapshots/。生成中/失败时返回默认小图,
* 前端以 naturalWidth 判断是否为真实截图。
*/
public function snapshot()
{
$id = (int)$this->request->param('id/d', 0);
$link = $id > 0 ? LinksModel::find($id) : null;
$url = $link ? (string)$link->url : '';
if (!$url) {
return $this->serveDefault();
}
$root = app()->getRootPath() . 'public/static/haonav/snapshots/';
if (! is_dir($root)) {
@mkdir($root, 0755, true);
}
$key = md5($url);
$file = $root . $key . '.jpg';
if (is_file($file) && (time() - filemtime($file)) < 7 * 86400) {
return $this->serveFile($file);
}
// 失败/生成中负缓存 1 小时,避免每次 hover 都打远程
$failFile = $root . $key . '.fail';
if (is_file($failFile) && (time() - filemtime($failFile)) < 3600) {
return is_file($file) ? $this->serveFile($file) : $this->serveDefault();
}
$img = $this->fetchSnapshot($url);
if ($img) {
@file_put_contents($file, $img);
return $this->serveFile($file);
}
@touch($failFile);
return is_file($file) ? $this->serveFile($file) : $this->serveDefault();
}
/**
* 抓取 mshots 截图;生成中(返回 loading gif)或失败返回 false
*/
protected function fetchSnapshot(string $url)
{
if (! class_exists(\GuzzleHttp\Client::class)) {
return false;
}
$api = 'https://s0.wp.com/mshots/v1/' . urlencode($url) . '?w=480';
try {
$client = new \GuzzleHttp\Client(['timeout' => 8, 'verify' => false]);
$resp = $client->get($api, ['headers' => ['Member-Agent' => 'Mozilla/5.0']]);
$body = (string)$resp->getBody();
$ct = strtolower($resp->getHeaderLine('Content-Type'));
// mshots 首次请求会 307 到 loading gif,表示截图排队生成中,不缓存
if (stripos($ct, 'gif') !== false || strlen($body) < 2048) {
return false;
}
return $body;
} catch (\Throwable $e) {
return false;
}
}
}