Skip to content

Commit

Permalink
更新稳定版 v1.3
Browse files Browse the repository at this point in the history
新增检查更新功能,你可以访问 http://your-domain.com/check-update 来检查更新了。
  • Loading branch information
tnqzh123 committed Jun 12, 2017
1 parent e07c8e6 commit bc3da21
Show file tree
Hide file tree
Showing 7 changed files with 72 additions and 42 deletions.
36 changes: 23 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,14 @@ Bing 今日美图是 Microsoft 公司推出的图片服务,每天更新一张

当然有。

- 只有 2 个 PHP 文件,截至目前稳定版包括注释和空行总计只有 55 行代码,轻巧的不像实力派。
- 截至目前稳定版核心部分只有 2 个 PHP 文件,包括注释总计仅有 44 行代码,轻巧的不像实力派。
- 只是返回给用户一个 302 到 Bing 的今日美图图片的真实地址:
- 不在服务器端存储每天的图片,不用担心存储空间爆炸。
- 耗费流量极少,不用担心一夜之间房子归~~移动~~ IDC。
- 速度非常快,不用担心图片拖慢网页加载速度。
- 用途方面简直就是万金油,你甚至可以配合 Wallpaper Engine 自动获取每日的 Bing 今日美图并设置为你的电脑桌面壁纸。
- 使用的是一个非常神奇的 JSON API,你甚至可以获取到明天的 Bing 今日美图!
- 使用的是一个非常神奇的 JSON API,你甚至可以在当天 16 时后获取到明天的 Bing 今日美图!
- 可以很方便地检查更新,自动更新正在开发中...
- 可能还有更多...

## 我要怎么部署和使用这个 API?
Expand All @@ -42,28 +43,29 @@ Bing 今日美图是 Microsoft 公司推出的图片服务,每天更新一张
### 部署教程

