果创云支持对云函数进行在线接口编程，进入开放平台我的接口 - 在线接口编程，设计一个新接口，设计和配置好接口参数、接口名称、接口返回后，再把云函数源代码填上，提交审核通过并发布后即可利用。
云函数编写入口：在线接口编程。
云函数具有以下特点和上风：
云函数由开拓者自己编写，发布后可天生自己的云接口，即MyAPI，而云函数底层则依赖于果创云供应的根本做事。
因此，云函数整体架构如下：
整体架构分为四层：
第一层：MyAPI我的接口 供应给客户端调用的云接口。第二层：云函数。 由开拓者自己编写，可在线接口编程，编写云函数，天生接口。第三层：果创云聚合做事 由果创云供应，封装了常用的做事，可进行数据库、CURL、短信等做事操作。第四层：云做事 由第三方供应的云做事，包括但不限于自建数据库、云数据库、企业邮箱、短信接口、开放平台接口和内部接口等。云函数格式当前只支持PHP云函数，开拓者自定义的云函数，须要符合PHP语法。其云函数署名和云函数模板如下：
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); // TODO // 在这里编写你的详细业务 return $result;}云函数参数
云函数参数解释：
$params，类型：数组，为当前客户真个接口参数，由开拓者配置的接口参数和客户端动态通报的参数而定，例如：array('uuid' => null, 'left' => 1, 'right' => 2)$di，类型：数组，为DI容器，里面封装并供应了浩瀚强大而实用的PHP做事，例如数据库操作等，对付后端编程有非常大的帮助，后面会详细先容。获取接口参数如何获取客户端通报过来的接口参数？
在果创云开放接口参数配置，添加参数后，就可以在源代码中获取。如下：
假设，配置的接口参数名字为：abc，那么在PHP源代码中，获取接口参数的办法是从$params参数中获取，如：
$abc = $params['abc'];
参数名称和配置的接口名称同等。并且，此时获取的接口参数会根据配置的接口参数规则进行过滤、转换和检测。
温馨提示：接口会自动对客户真个参数进行校验、核对和转换，通过$params参数获取的是终极可用的参数。
云函数代码规范开头不须要<?php标签，结束不须要?>标签。你可以在本地调试好PHP代码函数，或者通过在线工具编写和运行你的PHP代码。
特殊把稳以下几点：
1、接口代码须要符合PHP语法，PHP语法可参考PHP 教程2、一些敏感的PHP函数和API接口会被禁用，例如读写本地文件、获取系统信息等。如何进行本地调试？ 在本地调试时，可以这样实行你的PHP代码。首先，创建一个PHP文件，例如：yesapi.php，然后在里面放置代码：
<?php$fun = function ($params, $di) { // 函数内的代码复制过来 $result = array('err_code' => 0, 'err_msg' => ''); $result['sum'] = $params['left'] + $params['right']; return $result;};// 仿照一些测试数据$params = array('left' => 1, 'right' => 2);// 实行函数，输出结果var_dump($fun($params, array()));// 输出结果 1+2=3array(3) { ["err_code"]=> int(0) ["err_msg"]=> string(0) "" ["sum"]=> int(3)}
即这样实行，通过CLI办法运行。
$ php ~/tmp/test.php array(3) { ["err_code"]=> int(0) ["err_msg"]=> string(0) "" ["sum"]=> int(3)}
温馨提示：在本地没有$di做事，可以利用空数组来代替，或进行仿照测试。
云函数运行结果如何返回接口结果呢？
以下是一个返回示例：
return array('err_code' => 0, 'err_msg' => '', 'title' => 'Hi, 欢迎利用果创云开放接口！
');
把稳，该当在函数的末了一行代码通过return关键字返回结果。结果的类型是数组，且应包括：err_code、err_msg这两个基本字段，以及其他须要自定义的返回字段。个中，约定err_code为0表示成功。
云函数示例以下是一个大略的例子，进行两个数的相加。
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $result['sum'] = $params['left'] + $params['right']; return $result;}
添加一个新接口，并进行编辑：
编写接口时，设置接口参数、接口返回、云函数代码等，如（局部截图）：
保存后，你可以看到类似这样的在线接口文档（部分截图）：
提交审核和发布
在完成接口设计和云函数开拓后，就可以勾选“申请发布”。等审核通过后即可发布和利用。
。
天生云接口和接口文档发布通过后，你就可以天生了自己的云接口，以及在线接口文档。
在线接口文档，可以供应给客户端开拓职员查看和接入利用；云接口可以供应给客户端进行调用。
天生的完全在线接口文档类似：
接口文档地址：
http://api.yesapi.cn/docs.php?service=SVIP.Sdogstar_MyApi.ATest&detail=1&type=fold
客户端调用后，就可以得到云函数实行后的结果。
编写好云函数后，会自动天生云接口，和接口文档。如果须要，也可以自己手动编写接口文档。
温馨提示：如果须要手动编写API接口文档，可以进入我的在线文档编辑，保存后可发布接口文档。
文档编辑后台：
保存后，外部查看的接口文档效果：
如何支持多个客户端接入？
如果须要支持多个客户端调用API接口，可以【客户端管理】，添加客户端运用，然后分配app_key和密钥。
云函数PHP开拓手册
以下通过代码示例和模板，先容云函数如何进行开拓，大家可以把代码复制过去，稍作修正。只须要简短的几行PHP代码，或者一段代码，你就实现自己的业务逻辑，无需管理做事器即可运行移动后端代码。
HIGHLIGHT 开拓须知在开始，以下是一些主要的知识点和把稳事变。
我的模型数据库操作请利用：$di['db']->模型英文名称_tbl，例如文章模型：$di['db']->article_tbl，后面要固定加上_tbl；直连数据库(MySQL/SQLServer等)操作请利用：$di['db_super']->数据库表完全名称，例如：$di['db_super']->article；利用前请配置接入你的数据库。再重复解释下，直连数据库和我的模型数据库操作一样，差异在于：直连数据库在利用前须要先配置接入你的数据库，DI做事利用$di['db_super']，末了须要填写完全的表名称，不须要额外的_tbl后缀。
DI做事一览DI做事 功能解释 备注 $di['db'] 我的模型数据库 可进行CURD数据库操作，针对单表 $di['db_super'] 直连数据库 可进行CURD数据库操作，针对单表，利用前须要进行MySQL数据库直连做事配置 $di['logger'] 日志做事 记录各种日志 $di['email'] 邮箱做事 发送邮件，利用前须要进行邮箱做事配置 $di['pinyin'] 拼音做事 将汉字转成拼音 $di['curl'] CURL做事 要求远程接口，仅支持80端口 $di['crypt'] 安全做事 对数据进行加密和解密 $di['sms_aliyun'] 阿里云短信 通过阿里云做事发送短信，利用前须要进行阿里云做事配置
云函数代码模板F1-1、两数相加function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $result['sum'] = $params['left'] + $params['right']; return $result;}
假设通报参数为：left=1&right=2，要求此云函数后，将会得到如下结果：
{ "ret": 200, "data": { "err_code": 0, "err_msg": "", "sum": 3 }, "msg": "V2.1.1 YesApi"}F1-2、数据库-获取模型总数
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $result['count'] = $di['db']->article_tbl->count('id'); // 模型名称后面须带上_tbl后缀 return $result;}
假设你有模型如下，有23条数据：
要求此云函数后，将会得到如下结果：
{ "ret": 200, "data": { "err_code": 0, "err_msg": "", "count": 23 }, "msg": "V2.1.1 YesApi"}F1-3、数据库-添加模型数据
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $article = $di['db']->article_tbl; $article->insert($data); $result['id'] = $article->insert_id(); // 返回新增的ID return $result;}F1-4、数据库-查询模型数据
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $result['article'] = $di['db']->article_tbl->where('id', 1)->fetchOne(); // 取出id=1的文章数据 return $result;}F1-5、数据库-更新模型数据
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $data = array('title' => '新文章标题', 'content' => '文章内容'); // 待更新的数据 $result['update_row'] = \$di['db']->article_tbl->where('id', 1)->update($data); // 更新id=1的文章数据，返回更新的数量 return $result;}F1-6、数据库-删除模型数据
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $result['delete_row'] = $di['db']->article_tbl->where('id', 1)->delete(); // 删除数据，返回删除的数量 return $result;}F1-7、数据库-获取模型列表数据
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $result['list'] = $di['db']->article_tbl->where('id > ?', 1)->where('id < ?', 10)->fetchAll(); // 取出id从1到10的全部数据 return $result;}F1-8、数据库-获取模型列表数据(搜索+分页+排序+字段选择)
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $result['list'] = $di['db']->article_tbl ->select('id, title, content') ->where('id', 1) // 精确区配 ->where('name LIKE ?', '%小白%') // 模糊匹配 ->where('id', array(1, 2, 3)) // 范围列举 ->where('id > ?', 1) // 范围大于 ->where('id < ?', 10) // 范围小于 ->where('id BETWEEN ? AND ?', array(1, 10)) // 范围介于 ->or('status', 1) // 或逻辑条件 ->order('add_time DESC') // 按韶光降序 ->limit(0, 100) // 分页，取出前面100条 ->fetchAll(); // 取全部数据 return $result;}
温馨提示：获取列表数据时，一定要利用limit限定分页数量，否则会审核不通过。
F2-1、CURL-GET要求function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); // 第一个参数为网址，第二个参数表示超时时间(单位毫秒) $result['res'] = $di['curl']->get('http://demo.phalapi.net/?username=YesApi', 3000); // 得到结果类似：{"ret":200,"data":{"title":"Hello YesApi","version":"2.13.3","time":1590764249},"msg":""} return $result;}F2-2、CURl-POST要求
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); // 第一个参数为网址，第二个参数是POST的参数，第三个参数表示超时时间(单位毫秒) $result['res'] = $di['curl']->post('http://demo.phalapi.net/', array('username' => 'YesApi'), 3000); // 得到结果类似：{"ret":200,"data":{"title":"Hello YesApi","version":"2.13.3","time":1590764249},"msg":""} return $result;}
温馨提示：通过云函数以及CURL，可以对原有的API接口进行封装，形成对外开放的接口API。
F3-1、日志function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $di['logger']->record('DEBUG', '调试日志，这里可放日志内容'); $di['logger']->record('INFO', '业务日志，这里可放日志内容'); $di['logger']->record('INFO', array('uuid' => 'ABC', 'tip' => '第二个参数还可以是数组')); $di['logger']->record('NOTICE', '提醒日志，这里可放日志内容'); $di['logger']->record('WARNNING', '警告日志，这里可放日志内容'); $di['logger']->record('ERROR', '缺点日志，这里可放日志内容'); return $result;}
温馨提示：日志记录后，可以到开放平台查看日志。
F4-1、发送邮件function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); // 第一个参数是收件人邮箱，第二个参数是邮件标题，第三个参数是邮件正文内容(HTML格式) $result['is_send'] = $di['email']->send('helper@yesapi.cn', '邮件标题', '邮件内容'); return $result;}
温馨提示：利用前请先配置邮箱做事配置。
F5-1、安全-加密解密function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $result['encrypt_data'] = $di['crypt']->encrypt('YesApi'); // 对数据进行加密 $result['decrypt_data'] = $di['crypt']->decrypt($result['encrypt_data']); // 对数据进行解密 return $result;}
温馨提示：每个app_key加密的数据，只能由自己的app_key进行解密。
F6-1、拼音function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $result['pinyin_1'] = $di['pinyin']->convert('小白接口'); // 将一段汉字串内容转成拼音，结果是：xiao bai jie kou $result['pinyin_2'] = $di['pinyin']->abbr('小白接口'); // 获取拼音首字母，结果是：x b j k $result['pinyin_3'] = $di['pinyin']->name('张三'); // 姓名转拼音，结果是：zhang san return $result;}F7-1、发送短信
function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); // 参数1：手机号，参数2：短信署名，参数3：短信模板，参数3：更多数组参数(没动态参数时可传空数组) $di['sms_aliyun']->aliyunSendSms('13800138000', '小白接口', 'SMS_153055065', array('code' => '123456')); return $result;}
温馨提示：利用前须要进行阿里云做事配置
F9、实用函数function ($params, $di) { $result = array('err_code' => 0, 'err_msg' => ''); $time = time(); // 当前韶光戳，例如：1590561632 $datetime = date('Y-m-d H:i:s'); // 当前韶光，例如：2020-05-20 00:00:00 $arr = json_decode('{"name":"YesApi"}', true); // json解析成数组 $json = json_encode($arr); // 数组转json $md5 = md5('123456'); // md5操作 return $result;}
更多示例，即将到来！
