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

dashen

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

8.9更新到1.3.0beta
1，新增EXTEND_NO_DETECT常量，默認(rèn)為false，會自動檢測框架源文件更新情況。當(dāng)更新各擴(kuò)展的時候不需要再刪除緩存文件。當(dāng)功能穩(wěn)定而不需要更新擴(kuò)展的時候可以設(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，新增文件依賴，即使啟用緩存了也會優(yōu)先保證extend文件夾的ext類存在才會執(zhí)行。
3，新增云上報的類在extend文件夾里的映射，對應(yīng)關(guān)系為：api/manyou 對應(yīng) extend/class/api/manyou




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


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


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


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


安裝和使用方法：
1，下載對應(yīng)的文件包，覆蓋到根目錄，其實(shí)只修改了一個文件：class_core.php，我們在里面修改了自動加載機(jī)制。
2，在論壇下建立新的文件夾extend/class，而這個class里面的目錄和文件列表均和source/class下的保持一致。
3，比如我們需要修改source/class/discuz/discuz_upload.php里面的類，把它的save，makedir等方法修改，則只需要在extend/class下建立一個discuz文件夾，再建立一個名為discuz_upload_ext.php的文件，這個表示這個類是擴(kuò)展的。
4，在discuz_upload_ext.php文件里，我們對類discuz_upload進(jìn)行修改，則只需要寫一個類繼承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)備對table文件夾下的某個數(shù)據(jù)庫操作的方法進(jìn)行重寫，類似，在extend/class下建立table文件夾，在里面建立比如table_forum_post_ext.php文件，然后寫一個子類，class table_forum_post_ext extends table_forum_post{}，在里面可以新增或者對已有的方法進(jìn)行重載，這個會讓整個論壇所有調(diào)用此方法都使用你修改后的方法。

文件目錄列表：

登錄/注冊后可看大圖

注意事項(xiàng)：
1，關(guān)于子類的命名請嚴(yán)格按照上面說的方式來命名，否則不會被讀取。
2，寫代碼時請盡量按照discuz的書寫格式來寫，比如不要使用短標(biāo)簽等。
3，在class_core定義了一個EXTEND_NO_CACHE常量，當(dāng)生成緩存出現(xiàn)問題時可以打開強(qiáng)制更新緩存，當(dāng)代碼測試無誤后請修改為false。新增EXTEND_NO_DETECT常量，可以自動檢測擴(kuò)展源文件變動而自動更新緩存，默認(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，由于歷史原因，有些文件里有兩個或多個類，我們也可以對其中的一個或者多個進(jìn)行繼承，方法如上面所述。

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

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

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

2022-4-20 15:10 上傳

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

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

2022-4-20 15:10 上傳

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

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

2022-4-20 15:10 上傳

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

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


關(guān)于bin目錄駐守進(jìn)程腳本的開機(jī)啟動配置
在擴(kuò)展中我們有些腳本是需要一直在后臺不間斷運(yùn)行的，比如session機(jī)制統(tǒng)計腳本，云上報異步腳本。
為了避免重啟時任務(wù)丟失，我們需要在開機(jī)啟動里加上這個腳本，大家可以參考如下設(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，云上報異步設(shè)置開機(jī)啟動可能會出錯，提示random函數(shù)不存在，這時需要在bin_async_cron.php中加入function_core文件中的random函數(shù)即可。

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

hello1069

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

hello1069

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