Files
CardAuth/backend/app/Controllers/ProjectVersionController.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

365 lines
12 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\Controllers;
use App\Core\Controller;
use App\Core\Database;
use App\Services\VersionService;
/**
* 项目版本/安装包管理控制器
* 发布/修改仅 admin + project_admin;agent 只读
*/
class ProjectVersionController extends Controller
{
private const ALLOWED_EXT = ['zip', 'tar', 'gz', 'tgz', '7z', 'exe', 'dmg', 'apk', 'msi', 'pkg', 'rar', 'bin'];
private const MAX_SIZE = 200 * 1024 * 1024; // 200MB
/**
* 版本列表
* GET /api/projects/{projectId}/versions
*/
public function list(int $projectId): void
{
$user = $this->getCurrentUser() ?: [];
if (!VersionService::assertProjectAccess($projectId, $user)) {
$this->error('无权访问该项目', 403);
}
$db = Database::getInstance();
$list = $db->fetchAll(
"SELECT v.*, p.name AS project_name
FROM {$db->table('project_versions')} v
LEFT JOIN {$db->table('projects')} p ON p.id = v.project_id
WHERE v.project_id = ?
ORDER BY v.id DESC",
[$projectId]
);
$this->success($list);
}
/**
* 版本详情
* GET /api/projects/{projectId}/versions/{id}
*/
public function detail(int $projectId, int $id): void
{
$user = $this->getCurrentUser() ?: [];
if (!VersionService::assertProjectAccess($projectId, $user)) {
$this->error('无权访问该项目', 403);
}
$db = Database::getInstance();
$row = $db->fetch(
"SELECT v.*, p.name AS project_name
FROM {$db->table('project_versions')} v
LEFT JOIN {$db->table('projects')} p ON p.id = v.project_id
WHERE v.id = ? AND v.project_id = ?",
[$id, $projectId]
);
if (!$row) {
$this->error('版本不存在', 404);
}
$this->success($row);
}
/**
* 上传发布版本
* POST /api/projects/{projectId}/versions (multipart)
*/
public function create(int $projectId): void
{
$user = $this->getCurrentUser() ?: [];
$role = $user['role'] ?? '';
if (!VersionService::canPublish($role)) {
$this->error('代理账号不可发布版本', 403);
}
if (!VersionService::assertProjectAccess($projectId, $user)) {
$this->error('无权操作该项目', 403);
}
$version = trim($_POST['version'] ?? '');
if ($version === '') {
$this->error('版本号不能为空');
}
if (!isset($_FILES['file']) || $_FILES['file']['error'] !== UPLOAD_ERR_OK) {
$this->error('请上传安装包文件');
}
$file = $_FILES['file'];
$ext = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
if (!in_array($ext, self::ALLOWED_EXT, true)) {
$this->error('仅支持 ' . implode('/', self::ALLOWED_EXT) . ' 格式的安装包');
}
if ($file['size'] > self::MAX_SIZE) {
$this->error('安装包大小不能超过 200MB');
}
$db = Database::getInstance();
$exists = $db->fetch(
"SELECT id FROM {$db->table('project_versions')} WHERE project_id = ? AND version = ?",
[$projectId, $version]
);
if ($exists) {
$this->error('该版本号已存在');
}
$uploadDir = BASE_PATH . '/public/uploads/packages/' . $projectId;
if (!is_dir($uploadDir) && !mkdir($uploadDir, 0755, true) && !is_dir($uploadDir)) {
$this->error('创建上传目录失败');
}
// 安全文件名:随机 + 原扩展名
$safeName = 'pkg_' . $projectId . '_' . time() . '_' . bin2hex(random_bytes(6)) . '.' . $ext;
$filepath = $uploadDir . '/' . $safeName;
if (!move_uploaded_file($file['tmp_name'], $filepath)) {
$this->error('安装包上传失败,请重试');
}
$checksum = '';
if (is_file($filepath)) {
$checksum = @hash_file('sha256', $filepath) ?: '';
}
$fileSize = (int) $file['size'];
$isLatest = isset($_POST['is_latest']) ? (int) $_POST['is_latest'] : 1;
$isForce = isset($_POST['is_force']) ? (int) $_POST['is_force'] : 0;
$isForce = $isForce === 1 ? 1 : 0;
$isLatest = $isLatest === 0 ? 0 : 1;
$minVersion = trim($_POST['min_client_version'] ?? '');
$changelog = $_POST['changelog'] ?? '';
$filePath = '/uploads/packages/' . $projectId . '/' . $safeName;
$db->beginTransaction();
try {
if ($isLatest) {
$db->execute(
"UPDATE {$db->table('project_versions')} SET is_latest = 0 WHERE project_id = ?",
[$projectId]
);
}
$versionId = $db->insert(
"INSERT INTO {$db->table('project_versions')}
(project_id, version, file_name, file_path, file_size, checksum, changelog,
min_client_version, is_force, is_latest, download_count, status, created_by)
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0, 1, ?)",
[
$projectId,
$version,
$file['name'],
$filePath,
$fileSize,
$checksum,
$changelog !== '' ? $changelog : null,
$minVersion,
$isForce,
$isLatest,
(int) ($user['id'] ?? 0),
]
);
$db->commit();
} catch (\Throwable $e) {
$db->rollback();
@unlink($filepath);
$this->error('版本发布失败: ' . $e->getMessage());
}
logger('version_publish', 'project_version', $versionId, [
'project_id' => $projectId,
'version' => $version,
'is_force' => $isForce,
'is_latest' => $isLatest,
]);
$row = $db->fetch(
"SELECT * FROM {$db->table('project_versions')} WHERE id = ?",
[$versionId]
);
$this->success($row, '版本发布成功');
}
/**
* 更新版本信息(changelog / force / min_version / status)
* PUT /api/versions/{id}
*/
public function update(int $id): void
{
$user = $this->getCurrentUser() ?: [];
if (!VersionService::canPublish($user['role'] ?? '')) {
$this->error('代理账号不可修改版本', 403);
}
$db = Database::getInstance();
$row = $db->fetch(
"SELECT * FROM {$db->table('project_versions')} WHERE id = ?",
[$id]
);
if (!$row) {
$this->error('版本不存在', 404);
}
if (!VersionService::assertProjectAccess((int) $row['project_id'], $user)) {
$this->error('无权操作该项目的版本', 403);
}
$input = $this->getJsonInput();
$changelog = array_key_exists('changelog', $input) ? $input['changelog'] : $row['changelog'];
$minVersion = array_key_exists('min_client_version', $input) ? trim((string) $input['min_client_version']) : ($row['min_client_version'] ?? '');
$isForce = array_key_exists('is_force', $input) ? ((int) $input['is_force'] === 1 ? 1 : 0) : (int) $row['is_force'];
$status = array_key_exists('status', $input) ? ((int) $input['status'] === 1 ? 1 : 0) : (int) $row['status'];
$db->execute(
"UPDATE {$db->table('project_versions')}
SET changelog = ?, min_client_version = ?, is_force = ?, status = ?
WHERE id = ?",
[
$changelog !== '' ? $changelog : null,
$minVersion,
$isForce,
$status,
$id,
]
);
logger('version_update', 'project_version', $id, [
'version' => $row['version'],
'is_force' => $isForce,
]);
$this->success($db->fetch("SELECT * FROM {$db->table('project_versions')} WHERE id = ?", [$id]), '更新成功');
}
/**
* 切换强制推送
* PUT /api/versions/{id}/force
*/
public function toggleForce(int $id): void
{
$user = $this->getCurrentUser() ?: [];
if (!VersionService::canPublish($user['role'] ?? '')) {
$this->error('代理账号不可修改强制推送', 403);
}
$db = Database::getInstance();
$row = $db->fetch(
"SELECT * FROM {$db->table('project_versions')} WHERE id = ?",
[$id]
);
if (!$row) {
$this->error('版本不存在', 404);
}
if (!VersionService::assertProjectAccess((int) $row['project_id'], $user)) {
$this->error('无权操作该项目的版本', 403);
}
$input = $this->getJsonInput();
if (array_key_exists('is_force', $input)) {
$isForce = ((int) $input['is_force'] === 1) ? 1 : 0;
} else {
$isForce = ((int) $row['is_force'] === 1) ? 0 : 1;
}
$db->execute(
"UPDATE {$db->table('project_versions')} SET is_force = ? WHERE id = ?",
[$isForce, $id]
);
logger('version_force_toggle', 'project_version', $id, [
'version' => $row['version'],
'is_force' => $isForce,
]);
$this->success(
['id' => $id, 'is_force' => $isForce],
$isForce ? '已开启强制推送' : '已关闭强制推送'
);
}
/**
* 设为最新版本
* PUT /api/versions/{id}/latest
*/
public function setLatest(int $id): void
{
$user = $this->getCurrentUser() ?: [];
if (!VersionService::canPublish($user['role'] ?? '')) {
$this->error('代理账号不可设置最新版本', 403);
}
$db = Database::getInstance();
$row = $db->fetch(
"SELECT * FROM {$db->table('project_versions')} WHERE id = ?",
[$id]
);
if (!$row) {
$this->error('版本不存在', 404);
}
if (!VersionService::assertProjectAccess((int) $row['project_id'], $user)) {
$this->error('无权操作该项目的版本', 403);
}
$db->beginTransaction();
try {
$db->execute(
"UPDATE {$db->table('project_versions')} SET is_latest = 0 WHERE project_id = ?",
[(int) $row['project_id']]
);
$db->execute(
"UPDATE {$db->table('project_versions')} SET is_latest = 1, status = 1 WHERE id = ?",
[$id]
);
$db->commit();
} catch (\Throwable $e) {
$db->rollback();
$this->error('设置最新版本失败');
}
logger('version_set_latest', 'project_version', $id, ['version' => $row['version']]);
$this->success(null, '已设为最新版本');
}
/**
* 删除版本
* DELETE /api/versions/{id}
*/
public function delete(int $id): void
{
$user = $this->getCurrentUser() ?: [];
if (!VersionService::canPublish($user['role'] ?? '')) {
$this->error('代理账号不可删除版本', 403);
}
$db = Database::getInstance();
$row = $db->fetch(
"SELECT * FROM {$db->table('project_versions')} WHERE id = ?",
[$id]
);
if (!$row) {
$this->error('版本不存在', 404);
}
if (!VersionService::assertProjectAccess((int) $row['project_id'], $user)) {
$this->error('无权操作该项目的版本', 403);
}
$db->execute("DELETE FROM {$db->table('project_versions')} WHERE id = ?", [$id]);
// 删除物理文件
$abs = BASE_PATH . '/public' . $row['file_path'];
if (is_file($abs)) {
@unlink($abs);
}
logger('version_delete', 'project_version', $id, [
'project_id' => (int) $row['project_id'],
'version' => $row['version'],
]);
$this->success(null, '版本已删除');
}
}