DISCUZX2.5/X3/X3.1擴(kuò)展框架DXEXTEND1.3.0版本發(fā)布[9.25升級(jí)X31重要]

dashen

9.25 升級(jí)3.1提示：論壇2.5/3.0版本已經(jīng)安裝了框架的升級(jí)到最新版3.1的，請(qǐng)下載覆蓋最新包并手動(dòng)刪除extend/class/class_cloud_ext.php文件

8.9更新到1.3.0beta
1，新增EXTEND_NO_DETECT常量，默認(rèn)為false，會(huì)自動(dòng)檢測(cè)框架源文件更新情況。當(dāng)更新各擴(kuò)展的時(shí)候不需要再刪除緩存文件。當(dāng)功能穩(wěn)定而不需要更新擴(kuò)展的時(shí)候可以設(shè)置成true。

7.19更新到1.2.2beta
1，修復(fù)自定義常量失效

7.18更新到新版1.2beta
1，修復(fù)支持discuz_application類擴(kuò)展

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

7.16更新到版本1.1.1beta：
1，新增開關(guān)常量，在config文件里寫$_config['extend']['innodb']['on'] = 1;用來代表開關(guān)，在系統(tǒng)中生成INNODB常量值為1.
2，新增文件依賴，即使啟用緩存了也會(huì)優(yōu)先保證extend文件夾的ext類存在才會(huì)執(zhí)行。
3，新增云上報(bào)的類在extend文件夾里的映射，對(duì)應(yīng)關(guān)系為：api/manyou 對(duì)應(yīng) extend/class/api/manyou




現(xiàn)有的插件機(jī)制是一種HOOK鉤子機(jī)制，可以大致理解成是一種半路攔截的機(jī)制，在核心類實(shí)例化后運(yùn)行runhooks(),在編譯好的模板頂端運(yùn)行hookscriptoutput()。這種方法雖然好用，但是當(dāng)我們想修改一些核心類庫的時(shí)候，就不是那么方便了。
比如當(dāng)我們需要在table_forum_post類的fetch_all_prune_by_search方法里增加一個(gè)參數(shù),讓里面的搜索由sphinx來完成(舉個(gè)例子，可行性暫不說)。
或者我們覺得mysql用來做計(jì)數(shù)不方便，要改用redis來統(tǒng)計(jì)的時(shí)候，我們不得不修改源碼，其他似乎找不到可以不改源碼的方法。
又比如我們論壇使用了云主機(jī)，不允許本地IO，我們需要把所有的附件傳到另外一個(gè)提供了上傳API的云服務(wù)器，我們還是不得不修改底層的upload類或者使用效率低下的FTP遠(yuǎn)程附件。


那么有沒有不修改源碼就能實(shí)現(xiàn)所有類擴(kuò)展的方法呢？我們最近在進(jìn)行一系列論壇優(yōu)化方案的時(shí)候就遇到了這個(gè)問題，比如INNODB，redis分頁，計(jì)劃任務(wù)分離等都需要修改底層的類來實(shí)現(xiàn)。所以我們推出了適應(yīng)于X25/X3的擴(kuò)展框架。


擴(kuò)展框架的目標(biāo)：
我們可以在不修改任何源碼的情況下，修改、新增source/class目錄下所有的類文件。


擴(kuò)展框架的原理：
我們通過修改論壇的自動(dòng)加載機(jī)制，讓他優(yōu)先加載我們的擴(kuò)展類，而擴(kuò)展類均繼承了需要擴(kuò)展的父類。


安裝和使用方法：
1，下載對(duì)應(yīng)的文件包，覆蓋到根目錄，其實(shí)只修改了一個(gè)文件：class_core.php，我們?cè)诶锩嫘薷牧俗詣?dòng)加載機(jī)制。
2，在論壇下建立新的文件夾extend/class，而這個(gè)class里面的目錄和文件列表均和source/class下的保持一致。
3，比如我們需要修改source/class/discuz/discuz_upload.php里面的類，把它的save，makedir等方法修改，則只需要在extend/class下建立一個(gè)discuz文件夾，再建立一個(gè)名為discuz_upload_ext.php的文件，這個(gè)表示這個(gè)類是擴(kuò)展的。
4，在discuz_upload_ext.php文件里，我們對(duì)類discuz_upload進(jìn)行修改，則只需要寫一個(gè)類繼承discuz_upload類。示例如下：

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

復(fù)制代碼

這樣你寫的save方法就替代了論壇所有調(diào)用discuz_upload->save()的地方了，是不是很方便呢？
5，又比如，我們準(zhǔn)備對(duì)table文件夾下的某個(gè)數(shù)據(jù)庫操作的方法進(jìn)行重寫，類似，在extend/class下建立table文件夾，在里面建立比如table_forum_post_ext.php文件，然后寫一個(gè)子類，class table_forum_post_ext extends table_forum_post{}，在里面可以新增或者對(duì)已有的方法進(jìn)行重載，這個(gè)會(huì)讓整個(gè)論壇所有調(diào)用此方法都使用你修改后的方法。

