mrlee/MrleeAdmin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

初始化本地仓库

Browse Source
This commit is contained in:
mrlee
2026-08-31 11:33:59 +08:00
commit 663f74b633
2390 changed files with 402918 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
backend/core/plugin/PluginInstall.php
+449
View File
@@ -0,0 +1,449 @@
<?php
/**
*+------------------
* madong
*+------------------
* Copyright (c) https://gitee.com/motion-code All rights reserved.
*+------------------
* Author: Mr. April (405784684@qq.com)
*+------------------
* Official Website: http://www.madong.tech
*/
/**
* 插件安装基类
* 使用 Trait 实现职责分离：
* - ConfigTrait: 配置管理
* - MigrationTrait: 迁移操作
* - SeedTrait: 种子操作
* - MenuTrait: 菜单操作
* - TemplateTrait: 模板资源操作
* - DependencyTrait: 依赖安装
* 使用方式：
* 1. 在插件目录创建 Install.php
* 2. 继承此类即可，迁移和种子会自动执行
* 3. 可重写 install/uninstall/update 方法添加自定义逻辑
* 配置覆盖：
* - 默认配置: core/plugin/config/default.php
* - 应用配置: core/plugin/config/app.php
* - 插件配置: plugin/{name}/config/info.php (可覆盖上述配置)
*/
namespace core\plugin;
use core\plugin\traits\ConfigTrait;
use core\plugin\traits\MigrationTrait;
use core\plugin\traits\SeedTrait;
use core\plugin\traits\MenuTrait;
use core\plugin\traits\TemplateTrait;
use core\plugin\traits\DependencyTrait;
class PluginInstall
{
use ConfigTrait;
use MigrationTrait;
use SeedTrait;
use MenuTrait;
use TemplateTrait;
use DependencyTrait;
/** @var string 插件名称 */
protected string $pluginName = '';
/** @var string 插件路径 */
protected string $pluginPath = '';
/** @var string|null 连接名（默认使用框架配置） */
protected ?string $connection = null;
/** @var array 插件配置 */
protected array $appConfig = [];
/** @var callable|null 进度回调函数（用于在线模式通过 SSE 返回进度） */
protected $progressCallback = null;
/** @var bool 是否为在线模式（非 CLI） */
protected bool $isOnlineMode = false;
/** @var bool 卸载阶段是否保留已复制的模板资源 */
protected bool $preserveTemplatesDuringUninstall = false;
/**
* @param callable|null $progressCallback 进度回调
* @param bool $isOnlineMode 是否为在线模式
*/
public function __construct(?callable $progressCallback = null, bool $isOnlineMode = false)
{
$this->progressCallback = $progressCallback;
$this->isOnlineMode = $isOnlineMode;
$this->init();
}
/**
* 设置进度回调
*/
public function setProgressCallback(?callable $callback): self
{
$this->progressCallback = $callback;
return $this;
}
/**
* 设置是否为在线模式
*/
public function setOnlineMode(bool $isOnlineMode): self
{
$this->isOnlineMode = $isOnlineMode;
return $this;
}
/**
* 输出日志（CLI 模式 echo，在线模式通过回调）
*/
protected function log(string $message, ?int $progress = null): void
{
if ($this->isOnlineMode && $this->progressCallback) {
// 在线模式：通过回调返回进度
($this->progressCallback)($message, $progress);
} else {
// CLI 模式：直接输出
echo $message . "\n";
}
}
/**
* 输出进度
*/
protected function progress(string $message, int $progress): void
{
$this->log($message, $progress);
}
/**
* 输出消息（用于 Trait 中的 echo 替换）
* CLI 模式直接输出，在线模式输出到缓冲区
*/
protected function output(string $message): void
{
echo $message . "\n";
}
/**
* 初始化
*/
protected function init(): void
{
$this->pluginPath = $this->getPluginPath();
$this->pluginName = basename($this->pluginPath);
$this->appConfig = $this->getAppConfig();
}
/**
* 插件路径 - 子类可重写
*/
protected function getPluginPath(): string
{
$class = static::class;
$parts = explode('\\', $class);
if (count($parts) >= 2 && $parts[0] === 'plugin') {
return base_path('plugin/' . $parts[1]);
}
return base_path('plugin');
}
/**
* 插件名称
*/
protected function getPluginName(): string
{
return $this->pluginName ?: basename($this->getPluginPath());
}
/**
* 设置数据库连接
*/
public function setConnection(?string $connection): self
{
$this->connection = $connection;
return $this;
}
/**
* 强制重新运行迁移
*/
public function forceMigrate(): void
{
$this->output("⚠️ Force migration - clearing migration logs...");
$this->clearLogs();
$this->runMigrations();
}
/**
* 安装
*/
public function install($version): void
{
$this->log("====== Plugin Install: {$this->getPluginName()} ======", 0);
$this->log("Version: {$version}");
$this->log("Path: {$this->pluginPath}");
// 安装前回调
$this->beforeInstall($version);
// 安装 Composer 依赖（后端）
$this->installComposerDeps();
// 运行迁移（后端）
$this->runMigrations();
// 运行种子（后端）
$this->runSeeds();
// 安装前端依赖
$this->installNpmDeps();
// 复制前端模板到各端
$this->copyTemplates();
// 执行各端安装命令
$this->runInstallCommands();
// 安装后回调 - 可重写用于导入菜单等操作
$this->afterInstall($version);
// 保存插件安装状态
$this->savePluginConfig($version);
$this->log("====== Install Completed ======", 100);
}
/**
* 安装前回调 - 可重写
*/
protected function beforeInstall(string $version): void
{
$this->log(" 🔄 Running beforeInstall...");
}
/**
* 安装后回调 - 可重写
*/
protected function afterInstall(string $version): void
{
$this->log(" 🔄 Running afterInstall...");
// 加载插件菜单
$this->loadMenus();
}
/**
* 卸载前回调 - 可重写
*/
protected function beforeUninstall(string $version): void
{
$this->log(" 🔄 Running beforeUninstall...");
}
/**
* 卸载后回调 - 清理菜单
*/
protected function afterUninstall(string $version): void
{
$this->log(" 🔄 Running afterUninstall...");
// 卸载菜单
$this->uninstallPluginMenus();
}
/**
* 卸载
*/
public function uninstall($version): void
{
$this->log("====== Plugin Uninstall: {$this->getPluginName()} ======", 0);
$this->preserveTemplatesDuringUninstall = true;
try {
// 卸载前回调和卸载后回调均不得物理删除模板资源。
$this->beforeUninstall($version);
// 获取卸载配置
$pluginInfo = $this->getPluginInfo();
$uninstallConfig = $pluginInfo['uninstall'] ?? [];
$dropTables = $uninstallConfig['drop_tables'] ?? false;
$this->log("📋 Uninstall config: drop_tables=" . ($dropTables ? 'true' : 'false'));
// 回滚迁移（可选删除表）
$this->rollbackMigrations($dropTables);
// 清理日志
$this->clearLogs();
$this->afterUninstall($version);
} finally {
$this->preserveTemplatesDuringUninstall = false;
}
$this->log('📦 Plugin package, templates and dependencies are preserved until deletion; only the installation marker is removed.');
$this->log("====== Uninstall Completed ======", 100);
}
/**
* 删除插件
*/
public function delete($version): void
{
$this->log("====== Plugin Delete: {$this->getPluginName()} ======", 10);
// 获取插件配置
$pluginInfo = $this->getPluginInfo();
$uninstallConfig = $pluginInfo['uninstall'] ?? [];
$undeletable = $uninstallConfig['undeletable'] ?? false;
$this->log("📋 Plugin config: undeletable=" . ($undeletable ? 'true' : 'false'), 20);
// 检查是否允许删除
if ($undeletable) {
throw new \Exception('系统内置插件不允许删除');
}
// 删除前回调
$this->beforeDelete($version);
// 删除安装时复制到前端项目的模板资源
$this->deleteTemplates();
// 按插件配置移除安装时合并的依赖
$globalUninstallConfig = $this->getConfig('uninstall', []);
$removeDependencies = $uninstallConfig['remove_dependencies'] ?? $globalUninstallConfig['remove_dependencies'] ?? false;
if ($removeDependencies) {
$this->removeMergedDependencies();
}
// 获取插件目录
$pluginDir = $this->pluginPath;
if (!is_dir($pluginDir)) {
throw new \Exception('插件目录不存在：' . $pluginDir);
}
$this->log("📁 Deleting plugin directory: {$pluginDir}", 40);
// 使用递归删除整个插件目录
$this->removeDirectory($pluginDir);
$this->log("✅ Plugin deleted successfully", 100);
// 删除后回调
$this->afterDelete($version);
}
/**
* 删除前回调 - 可重写
*/
protected function beforeDelete(string $version): void
{
$this->log(" 🔄 Running beforeDelete...");
}
/**
* 删除后回调 - 可重写
*/
protected function afterDelete(string $version): void
{
$this->log(" 🔄 Running afterDelete...");
}
/**
* 递归删除目录
*/
protected function removeDirectory(string $directory): void
{
if (!is_dir($directory)) {
return;
}
$files = scandir($directory);
foreach ($files as $file) {
if ($file === '.' || $file === '..') {
continue;
}
$path = $directory . DIRECTORY_SEPARATOR . $file;
if (is_dir($path)) {
$this->removeDirectory($path);
} else {
@unlink($path);
}
}
@rmdir($directory);
}
/**
* 删除模板资源 - 仅应在删除插件或升级清理阶段调用
*/
protected function deletePluginTemplates(): void
{
$this->deleteTemplates();
}
/**
* 更新
*/
public function update($version): void
{
$this->output("====== Plugin Update: {$this->getPluginName()} ======");
// 先卸载
$this->uninstall($version);
// 升级前清理旧模板，避免已删除的旧文件残留
$this->deleteTemplates();
// 再安装
$this->install($version);
$this->output("====== Update Completed ======");
}
// =========================================================
// 端安装命令执行
// =========================================================
/**
* 执行各端安装命令
*/
protected function runInstallCommands(): void
{
$this->output("📦 Running install commands...");
$projectRoot = $this->getProjectRoot();
// 后端安装命令
$this->runBackendCommands($projectRoot);
// 前端安装命令
$this->runFrontendCommands($projectRoot);
}
/**
* 执行后端安装命令
*/
protected function runBackendCommands(string $projectRoot): void
{
// 可在子类中重写实现自定义命令
}
/**
* 执行前端安装命令
*/
protected function runFrontendCommands(string $projectRoot): void
{
// 可在子类中重写实现自定义命令
}
}