x10211 一个简单的灵感生成器

在开始之前，请确认以下条件：

• PHP 版本 >= 7.0
• MySQL 数据库已创建
• PDO 扩展已启用

步骤 1：配置数据库

编辑 config/config.php 文件：

// 方案A：MySQL（推荐）
define('DB_TYPE', 'mysql');
define('DB_HOST', 'localhost');           // 或您的数据库地址
define('DB_PORT', '3306');
define('DB_NAME', '你的数据库名');         // 必须先创建好数据库
define('DB_USER', '你的数据库用户名');
define('DB_PASS', '你的数据库密码');
define('DB_CHARSET', 'utf8mb4');
​
// 方案B：SQLite（测试用，无需配置）
// define('DB_TYPE', 'sqlite');
// define('DB_PATH', __DIR__ . '/../data/inspiration.db');

步骤 2：上传文件

方式 A：标准部署（推荐）

1. 将整个项目上传到服务器

2. 将网站根目录指向 / 文件夹

   • 这样更安全，配置目录不会被直接访问

   • Apache/Nginx 配置示例：

     # Apache
     DocumentRoot /path/to/inspiration-generator/public
     ​
     # Nginx
     root /path/to/inspiration-generator/public;

方式 B：简化部署（虚拟主机）

如果虚拟主机不支持修改根目录：

1. 将 public/ 目录下的所有文件移动到网站根目录

2. 确保以下文件结构：

   /config/config.php
   /core/Database.php
   /core/Generator.php
   /core/Interpreter.php
   /data/schema.sql
   /install/install.php
   /index.php
   /api.php

步骤 3：运行安装

访问以下URL之一（根据您的部署方式选择）：

• 标准部署：http://your-domain/install/install.php

• 简化部署：http://your-domain/install/install.php

点击「开始安装」按钮，等待完成。

安装成功后，请立即删除 install/ 目录！

随后把运行目录指向 Public

步骤 4：验证部署

测试 API 是否正常

访问：http://your-domain/check-api.php

如果看到类似以下 JSON 响应，说明 API 正常：

{
    "status": "success",
    "message": "API 正常工作",
    "database_type": "mysql",
    "available_modes": 5,
    "config_path": "/path/to/inspiration-generator/config/config.php"
}

测试主页是否正常

访问：http://your-domain/index.php

应该能看到灵感生成器的界面，点击「生成灵感」按钮测试功能。

常见问题排查

1. 页面显示空白

原因：PHP 错误被隐藏了

解决方法：

• 检查 PHP 版本是否 >= 7.0

• 开启错误显示（临时）：

  // 在 config/config.php 中添加
  define('DEBUG_MODE', true);

2. 安装时出现路径错误

原因：配置文件路径不正确

解决方法：

• 确保 config/config.php 文件存在

• 检查文件权限（需要读取权限）

3. 生成灵感时提示网络错误

原因：API 路径问题或服务器配置问题

解决方法：

1. 访问 http://your-domain/check-api.php 查看 API 是否正常

2. 打开浏览器控制台（F12），查看 Network 标签

3. 检查 api.php 的请求地址和响应

4. 确保 .htaccess 文件存在且配置正确

4. 数据库连接失败

原因：数据库配置错误或数据库不存在

解决方法：

• 检查 config/config.php 中的数据库配置

• 确认数据库已创建

• 确认用户名和密码正确

• 检查 MySQL 服务是否运行

验证清单

部署完成后，请确认：

• 能够访问主页（index.php）
• 能够访问 API 诊断页面（check-api.php）
• 数据库连接正常
• 点击「生成灵感」按钮能成功生成
• 浏览器控制台没有错误

成功部署后

1. 删除 install/ 目录（安全）

2. 设置 .htaccess 文件权限为 444（只读）

3. 定期备份数据库

4. 可选：启用 HTTPS 提升安全性