为 Magento 开发自定义模块

magento 自定义模块开发是任何 magento 开发或 magento 项目的核心部分，因为在任何阶段您可能希望将自己的功能/模块集成到现有的 magento 项目中。

在本系列中，我将介绍 Magento 自定义模块开发的详细信息。

如果您想进一步开发 Magento，请查看 Envato Market 上各种有用的 Magento 扩展。

在本系列中，我指的是 Magento 社区版 1.7，尽管是自定义版本 所有版本的 Magento 中的模块结构都是相同的。在开始实际的模块开发之前，让我们快速了解 Magento 的基本结构。

每当您安装新的 Magento 时，您都会注意到以下 Magento 目录结构：

Magento MVC 结构简介

与 Joomla、CakePHP、CodeIgniter 等任何其他主要框架一样，Magento 也遵循基于 MVC 的架构，尽管这与核心 PHP MVC 架构略有不同。在这里，我将通过与简单的 PHP MVC 架构进行比较来解释 Magento 架构的差异。

PHP MVC架构

在典型的 MVC 模式中，应用程序的流程如下所示：

1. 有一个主要入口点 - index.php - 整个应用程序路由机制从这里确定。
2. 根据此路由机制和请求的 URL 模式，应用将调用适当的控制器。
3. 然后控制器调用适当的视图。
4. 最后，视图文件从模型文件收集数据并显示数据。

Magento MVC 架构

Magento 的 MVC 架构在 MVC 模式的基础上添加了几层，但应用程序的基本控制流程如下：

1. 有一个主入口点 - index.php - 整个应用程序将从这里初始化。
2. 将根据请求的 URL 调用适当的控制器。
3. 控制器定义页面并加载这些页面的布局文件。
4. 布局文件告诉控制器要使用哪些块文件。
5. 块文件从模型和帮助程序文件中收集数据并将其传递到模板文件。
6. 模板文件接收数据并呈现 html。

最初，这可能很难理解，因为它包含一些额外的层。为了更熟悉控制流程，让我们开发一个自定义的“Hello World”模块。

开始使用模块之前

• 我假设您已经拥有版本 1.7 或 1.7+ 的 Magento 工作副本（否则版本在现阶段并不重要）
• 禁用缓存。 要禁用缓存，请转至 Magento 管理面板 > 系统 > 缓存管理 > 从左侧复选框中选择所有缓存类型 > 选择操作：从右上角下拉列表中禁用 > 单击提交。

Magento 模块的结构

代码池

Magento 包含三种类型的代码池，Magento 的所有自定义模块和核心模块都驻留在其中。

1. 核心池包含默认情况下随 Magento 安装一起提供的所有核心模块。这些模块由 Magento 开发人员编写。建议不要修改这些模块，因为每当您升级 Magento 安装时，所有核心模块都将被覆盖，并且您的修改将会丢失。
2. 社区池包含由第三方程序员开发并通过 Magento Connect 安装的所有模块（即自定义模块）。这些模块通常扩展核心模块并提供自己的功能，这些功能通常可以在 Magento 中的任何地方使用。
3. 本地池包含将用于特定项目但不会在 Magento Connect 中读取的所有自定义模块

因此，我们有两种池选择：社区池或本地池。由于我们正在开发自己的项目，因此我们将使用本地池，尽管使用社区池也没有限制。

结构

Magento 模块由以下组件组成：

• 块包含用于在模板中显示数据的函数。
• 模型包含模块的业务逻辑。
• 资源模型包含用于数据库交互的函数。
• 控制器定义页面布局并阻止文件，并在请求网址时加载。
• etc包含 XML 格式的配置文件，它告诉 Magento 模块有多少个文件以及模块如何交互。
• 帮助程序包含用于定义常见业务逻辑（例如图像调整大小、验证）的函数。这些函数可以在 Magento 应用程序的任何地方使用
• sql包含用于创建、修改或删除 SQL 表的 SQL 脚本。

模块命名

我们需要为我们的模块命名。一般来说，Magento 模块名称由两部分组成：_。为 Magento 模块命名的最佳做法是选择 <namespace></namespace> 作为作者或公司名称，并选择 <module></module> 作为实际模块名称。

根据这些命名约定，我为我们的模块指定了 Chiragdodia_Mymodule 名称。我们将在本系列中引用这个名称。

代码设置和配置

 让我们根据上述结构创建目录。转到 Magento 安装目录，然后导航到 app/code/local  并创建如下所示的目录。

下一步，我们将通过在 app/etc/modules 目录中创建配置文件 Chiragdodia_Mymodule.xml 来配置并激活我们的模块。 该目录包含所有模块的配置文件。

<?xml version="1.0"?>
<config>
    <modules>
        <Chiragdodia_Mymodule>
        <active>true</active>
        <codePool>local</codePool>
        </Chiragdodia_Mymodule>
    </modules>
</config>

