95 lines
2.5 KiB
PHP
95 lines
2.5 KiB
PHP
<?php
|
|
// +----------------------------------------------------------------------
|
|
// | YwxApp [ WE CAN DO IT JUST THINK ]
|
|
// +----------------------------------------------------------------------
|
|
// | Copyright (c) 2026-2036 http://ywxapp.cn All rights reserved.
|
|
// +----------------------------------------------------------------------
|
|
// | Author: ywxapp<admin@ywxapp.cn>
|
|
// +----------------------------------------------------------------------
|
|
declare (strict_types = 1);
|
|
|
|
namespace addon\docs\model;
|
|
|
|
use think\Model;
|
|
|
|
/**
|
|
* 文档版本模型
|
|
*
|
|
* @author ywxapp <admin@ywxapp.cn>
|
|
*/
|
|
class DocsVersion extends Model
|
|
{
|
|
protected $name = 'docs_version';
|
|
|
|
protected $autoWriteTimestamp = true;
|
|
protected $createTime = 'create_at';
|
|
protected $updateTime = 'update_at';
|
|
|
|
protected $type = [
|
|
'id' => 'integer',
|
|
'project_id' => 'integer',
|
|
'is_default' => 'integer',
|
|
'sort' => 'integer',
|
|
'status' => 'integer',
|
|
];
|
|
|
|
/**
|
|
* 关联所属项目
|
|
*/
|
|
public function project()
|
|
{
|
|
return $this->belongsTo(DocsProject::class, 'project_id', 'id');
|
|
}
|
|
|
|
/**
|
|
* 获取项目下的启用版本列表
|
|
*
|
|
* @param int $projectId 项目ID
|
|
* @return \think\Collection
|
|
*/
|
|
public static function listByProject(int $projectId)
|
|
{
|
|
return static::where('project_id', $projectId)
|
|
->where('status', 1)
|
|
->order('sort', 'asc')
|
|
->order('id', 'asc')
|
|
->select();
|
|
}
|
|
|
|
/**
|
|
* 解析项目的目标版本
|
|
*
|
|
* 优先按名称精确匹配，其次取默认版本，最后退回第一个版本。
|
|
*
|
|
* @param int $projectId 项目ID
|
|
* @param string $name 版本标识，为空表示取默认
|
|
* @return static|null
|
|
*/
|
|
public static function resolve(int $projectId, string $name = '')
|
|
{
|
|
if ($name !== '') {
|
|
$version = static::where('project_id', $projectId)
|
|
->where('name', $name)
|
|
->where('status', 1)
|
|
->find();
|
|
if ($version) {
|
|
return $version;
|
|
}
|
|
}
|
|
|
|
$default = static::where('project_id', $projectId)
|
|
->where('status', 1)
|
|
->where('is_default', 1)
|
|
->find();
|
|
if ($default) {
|
|
return $default;
|
|
}
|
|
|
|
return static::where('project_id', $projectId)
|
|
->where('status', 1)
|
|
->order('sort', 'asc')
|
|
->order('id', 'asc')
|
|
->find();
|
|
}
|
|
}
|