iCMS v7 到 v8 升级工具

这是一个专门用于将 iCMS v7 升级到 v8 的数据库升级工具，提供了 Web 界面和命令行两种使用方式。

🚀 功能特性

• Web 界面升级: 友好的图形界面，分步骤引导升级
• 命令行升级: 适合大数据量，无超时限制
• 安全检查: 升级前的数据备份提醒和安全检查
• 进度显示: 实时显示升级进度和详细日志
• 错误处理: 完善的错误处理和回滚机制
• 数据统计: 升级前显示数据量统计

📋 升级前准备

必须完成的准备工作

1. 备份数据库 ⚠️

   mysqldump -u用户名 -p密码 数据库名 > icms_v7_backup.sql

2. 安装 iCMS v8

   • 下载并部署 iCMS v8 程序文件
   • 安装时可以使用临时数据库
   • 确保程序文件部署正确

3. 检查环境要求

   • PHP 7.4 或更高版本
   • MySQL 5.7 或更高版本
   • 足够的磁盘空间

🌐 Web 界面使用方法

1. 访问升级页面

在浏览器中访问：

http://你的域名/v7to8/upgrade.html

2. 按步骤操作

第一步：准备工作

• 阅读升级说明
• 确认已完成数据备份
• 勾选安全检查清单

第二步：数据库配置

• 填写 v7 数据库连接信息
• 测试数据库连接
• 确认连接成功后继续

第三步：确认升级

• 查看数据统计信息
• 确认升级并开始执行
• 等待升级完成

💻 命令行使用方法

基本用法

cd /v8程序目录/public/v7to8
php cli_upgrade.php --username=数据库用户名 --password=数据库密码 --database=数据库名

完整参数示例

php cli_upgrade.php \
  --host=localhost \
  --port=3306 \
  --username=root \
  --password=123456 \
  --database=icms_v7 \
  --prefix=icms_ \
  --backup \
  --force

参数说明

📁 文件说明

v7to8/
├── upgrade.html          # Web界面升级页面
├── get_connection.php   # 数据库连接测试
├── get_stats.php        # 获取数据统计
├── upgrade.php          # Web升级处理脚本
├── cli_upgrade.php      # 命令行升级脚本
├── icms7toicms8.sql     # 数据库升级SQL文件（必需）
├── test_sql_parser.php  # SQL文件解析测试脚本
├── completed.php       # 升级完成重置管理密码
└── README.md           # 说明文档

📄 SQL升级文件详情

icms7toicms8.sql 文件包含了从iCMS v7升级到v8所需的所有数据库结构变更：

• 文件大小: 约52KB
• SQL语句数量: 121条
• 主要操作类型:
  • 表重命名: 8个表（如 icms_members → icms_admin）
  • 表结构修改: 29个ALTER TABLE语句
  • 新表创建: 28个新表
  • 数据插入: 10条INSERT语句
  • 数据更新: 7条UPDATE语句
  • 其他操作: 38条（包括索引、约束等）

⚡ 性能建议

选择合适的升级方式

• 小型网站 (< 1万条记录): 使用 Web 界面
• 中型网站 (1-5万条记录): 推荐命令行方式
• 大型网站 (> 5万条记录): 必须使用命令行方式

优化建议

1. 升级前优化

   OPTIMIZE TABLE icms_article;
   OPTIMIZE TABLE icms_user;
   OPTIMIZE TABLE icms_category;

2. 临时调整配置

   # my.cnf
   innodb_buffer_pool_size = 1G
   max_allowed_packet = 64M

🔧 故障排除

常见问题

1. 连接超时

解决方案：使用命令行方式升级

2. 内存不足

解决方案：增加 PHP memory_limit 或使用命令行

3. 权限不足

解决方案：确保数据库用户有 ALTER, CREATE, DROP 权限

4. 表不存在

解决方案：检查表前缀设置是否正确

5. SQL执行错误

解决方案：使用 test_sql_parser.php 验证SQL文件，检查表前缀是否正确

6. 升级中断

解决方案：检查日志错误信息，恢复数据库备份后重新尝试

升级失败恢复

如果升级失败，可以通过以下方式恢复：

# 恢复数据库备份
mysql -u用户名 -p密码 数据库名 < icms_v7_backup.sql

📊 升级内容

主要变更

1. 表结构调整

   • 重命名部分表
   • 添加新字段
   • 修改字段类型
   • 优化索引结构

2. 数据迁移

   • IP地址格式转换
   • 状态字段标准化
   • 时间戳格式统一

3. 系统配置

   • 更新版本信息
   • 添加新配置项
   • 清理废弃配置

⚠️ 注意事项

1. 数据安全

   • 升级前必须备份数据库
   • 建议在测试环境先试运行
   • 升级过程不可逆

2. 环境要求

   • 确保 PHP 和 MySQL 版本兼容
   • 检查磁盘空间充足
   • 关闭网站访问（避免数据冲突）

3. 升级时间

   • 小型网站：5-10分钟
   • 中型网站：30-60分钟
   • 大型网站：1-3小时

📞 技术支持

如果在升级过程中遇到问题，请：

1. 查看升级日志
2. 检查 PHP 错误日志
3. 确认数据库连接正常
4. 联系技术支持

重要提醒: 升级前请务必备份数据库，升级过程不可逆！