OpenCart: 후크 설정 및 제거 방법

모듈 개발자로서 일상적인 OpenCart 사용자 정의 모듈 개발에서 사용자 정의 아키텍처를 생성해야 하는 경우가 많습니다. 다른 프레임워크와 마찬가지로 OpenCart 모듈 아키텍처에서 다양한 후크 형태로 구성되었습니다.

위 후크를 계속 탐색하기 전에 OpenCart의 확장 기능 개념을 살펴보겠습니다. 위에서 아래로 살펴보면 OpenCart의 핵심 기능을 풍부하게 할 수 있는 OpenCart의 확장입니다. 이를 설치하면 간단한 이미지 갤러리이든 멋진 드래그 앤 드롭 기능이든 프런트 엔드 스토어에 기능을 추가할 수 있습니다.

또한 확장 프로그램은 제공하는 기능에 따라 논리적 그룹으로 분류됩니다. 간단한 예로 결제 확장 프로그램은 프런트엔드 결제에 새로운 결제 방법을 추가하는 한편, 매장에서 스팸 활동을 감지할 수 있는 사기 방지 확장 프로그램입니다. 백엔드로 이동하여 OpenCart가 지원하는 다양한 유형의 확장 프로그램을 보여주는 Extensions 메뉴 아래의 목록을 살펴보세요.

모듈도 OpenCart의 또 다른 확장이라는 사실을 알면 놀랄 것입니다. 각 확장은 OpenCart 생태계에서 작동하는 방식에 대한 일반적인 작업 흐름을 중심으로 구축되었습니다. 후크를 사용하면 모듈 활성화 중 설치 후크를 실행하거나 제거 중 가비지 정리 등 특정 이벤트를 기반으로 특정 작업을 수행할 수 있습니다.

이 문서에서는 이러한 설치 및 제거 후크에 대해 설명합니다. 모듈의 맥락에서 논의되지만 다른 유형의 확장에도 동일한 접근 방식을 적용하는 데 방해가 되는 내용은 없으므로 자유롭게 이 파일을 직접 탐색해 보세요.

이 튜토리얼의 코드 조각을 제공하는 최신 버전의 OpenCart입니다. 이 글을 쓰는 시점에서는 2.1.0.2 안정 버전입니다.

단계별 설치 후크

이 섹션에서는 장착 후크의 구체적인 용도를 살펴보겠습니다. 즐겨 사용하는 텍스트 편집기에서 admin/controller/extension/module.php，然后找到 install 메소드를 열어보세요. 다음과 같아야 합니다:

으아악

이것은 백엔드에서 모듈을 설치하려고 할 때마다 호출되는 모듈용 범용 설치 후크입니다. 이 방법의 중요한 부분을 살펴보겠습니다.

먼저 후속 활동에 필요한 모델 파일을 로드합니다. $this->model_extension_extension->install 메소드 호출은 이 특정 모듈에 대한 항목이 데이터베이스에 추가되도록 합니다.

다음은 addPermission 메서드를 호출하여 수행되는 몇 가지 ACL 작업입니다. 이는 현재 사용자 관리자가 모듈별 설정에 액세스하고 이를 변경할 수 있도록 보장합니다.

마지막으로 설치 중인 모듈의 install 方法。不要与我们已经使用的 install 方法混淆 - 它会调用模块特定的 install 메서드를 호출합니다(존재하는 경우).

예를 들어 Login with PayPal 모듈을 설치하려고 하면 아래와 같이 admin/controller/module 中定义的安装方法/pp_login.php 파일이 호출됩니다.

으아악

OpenCart 2.x는 출시 이후 몇 가지 흥미로운 기능을 포함했으며 Event Observer도 그 중 하나입니다. 이를 통해 다른 모듈이 관찰자를 설정할 수 있는 모듈별 이벤트를 추가하여 특정 이벤트가 트리거될 때 임의의 코드를 실행할 수 있습니다. 이것이 바로 post.customer.logout 사용자 정의 이벤트를 추가하는 위의 설치 방법에서 설명한 내용입니다!

