PbootCMS二次开发文档

目录结构

|-apps    #应用目录
|    |-admin    #后台
|    |-api      #API接口
|    |-common   #公共目录
|    |-home     #前台
|-config    #配置
|    |-config.php    #系统配置
|    |-database.php    #数据库配置
|    |-route.php    #自定义路由配置
|-core    #框架核心
|-data    #sqilte数据库存储位置
|-runtime    #运行时目录
|-static    #静态资源目录
|-template    #模板文件夹目录
|-admin.php    #后台入口
|-api.php    #API接口入口
|-index.php    #前台入口

系统常量

1、模型

模型命名空间：app\home\model,以app开头，home为当前应用名，以model结尾；

用户应用模型应继承core\basic\Model类；

例如：

class TodoModel extends Model
{
......
}

2、控制器

控制器命名空间：app\home\controller;以app开头，home为当前应用名，以controller结尾；

用户控制器应继承core\basic\Controller类；

例如：

class TodoController extends Controller
{
......
}

2.1、控制器空方法

_empty()，当无法匹配到方法时自动调用。

2.2、继承应用控制基类中的方法介绍

函数库文件

|-core/function
| |-file.php //数据处理
| |-handle.php //公共函数
| |-helper.php //助手函数

1.1、数据处理

1.2、公共函数

1.3、助手函数

1、数据库操作执行

1.1、通过Db类操作

//静态方式
//执行连贯操作方法
Db::table('ay_user')->select()
//执行原生操作方法
Db::all('select * from ay_user')
//对象方式
$db = new Db();
//执行连贯操作方法
$db->table('ay_user')->select()
//执行原生操作方法
$db->all('select * from ay_user')

可用于模板中加载数据，例如：

{php}
//获取友情链接
Db::table('ay_link')->select()
{/php}

2、数据库连贯操作

3、连贯操作终极方法

直接输出

嵌套输出

好了，接下来我们手摸手来写一个完整 MVC 结构文件。

1、前端

1.1、准备工作

伪静态操作这里就不赘述了；

设计好业务需求所需的数据库结构；

假设我们需要做一个会员投稿（Contribution）；

会员投稿流程就是发布文章到指定的栏目，只是一般状态设置成不显示，然后管理员审核后将状态设置为显示；（深入的业务需求请自行涉及补充）

1.2、创建模型

文件创建路径：apps/home/model/；在该目录下新建文件：ContributionModel.php

<?php
namespace app\home\model;

use core\basic\Model;

class ContributionModel extends Model{
//具体数据库操作方法请自行处理
}

注意细节：

1、命名空间，前面有提到，app开头，当前应用，一般前端就是home，model结尾

2、引入 Controller 基类，让ContributionModel继承Model

1.3、创建控制器

文件创建路径：apps/home/controller/；在该目录下新建文件：ContributionController.php

<?php
namespace app\home\controller;

use core\basic\Controller;
use app\home\model\ContributionModel;
use core\basic\Url;

class CartController extends Controller
{

protected $parser;

protected $model;

protected $htmldir;

public function __construct()
{
// 未登录时跳转到用户登录
if (! session('pboot_uid')) {
location(Url::home('member/login'));
}
$this->model = new ContributionModel();
$this->parser = new ParserController();
$this->htmldir = $this->config('tpl_html_dir') ? $this->config('tpl_html_dir') . '/' : '';
}

public function index(){
$content = parent::parser($this->htmldir . 'member/article_list.html'); // 框架标签解析
$content = $this->parser->parserBefore($content); // CMS公共标签前置解析
$content = str_replace('{pboot:pagetitle}', '我的文章列表', $content);
$content = $this->parser->parserPositionLabel($content, 0, '我的文章列表', Url::home('member/index')); // CMS当前位置标签解析
$content = $this->parser->parserSpecialPageSortLabel($content, - 4, '我的文章列表', Url::home('member/index')); // 解析分类标签
$content = $this->parser->parserAfter($content); // CMS公共标签后置解析
echo $content;
exit();
}

//其他功能自行补充，本文主要讲的是如何创建功能模块
}

注意细节：

1、命名空间，前面有提到，app开头，当前应用，一般前端就是home，controller结尾

2、引入 Model 基类，让ContributionController继承Controller

3、引入上一步创建好的ContributionModel模型，在__construct中进行实例化

4、该功能仅登陆后可用，在__construct中加入登陆状态判断

5、在模板文件夹template/default/html/member/中创建article_list.html文件，该文件即为我的文章列表功能所对应的视图文件。

2、后端

文件地址：apps/common/route.php；打开文件，在该文件中预先写好路由配置。

官方推荐将路由写在config/route.php文件中，升级不会被覆盖。

例如：

// 商城模块
'admin/ShopCategory' => 'admin/shop.ShopCategory',
'admin/Goods' => 'admin/shop.Goods',
'admin/Order' => 'admin/shop.Order',
'admin/Payment' => 'admin/shop.Payment',

我在会员模块下方增加了几个新功能的路由。

另外注意的一个细节就是，后端无需接入parser，直接显示视图文件即可。

例如：

<?php
namespace app\admin\controller\member;

use core\basic\Controller;
use app\admin\model\member\AuditModel;

class AuditController extends Controller
{

    private $model;

    public function __construct()
    {
        $this->model = new AuditModel();
    }

    // 审核列表
    public function index()
    {
        //准备页面所需数据
        ......
        //直接显示模板文件
        $this->display('member/audit.html');
    }
}