Clientexec 升级示意图

最近 [[Clientexec]] 发布了 7.0.1 稳定版，我使用了 Clientexec 来管理主机，我一直在等这个大版本更新。之前一直停留在 6.6.1，看到 7.0 正式稳定后终于决定动手升级。整个过程踩了一些坑，这里把完整的升级流程和注意事项分享出来，希望能帮到同样需要升级的朋友。

为什么要升级到七

Clientexec 团队在 6.x 系列上持续投入了很长时间，从 6.5 到 6.6、6.7、6.8，每个版本都带来了不少改进。正因为这种「先把 6.x 做好」的策略，7.0 的发布时间比预期晚了不少，但换来的是一个更成熟的大版本。7.0 系列带来了不少值得期待的变化：新增了 [[PayPal]] Vault 支付网关，[[Virtualizor]] 集成增加了重启、关机和启动操作，升级/降级功能也做了改进。而 7.0.1 作为第一个维护版本，进一步移除了自动升级对 shell_exec 的依赖改用 [[ZipArchive]]，修复了大量 [[Stripe]]、[[DirectAdmin]]、[[Enhance]] 集成的问题，同时优化了管理界面的 UI 和性能。值得一提的是，7.0 的变化主要集中在管理后台界面，客户端区域的改动不大，所以对终端用户的影响是比较小的。

升级前的准备工作

在动手升级之前，有几个前置条件必须先确认，否则升级过程中可能会遇到各种报错。

服务器环境要求

7.0.1 对服务器环境提出了新的要求，最关键的是 PHP 版本。最低需要 [[PHP]] 8.2，配合 ionCube Loader 14.0。如果你的服务器还在跑 PHP 7.x 或者 8.0/8.1，那必须先升级 PHP。另外如果你打算用 PHP 8.4，那还需要 ionCube Loader 15.0。除了 PHP 版本之外，还需要确保 ZipArchive 扩展已启用，因为 7.0.1 的自动升级机制从 shell_exec 切换到了 ZipArchive。

检查当前环境可以用以下命令：

# 检查 PHP 版本，确认 >= 8.2
php -v

# 检查 ionCube Loader 是否已安装
php -m | grep ionCube

# 检查 ZipArchive 扩展
php -m | grep zip

如果 PHP 版本不满足要求，根据你的操作系统和面板，先完成 PHP 的升级。以 Ubuntu + [[Nginx]] 为例，可以通过 ppa:ondrej/php 仓库来安装 PHP 8.2 或更高版本，然后安装对应版本的 ionCube Loader。

备份数据

这一步无论如何不能跳过。升级大版本出问题的概率不算低，尤其是从 6.6.1 直接跳到 7.0.1 中间跨越了好几个版本的数据库迁移脚本。一定要做好完整备份，万一升级失败还能回滚。

数据库备份：

mysqldump -u username -p clientexec_db > clientexec_backup_$(date +%Y%m%d).sql

文件备份：

cp -r /path/to/clientexec /path/to/clientexec_backup_$(date +%Y%m%d)

备份时特别注意两个关键文件和目录，它们在后续升级中必须保留，不能被覆盖：config.php 是你的核心配置文件，包含数据库连接信息等；uploads/ 目录存放了用户上传的所有文件。这两样东西丢了基本就是灾难性的，所以务必确认备份完整。

自动升级方式

如果你的服务器环境一切就绪，自动升级是最简单的方式。登录 Clientexec 管理后台之后，页面底部通常会显示一条 “New Version Available” 的提示信息。点击这个链接，系统会引导你完成整个升级流程，包括下载新版本文件、替换旧文件和执行数据库迁移。

需要注意的是，在 6.6.1 版本上执行自动升级时，系统仍然依赖 shell_exec 函数。如果你的 PHP 环境禁用了这个函数（很多共享主机默认禁用），自动升级会失败。这种情况下要么在 php.ini 中临时启用 shell_exec，要么选择下面的手动升级方式。好消息是一旦升级到 7.0.1，后续的自动升级就不再需要 shell_exec 了，因为改用了 ZipArchive 来处理文件解压。

手动升级方式

如果自动升级不可用或者你更喜欢可控的操作，手动升级也不复杂，按照以下步骤操作即可。

下载安装包

首先从 Clientexec 官方下载页面 下载 7.0.1 的安装包。下载时记得选择 ionCube 编码版本。下载完成后在本地解压这个压缩包。

替换服务器文件

通过 FTP 或 SFTP 连接到你的服务器，找到 Clientexec 的安装目录。这一步的核心操作是：删除服务器上 Clientexec 目录中除了 config.php 文件和 uploads/ 目录以外的所有内容，然后把本地解压出来的新文件上传上去。上传时同样要注意，不要用下载包里自带的 config.php 覆盖你服务器上的那份，否则数据库连接等配置就丢了。

# 如果你有 SSH 访问权限，也可以通过命令行操作
cd /path/to/clientexec

# 先移走需要保留的文件
mv config.php /tmp/clientexec_config.php
mv uploads /tmp/clientexec_uploads

# 清理旧文件
rm -rf *

# 解压新版本文件
unzip /path/to/clientexec-7.0.1.zip -d .

# 恢复配置文件和上传目录
mv /tmp/clientexec_config.php config.php
rm -rf uploads
mv /tmp/clientexec_uploads uploads

执行数据库迁移

文件替换完成后，在浏览器中访问你的 Clientexec 安装地址并在末尾加上 /install.php，例如 https://billing.example.com/install.php。页面会显示升级向导，自动检测当前数据库版本并执行所有必要的迁移脚本。因为从 6.6.1 到 7.0.1 中间跨越了多个版本（6.7、6.8、7.0），迁移脚本会按版本顺序依次执行，这个过程可能需要几分钟时间，耐心等待即可。

升级后的验证

升级完成后不要急着宣布成功，先做一轮完整的检查。登录管理后台，在页面底部确认版本号已经显示为 7.0.1。然后逐个检查关键功能模块：支付网关是否正常连接，域名管理是否正常工作，工单系统能否正常创建和回复，自动化任务（cron jobs）是否正常运行。另外也要从客户端角度测试一下，确保客户能正常登录、查看服务、提交工单等。

如果页面上有安全提示要求删除 install.php，按照提示操作即可。这个文件在升级完成后留在服务器上是一个安全隐患，因为任何人访问它都可能触发重新安装流程。

常见问题和注意事项

从 6.6.1 直接升级到 7.0.1 是一次跨多个中间版本的大跳跃，虽然升级脚本设计上会自动处理所有中间版本的迁移，但实际操作中还是有一些值得注意的地方。如果条件允许，强烈建议先在一个测试环境中跑一遍完整的升级流程，确认没有问题后再在生产环境上操作。可以复制一份数据库和文件到测试服务器上先试跑，这样即使出了问题也不会影响正式业务。

如果升级过程中遇到了无法自行解决的问题，可以在 Clientexec 论坛 的安装升级板块寻求帮助，也可以提交官方工单。如果不想自己折腾，Clientexec 还提供了一个 35 美元的付费升级服务，由官方团队帮你完成整个升级过程。

最后

这次从 Clientexec 6.6.1 升级到 7.0.1 的过程总体来说是比较顺利的，关键在于升级前的准备工作要做充分，尤其是 PHP 版本检查和数据备份这两步。7.0 系列在管理界面上的改进确实让日常操作更加流畅，新增的 PayPal Vault 和 Virtualizor 功能对于做主机业务的人来说也是实实在在的改善。如果你还在 6.x 版本上犹豫要不要升级，我的建议是趁着 7.0.1 已经修复了一批初始 bug，现在是一个不错的升级时机。