OpenCart程序结构与业务逻辑

一、程序业务逻辑说明

在 OpenCart 中，index.php 文件是整个应用程序的入口文件，它负责初始化应用程序并调度请求。以下是 index.php 文件加载执行的流程：

1. **设置路径常量：** 
   - index.php 首先定义了一些重要的路径常量，如 `DIR_APPLICATION`、`DIR_SYSTEM`、`DIR_LANGUAGE` 等，这些常量指向了不同的目录，便于后续引用。

2. **引入框架文件：**
   - 通过引入系统目录下的 `startup.php` 文件，初始化了系统框架。`startup.php` 文件主要负责加载系统核心文件和必要的函数。

3. **加载配置：**
   - 使用 `Registry` 类加载了配置文件（config.php）中的配置信息，包括数据库连接、错误报告等。

4. **引入数据库类：**
   - 通过加载 `DB` 类的实例化对象，为后续数据库操作做准备。

5. **加载公共函数库：**
   - 引入 `library` 目录下的公共函数库文件（`common.php`），其中包含了许多通用的函数，方便后续调用。

6. **启动 Session：**
   - 如果启用了 Session，会初始化 Session。

7. **加载路由：**
   - 根据 URL 中的参数，解析并确定要加载的控制器和方法，以及传递给它们的参数。

8. **执行控制器方法：**
   - 根据路由确定的控制器和方法，调用对应的控制器类和方法，并传递参数。

9. **输出结果：**
   - 控制器方法执行完毕后，可能会生成相应的输出，如 HTML、JSON 等，index.php 负责将这些结果返回给客户端。

10. **清理资源：**
    - 执行完控制器方法后，可能需要清理一些资源，如关闭数据库连接等。

总体来说，index.php 文件是 OpenCart 应用程序的入口，它负责初始化应用程序环境、加载所需的核心文件、处理请求路由、调度控制器方法以及输出结果，是整个应用程序执行的起点。

二、重要类文件说明

1、spl_autoload_register('library'); spl_autoload_extensions('.php'); 的作用

这两个函数都是 PHP 中用于自动加载类文件的函数，用于简化在代码中手动包含类文件的操作。

11）. `spl_autoload_register('library');`：
   - 这个函数用于注册一个或多个自动加载函数。在这里，`'library'` 是一个自定义的自动加载函数的名称。当 PHP 遇到一个尚未加载的类时，它将按顺序调用注册的自动加载函数，直到找到可以加载该类的自动加载函数为止。
   - 通常情况下，自动加载函数会根据类名来确定类文件的路径，并将其包含进来。在这里，`'library'` 可能是一个用户自定义的自动加载函数，用于加载应用程序中的类文件。

12）. `spl_autoload_extensions('.php');`：
   - 这个函数用于设置自动加载函数的文件扩展名。默认情况下，PHP 的自动加载函数会搜索 `.php` 文件作为类文件。通过调用 `spl_autoload_extensions` 函数，可以设置自动加载函数搜索的文件扩展名。
   - 在这个例子中，设置了自动加载函数的文件扩展名为 `.php`，这意味着自动加载函数将只搜索以 `.php` 结尾的文件来加载类。

综合起来，这两个函数结合起来的作用是注册一个自定义的自动加载函数（例如名为 `'library'` 的函数），并设置自动加载函数的文件扩展名为 `.php`。这样，在应用程序中使用类时，就不需要手动包含类文件了，PHP 将根据注册的自动加载函数来自动加载所需的类文件。

举例说明：

假设我们有一个简单的 PHP 应用程序，其中包含一个名为 `User` 的类，这个类定义在 `User.php` 文件中。我们可以使用 `spl_autoload_register` 和 `spl_autoload_extensions` 函数来实现自动加载这个类的文件。

首先，我们定义一个自动加载函数，例如：

```php
function custom_autoloader($class_name) {
    // 构建类文件路径
    $file_path = __DIR__ . '/' . $class_name . '.php';

    // 检查文件是否存在，如果存在则包含类文件
    if (file_exists($file_path)) {
        include_once $file_path;
    }
}
```

这个自动加载函数 `custom_autoloader` 接收一个类名作为参数，并根据类名构建类文件的路径，然后检查文件是否存在，如果存在则包含该文件。

接下来，我们使用 `spl_autoload_register` 函数注册这个自动加载函数：

```php
spl_autoload_register('custom_autoloader');
```

现在，当我们尝试使用 `User` 类时，PHP 将会自动调用 `custom_autoloader` 函数来尝试加载 `User.php` 文件，而无需手动包含文件。

```php
$user = new User();
```

另外，通过调用 `spl_autoload_extensions` 函数，我们可以设置自动加载函数的文件扩展名为 `.php`：

```php
spl_autoload_extensions('.php');
```

