安装准备

一、确认帝国的版本是否为 7.5（UTF8）
二、确认PHP的版本必须大于5.4

目录说明

下载后的插件共两个目录 e 和 ecmsapi

核心目录为 ecmsapi 放置于帝国程序的根目录。
接口管理插件为 e/admin/ecmsapi 目录。其中admin目录为你后台目录，请自行修改。

安装步骤

一、将解压后的两个目录，复制到帝国根目录。（e目录中的admin文件夹请改名为后台目录）

二、设置以下几个目录的权限为可写。

• ecmsapi/_cache/
• ecmsapi/_mod/
• ecmsapi/_common/
• ecmsapi/_temp/

三、在后台添加扩展菜单，步骤如下：

到此安装完成。

卸载插件

简单粗暴的删除安装时的两个目录即可。（/ecmsapi/和/e/admin/ecmsapi/）

开发需求

1、获取新闻模型中最新的10条新闻
2、获取指定用户发布的新闻，每页显示10条

模块管理

进入插件管理页面，点击右上角的添加模块

添加成功后可以看到

点击后面的管理按钮或者模块名称，进入当前模块下的接口管理

接口管理

点击右上角的添加接口

代码区什么都不写，直接保存。提示成功，表示一个接口已添加完成。下面开始书写接口功能。

书写接口代码

附上具体代码：

<?php
// 禁止用户直接访问口文件
defined("ECMSAPI_MOD") or exit;  

// 获取最新发布的10篇新闻，参数具体说明请查看详细文档
$list = $api->load('db')->select('[!db.pre!]ecms_news' , '*' , '1' , '10,1' , 'id desc');

// 构造输出结构
$result = [
    'code' => 1,
    'list' => $list
];

// 输出json数据
$api->json($result);

第一个接口功能开发完毕。

通过参数，获取指定会员发布的新闻

我们再在当前模型下新建一个接口，接口名称为：usernews

接口代码如下：

<?php
// 禁止用户直接访问口文件
defined("ECMSAPI_MOD") or exit;

// 获取参数 自动获取GET或POST参数
$uid = $api->param('uid' , 0 , 'intval');  // 获取用户ID，并格式化为数字
$page = $api->param('page' , 1 , 'intval'); // 获取页码，并格式化为数字
$page = $page > 0 ? $page : 1;  // 页码应该从1开始，简单处理一下

// 获取指定用户ID的10篇新闻，参数具体说明请查看详细文档
$list = $api->load('db')->select('[!db.pre!]ecms_news' , '*' , 'userid='.$uid , '10,'.$page , 'id desc');

// 构造输出结构
$result = [
    'code' => 1,
    'list' => $list
];

// 输出json数据
$api->json($result);

点击预览，浏览器输出结果是：

{"code":1,"list":[]}

为什么会没有数据？因为默认的预览是不会添加任何的参数。你可以尝试在预览的地址中添加uid与page参数如：

你的域名/ecmsapi/index.php?mod=news&act=usernews&uid=1&page=1

模块分享

我们自己制作的接口如何分享给或出售给他人使用？

很简单，拿我们刚制作的接口为例。我们制作完接口后，只需要打开 /ecmspai/_mod/目录，找到news文件夹。然后复制整个news文件夹发送给他人即可。

安装模块

从他人那获取到的模块，直接将模块目录（目录名称可以任意修改）上传到/ecmspai/_mod/目录即可。