Yaconf – 一个高性能的配置管理扩展

作者: Laruence( ) 本文地址: http://www.laruence.com/2015/06/12/3051.html 转载请注明出处

这个项目其实不是我新的idea, 这个是我在来微博以后, 第一个优化项目中顺手做的一个小工具, 本身叫做Weibo_Conf. 但是因为Weibo_Conf是属于Weibo扩展的, 里面还有一些其他功能是专门为Weibo定制的. 所以不适合直接开源.

随着PHP7的发布, 新增了很多持久化类型的支持比如IS_IMMUTABLE_ARRAY, 于是我就在PHP7下重新开发了Yaconf, 开源出来, 方便大家使用.

项目地址

代码已经提交到了Github: https://github.com/laruence/yaconf , 欢迎大家提交Issue

简介

首先说说, 这个是干啥的.

1. 我见过很多的项目中, 用PHP文件做配置的, 一个config目录下可能有十几个甚至数十个.php配置文件, 里面都是各种各样的array, 还有甚者会把一些词典文件(比如中文/英文对照)也放到配置中去. 这就导致配置文件的解析耗费了很大的性能(诚然, 用了opcache能好点, 但是实际上还是有执行的过程).

2. 除了PHP的, 还有用json的, yaml的, 一个共同的特点就是这些配置的可读性比较差. 另外, 他们也都要runtime解析.

3. config目录往往和代码在一起, 首先会有安全隐患(配置中往往有敏感信息), 其次如果配置和代码属于一个项目, 这就会导致配置的修改也要走代码上线的流程.

4. 一些资源配置文件, 比如mysql/memcache的配置信息, 这些内容本来是应该对开发透明的, 运维直接负责即可. 但是放到了代码中就会导致, 运维如果要发起一些变更, 也要开发配合修改配置文件上线.

所以, Yaconf就是为了解决这些问题而生的一个工具.

1. 它使用单独的一个配置目录(在yaconf.directory指定), 不和代码在一起.

2. 它在PHP启动的时候, 处理所有的要处理的配置, 然后这些配置就会常驻内存, 随着PHP的生命周期存亡. 避免了每次请求的时候解析配置文件.

3. 所有的配置内容都是immutable的, 这就可以借助于Fork的COW, 降低内存占用, 并且在访问配置的时候, 几乎不需要任何的内存Copy, 也不会有无谓的引用计数增减

4. 最重要的, 配置目录和代码分离以后, 可以借助一个配置管理后台, 来实现配置的统一化管理.

5. 它支持(对于非ZTS)配置变更重新加载, 也就是说配置如果有变化(建议更改配置一定使用mv, 不要使用cp), 它会reload, 不需要重启(检测的频率由yaconf.check_delay控制).

6. 它支持丰富的配置类型, 包括字符串, 数组, 分节, 分节继承, 并且还可以在配置中直接写PHP的常量和环境变量等.

7. 最重要的是, 它很简单.

API

Yaconf 只提供了俩个方法,

mixed Yaconf::get(string $name, mixed $default = NULL)

这个是获取一个配置, 名字是配置的名字, 一般来说如果你有一个ini文件叫做foo.ini, 那么$name使用foo的话就会获取到这个文件内的所有内容, 以数组形式返回. default是当配置不存在的时候返回的默认值.

bool Yaconf::has(string $name)

这个是检测一个配置是否存在.

Yaconf的配置项

yaconf.directory

配置文件目录, 这个配置不能通过ini_set指定, 因为必须在PHP启动的时候就确定好.

yaconf.check_delay

多久(秒)检测一次文件变动, 如果是0就是不检测, 也就是说如果是0的时候, 文件变更只能通过重启PHP重新加载

配置的格式

Yaconf采用ini文件作为配置文件, 这是因为我一直觉得ini是最适合做配置文件的, key-value格式, 清晰可读.

简单的配置写起来如下(以下全部假设ini文件的名字是test):

foo="bar"
phpversion=PHP_VERSION
env=${HOME}

如上所示, 对于一般的配置我们都用引号引起来. 而对于没有引起来的, 会尝试以PHP的常量做解释, 也就是说我们可以直接在配置里面写PHP的常量.

另外你也看到了, 我们可以直接在配置中写环境变量, 比如上面的env:

Yaconf::get("test.env"); //test是配置文件名字
//string(16) "/home/huixinchen"

如上面所示, 你可以看到, 假设对于foo的值, 你可以通过如下代码访问:

Yaconf::get("test.foo"); //test是配置文件名字

Yaconf也支持数组类型的配置, 写法如下:

arr[]=1
arr.1=2

如上面所示你可以直接使用foo[]这种形式来定义数组, 也可以使用arr.1, arr.2来指定key定义.

对于数组的第二个值, 你可以通过如下代码访问:

