苹果cms二次开发自定义API教程
苹果CMS后台自带API功能，可以为前端页面提供部分影视数据，但在实际开发过程中，默认API的功能有时无法满足特定业务需求。这种情况下，可以根据网站的实际需求自定义API接口。常见的实现方式主要有两种：创建API控制器，以及通过模板自定义PHP功能实现接口。
第一种方法：新增API控制器
第一种方式是直接在苹果CMS的API控制器目录中创建自定义控制器。进入 APPlication/api/controller 目录，新建一个 Test.php 文件。
注意：控制器文件名建议使用大写字母开头，例如 Test.php。ThinkPHP 5 的控制器命名和自动加载规则对文件名及类名有对应要求，因此不要随意修改大小写。
创建Test.php控制器
<?php
namespace app\api\controller;
use think\Controller;
use think\Cache;
class Test extends Base
{
var $_param;
```
public function __construct()
{
parent::__construct();
$this->_param = $this->request->param();
}
public function index()
{
$data = [];
$list = ['code' => 0, 'data' => $data];
return json($list);
}
```
}创建控制器后，即可通过类似 域名/api.php/test 的地址访问该接口。此时只是完成了API控制器的基本创建，实际项目中通常还需要在控制器中调用苹果CMS数据库中的影视、分类等数据。
调用影视数据
例如，可以根据分类ID、页码和每页数量查询影视数据，并将查询结果以JSON格式返回。
$lp = $this->request->param(); // 请求参数
$where = [];
$where['type_id'] = $lp['type']; // 分类ID
$order = 'vod_time desc'; // 排序
$page = $lp['page']; // 页数
$limit = $lp['num']; // 每页数量
$data = model('Vod')->listData($where, $order, $page, $limit);
$list = ['code' => 0, 'data' => $data];
return json($list);配置完成后，可以通过GET请求传递分类、页码和数量等参数，例如：
http://www.xxx.com/api.php/test?type=1&page=1&num=20
接口会根据请求参数查询对应的影视数据，并返回JSON结果。实际使用时，也可以根据项目需求改为POST请求，并增加参数验证、权限验证等处理。
第二种方法：通过模板自定义PHP功能
如果不希望单独创建API控制器，也可以利用苹果CMS模板中的PHP功能实现简单的数据接口。这种方式更适合接口逻辑比较简单、主要用于模板或前端数据调用的场景。
第一步：引入自定义PHP文件
首先，在全局引入的 include.html 模板文件中加入以下代码，用于加载自定义PHP函数文件：
{php}require MAC_ROOT_TEMPLATE . 'php/function.php'{/php}第二步：创建function.php
接着，在模板目录中创建 php 文件夹，并在其中创建 function.php 文件。
<?php
function vod()
{
$param = input();
```
$param['page'] = intval($param['page']) < 1 ? 1 : intval($param['page']);
$param['limit'] = intval($param['limit']) < 20 ? 20 : intval($param['limit']);
$where = [];
$where['vod_type'] = $param['type'];
$order = 'vod_time desc'; // 排序
$res = model('Vod')->listData(
$where,
$order,
$param['page'],
$param['limit']
);
return json($res['list']);
```
}上面的 vod() 函数会读取请求参数，并根据 type、page 和 limit 参数查询影视数据，最后将查询结果转换为JSON格式返回。
第三步：创建API模板页面
然后在自定义标签模板目录中创建 api.html 文件，用于执行接口功能。
{include file="public/include"}也可以直接在模板页面中引入自定义PHP文件并执行对应函数：
{php}require MAC_ROOT_TEMPLATE . 'php/function.php'{/php}
{:vod()}访问自定义接口
完成配置后，可以通过以下地址访问自定义接口：
http://www.xxx.com/index.php/label/api.html?type=1&page=1&limit=20
访问后，模板页面会执行 vod() 函数，并将查询到的影视数据以JSON格式输出，从而实现一个简单的自定义数据接口。
两种苹果CMS自定义API方式对比
API控制器：适合开发独立、功能较完整的API接口，便于后续扩展参数验证、权限控制和不同数据接口。
模板PHP功能：实现方式相对简单，适合快速创建简单的数据输出接口。
数据查询：两种方式都可以调用苹果CMS模型获取影视数据，具体查询条件可以根据业务需求进行调整。
接口安全：如果接口对外公开使用，建议增加参数校验、访问频率限制以及必要的权限验证，避免接口被恶意调用。
苹果CMS自定义API注意事项
自定义API涉及程序控制器、模板PHP以及数据库模型调用，修改前建议先备份相关文件。尤其是直接修改系统目录或控制器文件时，应注意苹果CMS版本差异，避免不同版本之间出现类名、命名空间或模型方法不兼容的问题。
同时，接口返回的数据格式应尽量保持统一，例如统一使用JSON格式，并根据实际业务设置状态码、数据列表和分页信息，这样更方便APP、前端页面或其他程序进行调用。
总结
苹果CMS自定义API主要可以通过新增API控制器和模板自定义PHP功能两种方式实现。前者更加适合独立API开发，后者则适合快速实现简单的数据接口。根据实际项目需求选择合适的方式，并做好参数校验和接口访问控制，可以让自定义API更加稳定和安全。