Discuz! X5.0 插件目录文件层级技术文档【2025年5月1日即将发布DZ X5.0~】-开发文档-DZ插件网

Discuz! X5.0 插件目录文件层级技术文档【2025年5月1日即将发布DZ X5.0~】

惧愁人

2025/03/03 14:05:50

Discuz! X5.0 寮鍙戞妧鏈枃妗
缁撴瀯姒傝堪|App 鎵╁睍|鏂板鎻掍欢鎺ュ彛|鏂板妯℃澘鎺ュ彛|浜戞彃浠
[size=1.3em]鐩綍

X5锛屾垜浠皢寮鏀捐繘琛屽埌搴曪紝璁╁畠鎴愪负涓涓钩鍙

缁撴瀯姒傝堪鐩綍缁撴瀯

Discuz! X5.0 灏嗙洰褰曠粨鏋勮繘琛屼紭鍖栧拰鏀归狅紝瀵规枃浠剁殑浣滅敤杩涜閲嶆柊褰掔被鐨勫悓鏃讹紝涔熷交搴曞姞寮轰簡寮鏀炬э紝鎴戜滑鎶婅繖涓叏鏂扮殑鏋舵瀯鍛藉悕涓 MitFrame銆傞噸鏂版暣鐞嗗悗鐨勭洰褰曠粨鏋勮涓嬭〃锛

[td]

鐩綍	鍚箟
/	棣栭〉鐩綍
/api	API 鎺ュ彛鐩綍
/archiver	Archiver 鐗堢洰褰
/source/app	APP 鐩綍
/source/child	瀛愭枃浠剁洰褰
/source/class	绫绘枃浠剁洰褰
/source/data	鏁版嵁鏂囦欢鐩綍
/source/function	鍑芥暟鏂囦欢鐩綍
/source/index	棣栭〉鏂囦欢鐩綍
/source/language	璇█鍖呮枃浠剁洰褰
/source/plugin	鎻掍欢鐩綍
/vendor	绗笁鏂瑰簱鏂囦欢
/template	妯℃澘鐩綍

鏈仛淇敼鐨勭洰褰曟湰鏂囧皢涓嶅仛闃愯堪

APP 鐩綍

Discuz! X5.0 灏嗗悇涓ā鍧楀姛鑳界殑鍖呭惈绫绘枃浠惰繘琛屼簡鍚堝苟锛屾墍鏈夊悓妯″潡鐨勬枃浠堕兘鍦ㄥ悇鑷殑鐩綍涓嬨
X3.5 鐗堟湰鐨 /source/module 鐩綍宸茬粡鍚堝苟鍒板悇涓 app 鐨勫瓙鐩綍 /source/app/xxx/module 涓

濡傛灉鎮ㄨ杩涜 app 鐨勬墿灞曪紝鍙洿鎺ュ湪 /source/app 涓嬪垱寤虹洰褰曪紝鐒跺悗鍦ㄦ鐩綍涓嬪垱寤哄悓鍚嶆枃浠讹紝渚嬪 /source/app/xxx/xxx.php

<?php
require './source/class/class_core.php';
$discuz = C::app();
$discuz->cachelist = [];
$discuz->init();
require_once appfile('yyy/zzz'); // 璋冪敤 /source/app/xxx/yyy/zzz.php 鏂囦欢

/source/app/xxx 鐩綍涓嬪彲浠ョ洿鎺ュ垱寤烘ā鏉挎枃浠讹紝鍙敤绫讳技浠ヤ笅鏂瑰紡璋冪敤 source/app/xxx/template/tpl.php 妯℃澘鏂囦欢銆備粎鏀寔 php 鏍煎紡鏄ā鏉挎枃浠

template('tpl', 0, 'source/app/xxx/template');

瀛愭枃浠剁洰褰

瀛愭枃浠剁洰褰曞皢 X3.5 鐗堟湰鐨 /source/include 鐩綍鐨勮繘琛屼簡浼樺寲鏀归狅紝骞舵寜鐓у悇涓ā鍧椾互鍙婂叾瀛愭ā鍧楄繘琛岄愬眰鍛藉悕锛屽叏灞瀛愭枃浠朵綅浜 /source/child 鐩綍涓嬶紝鍚勪釜 app 鐨勫瓙鏂囦欢浣嶄簬 /source/app/xxx/child 鐩綍涓嬨侱iscuz! X5.0 绯荤粺绋嬪簭鐨勭浉搴旀ā鍧椾細鑷姩寮曠敤 child 鐩綍涓浉搴旀ā鍧楃殑鏂囦欢锛屼絾鏄鏋滄彃浠舵敞鍐屼簡鎺ョ锛屽彲浠ュ畬鍏ㄤ唬鏇垮師鏈夌郴缁熺殑閫昏緫銆
鎺ョ鏂规硶璇﹁鈥滄柊澧炴彃浠舵帴鍙ｂ>鈥滃瓙鏂囦欢鈥銆

