Struct AddonAutoload 

pub struct AddonAutoload { /* private fields */ }

自动加载器 — 对齐 spl_autoload_register 插件自动加载器（对齐 PHP spl_autoload_register 回调）

设计

• 持有插件根目录（对齐 PHP app()->getRootPath() . 'addons/'）
• 提供 resolve(class) 方法：类名 → 文件路径（不实际加载文件）
• 支持 PSR-0 风格的下划线转目录分隔符

Implementations

impl AddonAutoload

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

创建自动加载器

• addons_path：插件根目录，对齐 PHP getAddonsPath() 返回的 {rootPath}/addons/

pub fn addons_path(&self) -> &Path

获取插件根目录

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

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

规则

1. 类名必须以 addons\ 开头（对齐 PHP strpos($class, $namespace) === 0）
2. 命名空间分隔符 \ 转换为目录分隔符 /（对齐 str_replace('\\', '/', ...)）
3. 类名中的下划线 _ 转换为目录分隔符（对齐 str_replace('_', '/', $class)）
4. 拼接 .php 后缀
5. 检查文件是否存在

参数

• class：完整类名（如 addons\operate\Plugin）

返回

• Ok(Some(path))：类映射到文件且文件存在
• Ok(None)：类名不属于 addons\ 命名空间，或文件不存在（让其他 autoloader 处理）
• Err(_)：路径解析失败

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

解析控制器类名（对齐 PHP get_addons_class($name, 'controller', $class)）

多级控制器点号分隔

对齐 PHP get_addons_class 中 . 处理：

if (strpos($class, '.') !== false) {
    $array = explode('.', $class);
    $class = array_pop($array);
    $class = Str::studly($class);
    $class = implode('\\', $array) . '\\' . $class;
}

示例

• resolve_controller("operate", "Order") → addons/operate/controller/Order.php
• resolve_controller("operate", "admin.Order") → addons/operate/controller/admin/Order.php
• resolve_controller("operate", "admin.sub.Order") → addons/operate/controller/admin/sub/Order.php

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

解析插件入口类（对齐 PHP get_addons_class($name) 默认 type=‘hook’）

示例

• resolve_plugin("operate") → addons/operate/Plugin.php

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

强制解析类名（对齐 PHP get_addons_class 返回字符串而非 bool）

与 resolve 的区别：不检查文件是否存在，直接返回路径

Trait Implementations

impl Clone for AddonAutoload

fn clone(&self) -> AddonAutoload

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AddonAutoload

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

Formats the value using the given formatter.

impl Eq for AddonAutoload

impl PartialEq for AddonAutoload

fn eq(&self, other: &AddonAutoload) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for AddonAutoload