DISCUZX2.5/X3/X3.1扩展框架DXEXTEND1.3.0版本发布[9.25升级X31重要提示]

浪子追风

9.25 升级3.1提示：论坛2.5/3.0版本已经安装了框架的升级到最新版3.1的，请下载覆盖最新包并手动删除extend/class/class_cloud_ext.php文件

8.9更新到1.3.0beta
1，新增EXTEND_NO_DETECT常量，默认为false，会自动检测框架源文件更新情况。当更新各扩展的时候不需要再删除缓存文件。当功能稳定而不需要更新扩展的时候可以设置成true。

7.19更新到1.2.2beta
1，修复自定义常量失效

7.18更新到新版1.2beta
1，修复支持discuz_application类扩展

7.17更新到版本1.1.2beta
1，类名方法名大小写不敏感

7.16更新到版本1.1.1beta：
1，新增开关常量，在config文件里写$_config['extend']['innodb']['on'] = 1;用来代表开关，在系统中生成INNODB常量值为1.
2，新增文件依赖，即使启用缓存了也会优先保证extend文件夹的ext类存在才会执行。
3，新增云上报的类在extend文件夹里的映射，对应关系为：api/manyou 对应 extend/class/api/manyou




现有的插件机制是一种HOOK钩子机制，可以大致理解成是一种半路拦截的机制，在核心类实例化后运行runhooks(),在编译好的模板顶端运行hookscriptoutput()。这种方法虽然好用，但是当我们想修改一些核心类库的时候，就不是那么方便了。
比如当我们需要在table_forum_post类的fetch_all_prune_by_search方法里增加一个参数,让里面的搜索由sphinx来完成(举个例子，可行性暂不说)。
或者我们觉得mysql用来做计数不方便，要改用redis来统计的时候，我们不得不修改源码，其他似乎找不到可以不改源码的方法。
又比如我们论坛使用了云主机，不允许本地IO，我们需要把所有的附件传到另外一个提供了上传API的云服务器，我们还是不得不修改底层的upload类或者使用效率低下的FTP远程附件。


那么有没有不修改源码就能实现所有类扩展的方法呢？我们最近在进行一系列论坛优化方案的时候就遇到了这个问题，比如INNODB，redis分页，计划任务分离等都需要修改底层的类来实现。所以我们推出了适应于X25/X3的扩展框架。


扩展框架的目标：
我们可以在不修改任何源码的情况下，修改、新增source/class目录下所有的类文件。


扩展框架的原理：
我们通过修改论坛的自动加载机制，让他优先加载我们的扩展类，而扩展类均继承了需要扩展的父类。


安装和使用方法：
1，下载对应的文件包，覆盖到根目录，其实只修改了一个文件：class_core.php，我们在里面修改了自动加载机制。
2，在论坛下建立新的文件夹extend/class，而这个class里面的目录和文件列表均和source/class下的保持一致。
3，比如我们需要修改source/class/discuz/discuz_upload.php里面的类，把它的save，makedir等方法修改，则只需要在extend/class下建立一个discuz文件夹，再建立一个名为discuz_upload_ext.php的文件，这个表示这个类是扩展的。
4，在discuz_upload_ext.php文件里，我们对类discuz_upload进行修改，则只需要写一个类继承discuz_upload类。示例如下：

1. <?php
   
2. 
   
3. class discuz_upload_ext extends discuz_upload {
   
4.         function save(){......}
   
5. }

复制代码

这样你写的save方法就替代了论坛所有调用discuz_upload->save()的地方了，是不是很方便呢？
5，又比如，我们准备对table文件夹下的某个数据库操作的方法进行重写，类似，在extend/class下建立table文件夹，在里面建立比如table_forum_post_ext.php文件，然后写一个子类，class table_forum_post_ext extends table_forum_post{}，在里面可以新增或者对已有的方法进行重载，这个会让整个论坛所有调用此方法都使用你修改后的方法。

文件目录列表：

注意事项：
1，关于子类的命名请严格按照上面说的方式来命名，否则不会被读取。
2，写代码时请尽量按照discuz的书写格式来写，比如不要使用短标签等。
3，在class_core定义了一个EXTEND_NO_CACHE常量，当生成缓存出现问题时可以打开强制更新缓存，当代码测试无误后请修改为false。新增EXTEND_NO_DETECT常量，可以自动检测扩展源文件变动而自动更新缓存，默认为false，即此功能生效。当功能趋于稳定后可以考虑设为true。
4，该框架可以实现source/class目录下所有类的重写，但是class_core文件里的除外，因为我们已经修改了。
5，由于历史原因，class目录下的类的构造函数有些是与类名相同，有些使用了__construct,子类如果需要调用父类的构造函数统一写成parent::__contruct()
6，由于历史原因，有些文件里有两个或多个类，我们也可以对其中的一个或者多个进行继承，方法如上面所述。

7，部分类使用了instance方法把实例保存到静态变量中来避免重复实例化，遇到这种类子类也应当存在此方法，否则实例化的是父类而导致子类中的方法均不生效。
8，其他插件更新的时候在1.3.0beta版本以下的必须要去data/sysdata文件夹下删除所有_ext结尾的文件，以便新插件生效

欢迎各位开发者试用，发现问题或者有更好的想法欢迎留言。
今后我们的各种性能扩展也基本会在此框架下运行。

X3.1



X3.0



X2.5




无编码版本区别，选择相应版本就行。

关于bin目录驻守进程脚本的开机启动配置
在扩展中我们有些脚本是需要一直在后台不间断运行的，比如session机制统计脚本，云上报异步脚本。
为了避免重启时任务丢失，我们需要在开机启动里加上这个脚本，大家可以参考如下设置。
1，进入/ect/rc.local
2，添加如下代码在最后：

1. cd /data/wwwroot/html/x3/extend/bin
   
2. nohup /usr/bin/php bin_session_cron.php > /data/wwwroot/html/x3/extend/bin/sessionlog 2> /data/wwwroot/html/x3/extend/bin/sessionlog2 &
   
3. nohup /usr/bin/php bin_async_cron.php > /data/wwwroot/html/x3/extend/bin/asynclog 2> /data/wwwroot/html/x3/extend/bin/asynclog2 &

复制代码

大家记得把路径替换成自己网站的，php命令也得替换成自己的
3，云上报异步设置开机启动可能会出错，提示random函数不存在，这时需要在bin_async_cron.php中加入function_core文件中的random函数即可。

4，最后记得给bin目录设置700权限