Struct App 

pub struct App { /* private fields */ }

App 容器（全局单例）

持有应用配置、各子系统单例和 DI 服务容器。通过 App::global() 获取全局实例， 通过 App::init() 初始化。

Implementations

impl App

pub fn new(config: AppConfig) -> App

构造 App 实例（不注册到全局单例）

用于测试或显式持有实例的场景。生产代码应使用 App::init() 注册全局单例。

pub fn init(config: AppConfig) -> &'static App

初始化全局 App 容器

只能调用一次，重复调用返回已有实例。

use sz_rust_core::container::App;
use sz_rust_core::config::AppConfig;

let config = AppConfig::load_from_dir("config").unwrap();
let app = App::init(config);

pub fn global() -> Option<&'static App>

获取全局 App 容器实例

必须先调用 App::init() 初始化，否则返回 None。

命名说明

此方法对应 PHP app() helper（获取全局容器实例）。 不使用 App::instance() 是为了避免与 App::instance<T>（绑定实例方法， 对齐 PHP app()->instance('key', $obj)）冲突。

pub fn config(&self) -> &AppConfig

获取应用配置

pub fn db_connection(&self, name: &str) -> Option<&DatabaseConnection>

获取数据库连接配置

对齐 PHP Db::connect('mysql')。

当前返回 DatabaseConnection 配置。 后续将替换为 SZ-ORM Pool 实例。

pub fn db_connection_names(&self) -> Vec<&str>

获取所有数据库连接名称

pub fn default_db_connection(&self) -> Option<&DatabaseConnection>

获取默认数据库连接配置

pub fn set_cache(&self, cache: impl Into<String>)

设置 Cache 单例（将替换为真正的 Cache facade）

pub fn cache(&self) -> Option<String>

获取 Cache 单例

pub fn set_log(&self, log: impl Into<String>)

设置 Log 单例（将替换为真正的日志系统）

pub fn log(&self) -> Option<String>

获取 Log 单例

pub fn container(&self) -> &Container

获取 DI 服务容器引用

pub fn bind<T, F>(&self, factory: F)

where T: Send + Sync + 'static, F: Fn() -> T + Send + Sync + 'static,

注册瞬态服务

对齐 PHP app()->bind('key', fn() => new Service())。

pub fn singleton<T, F>(&self, factory: F)

where T: Send + Sync + 'static, F: Fn() -> T + Send + Sync + 'static,

注册单例服务

对齐 PHP app()->singleton('key', fn() => new Service())。

pub fn scoped<T, F>(&self, factory: F)

where T: Send + Sync + 'static, F: Fn() -> T + Send + Sync + 'static,

注册请求作用域服务

对齐 PHP app()->scoped('key', fn() => new Service())。

pub fn instance<T>(&self, instance: T)

where T: Send + Sync + 'static,

直接绑定已创建的实例

对齐 PHP app()->instance('key', $obj)。

pub fn alias<T: 'static>(&self, name: impl Into<String>)

为服务类型注册字符串别名

对齐 PHP app()->alias('name', Service::class)。

pub fn make<T: Send + Sync + 'static>(&self) -> Option<Arc<T>>

解析服务实例（自动感知请求作用域）

对齐 PHP app()->make('key')。

P1-ARCH-DI-02：若当前线程处于 RequestScopeLayer 管理的请求中（即 current_scope_id() 返回 Some），则自动路由到 make_with_scope，使 Scoped 绑定在请求内缓存、请求结束清理。 请求外调用则退化为无作用域的 make（向后兼容）。

pub fn make_with_scope<T: Send + Sync + 'static>( &self, scope_id: ScopeId, ) -> Option<Arc<T>>

解析服务实例（带作用域 ID）

对齐 PHP app()->make('key') + 请求作用域支持。

pub fn clear_scope(&self, scope_id: ScopeId)

清理指定作用域的所有缓存实例

pub fn has_service<T: 'static>(&self) -> bool

检查服务是否已注册

Trait Implementations

impl Debug for App

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

Formats the value using the given formatter.