phpcms_v9二次開發(fā)手冊

1、PHPCMSPHPCMS二次開發(fā)教程文件目錄結構根目錄| | - - apiapi接口文件目錄| | - - cachescaches緩存文件目錄| - configs系統(tǒng)配置文件目錄| - caches_*系統(tǒng)緩存目錄| | phpcmsphpcms phpcmsphpcms框架主目錄| - languages框架語言包目錄| - libs框架主類庫、主函數(shù)庫目錄| - model框架數(shù)據(jù)庫模型目錄| - modules框架模塊目錄| - templates框架系統(tǒng)模板目錄| | - - phpsso_serverphpsso_server phpssophpsso主目錄| | - - st

2、aticsstatics系統(tǒng)附件包| - css系統(tǒng)css包| - images系統(tǒng)圖片包| - js系統(tǒng)js包| | - - uploadfileuploadfile網(wǎng)站附件目錄| - admin.php后臺管理入口| - index.php程序主入口| - crossdomain.xml FLASH跨域傳輸文件robots.txt搜索引擎蜘蛛限制配置文件favicon.ico系統(tǒng)icon圖標PHPCMS V 駭心文件說明模塊與控制器模塊：phpcms v9框架中的模塊，位于 模塊。即url訪問中的m訪問content模塊例如：:/yourname/index.php7m-content控制

3、器：phpcms v9的控制器就是模塊的類文件，位于phpcms/modules/模塊/目錄下面。類名成就是文件名+.php ,例如一個名為abc的控制器，那么他的 命名為abc.php即可?？刂破黝惸J繼承系統(tǒng)的函數(shù)庫，可以直接使用?？刂破黝惖念?名稱與控制器文件名必須相同。如果您創(chuàng)立了一個abc.php在test模塊下，那么我們在瀏覽器里面輸入URL:/yourname/index.php?m=test& c=abc二次開發(fā)技巧如果要對已存在的控制器進行二次開發(fā)，為了方便升級不建議直接對內核文 件直接修改該，您可以通過MY_*php的形式進行二次開發(fā)。例如您要對改phpcms/mo

4、od/index.php進行二次開發(fā)。您可以在與index.php同級的目錄下建立MY_index.php ?phpclass MY_index extends indexfunction _construct。parent:_construct。； 一phpcms/modules目錄中 每一個目錄稱之為一個,your code 這樣當您通過url訪問index控制器的時候，系統(tǒng)會默認指向MY_index.php并且原文件的方法將被繼承，可以直接使用。系統(tǒng)配置文件文件路徑：根目錄/caches/configsdatabase.php數(shù)據(jù)庫配置文件system.php系統(tǒng)配置文件route.ph

5、p路由配置文件調用方法如調用系統(tǒng)配置中的web_path:pc_base:load_config(system, web_path );CM隊口文件：PHPCMS采用MV段計模式開發(fā)，基于模塊和操作的方式進行訪問， 采用單一入 口模式進行工程部署和訪問，無論訪問任何一個模塊或者功能，只有一個統(tǒng)一的 入口。入口程序是在前期處理用戶請求的引導程序。它是唯一一個可以被最終用戶可以直接請求運行的。文件路徑：根目錄/index.php這段代碼首先加載了phpcms框架的引導文件base.php ,然后它根據(jù)指定的配 置文件建立了一個Web應用實例并運行。PHPCMS 架入口文件:文件路徑：根目錄/php

6、cms/base.php代碼片段如下：該文件為框架入口文件，包含實例化系統(tǒng)/模塊類方法，調用系統(tǒng)/模塊方法，系統(tǒng)常用常量等。如：pc_base:load_model(*_model)加載數(shù)據(jù)庫模型pc_base:load_sys _class(classname)實例化系統(tǒng)類pc_base:load_app_class(classname,admin)實例化模塊類pc_base:load_sys_func (funcfile)調用系統(tǒng)函數(shù)庫全局函數(shù)文件：文件路徑：根目錄/phpcms/libs/functions/global.func.php代碼片段如下： $val) $string$key

