Update document and version number

README_ZH.md

@@ -7,7 +7,7 @@ PanDownload 网页复刻版，PHP 语言版<br/>
 
 <div align="center"><a href="https://www.bilibili.com/video/BV1N5411A77n"><img src="https://i.loli.net/2021/04/04/9NJ2lC4T78o1XmZ.png" width="500"><br /><b>点此查看本项目安装、配置、使用视频教程</b></a></div>
 
-## 🔎实现原理
+## 🔎 实现原理
 通过curl获取网盘文件信息，处理后显示在网页中。通过api接口以及SVIP账号的Cookie(BDUSS)获取高速下载链接。<br/>
 本质就是用会员账号获取下载地址并发送给访客。
 
@@ -16,27 +16,21 @@ PanDownload 网页复刻版，PHP 语言版<br/>
  2. <a href="https://wenshu.court.gov.cn/website/wenshu/181107ANFZ0BXSK4/index.html?docId=YBxnFgDqvuAqHdQyp/Sg8Q8PO/kX2Ej8TmtEOh9d2AdVpX9Qxi5YzJ/dgBYosE2gsXAo9gkraFrIyNZhEOZTLb1tEqCCr7c0irDVWK+bNT9AqupYNfRiqH1vVaFmakha">中国裁判文书网《北京度友科技有限公司等与罗庆等不正当竞争纠纷一审民事判决书》</a>
 </h2>
 
