# Bing-upyun
# 轻量必应每日一图API，支持上传到又拍云调用
### 1.简介
##### 1.1 之前用的接口
在这之前，旧的必应背景图片接口的原理是：解析官方接口再返回图片URL。虽然代码简单，但由于微软服务器问题，从请求到图片接收完成，耗时大都会超过500ms，有时甚至会请求失败。且原来的这种方法不支持图片处理等功能。
##### 1.2 其他接口
目前网络上有很多优秀的必应每日一图接口，但大都需要常驻后台运行。另外，目前几乎没有采用又拍云储存图片的同类接口。因此便有了下面的项目。
##### 1.3 本接口
Bing-upyun是轻量化的php程序。本程序可以将每日最新的必应背景图片上传到又拍云，并提供调用接口（又拍云直链）。实测从请求到图片接收完成耗时300ms左右（视网络情况而不同）。
为了追求轻量化，本程序不会常驻后台，这也就意味着用户需要每日访问一次URL，以触发程序执行。建议在服务器上设置定时任务，每日 **00:01:00** 访问 `/php/index.php`。强烈建议定时任务在此时间访问，如需设置其他时间，请务必修改 `/php/config.php`中的`$config['delay']`为合适的值。详情见 7.3 设置定时任务。
接口正在更新，目前可返回处理后的图片（高斯模糊、灰阶）以及前n天的图片。
正在开发前端图片展示页面。
### 2.特点
1. 每天从必应搜索首页拉取最新背景图。
2. 支持将背景图**上传到又拍云**，不占用服务器存储空间。
3. 提供从又拍云调用图片的接口。
4. 不占用服务器后台，程序通过访问URL触发。
5. 可返回处理后的图片，支持高斯模糊、灰阶等。
6. 可返回n天前的图片。
### 3.DEMO
此接口为[小马奔腾](https://blog.mcloc.cn/)免费提供，支持最新的特性（可能含有Beta版功能），请合理使用。
### 4.目录结构
```
├── php
│ ├── bing // 图片缓存文件夹
│ ├── config.php // 配置文件
│ └── index.php // 后台图片处理程序
└── index.php // 图片调用接口
```
### 5.接口文档
| 参数名 | 是否必须 | 参数 | 返回结果 | 备注 |
| :----: | :------: | :------------------------: | :------------------------: | :-----------------------: |
| blur | 否 | 5/15/25 | 返回高斯模糊程度不同的图片 | 只支持5/15/25三个等级 |
| gray | 否 | true/false | 灰阶图片/正常色彩图片 | - |
| day | 否 | 数字n（大于等于0的正整数） | n天前的图片 | n的范围取决于程序运行天数 |
注意：`blur`和`gray`暂不支持组合使用，`day`和`blur`/`gray`可以组合使用。即不能返回灰阶的高斯模糊图片，可以返回n天前的高斯模糊图片和n天前的灰阶图片。
更多接口正在开发中...
### 6.前端
前端页面使用了Bootstrap框架、jQuery库。现正在开发...
### 7.部署方式
##### 7.1 修改又拍云连接信息
在`/php/config.php`中修改：
```php
//又拍云连接信息
$config['bucketName'] = '********'; //你的又拍云存储库
$config['operatorName'] = '********'; //你的存储库操作员
$config['operatorPwd'] = '********'; //你的存储库操作员密码
$config['domainName'] = '********'; //又拍云加速域名。注：结尾的 / 不能省略。如：'https://upyun.yourdom.com/'
```
##### 7.2部署文件到服务器
部署至可访问目录即可。
注意：`/php/bing`文件夹需要有写入权限。
##### 7.3 设置定时任务（重要）
本程序不会常驻后台，需要定时访问程序所在URL以触发程序执行（每天访问一次）。
定时任务访问URL： `网站根目录/php/index.php` 或 `网站根目录/php`
接口调用URL： `网站根目录/index.php` 或 `网站根目录/`
为避免时间误差引起的问题，建议**不要**将定时任务设置在每天的 00:00:00 ，推荐将定时任务设置在每日 **00:01:00** ，若如此做，则在完成以上步骤后，不需要额外设置。否则请参照以下规则：
`php/config.php` 中的`$config['delay']`为延时时间，如 `$config['delay'] = 90;` 即调用80s前的图片。这也就意味着，您在每天零点的90s后，才能收到当天最新的图片。在每天的 00:00:00 至 00:01:30 之间，您调用此接口返回的仍然是前一天的图片。