绠＄悊鍚庡彴鐨 URL admin.php?action=app&operation=xxx:yyy 鍙互鐩存帴璋冪敤 /source/app/xxx/admin/yyy.php銆

绫绘枃浠剁洰褰

绫绘枃浠剁洰褰曚腑鐨勬枃浠跺洜 autoload 浼氳嚜鍔ㄨ皟鐢紝浠ｇ爜涓彧闇瑕佺洿鎺ュ啓绫诲悕鍗冲彲璋冪敤鍒帮紝渚嬪涓嬩緥涓彲鐩存帴璋冪敤鍒 /source/class/class_i18n.php 鏂囦欢涓殑 class i18n{}

return i18n::cmd($cmd, $langkey, $path);

瀵逛簬鎻掍欢绫汇丄pp绫荤殑璋冪敤鍙氳繃鍛藉悕绌洪棿鐨勬柟寮忥紝瑙佷笅琛細

[td]

璋冪敤浠ｇ爜	鏂囦欢鍚	绫讳唬鐮
sample\lib_base::xxx()	/source/plugin/sample/lib/lib_base.php	namespace sample; class lib_base {鈥
sample\lib\sub_base::xxx()	/source/plugin/sample/lib/sub/sub_base.php	namespace sample\lib; class sub_base {鈥
sample\lib\sub\ssub_base::xxx()	/source/plugin/sample/lib/sub/ssub/ssub_base.php	namespace sample\lib\sub; class ssub_base {鈥

鏁版嵁鏂囦欢鐩綍

瀛樻斁闈 PHP 涓旀棤淇敼鏉冮檺鐨勬暟鎹枃浠讹紝X3.5 涓 data/ipdata銆乻ource/include/table 鐨勫唴瀹硅縼绉诲埌浜嗘鐩綍涓嬨

棣栭〉鏂囦欢鐩綍

姝ょ洰褰曚负 X3.5 棣栭〉鐨勬枃浠躲傚洜姝わ紝鐞嗚涓 Discuz! X5.0 涓椤靛彧鏈変竴涓 index.php 鏂囦欢锛屽叾浠栨枃浠舵槸涓轰簡鍏煎鏃х増鏈摼鎺ヨ岃缃殑璺宠浆鏂囦欢锛屽洜姝ゆ墍鏈夐椤垫枃浠堕兘鍙敤 index.php?app=xxx 鐨勬柊鏂瑰紡璁块棶銆傚悓鏃讹紝鎴戜滑涔熶紭鍖栦簡鎻掍欢妯″潡鏂囦欢鐨勮闂矾寰勶紝褰 ./source/app 涓寚瀹 app 涓嶅瓨鍦ㄧ殑鏃跺欙紝plugin.php?id=xxx:yyy 鐨勮闂矾寰勶紝鍙敤 index.php?app=xxx&module=yyy 浠ｆ浛銆

绗笁鏂瑰簱鏂囦欢

涓轰簡鍖哄垎绯荤粺鏂囦欢鍜岀涓夋柟鏂囦欢锛屾垜浠帹鑽愭墍鏈夌涓夋柟銆乧omposer 搴撶粺涓鏀惧湪姝ょ洰褰曚笅銆

鐗堟湰鍏煎瀛楁

鍦 X5.0 閲岋紝搴旂敤 XML 閰嶇疆鏂囦欢涓殑 version 瀛楁鐨勫兼湁浠ヤ笅鏂扮殑娉ㄦ剰浜嬮」锛

1銆佸瓧娈靛煎啓娉曚负鈥淴5.0鈥濓紝鑰屼笉鏄淴5鈥濓紱
2銆佲淴5.0鈥濈殑鍚箟鏄 X5.0+锛屽嵆 X5.1 鐗堟湰鍏煎鈥淴5.0鈥濓紝浣嗕笉鍏煎鈥淴5.2鈥濓紝鍥犳鐩墠鏃犻渶浣跨敤绫讳技鈥淴5.0,X5.1,X5.2鈥濈殑鍐欐硶锛屽彧闇鍐欌淴5.0鈥濆嵆鍙紝闄ら潪搴旂敤鍙吋瀹 X5.1+锛屽彲濉啓鈥淴5.1鈥濓紱
3銆乆5.0 璧蜂笉鍐嶅吋瀹光淴3.5鈥濅互鍙婃洿鑰佺殑鐗堟湰锛屽簲鐢ㄦ棤娉曞畨瑁呫傝纭繚鎮ㄧ殑搴旂敤 X3.x 鐗堝簲鐢ㄥ吋瀹逛簡 PHP8 鍚庡啀鎵撲笂鈥淴5.0鈥濆吋瀹规爣璁板苟杩涜鏇存柊鍙戝竷锛堝浜庝娇鐢 X5.0 鏂扮壒鎬х殑搴旂敤鎴戜滑浼氭墦涓婇澶栫殑鏍囩锛夛紱
4銆丏iscuz!岬鐗堟湰璇峰～鍐欌淲1.0鈥濓紱

进入原文参与互动