文件目錄列表：

注意事項(xiàng)：
1，關(guān)于子類的命名請(qǐng)嚴(yán)格按照上面說的方式來命名，否則不會(huì)被讀取。
2，寫代碼時(shí)請(qǐng)盡量按照discuz的書寫格式來寫，比如不要使用短標(biāo)簽等。
3，在class_core定義了一個(gè)EXTEND_NO_CACHE常量，當(dāng)生成緩存出現(xiàn)問題時(shí)可以打開強(qiáng)制更新緩存，當(dāng)代碼測(cè)試無誤后請(qǐng)修改為false。新增EXTEND_NO_DETECT常量，可以自動(dòng)檢測(cè)擴(kuò)展源文件變動(dòng)而自動(dòng)更新緩存，默認(rèn)為false，即此功能生效。當(dāng)功能趨于穩(wěn)定后可以考慮設(shè)為true。
4，該框架可以實(shí)現(xiàn)source/class目錄下所有類的重寫，但是class_core文件里的除外，因?yàn)槲覀円呀?jīng)修改了。
5，由于歷史原因，class目錄下的類的構(gòu)造函數(shù)有些是與類名相同，有些使用了__construct,子類如果需要調(diào)用父類的構(gòu)造函數(shù)統(tǒng)一寫成parent::__contruct()
6，由于歷史原因，有些文件里有兩個(gè)或多個(gè)類，我們也可以對(duì)其中的一個(gè)或者多個(gè)進(jìn)行繼承，方法如上面所述。

7，部分類使用了instance方法把實(shí)例保存到靜態(tài)變量中來避免重復(fù)實(shí)例化，遇到這種類子類也應(yīng)當(dāng)存在此方法，否則實(shí)例化的是父類而導(dǎo)致子類中的方法均不生效。
8，其他插件更新的時(shí)候在1.3.0beta版本以下的必須要去data/sysdata文件夾下刪除所有_ext結(jié)尾的文件，以便新插件生效

歡迎各位開發(fā)者試用，發(fā)現(xiàn)問題或者有更好的想法歡迎留言。
今后我們的各種性能擴(kuò)展也基本會(huì)在此框架下運(yùn)行。

X3.1
upload_extend1.3.0_x3.1.zip (3.45 KB, 下載次數(shù): 217)

2022-4-20 15:10 上傳

點(diǎn)擊文件名下載附件

X3：
upload_extend1.3.0_x3.zip (4.6 KB, 下載次數(shù): 173)

2022-4-20 15:10 上傳

點(diǎn)擊文件名下載附件

X25
upload_extend1.3.0_x25.zip (4.06 KB, 下載次數(shù): 174)

2022-4-20 15:10 上傳

點(diǎn)擊文件名下載附件

無編碼版本區(qū)別，選擇相應(yīng)版本就行。
已經(jīng)通過本框架完成的擴(kuò)展列表：
DISCUZX3/X25論壇云上報(bào)/計(jì)劃任務(wù)異步機(jī)制方案1.0beta
discuz-redis 擴(kuò)展 輕松快速分頁 避免分頁瓶頸
Discuz! X2.5 / X3 InnoDB 補(bǔ)丁
DISCUZX2.5/X3帖子點(diǎn)擊數(shù)緩存即時(shí)更新
DISCUZX2.5/3云存儲(chǔ)通用接口
DISCUZ X2.5/X3/X3.1 SESSION機(jī)制優(yōu)化擴(kuò)展 1.0.1beta版


關(guān)于bin目錄駐守進(jìn)程腳本的開機(jī)啟動(dòng)配置
在擴(kuò)展中我們有些腳本是需要一直在后臺(tái)不間斷運(yùn)行的，比如session機(jī)制統(tǒng)計(jì)腳本，云上報(bào)異步腳本。
為了避免重啟時(shí)任務(wù)丟失，我們需要在開機(jī)啟動(dòng)里加上這個(gè)腳本，大家可以參考如下設(shè)置。
1，進(jìn)入/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 &

復(fù)制代碼

大家記得把路徑替換成自己網(wǎng)站的，php命令也得替換成自己的
3，云上報(bào)異步設(shè)置開機(jī)啟動(dòng)可能會(huì)出錯(cuò)，提示random函數(shù)不存在，這時(shí)需要在bin_async_cron.php中加入function_core文件中的random函數(shù)即可。

4，最后記得給bin目錄設(shè)置700權(quán)限

hello1069

3.5版本的是不是同樣有效？？？？？？？？？？？？？？？？？？？？？？？？？

hello1069

為什么還沒有x3.5的？？？