OpenCart 技术文档

1. 安装指南

1.1 系统要求

• PHP 版本 >= 8.0
• 确保服务器支持 MySQL 或 MariaDB 数据库
• 确保服务器支持 Apache 或 Nginx 作为 Web 服务器

1.2 安装步骤

1. 下载 OpenCart 的最新版本。
2. 解压缩下载的文件。
3. 将解压后的文件上传到您的服务器。
4. 确保 config.php 和 admin/config.php 文件具有写权限。
5. 通过浏览器访问您的服务器地址，进入安装向导。
6. 按照安装向导的步骤完成安装。

2. 项目的使用说明

2.1 后台管理

• 安装完成后，您可以通过访问 http://yourdomain.com/admin 进入后台管理界面。
• 使用安装时设置的管理员用户名和密码登录。

2.2 前台使用

• 前台是您的在线商店，用户可以浏览商品、添加到购物车并完成购买。
• 您可以通过后台管理界面添加商品、设置价格、管理订单等。

3. 项目API使用文档

3.1 API 概述

OpenCart 提供了一套 RESTful API，允许开发者与平台进行交互。

3.2 API 认证

• 使用 API 密钥进行认证。
• 在后台管理界面生成 API 密钥。

3.3 常用 API 示例

• 获取商品列表: GET /index.php?route=api/product/list
• 创建订单: POST /index.php?route=api/order/create
• 获取订单详情: GET /index.php?route=api/order/detail&order_id=1

4. 项目安装方式

4.1 手动安装

• 按照上述安装指南中的步骤进行手动安装。

4.2 Docker 安装

• 确保您的本地机器上已安装 Docker Desktop。
• 在项目文件夹中运行 docker-compose up -d 启动容器。
• 通过浏览器访问 http://localhost 进入安装向导。

5. 版本控制

OpenCart 使用 MAJOR.MINOR.FEATURE.PATCH 的版本号格式：

• MAJOR: 重大更新，通常涉及核心代码的重写。
• MINOR: 核心结构的显著变化。
• FEATURE: 新增功能或扩展。
• PATCH: 修复错误。

6. 贡献指南

• 通过 GitHub 提交 Pull Request。
• 确保代码符合 OpenCart 的编码标准。
• 提交的 Pull Request 必须有明确的描述。

7. 许可证

OpenCart 使用 GNU General Public License version 3 (GPLv3) 许可证。