苹果CMS指南

新增独立API控制器

该方案适合正式对外接口,扩展性强,方便增加鉴权、参数校验逻辑。在 application/api/controller 目录新建控制器文件,文件名首字母大写,适配ThinkPHP5自动加载规则。

基础控制器示例

<?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,在此基础上调用模型读取影视数据。

影视列表查询代码

$lp = $this->request->param();

$where = [];
$where['type_id'] = $lp['type'];

$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);

请求示例:shturl.cc/nPTAKLIYET9O6n9NuS6rJVxTPx4vr8Ptdr4DeJqDRp,可按需改成POST提交,补充权限校验。

模板内嵌PHP实现简易接口

适合轻量、内部调用的简单接口,不用新增控制器,依托模板引擎运行。

在公共引入模板include.html加载自定义函数文件:

{php}require MAC_ROOT_TEMPLATE . 'php/function.php'{/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']);
}

新建模板api.html,写入调用代码:

{include file="public/include"}
{php}require MAC_ROOT_TEMPLATE . 'php/function.php'{/php}
{:vod()}

访问示例:shturl.cc/4SgE2Srq4levBGXpyB6uzpr7WVJJggfsSYMhR4OcFhnpTpWdn5QAlZjH

两种实现方式对比

  • API控制器:适合独立对外接口,方便增加鉴权、限流,后期维护更清晰;

  • 模板PHP方案:上手快,适合简单数据输出,不适合复杂对外服务;

  • 两种方式都可以调用系统Vod模型读取影视数据,查询条件自由调整;

  • 对外公开接口必须增加参数过滤、访问限制,防止恶意刷取。

开发注意事项

修改前备份相关文件,不同版本的苹果CMS模型、类结构存在差异,避免代码不兼容。统一返回JSON格式,规范状态码、分页字段,方便APP、前端页面对接。