这样一来，PHP 在加载类文件时只会搜索以 `.php` 结尾的文件，这也是默认的行为，所以实际上这一行代码并不是必需的，但是如果我们想要显式地设置文件扩展名的话，就可以这样做。

这样，当我们创建一个新的类，并且文件名与类名相同并且以 `.php` 结尾时，PHP 将会自动加载这个类文件，而无需手动包含。

2、system/engine/event.php

opencart中$event = new Event($registry);  这段代码的作用

在 OpenCart 中，这段代码的作用是创建一个名为 `$event` 的事件对象。这个事件对象在实例化时需要传入一个注册表对象 `$registry` 作为参数。

具体来说，这段代码做了以下几件事情：

21）. 创建了一个新的 `Event` 对象：`$event = new Event($registry);`
   - 这行代码实例化了一个 `Event` 对象，并将 `$registry` 作为参数传递给它。

22）. 传递注册表对象：`$registry`
   - 注册表对象 `$registry` 在 OpenCart 中通常用于管理应用程序中的各种组件、服务和设置。它充当了一个全局容器，允许各个部分的代码之间共享数据和状态。

通过创建 `$event` 对象，并传递 `$registry` 参数，我们可以在 OpenCart 中利用事件系统来触发和监听各种事件，从而实现模块之间的解耦和灵活的扩展机制。

举例说明：

当你在 OpenCart 中创建一个事件对象 `$event = new Event($registry);` 后，你可以使用该对象来触发和监听事件。

举个例子，假设你想要在用户注册成功后发送一封欢迎邮件。你可以通过触发和监听事件来实现这个功能。

首先，在用户注册成功的地方触发一个事件，比如在注册成功的控制器中：

```php
// 用户注册成功后触发一个事件
$this->event->trigger('model/account/register/after', $customer_id);
```

在上述代码中，`$this->event` 是一个事件对象，通过调用 `trigger` 方法并传递事件名称 `'model/account/register/after'` 和用户ID `$customer_id`，触发了一个名为 `'model/account/register/after'` 的事件，并传递了用户ID作为参数。

然后，在需要监听这个事件的地方，比如在发送邮件的模块中，你可以注册一个事件监听器来处理这个事件：

```php
// 注册一个事件监听器来发送欢迎邮件
$this->event->register('model/account/register/after', new Action('module/welcome_email/send'));
```

在上述代码中，我们使用 `register` 方法来注册一个事件监听器，当事件 `'model/account/register/after'` 被触发时，会执行 `module/welcome_email/send` 这个动作（Action），发送欢迎邮件给新注册的用户。

通过这种方式，你可以利用事件系统来实现模块之间的解耦，使得你的代码更加灵活和可扩展。

3、opencart中这个代码的作用：$route = new Router($registry);

在 OpenCart 中，`$route = new Router($registry);` 这段代码用于创建一个路由器对象，并传递注册表对象 `$registry` 作为参数。通过这个路由器对象，你可以处理和解析用户的请求，将请求映射到相应的控制器和操作。

举个例子，假设用户访问了以下 URL：`http://example.com/index.php?route=product/product&product_id=123`。

在 OpenCart 中，这个 URL 的结构一般遵循这样的格式：`index.php?route=控制器/操作&参数1=值1&参数2=值2...`。

现在，我们来解析这个 URL 并找到对应的控制器和操作。我们可以使用路由器对象来完成这个任务。示例代码如下：

```php
// 创建一个路由器对象
$route = new Router($registry);

// 解析用户请求
$route->dispatch($_SERVER['REQUEST_METHOD'], $_GET['route']);
```

在上面的代码中，我们首先创建了一个路由器对象 `$route`，然后调用了路由器对象的 `dispatch` 方法，并传递了 HTTP 请求的方法（GET、POST 等）以及请求中包含的路由信息（`$_GET['route']`）作为参数。

路由器会根据传递的路由信息解析出相应的控制器和操作，并执行对应的代码来处理用户的请求。在这个例子中，路由器会找到名为 `product` 的控制器，然后调用该控制器中的 `product` 操作，并将 `product_id` 参数传递给该操作。

通过路由器对象，你可以轻松地将用户的请求路由到正确的控制器和操作，实现你的应用程序的功能。

参考资料：

opencart 单入口文件简单分析
opencart中文使用手册
opencart 模块开发详解

Opencart 之 load 类详解

Opencart 之 controller类详解

Opencart 之 Registry 类详解

opencar二次开发常用代码

OpenCart 2中的自定义控制器

OpenCart框架运行流程介绍 
OpenCart 如何安装 vQmod 教程
Opencart2.0-模式结构
OpenCart电商系统主要文件结构介绍
opencart 百度登录和百度钱包支付插件 响应式适应pc/mobile
如何使用OpenCart 2.x Event事件系统

OpenCart程序结构与业务逻辑，新手必读

OpenCart框架运行流程介绍：https://www.cnblogs.com/yunlong/p/3709684.html