Struct AddonRegistry 

pub struct AddonRegistry { /* private fields */ }

插件注册中心

对齐 PHP think\addons\Service 中隐式的插件状态管理。

线程安全

使用 RwLock<HashMap<String, AddonManifest>> 实现，支持多读单写。

用法

use sz_rust_addons_loader::registry::AddonRegistry;
use sz_rust_addons_loader::manifest::AddonManifest;

let registry = AddonRegistry::new();
let manifest = AddonManifest::new("operate");
registry.register(manifest).unwrap();

assert!(registry.exists("operate"));
assert_eq!(registry.count(), 1);

Implementations

impl AddonRegistry

pub fn new() -> Self

创建空注册中心

pub fn register(&self, manifest: AddonManifest) -> AddonLoaderResult<()>

注册插件（对齐 PHP get_addons_instance 缓存到 $_addons[$name]）

错误

• AddonNotFound：插件名已存在（不覆盖）

pub fn upsert(&self, manifest: AddonManifest)

强制注册或更新插件（对齐 PHP array_merge 覆盖行为）

pub fn unregister(&self, name: &str) -> AddonLoaderResult<Option<AddonManifest>>

注销插件（对齐 PHP unset($_addons[$name])）

返回

• Ok(Some(manifest))：插件已存在并已移除
• Ok(None)：插件不存在

pub fn get(&self, name: &str) -> AddonLoaderResult<AddonManifest>

查询插件清单（对齐 PHP get_addons_info($name)）

错误

• AddonNotFound：插件不存在

pub fn try_get(&self, name: &str) -> Option<AddonManifest>

尝试查询插件清单（不返回错误）

pub fn exists(&self, name: &str) -> bool

判断插件是否存在（对齐 PHP class_exists 检查）

pub fn is_enabled(&self, name: &str) -> AddonLoaderResult<bool>

判断插件是否启用（对齐 PHP Route::execute 中 !$info['status'] 检查）

返回

• Ok(true)：插件存在且 status != 0
• Ok(false)：插件存在但 status == 0
• Err(AddonNotFound)：插件不存在

pub fn set_enabled(&self, name: &str, enabled: bool) -> AddonLoaderResult<()>

设置插件状态（对齐 PHP 修改 $info['status']）

参数

• name：插件名
• enabled：true=1（启用），false=0（禁用）

pub fn names(&self) -> Vec<String>

获取所有已注册的插件名（按字母序，对齐 PHP scandir 排序）

pub fn all(&self) -> Vec<AddonManifest>

获取所有已注册的插件清单（按名字序）

pub fn enabled_addons(&self) -> Vec<AddonManifest>

获取所有启用的插件清单（按名字序）

pub fn disabled_addons(&self) -> Vec<AddonManifest>

获取所有禁用的插件清单（按名字序）

pub fn count(&self) -> usize

获取已注册插件数量

pub fn clear(&self)

清空注册中心

pub fn load_from_directory( &self, addons_path: &Path, ) -> AddonLoaderResult<Vec<AddonLoaderError>>

从插件目录批量加载并注册（对齐 PHP Service::loadService 扫描逻辑）

扫描规则

对齐 PHP scandir($addons_path)：

1. 扫描 addons_path 下的所有子目录
2. 跳过 . .. 及文件项
3. 子目录必须包含 Plugin.php（对齐 PHP is_file($addonDir . ucfirst($name) . '.php')，Rust 侧统一使用 Plugin.php）
4. 解析 Plugin.php 中的 $info 数组
5. 注册到注册中心

错误处理

• 单个插件解析失败不会中断整体扫描，但会记录到返回的错误列表
• 目录读取失败返回 ScanDir 错误

pub fn addon_path(&self, name: &str) -> AddonLoaderResult<PathBuf>

获取插件文件路径（对齐 PHP getAddonsPath() . $name . DIRECTORY_SEPARATOR）

Trait Implementations

impl Debug for AddonRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AddonRegistry

fn default() -> Self

Returns the “default value” for a type.