ZenCart本地安装步骤是怎样的？

第一步：准备工作

在开始之前,请确保你已经准备好以下几样东西：

1. 本地服务器环境：Zen Cart 是一个 PHP 应用程序，需要一个 Web 服务器（如 Apache）、PHP 解释器和数据库（如 MySQL）来运行。

   • 推荐方案：安装 XAMPP
     • Windows: 访问 Apache Friends XAMPP for Windows 下载页面，下载最新稳定版的 XAMPP（XAMPP for Windows）。
     • macOS: 访问 Apache Friends XAMPP for macOS 下载页面，下载 DMG 文件。
     • Linux: 访问 Apache Friends XAMPP for Linux 下载页面，下载 TAR 文件。
   • 安装 XAMPP: 运行下载的安装程序，按照向导的提示进行安装，在安装过程中，通常会询问你想要安装哪些组件，请确保勾选 Apache 和 MySQL (MariaDB)，其他组件（如 Mercury Mail, FileZilla）可以不选。

2. Zen Cart 安装包：

   • 访问 Zen Cart 官方网站 https://www.zen-cart.com/
   • 在导航菜单中找到 "Download"，下载最新的稳定版 Zen Cart 安装包（通常是一个 .zip 或 .tar.gz 文件）。

3. 代码编辑器：

   • 你需要一个代码编辑器来修改配置文件,推荐使用 Visual Studio Code (VS Code)、Sublime Text 或 Notepad++，VS Code 是免费且功能强大的。

第二步：安装与配置 XAMPP

1. 启动 XAMPP 控制面板：

   
   （图片来源网络，侵删）

   安装完成后,在你的开始菜单或应用程序文件夹中找到并启动 "XAMPP Control Panel"。

2. 启动 Apache 和 MySQL 服务：

   • 在 XAMPP 控制面板中，找到 "Apache" 和 "MySQL" 这两行。
   • 点击每一行旁边的 "Start" 按钮，这两个服务的状态应该会变成 "Running"（运行中）。
   • 重要提示： 在你进行 Zen Cart 安装和测试期间，请保持这两个服务处于运行状态。

第三步：准备 Zen Cart 文件

1. 解压 Zen Cart 安装包：

   • 找到你下载的 Zen Cart 压缩包（zen-cart-v2.x.x.zip）。
   • 将其解压到一个你容易找到的文件夹中。

2. 移动文件到 XAMPP 的 Web 目录：

   • XAMPP 的 Web 根目录（即你的网站文件存放的地方）通常是：
     • Windows: C:\xampp\htdocs\
     • macOS: /Applications/XAMPP/htdocs/
     • Linux: /opt/lampp/htdocs/
   • 将解压后的 Zen Cart 文件夹（zen-cart-v2.x.x）中的（注意是内容，而不是文件夹本身）复制并粘贴到 htdocs 文件夹中。
   • 为了方便访问,你可以将 htdocs 文件夹中的 Zen Cart 文件夹重命名为一个简单的名字，zencart。

   操作示例：

   • 假设你的 Zen Cart 解压后，文件夹内包含 admin, cache, docs 等文件夹和 index.php 等文件。
   • 你需要把这些所有文件和文件夹，都移动到 C:\xampp\htdocs\ (或对应系统的路径) 下。
   • 移动后,htdocs 文件夹里就有一个名为 zencart 的文件夹，里面就是 Zen Cart 的所有文件。

第四步：创建数据库

Zen Cart 需要一个数据库来存储产品信息、订单、客户数据等。

1. 打开 phpMyAdmin：

   • 在你的浏览器中访问 http://localhost/phpmyadmin/，这是 XAMPP 自带的一个数据库管理工具。

2. 创建新数据库：

   • 在 phpMyAdmin 的主界面，找到顶部的 "新建" 选项卡，点击它。
   • 在 "数据库名称" 输入框中，为你的 Zen Cart 数据库起一个名字，zencart_db。
   • 在 "排序规则" (Collation) 中，选择 utf8mb4_unicode_ci，这是推荐的设置，可以很好地支持多语言和特殊字符。
   • 点击 "创建" 按钮，现在你已经成功创建了一个空的数据库。

第五步：运行安装向导

现在万事俱备,可以开始安装了。

1. 启动安装程序：

   • 在你的浏览器中访问 Zen Cart 的安装地址，根据你之前的操作，地址应该是： http://localhost/zencart/
   • 如果你的 XAMPP Apache 端口不是默认的 80，或者你使用了虚拟主机，请相应调整地址。

