Wildflower 1.3 Beta 技术文档

1. 安装指南

系统要求

• Web 服务器: Apache（需启用 mod_rewrite），或其他支持 mod_rewrite 规则的 Web 服务器（如 lighttpd 或 IIS）。
• PHP: 5.2 或更高版本（已知可与 5.1 版本兼容）。
• MySQL: 4.1 或更高版本。

安装步骤

1. 解压文件: 将压缩包解压，并将 wildflower 目录放置在 Apache 的文档根目录下或其子目录中。你可以根据需要重命名 wildflower 目录。
2. 创建数据库: 创建一个新的 MySQL 数据库，使用 utf8_unicode_ci 排序规则。将 SQL 文件 app/config/sql/wildflower.sql 导入到新创建的数据库中。
3. 配置数据库连接: 编辑 app/config/database.php 文件，填写数据库连接信息。
4. 开始项目: 通过修改 app 目录中的应用程序文件来开始你的项目。升级过程简单且耗时较少（参见升级部分）。
5. 访问管理区域: 管理区域位于 http://your-site/admin。
6. 默认登录信息: 默认的管理员登录用户名和密码为 admin/admin321。建议通过点击用户菜单中的“更改密码”来修改默认密码。
7. 配置设置: 查看并修改 vendors/wf_core.php 中的设置（更多设置在数据库登录后进入“设置”）。

2. 项目使用说明

Wildflower 架构

Wildflower 使用 CakePHP 的额外 MVC 路径功能。所有 Wildflower 的 MVC 文件（模型、视图、控制器）都位于 /wildflower 目录中。除了 app_controller.php、app_model.php 和 app_helper.php，这些文件位于 /app 目录中，是 Wildflower 正常运行所必需的。

自定义功能

你可以将任何 Wildflower MVC 文件复制到 /app 目录中进行修改，CakePHP 会自动使用这些文件。通过 Wildflower 的核心功能和一些设置，可以轻松定制站点。添加自定义控制器、模型等以实现自定义功能非常简单。由于应用程序特定的代码是隔离的，升级过程也很简单。

3. 项目 API 使用文档

升级指南

1. 备份数据: 在升级前务必进行备份。
2. 覆盖文件: 将新版本的文件复制并覆盖现有文件。
3. 运行数据库迁移: 从工作目录中运行以下命令以更新数据库：

   php vendors/ruckusing/main.php db:migrate
   

密码生成

如果在升级到启用 AuthComponent 的版本后无法登录，可以使用 UtilityShell 生成一个 AuthComponent 兼容的密码哈希：

./cake/console/cake wildflower hash myPassword

将生成的哈希值插入到数据库的 users 表的 password 字段中。

或者运行以下 SQL 语句（从 app/config/core.php 获取 salt 值）：

UPDATE users SET password = sha1(concat('salt', 'admin123')) WHERE login = 'admin';

4. 项目安装方式

手动安装

1. 下载项目: 从 GitHub 下载 Wildflower 项目。
2. 解压并配置: 按照上述安装步骤进行解压和配置。
3. 启动服务器: 启动 Web 服务器并访问项目。

自动安装

1. 使用 Composer: 如果你使用 Composer 管理依赖，可以通过 Composer 安装 Wildflower。
2. 配置并启动: 配置数据库连接并启动 Web 服务器。

通过以上步骤，你可以顺利安装并使用 Wildflower 1.3 Beta 版本。