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

dashen

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
upload_extend1.3.0_x3.1.zip (3.45 KB, 下載次數: 686)

2022-4-20 15:10 上傳

點擊文件名下載附件

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

2022-4-20 15:10 上傳

點擊文件名下載附件

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

2022-4-20 15:10 上傳

點擊文件名下載附件

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


關于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權限

hello1069

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

hello1069

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