搬家前的准备工作

在开始任何操作之前,请务必备份！备份！备份！重要的事情说三遍。

获取所有登录信息：

• 原服务器信息：
  • FTP/SFTP 用户名和密码
  • 数据库主机名、数据库名、数据库用户名、数据库密码
  • cPanel/Plesk 等控制面板登录信息（可选，但方便）
• 新服务器信息：
  • FTP/SFTP 用户名和密码
  • 数据库主机名、数据库名、数据库用户名、数据库密码
  • 新服务器的 IP 地址或域名
  • 新服务器的 PHP 版本和设置（确保与原服务器兼容，特别是 memory_limit 和 upload_max_filesize）

准备新服务器：

• 在新服务器上安装一个全新的 Zen Cart 版本，不需要配置，只需解压并上传文件即可，这能确保你有正确的文件结构。
• 在新服务器的数据库中,创建一个新的空数据库和对应的数据库用户，并授予所有权限。

搬家详细步骤

第一步：备份原网站

这是最关键的一步,防止意外发生。

1. 备份数据库：

   
   （图片来源网络，侵删）
   • 登录你的原服务器 cPanel 或使用 phpMyAdmin。
   • 进入 phpMyAdmin，选择你的 Zen Cart 数据库。
   • 点击“导出”选项卡。
   • 选择“快速”导出方式，确保格式为“SQL”。
   • 点击“执行”，将 .sql 文件下载到你的本地电脑。

2. 备份数据文件：

   • 使用 FTP/SFTP 客户端（如 FileZilla）连接到原服务器。
   • 下载整个 Zen Cart 网站文件夹（通常是 public_html 或 www 目录下的整个网站根目录）。
   • 重要： 你不需要下载 cache 和 logs 目录下的内容，这些是运行时生成的文件，但为了保险，可以下载整个目录，然后在之后清理。

第二步：上传文件到新服务器

1. 清空新服务器上的文件：

   • 通过 FTP/SFTP 连接到新服务器。
   • 删除你在新服务器上安装的那个“全新”但未配置的 Zen Cart 文件夹里的所有内容。

2. 上传原网站文件：

   • 将你在第一步中下载的整个 Zen Cart 网站文件夹（通过 FTP 客户端）上传到新服务器的 public_html 或 www 目录中。
   • 确保文件和目录的权限设置正确。
     • 所有目录权限设置为 755。
     • 所有文件权限设置为 644。
     • includes/configure.php 和 admin/includes/configure.php 可能需要设置为 644 或 444（具体取决于服务器安全设置）。
   • 大多数 FTP 客户端（如 FileZilla）都有“递归更改权限”或“文件属性”功能，可以一次性设置。

第三步：更新数据库信息（核心步骤）

这是让 Zen Cart 知道它的新家在哪里的关键一步。

1. 编辑 includes/configure.php 文件：

   • 通过 FTP 下载 includes/configure.php 文件到本地电脑。

   • 用文本编辑器（如 Notepad++, VS Code，不要用记事本）打开它。

   • 修改以下两行：

     // 修改为你的新域名
     define('HTTP_SERVER', 'https://www.yournewdomain.com');
     define('HTTPS_SERVER', 'https://www.yournewdomain.com');
     // 修改为你的新网站在服务器上的物理路径
     // 可以通过在服务器上创建一个 phpinfo.php 文件，访问后查看 "DOCUMENT_ROOT" 来获取这个值
     define('DIR_FS_CATALOG', '/home/username/public_html/');

   • 保存文件,然后通过 FTP 上传回原位置，覆盖旧文件。

2. 编辑 admin/includes/configure.php 文件：

   • 同样地,下载 admin/includes/configure.php 文件。

   • 修改以下几行：

     // 修改为你的新域名
     define('HTTP_SERVER', 'https://www.yournewdomain.com');
     define('HTTPS_SERVER', 'https://www.yournewdomain.com');
     // 修改为你的新网站在服务器上的物理路径
     define('DIR_FS_ADMIN', '/home/username/public_html/admin/');
     // 数据库连接信息，修改为你在新服务器上创建的信息
     define('DB_SERVER', 'localhost'); // 或新数据库主机地址
     define('DB_SERVER_USERNAME', 'new_db_user');
     define('DB_SERVER_PASSWORD', 'new_db_password');
     define('DB_DATABASE', 'new_db_name');
     define('DB_PREFIX', 'zen_'); // 保持与原数据库前缀一致

   • 保存文件,然后上传回原位置。

第四步：导入数据库

1. 清空新数据库：

   • 登录新服务器的 phpMyAdmin。
   • 选择你在新服务器上创建的那个空数据库。
   • 点击“清空”或“删除所有表”，确保数据库是空的。

2. 导入数据库：

   • 在 phpMyAdmin 的顶部，点击“导入”选项卡。
   • 选择你第一步中下载的 .sql 备份文件。
   • 点击“执行”，等待导入完成。

第五步：更新数据库中的绝对路径

Zen Cart 在数据库中也存储了一些文件路径，这些也需要更新。

1. 执行 SQL 查询：

   • 在新服务器的 phpMyAdmin 中，选择你的 Zen Cart 数据库。
   • 点击“SQL”选项卡。
   • 在输入框中粘贴以下 SQL 语句，并根据你的新路径修改 DIR_FS_CATALOG 的值：

     UPDATE configuration SET configuration_value = '/home/username/public_html/' WHERE configuration_key = 'HTTP_SERVER';
     UPDATE configuration SET configuration_value = 'https://www.yournewdomain.com/' WHERE configuration_key = 'HTTPS_SERVER';
     UPDATE configuration SET configuration_value = '/home/username/public_html/' WHERE configuration_key = 'DIR_FS_CATALOG';

   • 点击“执行”。

2. （可选但推荐）检查并更新 admin 路径：

   • 执行以下 SQL 查询，确保管理后台路径也正确：

     UPDATE admin SET admin_dir = 'admin' WHERE admin_id = 1; -- 确保管理目录名正确

第六步：清理和最终检查

1. 设置文件权限：

   • 再次通过 FTP 检查并设置以下目录的权限为 777（或 755，根据服务器要求，777 更安全）：
     • cache
     • images
     • pub
     • admin/backups
   • 搬家完成后,记得将这些权限改回 755。

2. 清空缓存：

   • 通过 FTP 删除 cache 目录下的所有文件（可以保留一个 .htaccess 文件）。

3. 检查 configure.php 文件：

   • 将 includes/configure.php 和 admin/includes/configure.php 的权限改回 644。

4. 更新 robots.txt 和 .htaccess：

   • 如果你的 robots.txt 或 .htaccess 文件中硬编码了旧域名，请手动更新它们。

第七步：测试网站

这是验证搬家是否成功的最后一步。

1. 清空浏览器缓存： 按 Ctrl + F5 (Windows) 或 Cmd + Shift + R (Mac) 强制刷新浏览器。
2. 访问前台： 在浏览器中输入你的新域名，检查网站是否正常显示，图片、CSS、JS 是否都加载正确。
3. 访问后台： 访问 https://www.yournewdomain.com/admin/，使用你的管理员账号登录，检查管理后台是否正常。
4. 测试功能：
   • 尝试添加商品到购物车。
   • 尝试结账流程（如果使用测试支付网关）。
   • 检查产品图片是否能正常显示。
   • 检查联系表单等是否工作正常。

常见问题与解决方案

• 问题1：网站显示空白页或错误。
  • 原因： 通常是 includes/configure.php 或