README

一个用于Laravel框架的企业微信(WeCom) SDK扩展包，提供Server API和Webhook API的便捷调用方式。

功能特性

• 支持企业微信Server API（获取access_token、发送消息、上传媒体文件等）
• 支持企业微信Webhook API（发送消息、上传媒体文件）
• 支持多应用配置
• 支持@用户和@手机号功能
• 支持Laravel 7.x - 12.x版本

安装

使用Composer安装扩展包：

composer require guolei19850528/laravel-wecom

配置

发布配置文件

php artisan vendor:publish --tag=guolei19850528/laravel-wecom

修改配置文件

发布后，配置文件将位于 config/guolei19850528-laravel-wecom-config.php，您可以根据需要修改配置：

return [
    'server' => [
        'your app name' => [
            'corpid' => '您的企业ID',
            'corpsecret' => '应用的凭证密钥',
            'agentid' => '应用的AgentId',
            'baseUrl' => 'https://qyapi.weixin.qq.com/cgi-bin/', // 可选，默认值
        ],
    ],
    'webhook' => [
        'your key name' => [
            'key' => 'Webhook密钥',
            'mentionedList' => ['user1', 'user2'], // 默认@用户列表
            'mentionedMobileList' => ['13800138000'], // 默认@手机号列表
            'baseUrl' => 'https://qyapi.weixin.qq.com/cgi-bin/webhook/', // 可选，默认值
        ],
    ],
];

使用示例

Server API

use Guolei19850528\Laravel\Wecom\Server\Api;

// 初始化API客户端
$api = new Api([
    'corpid' => 'your_corpid',
    'corpsecret' => 'your_corpsecret',
    'agentid' => 'your_agentid'
]);

// 获取access_token
$token = $api->gettoken();

// 发送文本消息
$api->messageSend([
    'touser' => '@all',
    'msgtype' => 'text',
    'text' => [
        'content' => '这是一条测试消息'
    ]
]);

// 上传媒体文件
$mediaId = $api->mediaUpload([
                'name' => 'robots.txt',
                'filename' => 'robots.txt',
                'contents' => fopen(public_path('robots.txt'), 'rb'),
            ]);

Webhook API

use Guolei19850528\Laravel\Wecom\Webhook\Api;

// 初始化API客户端
$api = new Api([
    'key' => 'your_webhook_key',
    'mentionedList' => ['user1', 'user2'],
    'mentionedMobileList' => ['13800138000']
]);

// 发送文本消息
$api->send([
    'msgtype' => 'text',
    'text' => [
        'content' => '这是一条测试消息'
    ]
]);

// 上传媒体文件
$mediaId = $api->uploadMedia([
                'name' => 'robots.txt',
                'filename' => 'robots.txt',
                'contents' => fopen(public_path('robots.txt'), 'rb'),
            ]);

版本支持

• PHP 8.x
• Laravel 7.x - 12.x

许可证

MIT License

作者

• 郭磊
• 邮箱: 174000902@qq.com
• GitHub: https://gitee.com/guolei19850528/laravel-wecom