php笔记之：初探PHPcms模块开发介绍

PHP笔记之：初探PHPcms模块开发介绍

什么是PHPcms模块？

PHPcms模块是基于PHPcms系统的一个插件模块，可以扩展PHPcms的功能。通常包括“前台模块”、“后台模块”和“标签库”三个部分。

开发环境搭建

要开发PHPcms模块，需要搭建好开发环境，通常需要以下工具和软件：

• PHP开发环境（建议使用PHP 7.0及以上版本）
• PHPcms代码库
• 编辑器（如Sublime Text、PhpStorm等）
• 浏览器（建议使用Google Chrome）

在安装好PHP和PHPcms之后，可以使用编辑器打开PHPcms的代码库，进入/modules/目录，新建一个目录来存放自己的模块。

前台模块

前台模块是用户访问网站时看到的页面模块，通常包括首页面、列表页、文章页等。以下是一个简单的前台模块示例：

<?php

defined('IN_PHPCMS') or exit('Restricted Access');

function content_{$catid}() {
    $id = isset($_GET['id']) ? intval($_GET['id']) : 0;
    $article = get_article_by_id($id);
    include template('module_name', 'article');
}

function content_list() {
    $page = isset($_GET['page']) ? intval($_GET['page']) : 1;
    $articles = get_articles_by_page($page);
    include template('module_name', 'list');
}

?>

在这个示例中，我们定义了一个名为module_name的前台模块。模块中定义了两个方法，content_list和content_{$catid}。其中，content_list用来显示文章列表，content_{$catid}用来显示指定文章。

对于文章列表和文章详情，我们都需要从数据库中获取数据，并定义对应的视图。这里我们使用了get_articles_by_page和get_article_by_id两个方法来获取文章数据，并使用template方法来加载对应的视图模板。

后台模块

后台模块是内容管理者登录后看到的页面，可以对网站内容进行添加、修改、删除等操作。以下是一个简单的后台模块示例：

<?php

defined('IN_PHPCMS') or exit('Restricted Access');

class admin_module_name {
    function __construct() {
        $this->db = pc_base::load_model('module_name_model');
    }

    function init() {
        // 显示后台首页
        include $this->admin_tpl('index');
    }

    function article_list() {
        // 获取文章列表，并显示对应的视图
        $articles = $this->db->select();
        include $this->admin_tpl('article_list');
    }

    function article_add() {
        // 添加文章
        if (isset($_POST['dosubmit'])) {
            $data = $_POST['data'];
            $data['addtime'] = time();
            $this->db->insert($data);
            showmessage('文章添加成功');
        }
        include $this->admin_tpl('article_add');
    }

    function article_edit() {
        // 编辑文章
        if (isset($_POST['dosubmit'])) {
            $data = $_POST['data'];
            $this->db->update($data, array('id'=>$_GET['id']));
            showmessage('文章更新成功');
        }
        $id = intval($_GET['id']);
        $article = $this->db->get_one(array('id'=>$id));
        include $this->admin_tpl('article_edit');
    }

    function article_delete() {
        // 删除文章
        $id = isset($_POST['id']) ? intval($_POST['id']) : 0;
        $this->db->delete(array('id'=>$id));
        showmessage('文章删除成功');
    }

    function get_menu() {
        // 返回后台菜单
        return array(
            array('name'=>'文章管理', 'action'=>'article_list'),
            array('name'=>'添加文章', 'action'=>'article_add'),
        );
    }

    function admin_tpl($file) {
        // 解析后台模板文件路径
        return PC_PATH.'modules/module_name/templates/admin/'.$file.'.tpl.php';
    }
}

?>

在这个示例中，我们定义了一个名为admin_module_name的后台模块。模块中定义了几个方法，包括init、article_list、article_add、article_edit和article_delete。

在init方法中，我们显示了后台首页。在article_list方法中，我们获取文章列表，并使用template方法来加载对应的视图模板。在article_add和article_edit方法中，我们分别提供了添加和编辑文章功能，并在完成相应的操作后向用户反馈信息。在article_delete方法中，我们提供了删除文章的功能。

此外，我们还定义了get_menu方法，用来返回后台菜单列表，并提供了admin_tpl方法，用来解析后台模板文件路径。

标签库

标签库是将常用的模块功能封装成一个标签，方便用户直接调用。以下是一个简单的标签库示例：

<?php

defined('IN_PHPCMS') or exit('Restricted Access');

class tag_module_name {
    function __construct() {
        $this->db = pc_base::load_model('module_name_model');
    }

    function lists($data) {
        // 获取文章列表，并返回结果
        $articles = $this->db->select();
        return $articles;
    }

    function get_article($data) {
        // 获取指定文章，并返回结果
        $id = isset($data['id']) ? intval($data['id']) : 0;
        $article = $this->db->get_one(array('id'=>$id));
        return $article;
    }
}

?>

在这个示例中，我们定义了一个名为tag_module_name的标签库。标签库中定义了两个方法，分别是lists和get_article。

在lists方法中，我们获取文章列表，并将结果返回。在get_article方法中，我们根据传入的参数获取指定文章，并将结果返回。

结语

通过以上三个部分的介绍，相信大家已经了解了如何开发一个PHPcms模块。当然，具体的开发过程还需要根据实际需要进行调整和实现。在编写模块代码时，一定要注意安全性，避免出现漏洞。