# simple-dingtalk

**Repository Path**: michonnehsu/simple-dingtalk

## Basic Information

- **Project Name**: simple-dingtalk
- **Description**: 轻量级钉钉服务端PHP-SDK，简化初学者的使用难度。（非官方）,拥有完善的文档及案例，减少开发者的心智负担。
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 50
- **Forks**: 16
- **Created**: 2021-10-04
- **Last Updated**: 2026-01-21

## Categories & Tags

**Categories**: web-dev-toolkits

**Tags**: PHP, 钉钉, dingTalk

## README

<p align="center" style="font-family: Arial, Helvetica, sans-serif;">轻量级钉钉服务端PHP-SDK，简化初学者的使用难度。</p>
<p align="center">
<img src="https://img.shields.io/badge/PHP-7.3^|8^-green" />
<img src="https://img.shields.io/badge/release-1.0.7^-orange" />
<img src="https://img.shields.io/badge/license-MIT-green" />
</p>

### 介绍
这是一款PHP编写的轻量级钉钉服务端扩展包，以最简单的方式取调用、源码易懂、模块化。  
用户可以自行定期更新token或应用自行判断，达到使用接口函数不需要考虑token的问题。
### 安装方式
```
composer require michonnehsu/simpledingtalk

```
### 文档地址
点击访问[文档](https://gitee.com/michonnehsu/simple-dingtalk/wikis/pages)  

### 用法
```
require './vendor/autoload.php';


use SimpleDingTalk\SimpleDingTalk;
use SimpleDingTalk\Storage\FileTokenStorage;
try {
    // 基础配置
    $config = [
        'app_key' => '',
        'app_secret' => '',
        'agent_id' => 0,
        'debug' => true,
        'redirect_uri'=>'https://www.dingtalk.com',
        'domain'=>'https://www.dingtalk.com'
    ];
    $fts=new FileTokenStorage('dingtalk');
    $dingtalk = new SimpleDingTalk($config,$fts);

    $data=[
        'dept_id'=>1
    ];
    $departmentInfo=$dingtalk->department()->get($data);

    print_r($departmentInfo);
    
} catch (\SimpleDingTalk\Exceptions\ApiException $e) {
    echo "API错误: " . $e->getMessage() . " (错误码: " . $e->getApiCode() . ")\n";
} catch (\Exception $e) {
    echo "错误: " . $e->getMessage() . "\n";
}
```
[如何配置以及使用](https://gitee.com/michonnehsu/simple-dingtalk/wikis/v2.0/%E5%9F%BA%E6%9C%AC%E7%94%A8%E6%B3%95)

### QQ群
群号 `815471943`