# DailyQuoteWeb

**Repository Path**: coldestbow30654/DailyQuoteWeb

## Basic Information

- **Project Name**: DailyQuoteWeb
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-13
- **Last Updated**: 2026-02-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 每日一句 API 服务

<div align="center">
  <img src="../DailyQuoteApp/assets/icons/icon.svg" width="128" height="128" alt="每日一句 Logo">

  「每日一句」后端 API 服务

  [![PHP Version](https://img.shields.io/badge/PHP-8.0+-blue)](https://www.php.net/)
  ![MySQL Version](https://img.shields.io/badge/MySQL-5.7+-orange)
  [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://www.gnu.org/licenses/agpl-3.0.html)</div>

## 项目简介

本项目是「每日一句」名言分享系统的后端 API 服务，提供名言管理、用户认证、内容提交等功能。API 服务采用 PHP 开发，遵循 RESTful 设计规范，返回标准 JSON 格式数据，支持跨域访问以服务于桌面客户端和 Web 前端。

### 技术栈

- **PHP 8.0+**：作为主要开发语言，利用其成熟的 Web 开发生态
- **MySQL 5.7+**：关系型数据库，存储用户数据、名言内容和操作日志
- **PDO**：PHP 数据对象扩展，提供安全的数据库访问接口
- **Cloudflare Turnstile**：人机验证服务，防止恶意攻击和自动化滥用
- **JWT**：JSON Web Token，用于用户身份认证和会话管理

### 核心功能

- 名言管理：获取每日精选、随机名言、按 ID 查询
- 用户认证：注册、登录、令牌验证、会话管理
- 内容提交：用户提交名言、每日限制检查、提交历史查看
- 管理功能：内容审核、用户管理、操作日志（需管理员权限）

## 快速开始

### 环境要求

- PHP 8.0 或更高版本
- PHP PDO 扩展
- PHP JSON 扩展
- MySQL 5.7 或更高版本
- Web 服务器（Apache/Nginx）

### 安装配置

1. 将本目录部署到支持 PHP 的 Web 服务器
2. 创建 MySQL 数据库
3. 执行 `db_init.php` 初始化数据表结构
4. 修改 `config.php` 中的数据库连接凭据
5. 配置 Web 服务器支持 URL 重写（用于 API 路由）

### 目录结构

```
DailyQuoteWeb/
├── admin.php          # 管理员后台界面
├── api.php            # 核心 API 接口入口
├── auth.php           # 用户认证模块
├── config.php         # 配置文件
├── create_db.php      # 数据库初始化脚本
├── db.php             # 数据库操作类
├── db_init.php        # 数据库表结构初始化
├── index.php          # 用户前端界面
├── login.php          # 用户登录页面
├── register.php       # 用户注册页面
├── security.php       # 安全防护模块
├── security_config.php# 安全配置
├── user_submit.php    # 用户内容提交
├── README.md          # 本项目介绍
└── docs/              # 文档目录
    └── API.md         # API 接口文档
```

## API 文档

详细的 API 接口说明、使用示例和错误代码请参阅：

Gitee链接(推荐)

- **[API 接口文档](https://gitee.com/coldestbow30654/DailyQuoteWeb/blob/main/docs/API.md)**：包含所有 API 接口的完整说明

---

GitHub链接

- **[API 接口文档](https://github.com/COLDESTBOW30654/DailyQuoteWeb/blob/main/docs/API.md)**：包含所有 API 接口的完整说明

## 相关文档

Gitee链接(推荐)

- **[项目总览](https://gitee.com/coldestbow30654/DailyQuote/blob/main/README.md)**：整个项目的综合介绍和技术架构
- **[桌面客户端开发文档](https://gitee.com/coldestbow30654/DailyQuoteApp/blob/main/docs/DEVELOPMENT.md)**：Electron 应用的开发指南

---

GitHub链接

- **[项目总览](https://github.com/COLDESTBOW30654/DailyQuote/blob/main/README.md)**：整个项目的综合介绍和技术架构
- **[桌面客户端开发文档](https://github.com/COLDESTBOW30654/DailyQuoteApp/blob/main/docs/DEVELOPMENT.md)**：Electron 应用的开发指南

## 许可证

本项目采用 AGPL v3 许可证开源。