Download presentation
Presentation is loading. Please wait.
1
PHPCMS 使用指南及二次开发向导
2
PHPCMS V9 介绍 PHPCMS V9 后台功能 PHPCMS V9 结构设计 PHPCMS V9 核心文件说明 PHPCMS V9 二次开发 PHPCMS V9 模板与标签
3
PHPCMS V9(后面简称V9)采用PHP5+MYSQL做为技术基础进行开发。V9采用OOP(面向对象)方式进行基础运行框架搭建。模块化开发方式做为功能开发形式。框架易于功能扩展,代码维护,优秀的二次开发能力,可满足所有网站的应用需求。 5年开发经验的优秀团队,在掌握了丰富的WEB开发经验和CMS产品开发经验的同时,勇于创新追求完美的设计理念,为全球多达10万网站提供助力,并被更多的政府机构、教育机构、事业单位、商业企业、个人站长所认可。 V9在保留2008版的特点的同时,对新版本作出重大的创新,以期待全新的PHPCMS系统服务更多的用户。
4
PHPCMS V9 介绍 PHPCMS V9 后台功能 PHPCMS V9 结构设计 PHPCMS V9 核心文件说明 PHPCMS V9 二次开发 PHPCMS V9 模板与标签
5
后台登录地址:
6
Phpcms v9后台主页面
7
Phpcms v9后台主要功能选项
8
Phpcms v9后台内容管理
9
Phpcms v9后台文章发布
10
PHPCMS V9 介绍 PHPCMS V9 后台功能 PHPCMS V9 结构设计 PHPCMS V9 核心文件说明 PHPCMS V9 二次开发 PHPCMS V9 模板与标签
11
根目录 | – api 结构文件目录 | – caches 缓存文件目录 | – configs 系统配置文件目录 | – caches_* 系统缓存目录 | – phpcms phpcms框架主目录 | – languages 框架语言包目录 | – libs 框架主类库、主函数库目录 | – model 框架数据库模型目录 | – modules 框架模块目录 | – templates 框架系统模板目录 | – phpsso_server phpsso主目录 | – statics 系统附件包 | – css 系统css包 | – images 系统图片包 | – js 系统js包 | – index.php 程序主入口
12
PHPCMS V9 介绍 PHPCMS V9 后台功能 PHPCMS V9 结构设计 PHPCMS V9 核心文件说明 PHPCMS V9 二次开发 PHPCMS V9 模板与标签
13
模块与控制器 模块: phpcms v9框架中的模块,位于phpcms/modules目录中 每一个目录称之为一个模块。即url访问中的m。
访问content模块示例: 控制器: phpcms v9的控制器就是模块的类文件,位于phpcms/modules/模块/目录下面。 类名成就是文件名+.php,例如一个名为abc的控制器,那么他的命名为abc.php即可。 控制器类默认继承系统的函数库,可以直接使用。控制器类的类名称与控制器文件名必须相同。 如果您创建了一个abc.php在test模块下,那么我们在浏览器里面输入URL:
14
二次开发技巧 如果要对已存在的控制器进行二次开发,为了方便升级不建议直接对内核文件直接修改该,您可以通过“MY_*.php”的形式进行二次开发。 例如您要对改phpcms/mood/index.php进行二次开发。您可以在与index.php同级的目录下建立"MY_index.php" <?php class MY_index extends index{ function __construct() { parent::__construct(); } ……your code } 这样当您通过url访问index控制器的时候,系统会默认指向MY_index.php 并且原文件的方法将被继承,可以直接使用。
15
系统配置文件 文件路径:根目录/caches/configs database.php 数据库配置文件 system.php 系统配置文件
route.php 路由配置文件 调用方法 如调用系统配置中的web_path: pc_base::load_config('system', web_path ');
16
CMS入口文件: PHPCMS是采用MVC设计模式开发,基于模块和操作的方式进行访问,采用单一入口模式进行项目部署和访问,无论访问任何一个模块或者功能,只有一个统一的入口。 入口程序是在前期处理用户请求的引导程序。它是唯一一个可以被最终用户可以直接请求运行的。 文件路径:根目录/index.php <?php define('PHPCMS_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR); include PHPCMS_PATH.'/phpcms/base.php'; pc_base::creat_app(); ?> 这段代码首先加载了 phpcms 框架的引导文件 base.php,然后它根据指定的配置文件建立了一个 Web 应用实例并运行。
17
PHPCMS框架入口文件: 文件路径:根目录/phpcms/base.php 代码片段如下: <?php
define('IN_PHPCMS', true); define('PC_PATH', dirname(__FILE__).DIRECTORY_SEPARATOR); if(!defined('PHPCMS_PATH')) define('PHPCMS_PATH', PC_PATH.'..'.DIRECTORY_SEPARATOR); define('CACHE_PATH', PHPCMS_PATH.'caches'.DIRECTORY_SEPARATOR); ... … … ?> 该文件为框架入口文件,包含实例化系统/模块类方法,调用系统/模块方法,系统常用常量等。如: pc_base::load_model(‘*_model’) 加载数据库模型 pc_base::load_sys_class(‘classname’) 实例化系统类 pc_base::load_app_class(‘classname’,’admin’) 实例化模块类 pc_base::load_sys_func (‘funcfile’) 调用系统函数库
18
全局函数文件: 文件路径:根目录/phpcms/libs/functions/global.func.php 代码片段如下:
function new_addslashes($string){ if(!is_array($string)) return addslashes($string); foreach($string as $key => $val) $string[$key] = new_addslashes($val); return $string; } ... … … ?> 该文件中的函数,为全系统基础函数,可以在系统中直接调用。 二次开发技巧: 如果需要增加自己的全局函数,可根据需要增加到/phpcms/libs/functions/global.func.php/extention.func.php中 不会影响升级
19
数据模型基类: 文件路径:根目录/phpcms/libs/classes/model.class.php 代码片段如下: <?php
pc_base::load_sys_class('db_factory', '', 0); class model { //数据库配置 protected $db_config = ''; //数据库连接 protected $db = ''; //调用数据库的配置项 protected $db_setting = 'default'; //数据表名 protected $table_name = ''; //表前缀 public $db_tablepre = ''; ... … … ?> 加载数据模型后,可以的数据库该类中方法进行数据库操作。
20
表单调用类: 文件路径:根目录/phpcms/libs/classes/form.class.php。 代码片段如下: <?php
class form { //编辑器调用 public static function editor($textareaid = 'content', $toolbar = 'basic', $module = '', $catid = '', $color = '', $allowupload = 0, $allowbrowser = 1,$alowuploadexts = '',$height = 200,$disabled_page = 0) { } //图片上传调用 public static function images($name, $id = '', $value = '', $moudle='', $catid='', $size = 50, $class = '', $ext = '', $alowexts = '',$thumb_setting = array(),$watermark_setting = 0 ) { } ... … … ?> 通过实例化该类可以,调用在程序中调用编辑器、表单上传、日期选择、栏目结构等表单。 实例化方法:pc_base::load_sys_class('form', '', 0);
21
模板解析缓存类: 文件路径:根目录/phpcms/libs/classes/template_cache.class.php 。 代码片段如下: <?php final class template_cache { public function template_compile($module, $template, $style = ‘default’) { $tplfile = $_tpl = PC_PATH.'templates'.DIRECTORY_SEPARATOR.$style.DIRECTORY_SEPARATOR.$module.DIRECTORY_SEPARATOR.$template.'.html'; ... … … ... … … ?> 该类作用为解析模板,解析模板及更新模板缓存
22
PHPCMS V9 介绍 PHPCMS V9 后台功能 PHPCMS V9 结构设计 PHPCMS V9 核心文件说明 PHPCMS V9 二次开发 PHPCMS V9 模板与标签
23
PHPCMS URL访问: 参数名称 描述 位置 备注
PHPCMS是采用MVC设计模式开发,基于模块和操作的方式进行访问,采用单一入口模式进行项目部署和访问,无论访问任何一个模块或者功能,只有一个统一的入口。 参数名称 描述 位置 备注 M 模型/模块名称 phpcms/modules中模块目录名称 必须 C 控制器名称 phpcms/modules/模块/*.php 文件名称 A 事件名称 phpcms/modules/模块/*.php 中方法名称 模块访问方法[示例]: 模型/模块名称 位于phpcms/modules/content 控制器名称 位于phpcms/modules/content/index.php 事件名称 位于phpcms/modules/content/index.php 中show()方法
24
二次开发命名规范 类文件需要以.class.php为后缀(这里是指的phpcms的系统类库文件和模块中的类库文件,第三方引入的不做要求),例如http.class.php。 函数文件需要以.func.php为后缀(第三方引入的不做要求),例如mail.func.php。 类名和文件名一致,例如 phpcmsapp类的文件命名是phpcmsapp.class.php。 数据模型需要以“数据表名称_model.class.php”为形式,类名称与文件名必须相同。
25
创建数据库和数据表(如数据库操作可略过)
二次开发开发流程 创建数据库和数据表(如数据库操作可略过) 创建模块目录 开发模块控制器类 开发模块类与模块函数(如无可略过) 创建模板文件(如前台显示可略过) 运行和调试
26
创建数据库模型类 数据库模型位于:phpcms/model/目录下。
数据模型文件的命名规则建议为数据表名称+'_model.class.php' 如果在我们的创建的模块中我要使用一个数据库“test”,首先需要建立一个数据库模型文件,文件名称为'test_model.class.php' <?php defined('IN_PHPCMS') or exit('No permission resources.'); pc_base::load_sys_class('model', '', 0); class test_model extends model { public function __construct() { $this->db_config = pc_base::load_config('database'); $this->db_setting = ‘default'; $this->table_name = 'test'; parent::__construct(); } } ?> 数据库模型类名称必须与文件名称相同; $this->db_setting = 'default'为数据库配置文件中配置数据库链接池名称,默认为default,一般情况下不需要修改。 $this->table_name = ‘test’为数据表名称
27
创建模块 如果要创建一个模块,只要在 phpcms/modules 目录下创建文件夹并放入你的控制器类就可以了。
例如要开发一个叫做test的模块,那么首先在phpcms/modules 目录下创建文件夹,并将其命名为test。模块的标准结构通常是这样的。 如果您的模板有单独的前台模板,你需要在phpcms/templates/default下创建一个您的模块目录来放置前台模板,"default"为你的风格包名称,我们默认适用default 访问test模块示例:
28
创建模块控制器类 为test模块增加一个名为myest的控制器 文件路径:根目录/phpcms/modules/test/mytest.php。 代码片段如下: <?php defined('IN_PHPCMS') or exit('No permission resources.'); class mytest { function __construct() { } public function init() { $var = 'hello world!'; echo $myvar; public function mylist() { $var = 'hello world!this is a example!'; } ?>
29
常用操作列表(1) 1.调用数据库模型 $this->db = pc_base::load_model('test_model');
其中$this->db中所支持的方法请参照phpcms/libs/classes/model.class.php中方法 2.加载系统类 $http = pc_base::load_sys_class('http'); //实例化http类 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(‘global‘,’test’); 调用test模块的global函数包
30
常用操作列表(2) 6.加载前台模板 include template('test', 'mytest', 'default');
7.加载后台模板 include $this->admin_tpl('mytest_admin_list'); 8.权限控制 后台控制控制器需要加载admin模块下的admin类,并继承该类 <?php defined('IN_PHPCMS') or exit('No permission resources.'); pc_base::load_app_class('admin','admin',0); class mytest_admin extends admin { //这个控制器需要登录后台才可以访问 } ?>
31
PHPCMS V9 介绍 PHPCMS V9 后台功能 PHPCMS V9 结构设计 PHPCMS V9 核心文件说明 PHPCMS V9 二次开发 PHPCMS V9 模板与标签
32
{pc:content action="lists" cache="3600" num="20" page="$page“}{/pc}
评论模块 会员模块 友情链接模块 投票模块 公告模块 专题模块 内容模块 …. … {pc:content action="lists" cache="3600" num="20" page="$page“}{/pc} 工具箱 json工具箱 xml工具箱 get标签 碎片工具箱 {pc:json url="
33
Thank you!
Similar presentations