phpcms_v9二次开发手册

1、PHPCMSPHPCMS二次开发教程文件目录结构根目录| | - - apiapi接口文件目录| | - - cachescaches缓存文件目录| - configs系统配置文件目录| - caches_*系统缓存目录| | phpcmsphpcms phpcmsphpcms框架主目录| - languages框架语言包目录| - libs框架主类库、主函数库目录| - model框架数据库模型目录| - modules框架模块目录| - templates框架系统模板目录| | - - phpsso_serverphpsso_server phpssophpsso主目录| | - - st

2、aticsstatics系统附件包| - css系统css包| - images系统图片包| - js系统js包| | - - uploadfileuploadfile网站附件目录| - admin.php后台管理入口| - index.php程序主入口| - crossdomain.xml FLASH跨域传输文件robots.txt搜索引擎蜘蛛限制配置文件favicon.ico系统icon图标PHPCMS V 骇心文件说明模块与控制器模块：phpcms v9框架中的模块，位于 模块。即url访问中的m访问content模块例如：:/yourname/index.php7m-content控制

3、器：phpcms v9的控制器就是模块的类文件，位于phpcms/modules/模块/目录下面。类名成就是文件名+.php ,例如一个名为abc的控制器，那么他的 命名为abc.php即可。控制器类默认继承系统的函数库，可以直接使用。控制器类的类 名称与控制器文件名必须相同。如果您创立了一个abc.php在test模块下，那么我们在浏览器里面输入URL:/yourname/index.php?m=test& c=abc二次开发技巧如果要对已存在的控制器进行二次开发，为了方便升级不建议直接对内核文 件直接修改该，您可以通过MY_*php的形式进行二次开发。例如您要对改phpcms/mo

4、od/index.php进行二次开发。您可以在与index.php同级的目录下建立MY_index.php ?phpclass MY_index extends indexfunction _construct。parent:_construct。； 一phpcms/modules目录中 每一个目录称之为一个,your code 这样当您通过url访问index控制器的时候，系统会默认指向MY_index.php并且原文件的方法将被继承，可以直接使用。系统配置文件文件路径：根目录/caches/configsdatabase.php数据库配置文件system.php系统配置文件route.ph

5、p路由配置文件调用方法如调用系统配置中的web_path:pc_base:load_config(system, web_path );CM队口文件：PHPCMS采用MV段计模式开发，基于模块和操作的方式进行访问， 采用单一入 口模式进行工程部署和访问，无论访问任何一个模块或者功能，只有一个统一的 入口。入口程序是在前期处理用户请求的引导程序。它是唯一一个可以被最终用户可以直接请求运行的。文件路径：根目录/index.php这段代码首先加载了phpcms框架的引导文件base.php ,然后它根据指定的配 置文件建立了一个Web应用实例并运行。PHPCMS 架入口文件:文件路径：根目录/php

6、cms/base.php代码片段如下：该文件为框架入口文件，包含实例化系统/模块类方法，调用系统/模块方法，系统常用常量等。如：pc_base:load_model(*_model)加载数据库模型pc_base:load_sys _class(classname)实例化系统类pc_base:load_app_class(classname,admin)实例化模块类pc_base:load_sys_func (funcfile)调用系统函数库全局函数文件：文件路径：根目录/phpcms/libs/functions/global.func.php代码片段如下： $val) $string$key

7、 =new_addslashes($val);return $string;,?该文件中的函数，为全系统根底函数，可以在系统中直接调用。二次开发技巧:如果需要增加自己的全局函数，可根据需要增加到/phpcms/libs/functions/global.func.php/extention.func.php中， 不会影响升级 数据模型基类：文件路径：根目录/phpcms/libs/classes/model.class.php代码片段如下：加载数据模型后，可以的数据库该类中方法进行数据库操作。表单调用类：文件路径：根目录/phpcms/libs/classes/form.class.php。

