Bing-upyun 开源项目安装与使用手册

1. 项目目录结构及介绍

Bing-upyun 是一个轻量级的必应每日一图API项目，它允许你获取并处理必应每日背景图片，支持上传至又拍云进行调用，同时提供了图片处理（如高斯模糊、灰阶转换）和历史图像回溯的功能。以下是项目的基本目录结构：

├── api                    # 后端接口相关文件夹
│   ├── php                # PHP处理脚本
│   │   ├── bing           # 图片缓存文件夹
│   │   ├── config.php     # 配置文件
│   │   └── index.php      # 图片处理后台程序
│   └── index.php          # 图片调用主接口
├── css                    # CSS样式表文件夹
│   ├── detail.css         # 详情页样式
│   ├── index.css          # 首页样式
│   └── main.css           # 主样式表
├── html                   # HTML模板文件夹
│   └── detail.html        # 图片详情页
├── js                     # JavaScript脚本文件夹
│   ├── detail.js          # 详情页脚本
│   ├── index.js           # 首页脚本
│   └── main.js            # 主脚本
├── lib                    # 第三方库文件夹
├── static                 # 静态资源文件夹
│   └── upyun_logo5.png    # 示例logo
└── index.html             # 首页入口文件

2. 项目的启动文件介绍

主要后端启动流程：

• 核心启动文件：位于api/index.php，这是前端调用的主接口，负责处理图像请求。
• 后台处理程序：api/php/index.php，这个文件需要通过定时任务定期访问，以自动更新每日的必应图片。

前端展示启动：

无需传统意义上的“启动”，前端通过部署到Web服务器上，直接通过浏览器访问index.html来查看和交互。

3. 项目的配置文件介绍

关键配置文件位于api/php/config.php，它包含了项目运行所必需的信息，必须进行相应的设定才能使项目正常工作。主要配置项包括：

$config['bucketName'] = '********';       // 你的又拍云存储库名
$config['operatorName'] = '********';      // 存储库操作员用户名
$config['operatorPwd'] = '********';      // 存储库操作员密码
$config['domainName'] = '********';       // 又拍云加速域名，末尾包含'/'
$config['mysqlHost'] = '********';       // MySQL数据库主机名
$config['mysqlUsername'] = '********';    // 数据库用户名
$config['mysqlPassword'] = '********';    // 数据库密码
$config['mysqlDbname'] = '********';     // 数据库存储的数据库名

记得将上述占位符替换成真实的凭据和地址。

此外，如果计划部署前端，还应在HTML和JavaScript文件中调整域名以指向正确的部署位置，特别是在细节配置如评论系统的API Key (Valine)以及静态资源的引用路径。

综上所述，正确配置这些部分并遵循部署指南，即可成功部署并使用Bing-upyun项目。