Yaconf::get("test.arr.1"); //test是配置文件名字

或者你可以通过获取整个arr数组之后访问:

$arr = Yaconf::get("test.arr"); //test是配置文件名字
echo $arr[1];

Yaconf也支持map类型的配置, 写法如下:

map.foo=bar
map.bar=foo

;你可以使用分号来写注释
map2.foo.name=yaconf
map2.foo.year=2015

对于map2的foo子map的name值可以通过如下形式访问:

Yaconf::get("test.map2.foo.name"); //test是配置文件名字

并且, 配置文件还可以分节, 和分节继承:

[parent]
parent="base"
children="NULL"

[children : parent]
children="children"

请注意配置的分节继承的语法 children:(冒号)parent, 这的意思是children节继承全部base的配置项. 然后你在children节里面定义的和parent节中同名的配置, 会覆盖掉parent中定义的内容.

对于chidlren节的children配置的值可以通过如下形式访问:

Yaconf::get("test.children.children"); //test是配置文件名字

样例

首先, 假设我们的所有的配置文件都放置在/tmp/yaconf中, 那么我们就需要在php.ini中增加如下配置:

yaconf.directory=/tmp/yaconf

这样yaconf在PHP启动的时候, 就会在这个目录下找所有的*.ini文件, 然后尝试处理他们. 这里要注意的是不支持多级目录, 也就是说, yaconf只会处理yaconf.directory内的*.ini文件, 不会处理子目录里面的(这主要是为了简单考虑, 因为有分节, 你就可以一个项目定义一个ini文件).

假设/tmp/yaconf下有俩个ini文件, 分别是:

foo.ini

name="yaconf"
year=2015
features[]="fast"
features.1="light"
features.plus="zero-copy"
features.constant=PHP_VERSION

bar.ini

[base]
parent="yaconf"
children="NULL"

[children:base]
children="set"

然后对于foo的内容:

php7 -r 'var_dump(Yaconf::get("foo"));'
/*
array(3) {
  ["name"]=>
  string(6) "yaconf"
  ["year"]=>
  string(4) "2015"
  ["features"]=>
  array(4) {
    [0]=>
    string(4) "fast"
    [1]=>
    string(5) "light"
    ["plus"]=>
    string(9) "zero-copy"
    ["constant"]=>
    string(9) "7.0.0-dev"
  }
}
*/

对于bar的内容:

php7 -r 'var_dump(Yaconf::get("bar"));'
/*
array(2) {
  ["base"]=>
  array(2) {
    ["parent"]=>
    string(6) "yaconf"
    ["children"]=>
    string(4) "NULL"
  }
  ["children"]=>
  array(2) {
    ["parent"]=>
    string(6) "yaconf"
    ["children"]=>
    string(3) "set"
  }
}
*/

当然你可以用 (.)链接语法精确访问任何一个特定的值.

最后

我的Ya系列扩展从此又多了一个新成员, 算上之前的Yaf(PHP框架), Yar(PHP RPC框架), Yac(PHP单机缓存), 大家就可以很容易搭建一套高性能的LAMP应用解决方案出来.

最后: Yaconf要求PHP7才能用, 而PHP7的alpha1版本今天已经发布了, 欢迎大家测试(关于alpha不alpha, 只要你的项目没有触发到有bug的地方, 那么对你来说就可以用, 不是么? ) :)

Comments

