企业apiphp,WeixinAPI-PHP
企业apiphp,WeixinAPI-PHP
#WeixinAPI PHP
##企业号主动调⽤接⼝的 PHP实现类包
##已实现了企业号接⼝中的⼤部分常⽤功能.
#WeixinAPI-PHP 使⽤⽂档
###1.使⽤api,需先将Api.class.php引⼊,该⽂件为本类包的核⼼类,对接⼝的操作都是基于此类进⾏开发. 核⼼类⾃动构建accesstoken,并实现了⾃动加载, 如引⼊到开发框架中,请⾃⾏调整⾃动加载功能.
###2.API⽂件夹为实际操作接⼝的class, 每个class的类名 对应企业号接⼝的模块(由基类的构造⽅法⾃动获得), 具体的接⼝节点由每个class⾥⾯的⽅法⾃⾏设置.
如: UserApi.class.php 类. 其对应的接⼝是
UserApi.class.php 类⾥的add ⽅法请求了节点 create
###当前API列表:
BaseApi.class.php 基类
UserApi.class.php 对⽤户的操作
DepartmentApi.class.php 对部门的操作
TagApi.class.php 对标签的操作
AgentApi.class.php 对应⽤的操作
JSSDKApi.class.php 对jssdk的签名获取
MediaApi.class.php 对媒体⽂件的操作
MessageApi.class.php 对消息的操作
###3.Cache⽬录缓存AccessToken和js_ticket(如果缓存驱动设为File的情况下)
###4.CacheDriver⽬录为缓存驱动 其中Redis驱动 如需使⽤, 请先调整下参数, 最好引⽤框架的相关配置参数
#WeixinAPI-PHP 的扩展⽅法
想要扩展,只需在API⽂件夹下创建⽂件即可,但创建的class的命名规范须遵循此接⼝下的开发规范,命名为 接⼝模块名
+Api.class.php并继承BaseApi, 如UserApi.class.php
其中User说过了, 是对应接⼝的模块, ⾄于对应的接⼝模块的节点请⾃⾏看其它Api中的调⽤⽅式.
##使⽤⽅法:
use WeixinAPI\Api;
// 引⼊ 核⼼类
include '/WeixinAPI/Api.class.php';
$CORP_ID = ''; // 企业号CORP_ID
$CORP_SECRECT = ''; // 企业号CORP_SECRECT
$cacheDriver = 'File'; // 缓存⽅式 ⽬前有两种 Redis 和 File
// 初始化
Api::init($CORP_ID, $CORP_SECRECT, $cacheDriver);
// 使⽤⼯⼚⽅法获取相应的接⼝模块
企业号申请$api = Api::factory('Xxxx');
// 具体⽅法请参照 类中的具体⽅法注释
$api->xxxx();
// 返回结果
$res = var_dump($res);
// 如果失败
if (false === $res) {
// ⼆者均可获取错误信息
var_dump(Api::getError());
var_dump($api->getError());
}
###其中调⽤Message接⼝的操作⽅法略微特殊 采⽤的是链式操作
如$Message->touser()->toparty()->totag->file/image/text/news/()->issafe()->send($agentid);
其中touser, toparty, totag三者必须调⽤其⼀, 三者的实参: 单个 ⽤户/部门/标签id 可以为⼀个字符串, 多个ID可以为⼀个⼀维数组. file/image/text/news等具体的详细类型⽅法 只能同时调⽤⼀个, 否则覆盖.
issafe 是否是安全消息
send⽅法 为最终发送动作 其实参为 的agentid.
send之前的⽅法, 顺序任意.

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。