Login with PayPal 모듈에 관한 한 매우 간단하지만 때로는 사용자 정의 스키마 등을 삽입하려는 경우 더 많은 것이 필요할 수 있습니다. PayPal Express Checkout 결제 확장 프로그램에서 설치 방법을 가져오겠습니다. 계속 열어보세요 admin/controller/ payment/pp_express.php.

으아악

먼저 해당 모델 파일을 로드하고 해당 파일을 사용하여 모델의 install 메서드를 호출합니다. 경험상 모드를 작동하고 싶을 때마다 해당 코드를 컨트롤러의 마운트 메소드에 직접 넣기보다는 모델의 마운트 메소드에서 구현해야 합니다.

이제 모델 파일admin/model/ payment/pp_express.php에 정의된 설치 방법을 빠르게 가져와 보겠습니다.

으아악

드디어 감사할 일이 생겼습니다! 보시다시피 OpenCart의 데이터베이스 API를 사용하여 여러 사용자 정의 MySQL 테이블이 생성되었습니다. 따라서 모델의 설치 방법을 이용하여 데이터베이스 관련 변경 사항을 적용하는 방법은 다음과 같습니다.

마운팅 후크에 관한 한, 이것이 전부입니다. 언뜻 보이는 것만큼 복잡하지 않기를 바랍니다. 이렇게 표현해보자. 프로세스는 확장별 설치 방법을 트리거하여 시작되며, 설치 중인 확장의 설치 메서드(있는 경우)를 호출합니다. 마지막으로 확장에 데이터베이스 작업이 필요한 경우 모델의 설치 메소드는 컨트롤러의 설치 메소드에서 호출됩니다.

浏览卸载挂钩

本节与上一节相对应，重点介绍卸载挂钩中发生的情况。我们将按照与上一节中的 install 方法相同的方式进行操作，因此让我们立即从文件 admin/ 中获取 <code class="inline">uninstall 挂钩的代码控制器/扩展/module.php。

<?php
  ...
  public function uninstall() {
    $this->load->language('extension/module');

    $this->document->setTitle($this->language->get('heading_title'));

    $this->load->model('extension/extension');

    $this->load->model('extension/module');

    if ($this->validate()) {
      $this->model_extension_extension->uninstall('module', $this->request->get['extension']);

      $this->model_extension_module->deleteModulesByCode($this->request->get['extension']);

      $this->load->model('setting/setting');

      $this->model_setting_setting->deleteSetting($this->request->get['extension']);

      // Call uninstall method if it exists
      $this->load->controller('module/' . $this->request->get['extension'] . '/uninstall');

      $this->session->data['success'] = $this->language->get('text_success');

      $this->response->redirect($this->url->link('extension/module', 'token=' . $this->session->data['token'], 'SSL'));
    }

    $this->getList();
  }
  ...
?>

同样，它看起来应该有点熟悉，因为其中大部分是样板代码。首先的重要代码片段是调用 uninstall 方法，该方法从 扩展 MySQL 表中删除当前正在卸载的扩展的条目。

接下来，它调用 deleteModulesByCode，这会删除与扩展关联的模块。这是一种特殊方法，只能在这种模块类型的扩展中找到 - 您不会在其他扩展中找到它，例如付款、运输、欺诈等。

原因是您可以复制每个模块来创建多个实例。例如，您可以在不同的页面上显示不同的横幅模块。另一方面，复制其他类型的扩展没有任何意义。再次举个例子，前端的 PayPal 付款扩展只需要一个实例。

接下来，它通过调用 deleteSetting 方法删除与该模块相关的配置变量。最后，它调用正在卸载的模块的 uninstall 方法。

让我们打开 admin/controller/module/pp_login.php 看看卸载方法是什么样的。

