Struct Env 

pub struct Env { /* private fields */ }

环境变量管理器 — 对齐 PHP think\facade\Env

通过 .env 文件加载配置，同时支持读取真实进程环境变量。

优先级

get() 查找顺序：

1. 真实进程环境变量 std::env::var(name)
2. 内部存储（.env 文件加载或 set() 写入的值）

线程安全

内部存储通过 Arc<RwLock<HashMap>> 保护，支持并发读、互斥写。 不调用 std::env::set_var，避免 Rust 2024 edition 的线程安全警告。

PHP 对齐

// PHP think\facade\Env
Env::load('.env');          // 加载 .env 文件
Env::set('APP_KEY', 'xxx'); // 设置内部变量
Env::get('APP_KEY');        // 获取（优先真实环境变量）
Env::has('APP_KEY');        // 检查存在

Implementations

impl Env

pub fn new() -> Env

创建空的 Env 实例

pub async fn load_from_file( &self, path: impl AsRef<Path>, ) -> Result<(), EnvError>

从 .env 文件加载配置

支持 INI 风格的 [section] 段，section 内的键会以 section.key 形式存储。

参数

• path: .env 文件路径

返回

成功返回 Ok(())，失败返回 EnvError。

PHP 对齐

Env::load('.env');

错误

• EnvError::FileRead: 文件读取失败
• EnvError::Parse: 文件解析失败（格式错误）

pub fn get(&self, name: &str) -> Option<String>

获取环境变量值

优先级

1. 真实进程环境变量 std::env::var(name)
2. 内部存储（.env 文件加载或 set() 写入的值）

参数

• name: 环境变量名（支持点分隔，如 database.hostname）

返回

存在返回 Some(value)，不存在返回 None。

PHP 对齐

Env::get('APP_KEY');  // 无默认值，不存在返回 null

pub fn get_with_default(&self, name: &str, default: &str) -> String

获取环境变量值，不存在时返回默认值

参数

• name: 环境变量名
• default: 默认值

返回

存在返回实际值，不存在返回 default。

PHP 对齐

Env::get('APP_DEBUG', false);  // 不存在时返回 false

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

检查环境变量是否存在

优先级

同 Env::get：真实进程环境变量优先于内部存储。

参数

• name: 环境变量名

返回

存在返回 true，否则返回 false。

PHP 对齐

Env::has('APP_KEY');

pub fn set(&self, name: &str, value: &str)

设置环境变量（仅写入内部存储）

注意

本方法不调用 std::env::set_var，仅修改内部 HashMap。 这样做的原因：

1. 避免 Rust 2024 edition 中 set_var 的线程安全警告
2. 对齐 PHP think\facade\Env::set() 的行为（仅修改内部数组，不调用 putenv()）

参数

• name: 环境变量名
• value: 环境变量值

PHP 对齐

Env::set('APP_KEY', 'base64:xxxxxx');

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

删除内部存储中的环境变量

注意

本方法仅删除内部存储中的值，不影响真实进程环境变量。

参数

• name: 环境变量名

返回

如果内部存储中存在该键并已删除，返回 true；否则返回 false。

pub fn all(&self) -> HashMap<String, String>

获取内部存储的所有键值对（快照）

注意

返回的是内部存储的副本，不包含真实进程环境变量。 主要用于调试和测试。

返回

所有内部存储键值对的 HashMap。

pub fn clear(&self)

清空内部存储

注意

仅清空内部存储，不影响真实进程环境变量。

Trait Implementations

impl Clone for Env

fn clone(&self) -> Env

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Env

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

Formats the value using the given formatter.

impl Default for Env

fn default() -> Env

Returns the “default value” for a type.