Struct AddonLoader 

pub struct AddonLoader { /* private fields */ }

插件加载器 — 对齐 think\addons\Service 插件加载器（主入口）

对齐 PHP think\addons\Service，统一管理插件发现/清单/注册/路由解析。

设计

• 持有插件根目录（对齐 PHP $this->addons_path）
• 持有 AddonRegistry（插件清单注册中心）
• 持有 AddonAutoload（类名→文件路径解析）
• 提供 register() 入口：扫描目录 + 解析清单 + 注册到 registry
• 提供 parse_route(url) 入口：URL → 控制器类名 + 文件路径

用法

use sz_rust_addons_loader::loader::AddonLoader;

let loader = AddonLoader::new("/path/to/addons");
let errors = loader.register().unwrap();
// errors 中包含解析失败的插件错误（不中断整体扫描）

let route = loader.parse_route("/addons/operate/Order/index").unwrap();
assert_eq!(route.addon, "operate");
assert_eq!(route.controller, "Order");
assert_eq!(route.action, "index");

Implementations

impl AddonLoader

pub fn new(addons_path: impl Into<PathBuf>) -> AddonLoader

创建加载器

• addons_path：插件根目录，对齐 PHP {rootPath}/addons/

pub fn addons_path(&self) -> &Path

获取插件根目录

pub fn registry(&self) -> &AddonRegistry

获取注册中心引用（共享只读）

pub fn autoload(&self) -> &AddonAutoload

获取自动加载器引用

pub fn register(&self) -> Result<Vec<AddonLoaderError>, AddonLoaderError>

注册所有插件（对齐 PHP Service::register() 完整流程）

流程

1. 扫描 addons_path 下所有子目录（对齐 PHP scandir）
2. 对每个子目录解析 Plugin.php 清单（对齐 PHP autoload()）
3. 注册到 registry（对齐 PHP get_addons_instance 缓存）
4. 不加载钩子和服务绑定（Rust 侧无 PHP 反射能力，钩子由调用方显式注册）

错误处理

• 单个插件解析失败不会中断整体扫描
• 返回的 Vec<AddonLoaderError> 包含所有失败的插件错误
• 目录读取失败返回 ScanDir 错误

pub fn parse_route(&self, url: &str) -> Result<AddonRoute, AddonLoaderError>

解析路由（对齐 PHP Route::execute($addon, $controller, $action)）

错误

• RouteParse：URL 格式错误
• AddonNotFound：插件不存在
• AddonDisabled：插件已禁用
• ControllerNotFound：控制器不存在

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

获取所有已注册插件名（按字母序）

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

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

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

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

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

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

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

判断插件是否存在

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

判断插件是否启用

pub fn get_manifest( &self, name: &str, ) -> Result<AddonManifest, AddonLoaderError>

获取插件清单

pub fn count(&self) -> usize

获取已注册插件数量

pub fn resolve_class( &self, class: &str, ) -> Result<Option<PathBuf>, AddonLoaderError>

解析类名到文件路径（对齐 PHP spl_autoload_register 回调）

pub fn resolve_controller( &self, addon: &str, controller: &str, ) -> Result<Option<PathBuf>, AddonLoaderError>

解析控制器类名到文件路径（对齐 PHP get_addons_class + class_exists）

pub fn resolve_plugin( &self, addon: &str, ) -> Result<Option<PathBuf>, AddonLoaderError>

解析插件入口类到文件路径

Trait Implementations

impl Debug for AddonLoader

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

Formats the value using the given formatter.