steady-as-hill/sooh-ini

ini manage

配置管理类

配置分情况统一管理的封装类。设计目的是解决两点：, _(*1)

1. 简化和统一获取配置的方式（比如获取时如果尚未加载就自动加载配置）
2. 支持多种配置格式，php的,ini的，单一大文件或拆开的多个小文件

配置一般是多级的，比如数据库配置, _(*2)

    {
        DB: {
            mysqlAtServer1:{
                server: "1.2.3.4",
                user: "root"
                pass: "123456"
            }
        },
        Session: {
            ....
        }
    }

这种情况下，可以通过 ini::getInstance()->getIni('DB.mysqlAtServer1.server')得到"1.2.3.4", _(*3)

也可以通过 ini::getInstance()->getIni('DB.mysqlAtServer1')得到 {server:"1.2.3.4",user:"root",pass:"123456"}, _(*4)

配置支持几种写法，参看：Ini文件格式, _(*5)

基本使用

1） 初始化构建ini实例(以目录模式为例)：, _(*6)

\Sooh\Ini::getInstance()->initLoader(new \Sooh\IniClasses\Files("/root/SingleService/_config"));, _(*7)

如果是swoole这种，两个请求之间不会彻底释放的，需要在处理controller的action之前，ini->runtime->free();, _(*8)

2） 基本使用, _(*9)

    \Sooh\Ini::getInstance()->getIni("Email.server");
    \Sooh\Ini::getInstance()->getRuntime("some.runtime.var");
    \Sooh\Ini::getInstance()->setRuntime("some.runtime.var",mixed);

关于配置的说明

配置按存储位置分为本地和远程；按类型基本可以分为模块配置和资源配置；按作用域可以分为静态配置、运行时的动态配置以及外部配置（可跨越进程的动态配置）, _(*10)

Ini提供了三个public的属性应对上述情况：, _(*11)

• statics 静态配置，这里主要存储系统初始化参数，一般不应该在运行时更改（并发覆盖啥的要自行考虑清除）
• runtime 运行时，主要是当前进程处理中用的，每个请求之初应该清空，当框架不会自动释放时(比如swoole里处理任务的函数之前生成的实例)，请在收到请求之初执行 ini->onNewRequest()
• permanent 永久的（比如redis），可跨进程间共享的，不是必须的，下一版本准备提供一个redis的

针对statics，分别提供了\Sooh\IniClasses\Files 和 \Sooh\IniClasses\Url 两个获取配置的驱动, _(*12)

permanent 一般是自行定制的, _(*13)

详细使用和限制

注意：由于在定位配置的时候使用了“.”，所以配置的键值部分不能有“.”!!!, _(*14)

详细用法参看 Ini设计和使用, _(*15)

另外，当凑数也罢，这里增加了shutdown管理的相关方法，使用时要自行配套使用：, _(*16)

function registerShutdown($func,$identifier), _(*17)

注册一个shutdown方法，当onShutdown的时候执行。（$identifier 是标识， 如果执行时抛出异常了，error_log的时候会给出这个identifier）, _(*18)

public function onShutdown(), _(*19)

系统执行结束后的清理，需根据运行环境框架自行选择调用位置触发执行, _(*20)

您也可以使用自己的Ini类替换使用：, _(*21)

通过 \Sooh\Ini::getInstance(其他实例) 设置一下，之后 \Sooh\Ini::getInstance()获 得的就是这个新的“其他实例”了, _(*22)

配置节点的名字里如果有"."，那么只能获取到上一级，之后的节点会取不到。, _(*23)