7、 =new_addslashes($val);return $string;,?該文件中的函數(shù)，為全系統(tǒng)根底函數(shù)，可以在系統(tǒng)中直接調用。二次開發(fā)技巧:如果需要增加自己的全局函數(shù)，可根據(jù)需要增加到/phpcms/libs/functions/global.func.php/extention.func.php中， 不會影響升級 數(shù)據(jù)模型基類：文件路徑：根目錄/phpcms/libs/classes/model.class.php代碼片段如下：加載數(shù)據(jù)模型后，可以的數(shù)據(jù)庫該類中方法進行數(shù)據(jù)庫操作。表單調用類：文件路徑：根目錄/phpcms/libs/classes/form.class.php。

8、代碼片段如下：通過實例化該類可以，調用在程序中調用編輯器、表單上傳、日期選擇、欄目結構等表單。實例化方法：pc_base:load_sys_class(form, , 0);模板解析緩存類：文件路徑：根目錄/phpcms/libs/classes/template_cache.class.php。 代碼片段如下：該類作用為解析模板，解析模板及更新模板緩存PHPCMS V9X 次開發(fā)PHPCMS URL問:PHPCMS采用MV段計模式開發(fā)，基于模塊和操作的方式進行訪問， 采用單一入 口模式進行工程部署和訪問，無論訪問任何一個模塊或者功能，只有一個統(tǒng)一的 入口。參數(shù)名稱描述位置備注 M模型/模塊名

