docs: 完善安装文档并更新数据库脚本

- 详细说明安装步骤，包括环境准备、数据库配置和权限设置 - 更新数据库脚本以使用动态数据库名替代硬编码 - 添加Windows系统下的权限设置说明 - 补充Web服务器配置和初始化管理员账号指引
2025-07-08 20:33:21 +08:00
parent 62eaa9d54f
commit e73bc2fc05
2 changed files with 279 additions and 26 deletions
--- a/README.md
+++ b/README.md
@@ -45,27 +45,282 @@ app2/
 - Node.js (可选，用于前端资源构建)
 - Web 服务器（如 Apache 或 Nginx）

-## 安装步骤
-1. 创建项目目录并将代码复制到该目录下。
-2. 修改 `config.php` 文件，配置 MySQL 数据库信息、管理员账号和邮件服务设置。
-3. 安装依赖包（将自动创建 `vendor` 目录并安装 PHPMailer 等必要依赖）：
-   ```bash
-   composer install
+## 快速启动指南
+对于有经验的开发者，可按照以下步骤快速部署：
+```cmd
+# 1. 克隆项目并进入目录
+git clone <repository-url> app2
+cd app2
+
+# 2. 创建并配置环境文件
+copy config.example.php config.php
+# 编辑config.php设置数据库和邮件信息
+
+# 3. 创建数据库并导入结构
+mysql -u root -p -e "CREATE DATABASE your_db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
+mysql -u root -p your_db_name < app_store.sql
+
+# 4. 安装依赖并设置权限
+composer install
+icacls files /grant Users:(OI)(CI)W
+icacls images /grant Users:(OI)(CI)W
+
+# 5. 启动开发服务器
+php -S localhost:8000
+```
+访问 http://localhost:8000 开始使用，管理员后台地址：http://localhost:8000/admin
+
+## 详细安装教程
+
+### 1. 环境准备
+确保您的系统满足以下要求：
+- PHP 7.4+（推荐PHP 8.0+）
+- MySQL 5.7+ 或 MariaDB 10.2+
+- Composer（PHP依赖管理工具）
+- Web服务器（Apache/Nginx/IIS）或PHP内置服务器
+- Git（可选，用于版本控制）
+
+#### 检查PHP环境
+打开命令提示符，输入以下命令验证PHP版本：
+```cmd
+php -v
+# 应显示PHP 7.4.0或更高版本
+
+# 检查必要扩展
+php -m | findstr /i "mysqli pdo_mysql json curl fileinfo"
+# 确保以上扩展均已安装
+```
+
+### 2. 获取项目代码
+选择以下任一方式获取代码：
+
+#### 方式一：使用Git克隆（推荐）
+```cmd
+git clone <repository-url> app2
+cd app2
+```
+
+#### 方式二：手动下载
+1. 从项目仓库下载ZIP压缩包
+2. 解压到本地目录（如 `d:\app2`）
+3. 打开命令提示符，进入项目目录：
+   ```cmd
+   cd d:\app2
   ```
-4. 登录 MySQL 数据库，创建名为'awa'的数据库：
+
+### 3. 数据库配置
+
+#### 创建数据库
+1. 登录MySQL控制台：
+   ```cmd
+   mysql -u root -p
+   ```
+2. 创建数据库（将`your_db_name`替换为您喜欢的数据库名称）：
   ```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
