steady-as-hill / sooh-ini
ini管理
This package is not auto-updated.
Last update: 2024-09-20 09:38:49 UTC
README
配置分情况统一管理的封装类。设计目的是解决以下两点:
- 简化并统一获取配置的方式(例如,如果尚未加载配置,则自动加载配置)
- 支持多种配置格式,如PHP、INI,单一大文件或拆分的多个小文件
配置通常是多级的,例如数据库配置
{
DB: {
mysqlAtServer1:{
server: "1.2.3.4",
user: "root"
pass: "123456"
}
},
Session: {
....
}
}
在这种情况下,可以通过 ini::getInstance()->getIni('DB.mysqlAtServer1.server') 获取 "1.2.3.4"
也可以通过 ini::getInstance()->getIni('DB.mysqlAtServer1') 获取 {server:"1.2.3.4",user:"root",pass:"123456"}
配置支持几种写法,请参考:Ini文件格式
基本使用
1)初始化构建ini实例(以目录模式为例):
\Sooh\Ini::getInstance()->initLoader(new \Sooh\IniClasses\Files("/root/SingleService/_config"));
如果是swoole这种,两个请求之间不会彻底释放的,需要在处理controller的action之前,ini->runtime->free();
2)基本使用
\Sooh\Ini::getInstance()->getIni("Email.server");
\Sooh\Ini::getInstance()->getRuntime("some.runtime.var");
\Sooh\Ini::getInstance()->setRuntime("some.runtime.var",mixed);
关于配置的说明
配置按存储位置分为本地和远程;按类型基本可以分为模块配置和资源配置;按作用域可以分为静态配置、运行时的动态配置以及外部配置(可跨进程的动态配置)
Ini提供了三个public的属性应对上述情况:
- statics 静态配置,这里主要存储系统初始化参数,一般不应该在运行时更改(并发覆盖啥的要自行考虑清除)
- runtime 运行时,主要是当前进程处理中用的,每个请求之初应该清空,当框架不会自动释放时(比如swoole里处理任务的函数之前生成的实例),请在收到请求之初执行 ini->onNewRequest()
- permanent 永久的(比如redis),可跨进程间共享的,不是必须的,下一版本准备提供一个redis的
针对statics,分别提供了\Sooh\IniClasses\Files 和 \Sooh\IniClasses\Url 两个获取配置的驱动
permanent 一般是自行定制的
详细使用和限制
注意:由于在定位配置时使用了“.”,所以配置的键值部分不能有“.”!!!
详细用法请参考 Ini设计和使用
另外,当凑数也罢,这里增加了shutdown管理的相关方法,使用时要自行配套使用:
function registerShutdown($func,$identifier)
注册一个shutdown方法,当onShutdown时执行。($identifier 是标识, 如果执行时抛出异常了,error_log的时候会给出这个identifier)
public function onShutdown()
系统执行结束后的清理,需根据运行环境框架自行选择调用位置触发执行
您也可以使用自己的Ini类替换使用:
通过 \Sooh\Ini::getInstance(其他实例) 设置一下,之后 \Sooh\Ini::getInstance() 获得的就是这个新的“其他实例”了
配置节点的名字里如果有".",那么只能获取到上一级,之后的节点会取不到。