Files
CardAuth/backend/app/Services/VersionService.php
T
root e809b7a903 v1.1.0: 新增安装统计与版本推送
功能说明:
- 安装统计: 每次安装独立计数(含已删除), 存活/已删除, 最后上线时间
- 版本推送: 上传安装包并推送客户端下载, 支持强制更新提示(不阻断授权)
- 客户端接口: check-update / heartbeat, verify 成功附带更新字段
- 管理端: 安装统计页 + 版本推送页; agent 不可发布版本(仅只读)
- 文档: README API 说明 + /docs 功能介绍与使用方法 + CHANGELOG

数据库:
- 新表 ca_installations / ca_project_versions
- 增量升级: backend/database/migrations/20261008_add_installations_and_versions.sql
2026-10-08 18:19:36 +08:00

185 lines
6.3 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
namespace App\Services;
use App\Core\Database;
/**
* 项目版本/安装包服务
*/
class VersionService
{
/**
* 语义化版本比较
* @return int -1 a<b, 0 a==b, 1 a>b
*/
public static function compare(string $a, string $b): int
{
return version_compare(self::normalize($a), self::normalize($b));
}
/**
* 规范化版本号:剥离前缀 v/V,预发布后缀
*/
public static function normalize(string $version): string
{
$version = trim($version);
if ($version === '') {
return '0.0.0';
}
if ($version[0] === 'v' || $version[0] === 'V') {
$version = substr($version, 1);
}
// 预发布:1.2.0-beta.1 -> 1.2.0-beta
return $version;
}
/**
* 获取项目最新可用版本
*/
public static function getLatest(int $projectId): ?array
{
$db = Database::getInstance();
$row = $db->fetch(
"SELECT * FROM {$db->table('project_versions')}
WHERE project_id = ? AND status = 1 AND is_latest = 1
ORDER BY id DESC LIMIT 1",
[$projectId]
);
return $row ?: null;
}
/**
* 构造客户端更新提示载荷
*
* @return array {
* update_available: bool, update_required: bool,
* current_version: string, latest_version: string,
* version: ?string, download_url: ?string, file_size: int,
* checksum: string, changelog: ?string,
* min_client_version: string, is_force: int
* }
*/
public static function buildUpdatePayload(int $projectId, string $clientVersion = ''): array
{
$db = Database::getInstance();
$latest = self::getLatest($projectId);
$clientVersion = self::normalize($clientVersion);
$hasClient = trim($clientVersion) !== '' && $clientVersion !== '0.0.0';
if (!$latest) {
return [
'update_available' => false,
'update_required' => false,
'current_version' => $clientVersion,
'latest_version' => '',
'version' => null,
'download_url' => null,
'file_size' => 0,
'checksum' => '',
'changelog' => null,
'min_client_version' => '',
'is_force' => 0,
'install_id' => null,
];
}
$latestVersion = self::normalize($latest['version']);
$minVersion = self::normalize($latest['min_client_version'] ?? '');
$isForce = (int) $latest['is_force'];
$updateAvailable = !$hasClient || self::compare($latestVersion, $clientVersion) > 0;
$belowMin = $minVersion !== '' && $minVersion !== '0.0.0'
&& self::compare($clientVersion, $minVersion) < 0;
$updateRequired = ($isForce === 1 && $updateAvailable) || ($belowMin && $updateAvailable);
return [
'update_available' => $updateAvailable,
'update_required' => $updateRequired,
'current_version' => $clientVersion,
'latest_version' => $latest['version'],
'version' => $latest['version'],
'download_url' => $latest['file_path'],
'file_size' => (int) $latest['file_size'],
'checksum' => $latest['checksum'] ?? '',
'changelog' => $latest['changelog'],
'min_client_version' => $latest['min_client_version'] ?? '',
'is_force' => $isForce,
'install_id' => null,
];
}
/**
* 数据范围:项目管理员/管理员可见;代理只读(由控制器限制写操作)
*/
public static function scope(array $user): array
{
$role = $user['role'] ?? '';
if ($role === 'admin') {
return ['where' => 'p.deleted_at IS NULL', 'params' => []];
}
if ($role === 'project_admin') {
$projectIds = $user['project_ids'] ?? [];
if (empty($projectIds)) {
return ['where' => '1=0', 'params' => []];
}
$placeholders = implode(',', array_fill(0, count($projectIds), '?'));
return [
'where' => "p.deleted_at IS NULL AND p.id IN ({$placeholders})",
'params' => array_map('intval', $projectIds),
];
}
// 代理:有卡密记录的项目
$db = Database::getInstance();
$agentIds = PermissionService::getAgentIdsUnder((int) ($user['id'] ?? 0));
if (empty($agentIds)) {
return ['where' => '1=0', 'params' => []];
}
$placeholders = implode(',', array_fill(0, count($agentIds), '?'));
return [
'where' => "p.deleted_at IS NULL AND p.id IN (
SELECT DISTINCT c.project_id FROM {$db->table('cards')} c WHERE c.use_user_id IN ({$placeholders})
)",
'params' => array_map('intval', $agentIds),
];
}
/**
* 是否允许发布/修改版本(仅 admin / project_admin)
*/
public static function canPublish(?string $role): bool
{
return in_array($role, ['admin', 'project_admin'], true);
}
/**
* 校验项目访问权限
*/
public static function assertProjectAccess(int $projectId, array $user): bool
{
$role = $user['role'] ?? '';
if ($role === 'admin') {
return true;
}
if ($role === 'project_admin') {
$projectIds = $user['project_ids'] ?? [];
return in_array($projectId, array_map('intval', $projectIds), true);
}
if ($role === 'agent') {
$db = Database::getInstance();
$agentIds = PermissionService::getAgentIdsUnder((int) ($user['id'] ?? 0));
if (empty($agentIds)) {
return false;
}
$placeholders = implode(',', array_fill(0, count($agentIds), '?'));
$count = (int) $db->fetchColumn(
"SELECT COUNT(*) FROM {$db->table('cards')} WHERE project_id = ? AND use_user_id IN ({$placeholders})",
array_merge([$projectId], $agentIds)
);
return $count > 0;
}
return false;
}
}