-![浅色及英文模式](https://s2.loli.net/2023/02/04/cs1EtFXpHDPS2AB.png)
-![首页](https://s2.loli.net/2023/02/04/fJlru3yj6b4MVE1.png)
-![文件列表](https://s2.loli.net/2023/02/04/hL2pDEyHQFb6BKR.png)
-![解析详情](https://s2.loli.net/2023/02/04/GZBsmz6xgShjuA2.png)
+![浅色首页](https://s2.loli.net/2023/04/04/yegBh8HXaNCqixb.png)
+![深色首页](https://s2.loli.net/2023/04/04/Ff1ub4MJxVsHYhZ.png)
+![文件列表](https://s2.loli.net/2023/04/04/4XOrj9xlFYqSyhw.png)
+![解析详情](https://s2.loli.net/2023/04/04/aVPoxJ52zCZLpIK.png)
+![后台页面](https://s2.loli.net/2023/04/04/dzvxNqO82WrM4lQ.png)
 
-## 📌Tips
-- 使用了 `Curl`，使用前请确认安装了Curl及其PHP插件（导致问题的主要原因）
-- 使用了 `SESSION`，注意 **PHP 访问系统文件（夹）权限** 问题
-- 仅支持 **PHP 7 和 7+**！
-- 一般情况下网页版不会出现问题，第一次使用就失败一般是**设置的问题**。
-- 如果使用一段时间后失效，一般是**账号失效问题**（点击退出登录按钮会导致当此登录获取到的 Cookies 失效，更改密码会使当前帐号获取过的所有 Cookies 失效）或 **服务器 IP 被封禁**（在解析了大量文件后可能会出现此问题，阈值大约为几十TB），如果是获取下载链接的方法失效，此项目将会被关闭。
-- 处理下载限速方法
-  - 尝试重新分享文件，部分文件可能出现奇怪的问题，部分文件名也有可能导致问题
-  - 耐心等待账号解封
-  - 更换后台 SVIP 账号
-  - 更换服务器 IP
-
-
-# 🔧Install & Setting
+# 🔧 安装及设置
 [**点此查看安装、配置、使用视频教程**](https://www.bilibili.com/video/BV1N5411A77n)
 
+## 宝塔面板 / 虚拟主机安装
+[AFF] 市面上虚拟主机参数参差不齐，经测试 [雨云](https://www.rainyun.cc/?ref=MjQyNDk=) 可完美运行本程序(香港EP二代 入门版, 7元/月)。
+1. 进入 [Releases](https://github.com/yuantuo666/baiduwp-php/releases) 下载项目文件 解压到对应目录
+2. 访问 `/install.php` 文件并填写相关信息进行安装
+3. 最后点击提交即可，需进行设置可网页访问 `/settings.php` （需启用数据库功能）
+
 ## Docker 安装
 ### 不使用MySQL数据库
 1. 安装 docker
@@ -83,13 +77,27 @@ docker run --network mysql-network --ip 172.28.0.3 -p 8080:80 yuantuo666/baiduwp
 http://服务器IP:8080/settings.php
 ```
 
-## 宝塔面板 / 虚拟主机安装
-[AFF] 市面上虚拟主机参数参差不齐，经测试 [雨云](https://www.rainyun.cc/?ref=MjQyNDk=) 可完美运行本程序(香港EP二代 入门版, 7元/月)。
-1. 进入 [Releases](https://github.com/yuantuo666/baiduwp-php/releases) 下载项目文件 解压到对应目录
-2. 访问 `/install.php` 文件并填写相关信息进行安装
-3. 最后点击提交即可，需进行设置可网页访问 `/settings.php` （需启用数据库功能）
-
-## 💡Contact
+## 📌 使用提示
+- 使用了 `Curl`，使用前请确认 **安装了 Curl** 及 **启用其 PHP 插件**
+- 使用了 `SESSION`，注意 **PHP 访问系统文件（夹）权限** 问题
+- 仅支持 **PHP 7 和 7+**！
+- 本项目使用的接口容易导致账号限速，参见 [#113](https://github.com/yuantuo666/baiduwp-php/issues/113)
+- 需要配置 `完整 Cookie`(普通账号和SVIP账号均可) + `BDUSS, STOKEN`(需SVIP账号) 才可以获取下载链接，获取方法需抓包。
+  - 获取 Cookie 参考 [图文教程](https://blog.imwcr.cn/2022/11/24/%e5%a6%82%e4%bd%95%e6%8a%93%e5%8c%85%e8%8e%b7%e5%8f%96%e7%99%be%e5%ba%a6%e7%bd%91%e7%9b%98%e7%bd%91%e9%a1%b5%e7%89%88%e5%ae%8c%e6%95%b4-cookie/)
+  - `BDUSS` 和 `STOKEN` 是 `Cookie` 中的两个参数。可以通过 `抓包 + 手动截取` 获得，或参考 [伪PD教程](https://pandownload.net/faq/cookie.html)。
+  - `BDUSS` 长度 192，其不包含开头的 `BDUSS=`；`STOKEN` 长度 64，其不包含开头的 `STOKEN=`。
+
+## 📚 进一步阅读
+- [更新日志](docs/CHANGELOG.md)
+- [关于这个项目](docs/About.md)
+- [API 文档](docs/API.md)
+  - 自 `3.0.0` 版本开始，本项目支持 API 接口。核心功能如获取文件列表、下载地址等均可通过 API 完成，具体请查看 [API 文档](docs/API.md)。
+
+## 📝 TODO
+- [ ] 多语言完善
+- [ ] 逐步重构代码
+
+## 💡 联系作者
 - 项目作者：Yuan_Tuo
 - 作者首页：https://imwcr.cn/
 - 作者邮箱：[email protected] (不答复百度网盘相关问题)
@@ -99,10 +107,12 @@ http://服务器IP:8080/settings.php
 
 如果遇到问题请先 **仔细阅读此文档** 、查看[视频教程](https://www.bilibili.com/video/BV1N5411A77n)
 以及查看[以前的议题](https://github.com/yuantuo666/baiduwp-php/issues)<br />
+如果还是无法解决，请在 [Issues](https://github.com/yuantuo666/baiduwp-php/issues) 中按模板提出问题，我会尽快回复。
 
-如果是**设置账号的 Cookies（BDUSS 和 STOKEN）**及**配置环境**等方面的问题，请自行解决。
+## 📃 License
+[MIT](LICENSE)
 
-## 🔔Thanks
+## 🔔 Thanks
 - [baiduwp JavaScript 版](https://github.com/TkzcM/baiduwp "baiduwp 项目")
 - [PanDownload 网站](https://pandownload.com/ "PanDownload 网站")
 - [Bootstrap 深色模式](https://github.com/vinorodrigues/bootstrap-dark "bootstrap-dark 项目")

Update.md → docs/CHANGELOG.md

@@ -1,4 +1,13 @@
 # Update
+### `3.0.0` 版本：
+- 更新日期：2023-04-04
+- 修改内容：
+  - 💥新增功能
+    - 新增后端API接口及文档 #237
+    - 后台获取账号状态增加缓存 #253
+  - ♻代码优化
+    - 重构解析有关操作为类
+
 ### `2.2.7` 版本：
 - 更新日期：2023-03-15
 - 修改内容：

index.php

@@ -14,7 +14,7 @@
  * @link https://space.bilibili.com/88197958
  *
  */
-$programVersion_Index = "2.2.7";
+$programVersion_Index = "3.0.0";
 session_start();
 define('init', true);
 if (!file_exists('./common/invalidCheck.php')) {

install/config_raw

@@ -9,7 +9,7 @@
  */
 require_once "./common/invalidCheck.php";
 
-const programVersion = '2.2.7';
+const programVersion = '3.0.0';
 const Sitename = '<Sitename>';
 
 const Cookie = '<Cookie>';