Leonmmcoset
c233f8ba31
- 拆分数据库创建和导入步骤，提供更清晰的指导 - 添加目录创建和权限设置的具体命令 - 新增故障排除章节，涵盖常见问题解决方案 - 保持文档与当前系统要求一致
88 lines
3.6 KiB
Markdown
88 lines
3.6 KiB
Markdown
# App Store 项目
|
||
|
||
这是一个基于 PHP 7.4 的 App Store 项目，使用 Bootstrap 实现 Fluent Design 风格界面，数据存储采用 MySQL 数据库。
|
||
|
||
## 项目结构
|
||
```
|
||
app2/
|
||
├── config.php # 配置文件，包含数据库和管理员信息
|
||
├── app_store.sql # 数据库初始化 SQL 文件
|
||
├── index.php # 首页
|
||
├── app.php # App 信息页
|
||
├── admin/ # 管理员后台目录
|
||
│ ├── addapp.php
|
||
│ ├── deleteapp.php
|
||
│ ├── editapp.php
|
||
│ ├── index.php
|
||
│ ├── login.php
|
||
│ ├── manage_tags.php
|
||
│ ├── review_apps.php
|
||
│ └── system_info.php
|
||
├── developer/ # 开发者后台目录
|
||
│ ├── dashboard.php
|
||
│ ├── edit_app.php
|
||
│ ├── login.php
|
||
│ ├── logout.php
|
||
│ ├── profile.php
|
||
│ ├── register.php
|
||
│ └── upload_app.php
|
||
├── vendor/ # Composer 依赖
|
||
├── includes/ # 通用包含文件
|
||
├── api.php # API 接口文件
|
||
├── styles.css # 自定义 CSS 文件
|
||
├── images/ # 存储 App 预览图片和年龄分级 SVG
|
||
│ ├── age_3plus.svg
|
||
│ ├── age_7plus.svg
|
||
│ ├── age_12plus.svg
|
||
│ ├── age_17plus.svg
|
||
├── files/ # 存储 App 文件
|
||
```
|
||
|
||
## 环境要求
|
||
- PHP 7.4+
|
||
- MySQL 5.7+
|
||
- Composer
|
||
- Node.js (可选，用于前端资源构建)
|
||
- Web 服务器（如 Apache 或 Nginx）
|
||
|
||
## 安装步骤
|
||
1. 创建项目目录并将代码复制到该目录下。
|
||
2. 修改 `config.php` 文件，配置 MySQL 数据库信息、管理员账号和邮件服务设置。
|
||
3. 安装依赖包（将自动创建 `vendor` 目录并安装 PHPMailer 等必要依赖）：
|
||
```bash
|
||
composer install
|
||
```
|
||
4. 登录 MySQL 数据库，创建名为'awa'的数据库：
|
||
```sql
|
||
CREATE DATABASE awa CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||
```
|
||
5. 执行 `app_store.sql` 文件导入数据库结构：
|
||
```sql
|
||
mysql -u your_username -p awa < app_store.sql
|
||
```
|
||
6. 创建 `files` 和 `images` 目录，并设置正确权限：
|
||
```bash
|
||
mkdir -p files images
|
||
chmod 755 files images
|
||
```
|
||
|
||
## 功能说明
|
||
- **首页**：展示最新 App 列表，包含基本信息和评分。
|
||
- **App 信息页**：显示 App 详细信息、版本历史、预览图片和用户评价，支持用户评分。
|
||
- **管理页**：管理员可以添加、删除 App，审核应用，管理标签和查看系统信息。
|
||
- **开发者后台**：开发者可以注册账号、管理应用、上传新版本和查看应用统计。
|
||
- **API 接口**：提供 `/api` 获取 App 列表，`/api/app/<编号>` 获取单个 App 详细信息。
|
||
|
||
## 管理员登录
|
||
默认管理员账号信息在 `config.php` 中配置，登录后可访问管理页面。
|
||
|
||
## 故障排除
|
||
- **数据库导入错误**：确保数据库名称为'awa'且已创建，检查SQL文件路径是否正确
|
||
- **权限问题**：确认 `files` 和 `images` 目录权限设置为755
|
||
- **邮件发送失败**：检查 `config.php` 中的SMTP配置，确保端口（通常465或587）和加密方式正确
|
||
- **类找不到错误**：运行 `composer install` 确保所有依赖已正确安装
|
||
|
||
## 注意事项
|
||
- 请确保 `files`、`images` 目录以及其子目录有足够的写入权限（推荐设置权限为755）。
|
||
- 生产环境中必须修改默认管理员密码和数据库连接信息，确保系统安全。
|
||
- 邮件服务配置：请在 `config.php` 中正确设置 SMTP 服务器地址、端口、用户名和密码，以确保开发者邮箱验证功能正常工作。 |