2. 检查环境：

   • 访问后,你会看到一个 "Pre-Installation Check"（安装前检查）页面，它会检查你的服务器环境是否符合 Zen Cart 的要求。
   • 如果看到红色的 "Fail"（失败）标记，通常是因为你没有启动 XAMPP 中的 Apache 或 MySQL 服务，或者 PHP 的版本不兼容，请返回第二步检查。
   • 如果看到绿色的 "Pass"（通过）标记，说明环境基本正常，如果有一两个小问题（如 register_globals），通常不影响安装，可以忽略。

3. 开始安装：

   • 点击页面底部的 "Click here to start your installation"（点击此处开始安装）链接。

4. 填写数据库信息：

   • Database Server: 留空或填写 localhost（默认值）。
   • Database Username: 输入数据库用户名，对于 XAMPP 本地环境，默认是 root。
   • Database Password: 输入数据库密码。注意： 新版的 XAMPP 出于安全考虑，root 用户默认是没有密码的，所以这里可能需要留空，或者如果你之前设置过密码，就输入你的密码。
   • Database Name: 输入你在第四步创建的数据库名，zencart_db。
   • Table Prefix: 数据库表前缀，保持默认的 zen_ 即可，这可以防止与其他程序冲突。
   • Admin Directory: 管理员文件夹名称，保持默认的 admin 即可。
   • 点击 "Next"。

5. 设置商店信息：

   • HTTP Server Address (Domain Name): 你的商店域名，本地安装可以填写 http://localhost/zencart/。
   • HTTPS Server Address: 如果没有使用 SSL，可以留空。
   • Enable SSL: 选择 False。
   • Store Name: 输入你的商店名称，"我的 Zen Cart 测试店"。
   • Email Address: 输入一个你的电子邮件地址，用于接收订单通知等。
   • Country: 选择你的国家。
   • Currency: 选择你使用的货币。
   • 点击 "Next"。

6. 管理员账户设置：

   • Admin User Name: 设置你的管理员用户名，admin。
   • Admin Password: 设置一个强密码。
   • Admin Password (again): 再次输入密码。
   • 点击 "Next"。

7. 完成安装：

   • 安装程序现在会开始创建数据库表、插入初始数据，这个过程很快。
   • 完成后,你会看到一个 "Installation Complete"（安装完成）的页面。
   • 非常重要的一步： 点击页面底部的 "Click here to delete the 'install' directory"（点击此处删除 'install' 目录）链接。
   • 为什么必须删除？ install 目录包含了安装程序，删除它可以防止任何人通过浏览器重新运行安装，从而保护你的商店安全。

第六步：访问你的商店

1. 访问前台商店：

   • 在浏览器中访问 http://localhost/zencart/。
   • 你应该能看到你的 Zen Cart 商店前台首页了！恭喜你！

2. 访问后台管理：

   • 在浏览器中访问 http://localhost/zencart/admin/。
   • 输入你刚才设置的管理员用户名和密码,然后登录。
   • 登录后,你就可以进入 Zen Cart 的后台管理界面，开始配置你的商店、添加产品了。

常见问题与解决方法

• 问题1：访问 http://localhost/zencart/ 时出现 404 或找不到页面。

  • 原因： 文件没有正确放到 htdocs 目录，或者路径错误。
  • 解决： 检查 htdocs 文件夹里是否有 zencart 文件夹，以及 zencart 文件夹内是否有 index.php 文件。

• 问题2：安装时连接数据库失败。

  • 原因： 数据库名、用户名、密码错误，或者 MySQL 服务没有启动。
  • 解决：
    1. 确认 XAMPP 控制面板中的 MySQL 服务状态是 "Running"。
    2. 确认数据库名是 zencart_db（或你自己设置的）。
    3. 确认用户名是 root。
    4. 确认密码,XAMPP 是新安装的，root 用户通常没有密码，尝试留空。

• 问题3：页面样式错乱，缺少 CSS 和图片。

  • 原因： Zen Cart 的 .htaccess 文件可能被阻止了，或者 Apache 的 mod_rewrite 模块没有启用。
  • 解决：
    1. 检查 zencart 文件夹下的 .htaccess 文件是否存在，并且没有被重命名。
    2. 在 XAMPP 控制面板中，点击 Apache 的 "Config" -> "httpd.conf"。
    3. 在打开的文件中,搜索 LoadModule rewrite_module，确保该行没有被注释（行首没有 ）。
    4. 保存文件并重启 Apache 服务。

• 问题4：安装完成后，无法进入后台，提示密码错误。

  • 原因： 可能是浏览器缓存问题，或者密码输入错误。
  • 解决：
    1. 清除浏览器缓存和 Cookie，然后重试。
    2. 确保输入的密码是你在安装步骤中设置的,而不是数据库的 root 密码。

现在你已经成功地在本地安装了 Zen Cart！接下来你可以在后台尽情探索，添加商品、设置支付方式、配置运费等，而不用担心会影响任何线上数据。