# ChaoxingSign

**Repository Path**: lightcomputer/ChaoxingSign

## Basic Information

- **Project Name**: ChaoxingSign
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-05
- **Last Updated**: 2024-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ⭐ ChaoxingSign | 超星学习通签到
PHP 版超星学习用自动签到，支持多用户签到，二次开发便捷！

`PHP 7.3` 测试通过，理应 `PHP 5.4` 及以上都能够使用

- 登录方式：

支持手机号码登录，暂时不支持学号登陆！！！

- 签到功能：

支持普通签到，手势签到，~~二维码签到~~，位置签到，拍照签到（无图片上传）

# 🎨 更新日志
<details open>
  <summary>2023/2/12</summary>
  
- 增加了docker-compose运行的支持，运行`run-docker.sh`即可完成一键部署
<details open>
  <summary>2022/12/23</summary>
  
- 增加Go-cqhttp推送，需要配置 config.php 文件
- 支持直接在config.php文件配置账号和密码（单用户使用）
- 默认设置了周六周日不签到
<details open>
  <summary>2022/08/29</summary>
  
- 修复无法登录的Bug
- 修复无法位置签到的Bug
- 调整了curl的实现方法，方便后期debug
</details open>
<details>
  <summary>2022/06/06</summary>
  
- 增加预签到
- 修复无法签到的Bug
</details>
<details>
  <summary>2022/04/27</summary>
  
- 新增 Bark 推送 
  > Bark API的末尾不需要添加 / 
- 修复获取课程失败导致签到失败的Bug 
- 优化签到效率 
</details>
<details>
  <summary>2021/03/21</summary>

- <a href="https://github.com/xiwangly2/ChaoxingSign/issues/6">#6</a> 升级为新版 Server 酱推送通道，原因：微信发布公告将在2021年4月底下线模板消息，故旧版推送通道将于 2021年4月 下线
    > 获取本源码后，请配置 `Config.php` 的相关配置
</details>

<details>
  <summary>2020/06/13</summary>

- 修复 <a href="https://github.com/xiwangly2/ChaoxingSign/issues/2">#2</a> 的问题，配置了 Server酱但不推送的问题
- 更改 判断时间区间的方法
- 添加 获取课程列表失败，重试2次以判断是API错误
</details>

<details>
  <summary>2020/05/27</summary>

- 修复 <a href="https://github.com/xiwangly2/ChaoxingSign/issues/1">#1</a>
- 更改 获取课程、签到 API
- 添加 手势、位置、二维码一键签到
- 添加 Server酱 微信推送，需要配置 `config.php` 文件
</details>

<details>
  <summary>2020/05/25</summary>

- 更改 登录接口，原接口已经失效
</details>

# 🎁 TODO
- [] 接入钉钉机器人 API

# 🧀 使用方法
1. 下载源码：

    直接下载：https://github.com/xiwangly2/ChaoxingSign/archive/master.zip
    
    克隆源码：`git clone https://github.com/xiwangly2/ChaoxingSign.git`

2. 🚀 运行
    1. 上传到**网站根目录**运行
    
        然后访问 `http://你的域名/main.php?account=你的超星账号&password=你的超星密码`
    
    2. 或者使用**命令行**运行
       ```
       php main.php -A "你的超星账号" -P "你的超星密码"
       ```

3. ⚙ 实现自动签到
    > 推荐大于等于 **10 分钟** 执行一次，避免出现异常
    > 
    > 我已经硬编仅能在每天的 08:00 ~ 22:00 之间运行，
    > 如果要取消或修改这一限制，请删除或注释
    > `main.php` 第 7~9 行
    1. 如果以**网页方式**运行，定时监控 `http://你的域名/main.php?account=你的超星账号&password=你的超星密码` 即可
    2. 如果使用**命令行方式**运行，添加 `crontab` 任务即可，具体添加 `crontab 任务` 方法可以网上搜。
    每天 早上8点到晚上22点之间，每10分钟签到一次 crontab 表达式：`0 */10 8-22 * * * *`

# √ 运行输出
签到成功：
```
正在签到：陈半仙@测试班级
[2020-06-13 11:44:14]签到成功

Server酱 消息推送成功
```

没有签到任务：
```
没有待签到的任务
```

# ❗ 注意
超星**可能**屏蔽了如 阿里云、腾讯云、百度云... 等 IDC IP 地址，故有可能出现未知的错误（我没测试，我仅在家庭宽带中测试成功）

# 🙇‍ 感谢
> 本项目的实现参考了以下文章

- https://www.z2blog.com/index.php/learn/423.html
- https://www.z2blog.com/index.php/default/459.html

> 本项目中使用到的 `Selector.php` 来自 [PHPSpider](https://github.com/owner888/phpspider) 

# License
遵循 [MIT License](./LICENSE) 协议

## 其它版本签到脚本推荐
> 排名不分先后

| 项目地址                                                | 开发语言   | 备注                                         |
| ------------------------------------------------------- | ---------- | ------------------------------------------ |
| https://github.com/mkdir700/chaoxing_auto_sign          | Python     | 超星学习通自动签到脚本&多用户多任务&API       |
| https://github.com/Wzb3422/auto-sign-chaoxing           | TypeScript | 超星学习通自动签到，梦中刷网课                |
| https://github.com/aihuahua-522/chaoxing-testforAndroid | Java       | 学习通（超星）自动签到                       |
| https://github.com/yuban10703/chaoxingsign              | Python     | 超星学习通自动签到                           |
| https://github.com/Huangyan0804/AutoCheckin             | Python     | 学习通自动签到，支持手势，二维码，位置，拍照等 |