9、稱phpcms/modules中模塊目錄名稱 必須* C控制器名稱phpcms/modules/模塊/*php文件名稱 必須 A事件名稱phpcms/modules/模塊/*php中方法名稱類文件需要以.class.php為后綴這里是指的phpcms的系統(tǒng)類庫文件和模塊中 的類庫文件，第三方引入的不做要求，例如.class.php。函數(shù)文件需要以.func.php為后綴第三方引入的不做要求，例如mail.func.php。類名和文件名一致，例如phpcmsapp類的文件命名是phpcmsapp.class.php。數(shù)據(jù)模型需要以“數(shù)據(jù)表名稱_model.class.php相同。二次開發(fā)開發(fā)流程

10、 創(chuàng)立數(shù)據(jù)庫模型類為形式，類名稱與文件名必須模塊訪問方法例如:二次開發(fā)命名標準數(shù)據(jù)庫模型位于：phpcms/model/目錄下。數(shù)據(jù)模型文件的命名規(guī)那么建議為數(shù)據(jù)表名稱+_model.class.php如果在我們的創(chuàng)立的模塊中我要使用一個數(shù)據(jù)庫“test， 首先需要建立一個數(shù)據(jù)庫模型文件，文件名稱為test_model.class.phpdb_config = pc_base:load_config(database);$this- db_setting =default;$this-table_name = test;parent:_construct();?數(shù)據(jù)庫模型類名稱必須與文件名稱相

11、同；$this-db_setting = default為數(shù)據(jù)庫配置文件中配置數(shù)據(jù)庫鏈接池名稱，默認為default，一般情況下不需要修改。$this- table_name =test為數(shù)據(jù)表名稱創(chuàng)立模塊如果要創(chuàng)立一個模塊，只要在phpcms/modules目錄下創(chuàng)立文件夾并放入你的控制器類就可以了。例如要開發(fā)一個叫做test的模塊，那么首先在phpcms/modules目錄下創(chuàng)立文件夾，并將其命名為test。模塊的標準結構通常是這樣的。如果您的模板有單獨的前臺模板，你需要在phpcms/templates/default下創(chuàng)立一個您的模塊目錄來放置前臺模板，default為你的風格包名稱，

12、我們默認適用defaultr r 訪問test模塊例如：:/yourname/index.php7mWest為test模塊增加一個名為myest的控制器 文件路徑：根目錄/phpcms/modules/test/mytest.php。代碼片段如下：?phpdefined(IN_PHPCMS) or exit(No permission resources.); class mytest function _construct。度素文科棄hp常用操作列表(1)1.調用數(shù)據(jù)庫模型$this-db = pc_base:load_model(test_model);其中$this-db中所支持的方法請

13、參照phpcms/libs/classes/model.class.php中方法2.加載系統(tǒng)類$= pc_base:load_sys_class(); /實例化類pc_base:load_sys_class(format, , 0); /調用form類，不進行實例化操作3.加載系統(tǒng)函3.加載系統(tǒng)函數(shù)庫pc_base:load_sys_func(mail); /調用mail函數(shù)包4.加載模塊類$test = pc_base:load_sys_class(classname,test); /實例化test模塊下classname類5.加載模塊函數(shù)庫pc_base:load_sys_func(glo

14、bal,test); /調用test模塊的global函數(shù)包常用操作列表(2)6.加載前臺模板include template(test, mytest, default);7.加載后臺模板include $this-admin_tpl(mytest_admin_list);8.權限控制后臺控制控制器需要加載admin模塊下的admin類，并繼承該類PHPCMS V效板與標簽PC標簽評論模塊會員模塊友情鏈接模塊投票模塊公告模塊專題模塊內容模塊工具箱json工具箱xml工具箱get標簽碎片工具箱v9v9二次開發(fā)之構建模塊全過程第一：開發(fā)流程為你的phpcms創(chuàng)立一個模塊的一般開發(fā)流程是： 創(chuàng)立數(shù)

15、據(jù)庫和數(shù)據(jù)表；(沒有數(shù)據(jù)庫操作可略過) 創(chuàng)立模塊目錄 創(chuàng)立模塊控制器類；創(chuàng)立模塊類與模塊函數(shù)；如果只是簡單的模塊可以不必創(chuàng)立創(chuàng)立模板文件；運行和調試。第二：創(chuàng)立模塊phpcms v9框架中的模塊，位于phpcms/modules目錄中 每一個目錄稱之為一個模塊如果要創(chuàng)立一個模塊，只要在phpcms/modules目錄下創(chuàng)立文件夾并放入你的控制器類就可 以了。例如我要開發(fā)一個叫做test的模塊，那么首先在phpcms/modules目錄下創(chuàng)立文件夾，并將其命名為test。test模塊的標準結構通常是這樣的。技素 文件夷目-其中classes為模塊類庫包functions為模塊函數(shù)庫包templa

16、tes為模塊模板包這里通常放置含有權限控制的控制器模板，也就是后臺模板。如果您的模板有單獨的 前臺模板，你需要在phpcmstemplatesdefault下創(chuàng)立一個您的模塊目錄來放置前臺模板，default為你的風格包名稱，我們默認適用defaultphpphp cmscms tempitempi atesdeatesde aulaul t t第三：創(chuàng)立模塊控制器類在創(chuàng)立模塊中我們已經(jīng)創(chuàng)立好了一個名為“test 的模塊，接下來我們繼續(xù)為這個模塊添加兩個控制器類。phpcms v9的控制器就是模塊的類文件，位于phpcms/modules/模塊/目錄下面。類名成就是文件名+.php ,例如一個

17、名為mytest的控制器，那么他的命名為mytest.php即可?？刂破黝?默認繼承系統(tǒng)的函數(shù)庫，可以直接使用?？刂破黝惖念惷Q與控制器文件名必須相同?？刂破黝愇募瑑煞N形式：1 .mytest.php控制器，前臺瀏覽(不含權限控制)這個控制器的url訪問方法前面已經(jīng)介紹過了，:/yourname/index.php?m=test&c=mytest:/yourname/index.php?m=test&c=mytest&a=mylist沒有填寫“a 的情況下，默認調用init方法2.mytest_admin.php控制器，后臺管理含權限控制后臺控制控制器需要加載adm

18、in模塊下的admin類 ，并繼承該類。需要注意的是因為你添加的控制器類繼承了其他的類，你要小心你控制器的方法名不要和該類中的方法名一樣了，否那么會造成影響，具體請查看admin類中有哪些方法。在控制器中增加模板調用phpcms可以實現(xiàn)完全的模板與程序別離，所以在我們的控制器程序中要加載模板，才可以更友好的顯示出來。1 .加載前臺模板前臺模板文件在模塊名稱目錄中，本例如也就在phpcmstemplatesdefaulttest中加載模板方法如下：includetemplate(test,mytest,default);其中test為模塊名稱mytest為模板目錄下模板名稱，default為風格

19、名稱，默認不填為defalut在上面例子中如果要給mytest.php中init方法加載一個mytest的模板，如下publicfunctioninit()$var=hello world!;includetemplate(test,mytest,default);這樣我們通過url訪問該方法的時候也就加載了對應的模板。2.加載后臺模板后臺模板文件在模塊名稱templates目錄中，本例如也就在phpcmsmodulestesttemplates中加載模板方法如下：include $this-admin_tpl(mytest_admin_list);其中mytest_admin_list為ph

20、pcmsmodulestesttemplates中mytest_admin_list.tpl.php,注意：此處模板必須以.tpl.php作為后綴在上面例子中如果要給mytest_admin.php中init方法加載一個mytest_admin_list的模板，如下publicfunctioninit()$myvar=oh,i am phpcmser;include $this-admin_tpl(mytest_admin_list);第四：創(chuàng)立數(shù)據(jù)庫模型類數(shù)據(jù)庫模型位于：phpcms/model/目錄下。數(shù)據(jù)模型文件的命名規(guī)那么建議為數(shù)據(jù)表名稱+_model.class.php如果在我們的創(chuàng)

21、立的模塊中我要使用一個數(shù)據(jù)庫“test， 首先需要建立一個數(shù)據(jù)庫模型文件，文件名稱為test_model.class.php內容如下： db_config =pc_base : load_config ( database );$this - db_setting =default ;$this - table_name =testparent : _construct ();?注意：1 .數(shù)據(jù)庫模型類名稱必須與文件名稱相同；2.$this-db_setting = default為數(shù)據(jù)庫配置文件中配置數(shù)據(jù)庫鏈接池名稱，默認為default，一般情況下不需要修改。3.$this-table_n

22、ame = test為數(shù)據(jù)表名稱這樣我們就建立好了一個數(shù)據(jù)庫模型類。在模塊的控制器中使用$this - db=pc_base : load_model ( test_model );來加載。具體如下 db=pc_base : load_model (test_model );publicfunction init ()$result =$this - db- select ();var_dump( $result );?其中$this-db中所支持的方法請參照phpcms/libs/classes/model.class.php中方法PCPC標簽使用說明在PHPCMS V9中我們正式開始需要P

23、C標簽做為數(shù)據(jù)的獲取的方式。PC標簽是以下面的方式進行聲明pc:content action= lists cache=3600 num=20 page=$page /pcPC標簽必須以pc開頭，并以/pc結尾的代碼片段。當然不以/pc結尾并不會引起程序致命性的錯誤，導致程序無法繼續(xù)運行。以下為兩種可能會出現(xiàn)的問題：1 .當網(wǎng)頁中出現(xiàn)兩個PC標簽時，可能會使得沒有閉合的PC標簽之后的PC標簽數(shù)據(jù)和其混亂。2.在后臺可視化編輯時，可能出現(xiàn)網(wǎng)頁結構錯亂的問題。PCPC標簽分析：PC標簽中pc:冒號之后跟隨的為模塊名。如上面的例子中調用的是內容模型的PC標簽。action=list這個形式所代表的是

24、參數(shù)。每一個PHPCMS V9模型都為其PC標簽定義了調用的參數(shù)。其中有一些調用參數(shù)是系統(tǒng)保存的參數(shù)，其對所有的PC標簽都是有效的。參數(shù)必須使用參數(shù)名=參數(shù)值的方式填寫，多個參數(shù)之間使用空格分開如下例，參數(shù)值可使用雙引號來包括，無論是 什么形式的引號都必須是成對出現(xiàn)的。pc:content參數(shù)名=參數(shù)值參數(shù)名=參數(shù)值參數(shù)名=參數(shù)值請查看PC標簽保存參數(shù)相關章節(jié)，以了解具體保存參數(shù)及其用途。PCPC標簽分類:PC標簽包含兩個類別，分別為:1 .工具類2.模塊類工具類，大體上可以理解為PHPCMS V9所提供的一些工具箱。請查看PC標簽工具箱相關章節(jié)，以了解更多關于工具類的PC標簽的更多信息。而模

25、塊類，是PHPCMS V9各個模型提供應大家調用模塊數(shù)據(jù)的數(shù)據(jù)接口。查看具體模塊的相關說明章節(jié)，以了解更多關于模塊類的PC標簽的更多信息。如何顯示PCPC標簽中的數(shù)據(jù)：默認情況下PC標簽中的數(shù)據(jù)都是數(shù)組方式返回的，你都可以通過$data來獲取到這個數(shù) 組，如果你在PC標簽中定義了return參數(shù)，返回的數(shù)組將使用return的值進行命令。一般情況下你可以使用如下的方式來顯示值：loop $data $key $val $val title /loop基中的$valurl和$valtitle需要具體根據(jù)所使用的PC標簽，返回的數(shù)據(jù)來判斷。PCPC標簽保存參數(shù)下表為PC標簽保存參數(shù)表，幾乎所有的P

26、C標簽都支持這些保存參數(shù)設置變量名默認值說明actionnull本參數(shù)的值表示為操作事件，模型類PC標簽必須使用包含本參數(shù)， 以 說明要進行的操作。cache0緩存存儲時間單位秒num20獲取記錄的條數(shù)，最后會被模板引 擎處理成limit傳送到處理函數(shù)中。pagenull當前分頁。一般填寫為$_GETpageurlrulenullURL規(guī)貝Ureturndata返回數(shù)據(jù)變量名下例中是一個完整的使用例子。pc:content action =lists catid =25 num=20 page=$_GETpage return=dataloop $data $n $r $rtitle/loop

27、/pcgetget標簽GET標簽源自于PHPCMS 2021版，其使用SQL語句直接獲取數(shù)據(jù)的特性，成為大家制作 模板的首選。在V9中這樣強大的工具也得到保存下來。GET標簽使用方式如下：pc:get sql=SELECT * FROM phpcms_member cache=3600 page=$page dbsource=discuz return=dataloop $data $key $val$valusername/loop$pages/pc從上面的代碼里面可以看出GET標簽所支持的參數(shù)。對照下面的列表了解每一個參數(shù)的用途：參數(shù)默認值必須說明sqlnull是要執(zhí)行的SQL語句cach

28、e0否緩存時間，單位為秒page0否分頁，通過變量把當前的分布傳給PC標簽進行處理dbsourcenull否數(shù)據(jù)源，當你通過系統(tǒng)后臺的數(shù)據(jù)源模塊配置過數(shù)據(jù)源時，可把數(shù)據(jù)源名填寫到這里，系統(tǒng)會去對應的數(shù)據(jù) 本系統(tǒng)的數(shù)據(jù)請留空return data否返回的數(shù)據(jù)的變量內容模塊內容模塊PC標簽調用說明模塊名：contentcontent模塊提供的可用操作操作名說明lists內容數(shù)據(jù)列表relation內容相關文章hits內容數(shù)據(jù)點擊排行榜category內容欄目列表position內容推薦位列表position操作說明如下:內容推薦位列表positionposition可用參數(shù):參數(shù)名是否必須默認值說

29、明posid是null推薦位IDcatid否null調用欄目IDthumb否0是否僅必須縮略圖order否null排序類型num是null數(shù)據(jù)調用數(shù)量代碼例子:pc:content action=position posid=2 order=listorder DESC num=4loop $data $key $val $valtitle /loop/pc返回參數(shù)如下表:字段類型空默認注釋titlechar(80)否1NULL推薦位標題urlchar否NULL推薦位鏈接地址inputtimeint(10)否NULL推薦位發(fā)布時間thumbchar是NULL推薦位縮略圖其他不定是根據(jù)模型所設置

30、的參加到推薦位中字段名稱內容列表listslists可用參數(shù):參數(shù)名是否必須默認值說明catid否null調用欄目IDwhere否nullsql語句的where局部thumb否0是否僅必須縮略圖order否null排序類型num是null數(shù)據(jù)調用數(shù)量moreinfo否0是否調用副表數(shù)據(jù)提醒：從PHPCMS V9 Beta 20211105版本開始支持moreinfo參數(shù)屬性，本參數(shù)表示在返回數(shù)據(jù)的時候，會把副表中的數(shù)據(jù)也一起返回。 一個內容模型分為2個表，一個主表一個副表, 主表中一般是保存了標題、所屬欄目等等短小的數(shù)據(jù)方便用于索引，而副表那么保存了大字段的數(shù)據(jù)，如內容等數(shù)據(jù)。在模型管理中新建

31、字段的時候， 是允許你選擇存入到主表還是副表的我們推薦的是，把不重要的信息放到副表中 要在PC標簽中使用moreinfo這個屬性。代碼例子：pc:content action=lists catid=2 order=id DESC num=4loop $data $key $val $valtitle /loop/pcwhere用法：pc:content action=lists catid=2 where=、thumb、!=AND、status、=99 order=id DESC num=4loop $data $key $val $valtitle /loop/pc返回參數(shù)如下表：O想要在

32、列表中調取副表的數(shù)據(jù)就需字段類型空默認注釋titlechar(80)否NULL推薦位標題urlchar否NULL推薦位鏈接地址inputtimeint(10)否NULL推薦位發(fā)布時間thumbchar是NULL推薦位縮略圖其他不定是其他模型字段點擊排行榜hitshits可用參數(shù)：參數(shù) 名 是否必 須默認 值說明catid否null調用欄目IDday否0調用多少天內的排行order否否null排序類型本月排行-monthviews DESC、本周排行-weekviews DESC、今日排行- dayviews DESCnum是null數(shù)據(jù)調用數(shù)量代碼例子：pc:content action=hi

33、ts catid=2 order=weekviews DESC num=10loop $data $key $val $valtitle /loop/pc返回參數(shù)如下表:字段類型空默認注釋titlechar(80)否NULL推薦位標題urlchar否NULL推薦位鏈接地址inputtimeint(10)否NULL推薦位發(fā)布時間thumbchar是NULL推薦位縮略圖其他不定是其他模型字段相關文章relationrelation可用參數(shù):參數(shù)名是否必須默認值說明catid否null調用欄目IDrelation否$relation無需更改keywords否null內容頁面取值：$rskeyword

34、snum是null數(shù)據(jù)調用數(shù)量代碼例子：pc:content action =relation relation =$relation catid=$catid num=5keywords =$rskeywords loop $data $r $rtitle( date(Y-m-d ,$rinputtime )/loop/pc返回參數(shù)如下表:字段類型空默認注釋titlechar(80)否NULL推薦位標題urlchar否NULL推薦位鏈接地址inputtimeint(10)否NULL推薦位發(fā)布時間thumbchar是NULL推薦位縮略圖其他不定是其他模型字段欄目列表(category)cate

35、gory)可用參數(shù):參數(shù)名是否必須默認值說明catid否0調用該欄目下的所有欄目，默認0,調用一級欄目$siteid否1默認調用系統(tǒng)站點order否null排序方式、一般按照listorder ASC排序，即欄目的添加順序代碼例子:pc:content action =category catid=0 num=25 siteid=$siteid order=listorder ASC loop $data $r $rcatname /loop/pc返回參數(shù)如下表:字段類型默認值說明catidsmallint無欄目IDsiteidtinyint(3)0站點IDmodulevarchar(15)無

36、模塊IDtypetinyint(1)1欄目類型IDmodelidtinyint(5)5模型IDparentidsmallint(5)5上級父欄目arrparentidvarchar(255)無所有父欄目childtinyint(1)0子欄目arrchildidmediumtext無所有子欄目catnamevarchar(30)無欄目名稱imagevarchar(100)無欄目圖片descriptionmediumtext無欄目描述parentdirvarchar(100)無父欄目目錄catdirvarchar(30)無欄目目錄urlvarchar(100)無欄目鏈接字段類型默認值說明items

37、mediumint(8)0欄目內容數(shù)hitsint(10)0點擊數(shù)settingmediumtext無欄目設置listordersmallint(5)0排序ismenutinyint(1)0是否顯示sethtmltinyint(1)0是否生成到根目錄lettervarchar(30)無欄目拼音PHPCMSPHPCMS v9.1.7v9.1.7整合discuzdiscuz X2X2的解決辦 法最近有不少朋友提出PHPCMS v9.1.7(20210909)與discuz新版X2整合過程 中有問題。由于PHPCMS V9默認整合的Ucenter版本為1.5.1 (即適用于Discuz X1.5以下Discuz 7.0之上的版本)，而最新的Discuz X2中升級了Ucenter版本至Ucenter 1.6,由于接口文件的變動，所以會導致一些無法同行問題?，F(xiàn)給出如下解決方案：第一步：確定你的PHPCMS PHPSS以本為最新版v9.1.7(20210909)。注：截 至發(fā)此文章時間最新版為該版本。第二步：使用新的uc_client文件，翻開phpsso_serverapi目錄修改原uc_client目錄名稱為uc_client.1.5.1,然后將下面文件曲壓后覆蓋到該目錄下。uc_client.rar(41.12 KB)第三步：使用下面文件覆蓋phpsso_serverphpcmsli