该文件将告诉 Magento 我们模块的位置。在 active 标签中，我们指定了 true 来启用我们的模块。如果到目前为止一切都正确，那么您将在 Magento 管理面板 > 系统 > 配置 > 高级 > 高级 > 禁用模块输出列表中找到您的模块。从这里您可以启用和禁用您的模块。

入门：开发

接下来我们将创建模块配置文件。该文件将告诉 Magento 有关我们模块的所有信息。这包括我们的模块包含多少个文件、什么类型的文件（模型、帮助程序、数据库类）等等。

千帆大模型平台

面向企业开发者的一站式大模型开发及服务运行平台

0

查看详情

转到 app/code/local/Chiragdodia/Mymodule/etc  并创建一个 config.xml 将包含以下内容的文件

<?xml version="1.0"?>
<config>
    <modules>
        <Chiragdodia_Mymodule>
            <version>0.1.0</version>    <!-- Version number of your module -->
        </Chiragdodia_Mymodule>
    </modules>
    <frontend>
        <routers>
            <mymodule>
                <use>standard</use>
                <args>
                    <module>Chiragdodia_Mymodule</module>
                    <frontName>mymodule</frontName>
                </args>
            </mymodule>
        </routers>
    </frontend>
</config>

让我们逐行了解每个标签。这里，第一个标签是 <module></module> ，它包含我们模块的名称和版本。在更新模块时版本号非常重要。

<frontend></frontend> 标签将告诉 Magento 有关调度的控制器的信息。在 <frontend></frontend> 标记内，我们定义了 <routers></routers> ，它告诉 Magento 如何通过路由机制访问我们的控制器。

在 <mymodule></mymodule> 标签中，我们在 <module></module> <frontname></frontname> 中的标签和前端名称。通过使用前端名称，我们可以在前端访问我们的模块，例如 yoursitename.com/index.php/mymodule/index。

通过调用 yoursitename.com/index.php/mymodule 或 yoursitename.com/index.php/mymodule/index Magento 将查找模块控制器的索引操作文件。因此，我们需要创建控制器文件。

转到 app/code/local/Chiragdodia/Mymodule/controllers  并创建文件 IndexController.php  包含以下内容。

请注意，在 Magento 中，每个文件的名称和类名称都区分大小写。在创建文件和类时，请务必小心命名您的作品，这一点非常重要。

<?php
class Chiragdodia_Mymodule_IndexController extends Mage_Core_Controller_Front_Action
{
    public function indexAction()
    {
        echo "Hello tuts+ World";
    }
}

现在打开 URL yoursite.com/index.php/mymodule/index 它将打印 “Hello tuts+ World”。 太棒了 - 我们终于完成了第一个 hello world 模块。

控制器调度

这里我们扩展了类 Mage_Core_Controller_Front_Action ，其中包含在URL路由中使用的所有方法。 Magento 类名反映了类文件的位置。因此，类 Mage_Core_Controller_Front_Action  位于位置 Mage > Core > Controller > Front > Action.php

查看我们的控制器的类名称，即 Chiragdodia_Mymodule_IndexController。 Magento 控制器的命名方式应反映 (<module>tag)_(Action Controllername)(keyword Controller).</module>

• tag = Chiragdodia_Mymodule（我们已在 config.xml 中定义了此标签） b>
• 操作 控制器名称 = 索引
• 操作控制器后跟 Controller 关键字

根据此模式，我们的控制器的名称是 Chiragdodia_Mymodule_IndexController

现在查看遵循以下路由模式的 URL 模式yoursite.com/index.php/frontendname/actionControllername/actionmethod

• 前端名称 = mymodule
• actionControllername = 索引
• actionmethodname = 索引

根据此网址模式，我们模块的网址为 yoursite.com/index.php/mymodule/index/index。您还可以使用 yoursite.com/index.php/mymodule 访问它，因为只要您未指定 actionController 或 actionmethod 名称，Magento 就会加载默认情况下的索引控制器和索引操作。

现在让我们再创建一个操作：testAction 。

<?php
class Chiragdodia_Mymodule_IndexController extends Mage_Core_Controller_Front_Action
{
    public function indexAction()
    {
        echo "Hello tuts+ World";
    }
    public function testAction()
    {
        echo "test action";
    }
}

我们可以使用 URL yoursite.com/index.php/mymodule/index/test 访问 testAction。 如前所述

• 前端名称 = mymodule
• actionControllername = 索引
• actionmethodname = 测试

这就是控制器在 Magento 中的工作原理。

一开始，一次理解所有内容可能很困难，因此我已将所有源代码包含到此模块中，以便您可以在将其用作指南的同时查看它并实现自己的工作。

下一步是什么？

在下一部分中，我们将通过创建布局和块文件来填充模块中的一些布局。我们将了解布局文件在 Magento 中如何工作以及块在 Magento 上下文中扮演什么角色。

在此之前，请创建您自己的模块，并让我知道任何给您带来麻烦的事情。

以上就是为 Magento 开发自定义模块的详细内容，更多请关注php中文网其它相关文章！