8、代码片段如下：通过实例化该类可以，调用在程序中调用编辑器、表单上传、日期选择、栏目结构等表单。实例化方法：pc_base:load_sys_class(form, , 0);模板解析缓存类：文件路径：根目录/phpcms/libs/classes/template_cache.class.php。 代码片段如下：该类作用为解析模板，解析模板及更新模板缓存PHPCMS V9X 次开发PHPCMS URL问:PHPCMS采用MV段计模式开发，基于模块和操作的方式进行访问， 采用单一入 口模式进行工程部署和访问，无论访问任何一个模块或者功能，只有一个统一的 入口。参数名称描述位置备注 M模型/模块名

9、称phpcms/modules中模块目录名称 必须* C控制器名称phpcms/modules/模块/*php文件名称 必须 A事件名称phpcms/modules/模块/*php中方法名称类文件需要以.class.php为后缀这里是指的phpcms的系统类库文件和模块中 的类库文件，第三方引入的不做要求，例如.class.php。函数文件需要以.func.php为后缀第三方引入的不做要求，例如mail.func.php。类名和文件名一致，例如phpcmsapp类的文件命名是phpcmsapp.class.php。数据模型需要以“数据表名称_model.class.php相同。二次开发开发流程

10、 创立数据库模型类为形式，类名称与文件名必须模块访问方法例如:二次开发命名标准数据库模型位于：phpcms/model/目录下。数据模型文件的命名规那么建议为数据表名称+_model.class.php如果在我们的创立的模块中我要使用一个数据库“test， 首先需要建立一个数据库模型文件，文件名称为test_model.class.phpdb_config = pc_base:load_config(database);$this- db_setting =default;$this-table_name = test;parent:_construct();?数据库模型类名称必须与文件名称相

11、同；$this-db_setting = default为数据库配置文件中配置数据库链接池名称，默认为default，一般情况下不需要修改。$this- table_name =test为数据表名称创立模块如果要创立一个模块，只要在phpcms/modules目录下创立文件夹并放入你的控制器类就可以了。例如要开发一个叫做test的模块，那么首先在phpcms/modules目录下创立文件夹，并将其命名为test。模块的标准结构通常是这样的。如果您的模板有单独的前台模板，你需要在phpcms/templates/default下创立一个您的模块目录来放置前台模板，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.调用数据库模型$this-db = pc_base:load_model(test_model);其中$this-db中所支持的方法请

13、参照phpcms/libs/classes/model.class.php中方法2.加载系统类$= pc_base:load_sys_class(); /实例化类pc_base:load_sys_class(format, , 0); /调用form类，不进行实例化操作3.加载系统函3.加载系统函数库pc_base:load_sys_func(mail); /调用mail函数包4.加载模块类$test = pc_base:load_sys_class(classname,test); /实例化test模块下classname类5.加载模块函数库pc_base:load_sys_func(glo

14、bal,test); /调用test模块的global函数包常用操作列表(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二次开发之构建模块全过程第一：开发流程为你的phpcms创立一个模块的一般开发流程是： 创立数

15、据库和数据表；(没有数据库操作可略过) 创立模块目录 创立模块控制器类；创立模块类与模块函数；如果只是简单的模块可以不必创立创立模板文件；运行和调试。第二：创立模块phpcms v9框架中的模块，位于phpcms/modules目录中 每一个目录称之为一个模块如果要创立一个模块，只要在phpcms/modules目录下创立文件夹并放入你的控制器类就可 以了。例如我要开发一个叫做test的模块，那么首先在phpcms/modules目录下创立文件夹，并将其命名为test。test模块的标准结构通常是这样的。技素 文件夷目-其中classes为模块类库包functions为模块函数库包templa

16、tes为模块模板包这里通常放置含有权限控制的控制器模板，也就是后台模板。如果您的模板有单独的 前台模板，你需要在phpcmstemplatesdefault下创立一个您的模块目录来放置前台模板，default为你的风格包名称，我们默认适用defaultphpphp cmscms tempitempi atesdeatesde aulaul t t第三：创立模块控制器类在创立模块中我们已经创立好了一个名为“test 的模块，接下来我们继续为这个模块添加两个控制器类。phpcms v9的控制器就是模块的类文件，位于phpcms/modules/模块/目录下面。类名成就是文件名+.php ,例如一个

17、名为mytest的控制器，那么他的命名为mytest.php即可。控制器类 默认继承系统的函数库，可以直接使用。控制器类的类名称与控制器文件名必须相同。控制器类文件包含两种形式：1 .mytest.php控制器，前台浏览(不含权限控制)这个控制器的url访问方法前面已经介绍过了，:/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可以实现完全的模板与程序别离，所以在我们的控制器程序中要加载模板，才可以更友好的显示出来。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);第四：创立数据库模型类数据库模型位于：phpcms/model/目录下。数据模型文件的命名规那么建议为数据表名称+_model.class.php如果在我们的创

21、立的模块中我要使用一个数据库“test， 首先需要建立一个数据库模型文件，文件名称为test_model.class.php内容如下： db_config =pc_base : load_config ( database );$this - db_setting =default ;$this - table_name =testparent : _construct ();?注意：1 .数据库模型类名称必须与文件名称相同；2.$this-db_setting = default为数据库配置文件中配置数据库链接池名称，默认为default，一般情况下不需要修改。3.$this-table_n

22、ame = test为数据表名称这样我们就建立好了一个数据库模型类。在模块的控制器中使用$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标签做为数据的获取的方式。PC标签是以下面的方式进行声明pc:content action= lists cache=3600 num=20 page=$page /pcPC标签必须以pc开头，并以/pc结尾的代码片段。当然不以/pc结尾并不会引起程序致命性的错误，导致程序无法继续运行。以下为两种可能会出现的问题：1 .当网页中出现两个PC标签时，可能会使得没有闭合的PC标签之后的PC标签数据和其混乱。2.在后台可视化编辑时，可能出现网页结构错乱的问题。PCPC标签分析：PC标签中pc:冒号之后跟随的为模块名。如上面的例子中调用的是内容模型的PC标签。action=list这个形式所代表的是

24、参数。每一个PHPCMS V9模型都为其PC标签定义了调用的参数。其中有一些调用参数是系统保存的参数，其对所有的PC标签都是有效的。参数必须使用参数名=参数值的方式填写，多个参数之间使用空格分开如下例，参数值可使用双引号来包括，无论是 什么形式的引号都必须是成对出现的。pc:content参数名=参数值参数名=参数值参数名=参数值请查看PC标签保存参数相关章节，以了解具体保存参数及其用途。PCPC标签分类:PC标签包含两个类别，分别为:1 .工具类2.模块类工具类，大体上可以理解为PHPCMS V9所提供的一些工具箱。请查看PC标签工具箱相关章节，以了解更多关于工具类的PC标签的更多信息。而模

25、块类，是PHPCMS V9各个模型提供应大家调用模块数据的数据接口。查看具体模块的相关说明章节，以了解更多关于模块类的PC标签的更多信息。如何显示PCPC标签中的数据：默认情况下PC标签中的数据都是数组方式返回的，你都可以通过$data来获取到这个数 组，如果你在PC标签中定义了return参数，返回的数组将使用return的值进行命令。一般情况下你可以使用如下的方式来显示值：loop $data $key $val $val title /loop基中的$valurl和$valtitle需要具体根据所使用的PC标签，返回的数据来判断。PCPC标签保存参数下表为PC标签保存参数表，几乎所有的P

26、C标签都支持这些保存参数设置变量名默认值说明actionnull本参数的值表示为操作事件，模型类PC标签必须使用包含本参数， 以 说明要进行的操作。cache0缓存存储时间单位秒num20获取记录的条数，最后会被模板引 擎处理成limit传送到处理函数中。pagenull当前分页。一般填写为$_GETpageurlrulenullURL规贝Ureturndata返回数据变量名下例中是一个完整的使用例子。pc:content action =lists catid =25 num=20 page=$_GETpage return=dataloop $data $n $r $rtitle/loop

27、/pcgetget标签GET标签源自于PHPCMS 2021版，其使用SQL语句直接获取数据的特性，成为大家制作 模板的首选。在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标签所支持的参数。对照下面的列表了解每一个参数的用途：参数默认值必须说明sqlnull是要执行的SQL语句cach

28、e0否缓存时间，单位为秒page0否分页，通过变量把当前的分布传给PC标签进行处理dbsourcenull否数据源，当你通过系统后台的数据源模块配置过数据源时，可把数据源名填写到这里，系统会去对应的数据 本系统的数据请留空return data否返回的数据的变量内容模块内容模块PC标签调用说明模块名：contentcontent模块提供的可用操作操作名说明lists内容数据列表relation内容相关文章hits内容数据点击排行榜category内容栏目列表position内容推荐位列表position操作说明如下:内容推荐位列表positionposition可用参数:参数名是否必须默认值说

29、明posid是null推荐位IDcatid否null调用栏目IDthumb否0是否仅必须缩略图order否null排序类型num是null数据调用数量代码例子:pc:content action=position posid=2 order=listorder DESC num=4loop $data $key $val $valtitle /loop/pc返回参数如下表:字段类型空默认注释titlechar(80)否1NULL推荐位标题urlchar否NULL推荐位链接地址inputtimeint(10)否NULL推荐位发布时间thumbchar是NULL推荐位缩略图其他不定是根据模型所设置

30、的参加到推荐位中字段名称内容列表listslists可用参数:参数名是否必须默认值说明catid否null调用栏目IDwhere否nullsql语句的where局部thumb否0是否仅必须缩略图order否null排序类型num是null数据调用数量moreinfo否0是否调用副表数据提醒：从PHPCMS V9 Beta 20211105版本开始支持moreinfo参数属性，本参数表示在返回数据的时候，会把副表中的数据也一起返回。 一个内容模型分为2个表，一个主表一个副表, 主表中一般是保存了标题、所属栏目等等短小的数据方便用于索引，而副表那么保存了大字段的数据，如内容等数据。在模型管理中新建

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返回参数如下表：O想要在

32、列表中调取副表的数据就需字段类型空默认注释titlechar(80)否NULL推荐位标题urlchar否NULL推荐位链接地址inputtimeint(10)否NULL推荐位发布时间thumbchar是NULL推荐位缩略图其他不定是其他模型字段点击排行榜hitshits可用参数：参数 名 是否必 须默认 值说明catid否null调用栏目IDday否0调用多少天内的排行order否否null排序类型本月排行-monthviews DESC、本周排行-weekviews DESC、今日排行- dayviews DESCnum是null数据调用数量代码例子：pc:content action=hi

33、ts catid=2 order=weekviews DESC num=10loop $data $key $val $valtitle /loop/pc返回参数如下表:字段类型空默认注释titlechar(80)否NULL推荐位标题urlchar否NULL推荐位链接地址inputtimeint(10)否NULL推荐位发布时间thumbchar是NULL推荐位缩略图其他不定是其他模型字段相关文章relationrelation可用参数:参数名是否必须默认值说明catid否null调用栏目IDrelation否$relation无需更改keywords否null内容页面取值：$rskeyword

34、snum是null数据调用数量代码例子：pc:content action =relation relation =$relation catid=$catid num=5keywords =$rskeywords loop $data $r $rtitle( date(Y-m-d ,$rinputtime )/loop/pc返回参数如下表:字段类型空默认注释titlechar(80)否NULL推荐位标题urlchar否NULL推荐位链接地址inputtimeint(10)否NULL推荐位发布时间thumbchar是NULL推荐位缩略图其他不定是其他模型字段栏目列表(category)cate

35、gory)可用参数:参数名是否必须默认值说明catid否0调用该栏目下的所有栏目，默认0,调用一级栏目$siteid否1默认调用系统站点order否null排序方式、一般按照listorder ASC排序，即栏目的添加顺序代码例子:pc:content action =category catid=0 num=25 siteid=$siteid order=listorder ASC loop $data $r $rcatname /loop/pc返回参数如下表:字段类型默认值说明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栏目内容数hitsint(10)0点击数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,由于接口文件的变动，所以会导致一些无法同行问题。现给出如下解决方案：第一步：确定你的PHPCMS PHPSS以本为最新版v9.1.7(20210909)。注：截 至发此文章时间最新版为该版本。第二步：使用新的uc_client文件，翻开phpsso_serverapi目录修改原uc_client目录名称为uc_client.1.5.1,然后将下面文件曲压后覆盖到该目录下。uc_client.rar(41.12 KB)第三步：使用下面文件覆盖phpsso_serverphpcmsli