<?php
  ...
  public function uninstall() {
    $this->load->model('extension/event');

    $this->model_extension_event->deleteEvent('pp_login');
  }
  ...
?>

很简单吧？它只是撤消注入到使用 PayPal 登录模块的安装方法中的内容。回想一下，我们在安装过程中创建了一个新事件 post.customer.logout，因此显然我们需要在卸载过程中删除它，以确保我们不会留下任何特定于模块的垃圾。 p>

此外，我们还可以快速了解一下 PayPal Express Checkout 付款扩展程序的卸载方法，就像我们在前面部分中介绍的安装方法一样。获取 admin/controller/ payment/pp_express. 的以下片段。

<?php
  ...
  public function uninstall() {
    $this->load->model('payment/pp_express');
    $this->model_payment_pp_express->uninstall();
  }
  ...
?>

完全符合预期——它加载模型并调用卸载方法。这也给了我们打开模型文件 admin/model/ payment/pp_express.php 并探索卸载方法的充分理由。

<?php
  ...
  public function uninstall() {
    $this->db->query("DROP TABLE IF EXISTS `" . DB_PREFIX . "paypal_order_transaction`;");
    $this->db->query("DROP TABLE IF EXISTS `" . DB_PREFIX . "paypal_order`;");
  }
  ...
?>

我们只是删除之前创建的 MySQL 表，因为我们不希望有人问我们，“你怎么能留下这些垃圾？”

所以，这就是 OpenCart 中安装和卸载挂钩的故事，希望不错。下一部分也是最后一部分快速总结了迄今为止在一个简单但有效的自定义模块中学到的概念，因为这在你的小猫后理论课程中是一件很好的事情。

使用安装/卸载挂钩创建/删除自定义架构

在本节中，我们将创建一个管理模块演示，除了在安装期间创建新架构并在卸载期间删除它之外，该模块不会做太多事情。

首先，让我们创建一个语言文件，以便在后端拾取该模块。继续创建一个包含以下内容的文件 admin/language/english/module/demo.php 。

<?php
// Heading
$_['heading_title']    = 'Demo Module';

接下来，我们需要创建一个模型文件来保存自定义模块的实际且有趣的代码。模型文件应放置在 admin/model/module/demo.php。它在 install 方法中创建一个演示 MySQL 表，并将其放入 uninstall 方法中。

<?php
class ModelModuleDemo extends Model {
  public function install() {
    $this->db->query("
      CREATE TABLE IF NOT EXISTS `" . DB_PREFIX . "demo` (
        `demo_id` int(11) NOT NULL AUTO_INCREMENT,
        `name` VARCHAR(100) NOT NULL,
        PRIMARY KEY (`demo_id`)
      ) ENGINE=MyISAM DEFAULT COLLATE=utf8_general_ci;");
  }

  public function uninstall() {
    $this->db->query("DROP TABLE IF EXISTS `" . DB_PREFIX . "demo`;");
  }
}

最后，继续创建一个包含以下内容的控制器文件 admin/controller/module/demo.php 。

<?php
class ControllerModuleDemo extends Controller {
  public function install() {
    $this->load->model('module/demo');
    $this->model_module_demo->install();
  }
  
  public function uninstall() {
    $this->load->model('module/demo');
    $this->model_module_demo->uninstall();
  }
}

它应该很简单 - 它加载模型并根据正在执行的操作调用相应的方法。

来吧，尝试一下。它应该在扩展 > 模块下列为演示模块。安装它，你应该会看到后端创建的 demo MySQL 表，当然不要忘记卸载它以删除该表。

结论

今天，我们讨论了 OpenCart 安装过程的一个重要方面，即安装和卸载挂钩。我们详细介绍了这些挂钩，并在本文的后面部分构建了一个简单的模块作为概念证明。

当然，欢迎提问和评论！

위 내용은 OpenCart: 후크 설정 및 제거 방법의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!