大网数据广告活动
PHP 语言与运行手册

Yaconf::get · 按名称读取一个配置值

· 52CE 我爱测

读取以 name 形式寻址,逐层定位嵌套的键:例如 "app" 中某个键的值。自 Yaconf 1.2.0 起,还支持 "users.database.master" 子目录下的 database.ini 文件中的键。 点号记法最多支持 64 层嵌套。

Yaconf::get

(PECL yaconf >= 1.0.0)

Yaconf::get — 按名称读取一个配置值

说明

public static function Yaconf::get(string $name, mixed $default = null): mixed

读取以 name 形式寻址,逐层定位嵌套的键:例如 "app" 中某个键的值。自 Yaconf 1.2.0 起,还支持 "users.database.master" 子目录下的 database.ini 文件中的键。 点号记法最多支持 64 层嵌套。

参数

name

要查找的配置名。使用点号记法逐层定位嵌套的键,例如 "app.name" "users.database.master"

default

当 name 时返回该值。未指定时返回 null。

返回值

当 name array;否则返回 default 参数,则返回 null)。

示例

下面的示例假定在 yaconf.directory 配置的目录中 放置了以下两个文件。

; app.ini
name="shop"                     ; scalar value
debug=0                         ; number
features[]="checkout"           ; array entries, both notations
features.1="wishlist"
; users/database.ini, in a sub-directory (Yaconf 1.2.0+)
master="192.168.0.10"
replica="192.168.0.20"

示例 #1 Yaconf::get() 示例

<?php
// 读取整个解析后的文件,返回数组
var_dump(Yaconf::get("app"));

// 点号记法逐层访问嵌套的键
var_dump(Yaconf::get("app.name"));           // string(4) "shop"
var_dump(Yaconf::get("app.features.1"));     // string(8) "wishlist"

// 1.2.0 起:子目录中的文件以目录名作为命名空间
var_dump(Yaconf::get("users.database.master")); // string(12) "192.168.0.10"

// 键不存在时返回默认值
var_dump(Yaconf::get("app.missing"));             // NULL
var_dump(Yaconf::get("app.missing", "fallback")); // string(8) "fallback"
?>

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。