2015/06/12, hecha writes: 沙发。。。。。。2015/06/12, mlboy writes: 不错。太好了,唯一不足就是要用在php7。。2015/06/12, Lancer writes: 不错。太好了,唯一不足就是没有PHP5。2015/06/12, sada writes: 鸟哥这是逼着我们尽早升级到php72015/06/12, 摩西 writes: 看了下代码,每次yaconf实例化后检查上次检测配置时间和当前时间间隔,超过间隔再检查文件修改时间,判断是否重新加载配置。不错不错~ 赞赞赞 不过能出个兼容老版本php的就更好了~2015/06/12, 投河自尽的鱼 writes: 应该介绍下php7的扩展api2015/06/13, littlehz writes: 能不能和opcache一样,如果配置了 yaconf.check_delay = 0,不自动检测文件变更,但是可以有相应的API手动更新,比如 Yaconf::reload(),这样提高生产环境的性能,并且只在发布代码/运维需要的时候变更配置。2015/06/17, Laruence writes: @littlehz 这个不行, 因为yaconf不是基于共享内存的, 所以如果你调用invalid, 只是invalid了当前进程的部分...2015/06/26, Mr.Cong writes: 感觉很好用,但是好像也有一个问题,就是每次修改完配置文件后,修需要重启apache,才能重新加载PHP2015/07/06, Anonymous writes: 112015/07/06, Anonymous writes: ty2015/07/06, Anonymous writes: rwer2015/07/31, 逍遥 writes: 这个不错,不看这文章以前还没发现。2015/08/25, qmore writes: 菜鸟一枚,来围观,看来必须学c哈。。。2015/09/03, Anonymous writes: 配置文件分开固然很好,但是不是多了一份维护的成本呢? 如果是根据环境变量区分的不同环境的变量,这个扩展可以加以区分的加载不?2015/09/07, newbmiao writes: 这个和yaf里的配置设计相似啊,直接用yaf多方便2015/09/25, alewater writes: 请问鸟哥,我在php7.0.0RC3下把check_delay设为0,然后启动php-fpm,页面代码就是var_dump,然后我修改了配置文件内容,为什么再刷新页面,内容就变化了呢,按理说check_delay为0应该不检查更新吧,不知道是不是我哪里的理解有偏差。2015/10/10, jetking writes: 看上去很不错的东东,唯一遗憾的是公司服务器仍然使用的是5.6系列,而且近期不能升级到PHP 7 -_-!2015/10/22, 燕睿涛 writes: 这个不错,应该挺实用的2015/12/21, Novopo writes: 在php7.0.1上已经测试过,非常好用。2016/05/30, Young writes: 感觉像可配版的auto_prepend_file功能2016/06/20, 汽车门窗密封条 writes: 感觉很好用,谢谢分享,对我们学习PHP知识有很大的帮助。楼主好样的2016/06/24, 蛋疼 writes: 我测试在FPM模式好使,配置确实会自动加载更新,但是在删除配置文件时有问题,比如我原本有一个配置文件foo.ini。 在phpinfo的parsed filename中可以看到foo.ini这个文件,但是如果我执行mv foo.ini foo2.ini后,就会出现问题,parsed filename中有时只有foo2.ini一个文件,有时foo.ini foo2.ini同时存在,重启FPM才能恢复正常。不过实际很少会删除配置文件,问题不大。 而且在CLI模式是不是不能自动更新配置啊。2016/07/24, 许文强 writes: 现在php的主流还是5.+系列,7还是使用的比较少。觉得这个不错,但是项目本身是php5的,就有点遗憾2016/08/09, エルメス メドール 安い writes: 口コミで高評価!業界最高級品質のスーパーコピーブランド激安通販専門店!スーパーコピーのブランド時計などブランドコピー品買取やブランドバッグ、ブランド財布の格安販売!まずはお気軽にお問い合わせください。信用第一、送料無料。スーパーコピーブランドなら当店で!スーパーコピー時計などブランドコピー品買取や ブランドバッグ、ブランド財布を低価でお客様に提供します。偽物ブランドと言っても なんと本物と見分けがつかないぐらい!まずはお気軽にお問い合わせください。ネットワークの時代の中の極めて優秀な人、ブランドコピー、スーパーコピーブランドN品 超人気専門サイト問屋 !!精巧に作られたブランドコピーバッグ当サイト販売したブランド コピーなので正規品と同等品質提供した格安で完璧な品質のをご承諾します、2016ー2016の新素材-新作!人気 スーパーコピーブランド,スーパーコピー時計,スーパーコピー激安販売,ブランドスーパーコピー専門! エルメス メドール 安い http://www.ooowatch.com/tokei/fm/index_10.html2016/08/27, ian writes: 你这框架封装的太深了,我在入口做POST,GET什么脏词过滤,最后用_request拿出来,什么都没过滤掉。 都不知道要在哪里改,总不能一个个单独过滤。提倡人性封装。2017/09/04, kaysen writes: 使用PHP内置函数auto_prepend_file()就可以2017/12/07, 鳄鱼皮鞋定做 writes: 不错不错~ 赞赞赞,唯一不足就是要用在php72017/12/11, jackZer writes: There's certainly a great deal to know about this issue. I like all of the points you have made.Copyright © 2010 风雪之隅 版权所有, 转载务必注明. 该Feed只供个人使用, 禁止未注明的转载或商业应用. 非法应用的, 一切法律后果自负. 如有问题, 可发E-mail至my at laruence.com.(Digital Fingerprint: 73540ba0a1738d7d07d4b6038d5615e2)

Related Posts:

Weibo LAMP演变 – 6月在上海分享的PPTPHP的性能演进(从PHP5.0到PHP7.1的性能全评测)让PHP7达到最高性能的几个Tips让你的PHP7更快(GCC PGO)在Qcon 2015 北京上的演讲PPT – PHP7PHP7 VS HHVM (Wordpress)Yac (Yet Another Cache) – 无锁共享内存CacheYaf and Phalcon, which is faster?Yar – 并行的RPC框架(Concurrent RPC framework)关于Yaf的一些说明

文章来源:

Author:Laruence
link:http://www.laruence.com/2015/06/12/3051.html