# php-robot

**Repository Path**: liuxiaojinla/php-robot

## Basic Information

- **Project Name**: php-robot
- **Description**: Robot 是一套简单、灵活、优雅的API，目前接入了国内主流的两大办公机器人（钉钉、微信），你可以使用它快速接入你的应用，从而更快捷的实现，数据统计提醒、程序异常报警等功能。

- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2022-05-07
- **Last Updated**: 2025-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 企业微信, 钉钉, 机器人, Robot

## README

# Robot | 机器人

#### 介绍

Robot 是一套简单、灵活、优雅的API，目前接入了国内主流的两大办公机器人（钉钉、微信），你可以使用它快速接入你的应用，从而更快捷的实现，数据统计提醒、程序异常报警等功能。

#### 安装教程

`composer require xin/robot`

#### 使用说明

配置文件 config.php

```php
<?php
// +----------------------------------------------------------------------
// | 机器人设置
// +----------------------------------------------------------------------

return [
    // 定义相关默认配置
    'defaults' => [
        'robot' => env('robot.driver', 'default'),
    ],

    // 定义机器人的相关配置
    'robots' => [
        'default' => [
            'driver' => 'wework',
            'key' => env('ROBOT.WEWORK_KEY', ''),
        ],

        //
        'danger' => [
            'driver' => 'dingtalk',
            'key' => env('ROBOT.DINGTALK_KEY', ''),
            'secret' => env('ROBOT.DINGTALK_SECRET', ''),
            'title' => env('ROBOT.DINGTALK_TITLE', '提醒助手'),
        ],
    ],
];

```

实例化机器人管理器

```php
<?php
$robot = new \Xin\Robot\RobotManager($config);
$robot->sendTextMessage("hello world");
$robot->sendMarkdownMessage("<h1>Hello world</h1>");

// 切换机器人
$robot->robot('danger')->sendTextMessage("服务器报警");
```

#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

#### 特技

1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md