diff --git a/README.md b/README.md index 08369c6..d3c88a5 100644 --- a/README.md +++ b/README.md @@ -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? @@ -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. ```` 获取当天的 Bing 今日美图 -![Eexample](https://www.littleqiu.net/bingpic.php) +![Eexample](https://www.littleqiu.net/bingpic/bingpic.php) e.g. ```` 获取昨天的 Bing 今日美图 -![昨天的 Bing 今日美图](https://www.littleqiu.net/bingpic.php?daysago=1) +![昨天的 Bing 今日美图](https://www.littleqiu.net/bingpic/bingpic.php?daysago=1) -e.g. ```` 获取明天的 Bing 今日美图 +e.g. ```` 获取明天的 Bing 今日美图,仅当天下午 16 时后有效 -![明天的 Bing 今日美图](https://www.littleqiu.net/bingpic.php?daysago=-1) +![明天的 Bing 今日美图](https://www.littleqiu.net/bingpic/bingpic.php?daysago=-1) 你也可以这样用: @@ -79,13 +81,21 @@ e.g. ```` 获取明天 ![还有这种操作?!](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``)。 ## **版权** diff --git a/bingpic-test.php b/bingpic-test.php index f88fb35..d39dba3 100644 --- a/bingpic-test.php +++ b/bingpic-test.php @@ -1,7 +1,7 @@ \ No newline at end of file diff --git a/check-update/index.php b/check-update/index.php new file mode 100644 index 0000000..0245532 --- /dev/null +++ b/check-update/index.php @@ -0,0 +1,24 @@ +当前版本已是最新版本!
当前版本号:$ver
当前版本发布日期:$date"); +} else { + echo ("欢迎使用辣鸡 Bing 今日美图 API 更新检查工具!
当前版本不是最新版本!
当前版本号:$ver
最新版本号:$updateJson[version]
最新版本发布日期:$date
请到 GitHub 下载最新版本。"); +}; +?> diff --git a/check-update/version.php b/check-update/version.php new file mode 100644 index 0000000..51f5b67 --- /dev/null +++ b/check-update/version.php @@ -0,0 +1,4 @@ + \ No newline at end of file diff --git a/settings-test.php b/settings-test.php index 96631fa..fe369f8 100644 --- a/settings-test.php +++ b/settings-test.php @@ -1,6 +1,10 @@ \ No newline at end of file diff --git a/settings.php b/settings.php.example similarity index 50% rename from settings.php rename to settings.php.example index f1d501c..9d5a4f2 100644 --- a/settings.php +++ b/settings.php.example @@ -1,10 +1,10 @@ \ No newline at end of file