1. 检查你的主机是否符合运行辣鸡 Bing 今日美图 API 的环境要求
2. [在这里](https://github.com/Minecraft-LittleQiu/laji-bing-pic-api/releases)下载辣鸡 Bing 今日美图 API,并放置到你的 Web 引擎的站点目录下
3. 修改 ```settings.php``` 中的设置
4. 安装完成后,访问 ``http://your-domain.com/bingpic.php`` 检查是否有报错
5. 还有别的步骤么——没有了!
2. [在这里](https://github.com/Minecraft-LittleQiu/laji-bing-pic-api/releases)下载辣鸡 Bing 今日美图 API 并解压
3.``settings.php.example`` 重命名为 ``settings.php`` 并修改其中的设置
4. 将所有文件放置在你在 Web 引擎中设置的站点目录(虚拟主机用户是上传至站点根目录)
5. 访问 ``http://your-domain.com/bingpic.php`` 检查是否有报错
6. 还有别的步骤么——没有了!

### 如何使用?

你可以在任何可以使用 URL 添加图片的地方引用 ``http://your-domain.com/bingpic.php``,会直接显示当天的或您在 ``settings.php`` 中设置的天数之前的 Bing 今日美图。

若您没有在 ``settings.php`` 中开启固定时间,您也可以在 URL 后加上 ``?daysago=x````?daysago=-x`` 获取 x 天前或 x 天后的 Bing 今日美图。
若您没有在 ``settings.php`` 中开启固定时间,您也可以在 URL 后加上 ``?daysago=x````?daysago=-1`` 获取 x 天前或明天的 Bing 今日美图。

e.g. ``<img src="http://your-domain.com/bingpic.php" />`` 获取当天的 Bing 今日美图

![Eexample](https://www.littleqiu.net/bingpic.php)
![Eexample](https://www.littleqiu.net/bingpic/bingpic.php)

e.g. ``<img src="http://your-domain.com/bingpic.php?daysago=1" />`` 获取昨天的 Bing 今日美图

![昨天的 Bing 今日美图](https://www.littleqiu.net/bingpic.php?daysago=1)
![昨天的 Bing 今日美图](https://www.littleqiu.net/bingpic/bingpic.php?daysago=1)

e.g. ``<img src=http://your-domain.com/bingpic.php?daysago=-1 />`` 获取明天的 Bing 今日美图
e.g. ``<img src=http://your-domain.com/bingpic.php?daysago=-1 />`` 获取明天的 Bing 今日美图,仅当天下午 16 时后有效

![明天的 Bing 今日美图](https://www.littleqiu.net/bingpic.php?daysago=-1)
![明天的 Bing 今日美图](https://www.littleqiu.net/bingpic/bingpic.php?daysago=-1)

你也可以这样用:

Expand All @@ -79,13 +81,21 @@ e.g. ``<img src=http://your-domain.com/bingpic.php?daysago=-1 />`` 获取明天

![还有这种操作?!](https://www.littleqiu.net/wp-content/uploads/2017/06/Cache_-604f82923c68bb83..jpg)![就是有这种操作!](https://www.littleqiu.net/wp-content/uploads/2017/06/Cache_6420743cd7bcf867..jpg)

## 更新 API

自稳定版 v1.3开始,可以自动检测更新(但不能自动更新),你可以定期访问 ``http://your-domain.com/check-update`` 来检查更新。

若有更新版本,你需要从 [Releases](https://github.com/Minecraft-LittleQiu/laji-bing-pic-api/releases) 中下载最新版本的压缩包并解压,将所有文件上传至你的 API 目录覆盖所有文件,更新即完成。

## 关于测试版

测试版(``bingpic-test.php``)是开发中的版本,更新速度比稳定版(``bingpic.php``)要快些,但可能会包含一些致命的 Bug 导致无法正常运行。所以请在将测试版部署在生产环境前三思。

测试版的部署方法和用法同稳定版。测试版不会在 [Releases](https://gtihub.com/Minecraft-LittleQiu/laji-bing-pic-api/releases) 中打包发布,你需要从 Git 上 Clone 一份即可使用。
测试版的部署方法和用法同稳定版。测试版不会在 [Releases](https://gtihub.com/Minecraft-LittleQiu/laji-bing-pic-api/releases) 中打包发布,你需要使用 Git 从 GitHub 上 Clone 一份即可使用。

~~若无特别说明,测试版的配置文件(``settings.php``)与稳定版的通用。~~

若无特别说明,测试版的 ``settings.php`` 与稳定版的通用
测试版 v1.3-test 开始新增了对配置文件能否兼容的检测(笨办法,我会在开发时在程序中设置兼容性),若能够兼容稳定版的配置文件则会加载稳定版的,若不能兼容则会自动加载开发版的配置文件(``settings-test.php``

## **版权**

Expand Down
2 changes: 1 addition & 1 deletion bingpic-test.php
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?php
/*
辣鸡 Bing 今日美图 API 测试版 By Little_Qiu
Version: 1.2-test
Version: 1.3-test
感谢 @GPlane 和 @Flyfish233
这是辣鸡 Bing 今日美图 API 的测试版。
该版本可能未开发完全或含有不稳定因素,请谨慎用于生产环境!
Expand Down
30 changes: 9 additions & 21 deletions bingpic.php
Original file line number Diff line number Diff line change
@@ -1,46 +1,34 @@
<?php

/*
/*
辣鸡 Bing 今日美图 API By Little_Qiu
Version: 1.2
感谢 @GPlane
*/
Version: 1.3
感谢 @GPlane 和 @Flyfish233
*/

// 检查 PHP 版本
if (version_compare(PHP_VERSION, '5.2.0', '<')) {
exit('错误:辣鸡 Bing 今日美图 API 要求 PHP 版本不低于 5.2.0,你正在使用的是 '.PHP_VERSION);
}

// 获取 Bing 今日美图的图片地址
function bg() {

// 导入设置
include 'settings.php';

// 检查是否使用 URL 指定时间
if (useurl) {

if (useUrl) {
// 获取 daysago 参数的值
$daysagoquery = "$_GET[daysago]";

$daysAgoQuery = "$_GET[daysago]";
// 获取 JSON
$data = json_decode(file_get_contents("http://cn.bing.com/HPImageArchive.aspx?format=js&idx=$daysagoquery&n=1"), true);

$data = json_decode(file_get_contents("http://bing.com/HPImageArchive.aspx?format=js&idx=$daysAgoQuery&n=1"), true);
} else {

// 获取 JSON
$data = json_decode(file_get_contents("http://cn.bing.com/HPImageArchive.aspx?format=js&idx=$daysago&n=1"), true);

$data = json_decode(file_get_contents("http://bing.com/HPImageArchive.aspx?format=js&idx=$daysAgo&n=1"), true);
};

// 返回 URL
return "https://cn.bing.com".$data['images'][0]['url'];

return "https://bing.com".$data['images'][0]['url'];
};

// 302 跳转
$url = bg();
header("Location: $url");
exit;

?>
24 changes: 24 additions & 0 deletions check-update/index.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
<?php
/*
辣鸡 Bing 今日美图 API 更新检查工具 By Little_Qiu
Version: 1.0
*/
// 检查 PHP 版本
if (version_compare(PHP_VERSION, '5.2.0', '<')) {
exit('错误:辣鸡 Bing 今日美图 API 要求 PHP 版本不低于 5.2.0,你正在使用的是 '.PHP_VERSION);
};
// 导入版本
include 'version.php';
// 设置下载地址
$releases = "https://github.com/Minecraft-LittleQiu/laji-bing-pic-api/releases";
// 获取 JSON
$updateJson = json_decode(file_get_contents("https://raw.githubusercontent.com/Minecraft-LittleQiu/laji-bing-pic-api/master/update.json"), true);
// 获取发布日期
$date = date('Y 年 m 月 d 日',$updateJson[date]);
// 对比版本号
if ($ver == $updateJson[version]){
echo ("欢迎使用辣鸡 Bing 今日美图 API 更新检查工具!</br>当前版本已是最新版本!</br>当前版本号:$ver </br>当前版本发布日期:$date");
} else {
echo ("欢迎使用辣鸡 Bing 今日美图 API 更新检查工具!</br>当前版本不是最新版本!</br>当前版本号:$ver </br>最新版本号:$updateJson[version] </br>最新版本发布日期:$date </br>请到 <a href=$releases>GitHub </a>下载最新版本。");
};
?>
4 changes: 4 additions & 0 deletions check-update/version.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
<?php
// 版本号,检查更新用,请勿随意修改!
$ver = 1.3;
?>
6 changes: 5 additions & 1 deletion settings-test.php
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
<?php
/*
辣鸡 Bing 今日美图 API 测试版配置文件 By Little_Qiu
你可以根据每个配置项上方的注释,修改你的配置文件。
*/
// 是否使用在 URL 后添加 daysago 参数的方法指定时间,若关闭则可在下一条设置项中设置时间
$useUrlSetDate = true;
$useUrl = true;
// 设置时间(几天前),将 0 修改为你需要的时间,1 为昨天,2 为前天,-1 为明天,以此类推
$daysAgo = '0';
?>
12 changes: 6 additions & 6 deletions settings.php → settings.php.example
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
<?php
// 是否使用在 URL 后添加 region 参数的方式指定地区,若关闭则可在下一条设置项中设置地区
$useUrlGetRegion = true
// 设置地区,cn 为中国版,global 为国际版
$region = cn;
/*
辣鸡 Bing 今日美图 API 配置文件 By Little_Qiu
你可以根据每个配置项上方的注释,修改你的配置文件。
*/
// 是否使用在 URL 后添加 daysago 参数的方法指定时间,若关闭则可在下一条设置项中设置时间
$useurl = true;
$useUrl = true;
// 设置时间(几天前),将 0 修改为你需要的时间,1 为昨天,2 为前天,-1 为明天,以此类推
$daysago = '0';
$daysAgo = '0';
?>

0 comments on commit bc3da21

Please sign in to comment.