Shadez/wowarmory 项目安装与配置指南

项目概述

Shadez/wowarmory 是一个模拟魔兽世界官方英雄榜功能的Web应用程序，它允许玩家在网页上查看游戏角色信息、装备、天赋等数据。该项目需要与魔兽世界私服（如MaNGOS或TrinityCore）配合使用，为私服玩家提供类似于官方英雄榜的服务体验。

系统要求

在开始安装前，请确保您的服务器满足以下最低配置要求：

1. Web服务器：Apache HTTP Server，必须启用mod_rewrite模块
2. PHP环境：PHP 5.x版本（不支持PHP 6），必须安装并启用XMLWriter扩展
3. 数据库：MySQL 5.0或更高版本

注意：虽然项目说明中提到不支持PHP 6，但实际使用时建议使用PHP 7.x的兼容版本，因为PHP 5已停止维护多年。

详细安装步骤

1. 数据库准备

首先需要创建一个专用的MySQL数据库：

CREATE DATABASE armory CHARACTER SET utf8 COLLATE utf8_general_ci;

建议使用armory作为数据库名，保持一致性便于后续维护。

2. 导入数据库结构

项目提供了两个主要的SQL文件：

1. wowarmory_release_r{LATEST_REVISION}.sql - 主数据库结构
2. wowarmory_spell_release_r{LATEST_REVISION}.sql - 法术数据

使用MySQL客户端工具或命令行导入这两个文件：

mysql -u username -p armory < wowarmory_release_rXXXX.sql
mysql -u username -p armory < wowarmory_spell_release_rXXXX.sql

3. 配置文件设置

项目配置文件位于includes/classes/configuration.php，需要通过模板文件创建：

cp includes/classes/configuration.php.default includes/classes/configuration.php

配置文件中有两个关键部分需要特别注意：

1. 角色数据库配置：

$ArmoryConfig['multiRealm'][1]['*_characters']

2. 世界数据库配置：

$ArmoryConfig['multiRealm'][1]['*_mangos']

需要根据实际数据库连接信息修改以下参数：

• 数据库主机地址
• 数据库用户名
• 数据库密码
• 数据库名称

4. 资源文件准备

项目运行需要魔兽世界的图标资源：

1. 下载图标资源包
2. 解压到wow-icons/_images/目录

5. 服务器配置

确保正确配置了Apache的URL重写规则：

1. 解压htaccess.zip文件
2. 将.htaccess文件放置在网站根目录

6. 数据库更新

检查sql/updates目录，如果有比当前版本更新的SQL文件，需要按顺序执行这些更新脚本。

高级配置

3D角色查看器

如需启用3D角色查看功能，请参考项目中的3DViewer_info.txt文件进行额外配置。

服务器核心补丁

为了使角色页面正常工作，需要对游戏服务器核心进行补丁：

1. 根据服务器类型选择对应补丁文件：
   • MaNGOS: tools/{SERVER}/wowarmory_patch.patch
2. 应用补丁到服务器核心
3. 执行对应的SQL更新到角色数据库

多服务器类型支持

如果您的环境中同时运行MaNGOS和TrinityCore服务器，需要在配置文件中指定每个领域的服务器类型：

$ArmoryConfig['multiRealm'][REALM_ID]['type'] = 'trinity'; // 或 'mangos'

权限设置（UNIX系统）

在Linux/Unix系统上，需要确保Web服务器对以下目录有写入权限：

chown -R www-data:www-data cache/
chmod -R 755 cache/

常见问题解决

1. 页面无法显示：检查Apache的mod_rewrite是否启用，以及.htaccess文件是否正确放置
2. 数据库连接失败：检查configuration.php中的数据库配置信息
3. 图标不显示：确认图标资源已正确解压到指定目录
4. 角色信息不更新：确保已正确应用服务器核心补丁

维护建议

1. 定期检查sql/updates目录是否有新版本更新
2. 建立数据库备份机制，特别是执行更新前
3. 监控cache目录大小，必要时设置清理策略

通过以上步骤，您应该能够成功部署Shadez/wowarmory项目，为您的魔兽世界私服玩家提供完整的英雄榜服务。