zyan/work-wechat

企业微信后台SDK

1.0.3 2021-08-18 01:34 UTC

Requires

• php: >=7.3
• doctrine/cache: ^1.10
• guzzlehttp/guzzle: ^7.2
• pimple/pimple: ^3.3
• predis/predis: ^1.1
• technodelight/php-cli-cross-platform-open: ^1.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.18
• phpunit/phpunit: ^9.5

MIT

• 读心印

• 企业微信SDK
• 企业微信爬虫
• 企业微信模拟登录
• 企业微信自建应用

README

企业微信后台SDK

• 获取qrcode
• 登录获取cookie
• 获取通讯录
• 获取应用列表
• 创建应用
• 设置侧边栏

等等

要求

1. php >= 7.3
2. Composer

安装

composer require zyan/work-wechat -vvv

用法

use Zyan\WorkWeChat\WorkWeChat;

//默认配置 可选 
$config = [
    'cache' => [ //缓存 目前仅支持 file redis 
        'default' => 'file',
        'stores' => [
            'file' => [
                'driver' => 'file',
                'path' => './chache',
            ],
            'redis' => [
                'driver' => 'redis',
                'host' => '127.0.0.1',
                'port' => 6379,
                'password' => null
            ]
        ]
    ]
];

$work = WorkWeChat::config($config);

获取登录二维码

$work->login->getQrcode();

/**
return
Array
(
    [qrcode_key] => eb67102ca70843de //二维码的key
    [qrcode_url] => https://work.weixin.qq.com/wwqrlogin/qrcode/eb67102ca70843de?login_type=login_admin
)
*/

通过企业微信扫码后 查询登录状态

$work->login->getStatus($qrcode_key)

/**
return

Array
(
    [data] => Array
        (
            [status] => QRCODE_SCAN_NEVER //登录状态
            [auth_source] => SOURCE_FROM_WEWORK
            [corp_id] => 0
            [code_type] => 2
            [clientip] => 183.17.231.150
            [confirm_clientip] => 
        )

)

QRCODE_SCAN_NEVER 等待扫码
QRCODE_SCAN_FAIL 取消操作
QRCODE_SCAN_ING 已扫码,等待确认
QRCODE_SCAN_SUCC 已确认 登录

*/

当登录状态为QRCODE_SCAN_SUCC时 获取cookie

$isLogin = $work->login->getCookie($auth_code, $qrcode_key);

//返回是否登录成功 true 为成功

//$auth_code 为授权 code 在 QRCODE_SCAN_SUCC时 会返回

//您不需要去处理cookie 因为系统已经帮你处理好了
//默认会将cookie转为array保存file缓存中

获取企业信信息

$work->corp->getCorp();

通讯录

//获取部门列表
$work->department->getList();

//获取员工列表
$work->user->getList();

应用操作

//获取所有应用列表
$work->apps->getList();

//创建内部应用 $visiblePid 可见部门
$work->apps->addOpenApiApp(string $name, string $description, string $logoImage, array $visiblePid = []);

//应用详情
$work->apps->getOpenApiApp(int $appId);

//应用设为开启状态
$work->apps->saveOpenApiApp(int $appId);

//获取可信域名txt文件验证 返回filename txt内容为文件名,需要自已生成txt
$work->apps->getDomainOwnershipVerifyInfo();

php完整示例 请查看 tests/test.php 中

前端交互示例暂无

参与贡献

1. fork 当前库到你的名下
2. 在你的本地修改完成审阅过后提交到你的仓库
3. 提交 PR 并描述你的修改，等待合并

注: 本项目同时发布在gitee 请使用github提交
github: https://github.com/aa24615/work-wechat

License

MIT license