steady-as-hill/sooh-ini
Composer 安装命令:
composer require steady-as-hill/sooh-ini
包简介
ini manage
关键字:
README 文档
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()获 得的就是这个新的“其他实例”了
配置节点的名字里如果有".",那么只能获取到上一级,之后的节点会取不到。
steady-as-hill/sooh-ini 适用场景与选型建议
steady-as-hill/sooh-ini 是一款 基于 PHP 开发的 Composer 扩展包,目前已累计 25 次下载、GitHub Stars 达 0, 最近一次更新时间为 2018 年 06 月 27 日, 在 PHP 生态内属于活跃度较高的组件。
它主要适用于以下技术方向: 「ini」 等业务场景。在实际项目中,围绕这些方向常见需要落地的问题包括:接口对接、性能调优、并发安全、与既有框架(Laravel / ThinkPHP / Yii / Webman 等)的兼容适配,以及生产环境的日志埋点与稳定性保障。
我们在过去多个企业项目中使用过 steady-as-hill/sooh-ini 或与其功能相近的方案,如果你在选型或落地过程中遇到问题,例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查,欢迎联系我们协助评估。
基于 steady-as-hill/sooh-ini 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复;针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维;也可按月提供技术保姆服务。
与 steady-as-hill/sooh-ini 相关的其它包
同方向 / 同关键字的高下载量 PHP Composer 包推荐,方便对比选型:
Framework Agnostic Configuration Library
A Zend Framework module to quickly and easily set PHP settings.
The slick/configuration component provides an easy-to-use solution for managing configuration files in your PHP applications.
Load configuration files the easy way. This configuration loader supports PHP, INI, JSON, XML, YAML and NEON file extensions.
A flexible configuration file loader that supports multiple file formats
Configuration classes (currently supports PHP, INI, XML and JSON configs), part of QuEasy PHP Framework
统计信息
- 总下载量: 25
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 0
- 点击次数: 5
- 依赖项目数: 1
- 推荐数: 0
其他信息
- 授权协议: MIT
- 更新时间: 2018-06-27