+   CREATE DATABASE your_db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+   exit
   ```

+#### 导入数据库结构
+```cmd
+mysql -u root -p your_db_name < app_store.sql
+```
+> **注意**：请确保在导入前替换命令中的`your_db_name`为您实际创建的数据库名称
+
+### 4. 应用配置
+
+#### 创建配置文件
+如果项目中存在`config.example.php`：
+```cmd
+copy config.example.php config.php
+```
+如果不存在，请手动创建`config.php`文件并添加以下内容：
+```php
+<?php
+// 数据库配置
+define('DB_HOST', 'localhost');
+define('DB_USER', 'root');
+define('DB_PASS', 'your_database_password');
+define('DB_NAME', 'your_db_name');
+
+define('APP_URL', 'http://localhost'); // 应用基础URL
+define('ADMIN_EMAIL', 'admin@example.com'); // 默认管理员邮箱
+define('ADMIN_PASSWORD', 'admin123'); // 默认管理员密码（首次登录后必须修改）
+
+// 邮件服务配置（用于开发者注册验证）
+define('SMTP_HOST', 'smtp.example.com');
+define('SMTP_PORT', 465);
+define('SMTP_USER', 'your_email@example.com');
+define('SMTP_PASS', 'your_email_password');
+define('SMTP_ENCRYPTION', 'ssl'); // 通常为ssl或tls
+
+define('DEBUG_MODE', true); // 开发环境设为true，生产环境设为false
+?>
+```
+
+#### 配置参数说明
+| 参数 | 说明 | 示例值 |
+|------|------|--------|
+| DB_HOST | 数据库主机地址 | localhost |
+| DB_USER | 数据库用户名 | root |
+| DB_PASS | 数据库密码 | your_actual_password |
+| DB_NAME | 数据库名称 | app_store |
+| APP_URL | 应用访问URL | http://localhost/app2 |
+| DEBUG_MODE | 调试模式开关 | true/false |
+
+### 5. 安装依赖
+使用Composer安装项目依赖：
+```cmd
+composer install
+```
+> 如果没有安装Composer，请先从 https://getcomposer.org/ 下载并安装
+
+### 6. 设置目录权限
+项目需要对以下目录有写入权限：
+- `files/`：存储上传的应用文件
+- `images/`：存储应用截图和图标
+
+#### 图形界面方式（推荐）
+1. 在文件资源管理器中找到项目目录
+2. 右键点击`files`文件夹，选择**属性**
+3. 切换到**安全**选项卡，点击**编辑**
+4. 选择当前用户，勾选**写入**权限，点击**确定**
+5. 对`images`文件夹执行相同操作
+
+#### 命令行方式
+```cmd
+icacls files /grant Users:(OI)(CI)W
+icacls images /grant Users:(OI)(CI)W
+```
+
+### 7. 配置Web服务器
+
+#### 选项A：使用PHP内置开发服务器（推荐用于开发）
+```cmd
+php -S localhost:8000
+```
+然后在浏览器中访问：http://localhost:8000
+
+#### 选项B：配置Apache服务器
+1. 确保`mod_rewrite`模块已启用
+2. 创建虚拟主机配置：
+```apache
+<VirtualHost *:80>
+    ServerName appstore.local
+    DocumentRoot "d:/app2"
+    <Directory "d:/app2">
+        Options Indexes FollowSymLinks
+        AllowOverride All
+        Require all granted
+    </Directory>
+</VirtualHost>
+```
+3. 修改`hosts`文件添加：`127.0.0.1 appstore.local`
+4. 重启Apache，访问 http://appstore.local
+
+#### 选项C：配置Nginx服务器
+```nginx
+server {
+    listen 80;
+    server_name appstore.local;
+    root d:/app2;
+    index index.php;
+
+    location / {
+        try_files $uri $uri/ /index.php?$query_string;
+    }
+
+    location ~ \.php$ {
+        fastcgi_pass 127.0.0.1:9000;
+        fastcgi_index index.php;
+        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
+        include fastcgi_params;
+    }
+}
+```
+
+### 8. 首次使用与安全设置
+
+#### 管理员账号初始化
+1. 访问管理员登录页面：http://localhost:8000/admin/login.php
+2. 使用默认账号登录：
+   - 用户名：`admin@example.com`（来自config.php中的ADMIN_EMAIL）
+   - 密码：`admin123`（来自config.php中的ADMIN_PASSWORD）
+3. **重要**：登录后立即点击右上角头像，选择**修改密码**，设置强密码
+
+#### 安全建议
+- 生产环境中设置`define('DEBUG_MODE', false);`
+- 定期备份数据库
+- 不要将`config.php`提交到版本控制系统
+- 保持PHP和所有依赖包为最新安全版本
+
+## 使用教程
+
+### 开发者功能
+
+#### 注册开发者账号
+1. 访问开发者注册页面：http://localhost:8000/developer/register.php
+2. 填写注册信息，提交后系统会发送验证邮件
+3. 点击邮件中的验证链接激活账号
+
+#### 上传新应用
+1. 登录开发者后台：http://localhost:8000/developer/login.php
+2. 点击**上传新应用**按钮
+3. 填写应用信息：
+   - 应用名称、描述、版本号
+   - 选择应用类别和年龄分级
+   - 上传应用图标（推荐尺寸：512x512px）
+   - 上传应用截图（最多5张）
+   - 上传应用安装包（支持.zip格式）
+4. 点击**提交审核**，等待管理员审核
+
+#### 管理应用版本
+1. 在开发者后台点击应用名称进入管理页面
+2. 点击**发布新版本**添加应用更新
+3. 填写版本变更说明和更新内容
+4. 上传新版本安装包
+
+### 管理员功能
+
+#### 应用审核
+1. 登录管理员后台：http://localhost:8000/admin/login.php
+2. 点击**应用审核**菜单
+3. 查看待审核应用列表，点击**查看详情**
+4. 审核应用信息和安装包，点击**通过**或**拒绝**并填写反馈
+
+#### 管理应用分类
+1. 在管理员后台点击**分类管理**
+2. 可以添加、编辑或删除应用分类
+3. 设置分类排序和显示状态
+
+#### 系统信息查看
+1. 在管理员后台点击**系统信息**
+2. 查看服务器环境、PHP配置和数据库状态
+3. 监控应用总数、开发者数量和文件存储使用情况
+
+### API使用指南
+
+#### 获取应用列表
+```http
+GET /api.php?action=list&page=1&limit=10
+```
+返回JSON格式的应用列表数据
+
+#### 获取应用详情
+```http
+GET /api.php?action=app&id=1
+```
+返回指定ID的应用详细信息
+
+#### API响应格式
+```json
+{
+  "success": true,
+  "data": {},
+  "message": "操作成功"
+}
+```
+
 ## 功能说明
 - **首页**：展示最新 App 列表，包含基本信息和评分。
 - **App 信息页**：显示 App 详细信息、版本历史、预览图片和用户评价，支持用户评分。
--- a/app_store.sql
+++ b/app_store.sql
@@ -1,7 +1,5 @@
 -- 创建数据库
 -- CREATE DATABASE IF NOT EXISTS app_store;
-USE awa;
-
 -- 创建APP表
 CREATE TABLE IF NOT EXISTS apps (
    id INT AUTO_INCREMENT PRIMARY KEY,
@@ -104,41 +102,41 @@ CREATE TABLE IF NOT EXISTS app_categories (
 );

 -- 修改评价表，支持文字评论并关联用户
-SET @exist_ip_address = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = 'awa' AND TABLE_NAME = 'reviews' AND COLUMN_NAME = 'ip_address');
+SET @exist_ip_address = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'reviews' AND COLUMN_NAME = 'ip_address');
 SET @sql = IF(@exist_ip_address > 0, 'ALTER TABLE reviews DROP COLUMN ip_address', 'SELECT 1');
 PREPARE stmt FROM @sql;
 EXECUTE stmt;
 DEALLOCATE PREPARE stmt;

 -- 检查并删除unique_review索引（如果存在）
-SET @exist_unique_review = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.STATISTICS WHERE TABLE_SCHEMA = 'awa' AND TABLE_NAME = 'reviews' AND INDEX_NAME = 'unique_review');
+SET @exist_unique_review = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.STATISTICS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'reviews' AND INDEX_NAME = 'unique_review');
 SET @sql = IF(@exist_unique_review > 0, 'ALTER TABLE reviews DROP INDEX unique_review', 'SELECT 1');
 PREPARE stmt FROM @sql;
 EXECUTE stmt;
 DEALLOCATE PREPARE stmt;

 -- 检查并添加user_id列（如果不存在）
-SET @exist_user_id = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = 'awa' AND TABLE_NAME = 'reviews' AND COLUMN_NAME = 'user_id');
+SET @exist_user_id = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'reviews' AND COLUMN_NAME = 'user_id');
 SET @sql = IF(@exist_user_id = 0, 'ALTER TABLE reviews ADD COLUMN user_id INT', 'SELECT 1');
 PREPARE stmt FROM @sql;
 EXECUTE stmt;
 DEALLOCATE PREPARE stmt;

 -- 检查并添加comment列（如果不存在）
-SET @exist_comment = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = 'awa' AND TABLE_NAME = 'reviews' AND COLUMN_NAME = 'comment');
+SET @exist_comment = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'reviews' AND COLUMN_NAME = 'comment');
 SET @sql = IF(@exist_comment = 0, 'ALTER TABLE reviews ADD COLUMN comment TEXT', 'SELECT 1');
 PREPARE stmt FROM @sql;
 EXECUTE stmt;
 DEALLOCATE PREPARE stmt;

 -- 添加外键约束（如果不存在）
-SET @exist_fk = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE WHERE TABLE_SCHEMA = 'awa' AND TABLE_NAME = 'reviews' AND COLUMN_NAME = 'user_id' AND CONSTRAINT_NAME = 'fk_reviews_users');
+SET @exist_fk = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'reviews' AND COLUMN_NAME = 'user_id' AND CONSTRAINT_NAME = 'fk_reviews_users');
 SET @sql = IF(@exist_fk = 0, 'ALTER TABLE reviews ADD CONSTRAINT fk_reviews_users FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE SET NULL', 'SELECT 1');
 PREPARE stmt FROM @sql;
 EXECUTE stmt;
 DEALLOCATE PREPARE stmt;
 -- 检查并添加唯一索引（如果不存在）
-SET @exist_unique_index = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.STATISTICS WHERE TABLE_SCHEMA = 'awa' AND TABLE_NAME = 'reviews' AND INDEX_NAME = 'unique_user_app_review');
+SET @exist_unique_index = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.STATISTICS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'reviews' AND INDEX_NAME = 'unique_user_app_review');
 SET @sql = IF(@exist_unique_index = 0, 'ALTER TABLE reviews ADD UNIQUE KEY unique_user_app_review (user_id, app_id)', 'SELECT 1');
 PREPARE stmt FROM @sql;
 EXECUTE stmt;
@@ -267,7 +265,7 @@ CREATE TABLE IF NOT EXISTS user_feedback (
 );

 -- 修改app_versions表，添加最后更新时间戳用于热门排行
-SET @exist_last_updated = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_NAME = 'app_versions' AND COLUMN_NAME = 'last_updated');
+SET @exist_last_updated = (SELECT COUNT(*) FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'app_versions' AND COLUMN_NAME = 'last_updated');
 SET @sql = IF(@exist_last_updated = 0, 'ALTER TABLE app_versions ADD COLUMN last_updated TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP', 'SELECT 1');
 PREPARE stmt FROM @sql;
 EXECUTE stmt;