Magento 2开发教程 - 创建新模块

视频在youtube网站国内访问不了，可以使用软件查看。
视频地址：www.youtube.com/embed/682p52tFcmY@autoplay=1

下面是视频文字介绍：

Magento 2系统整体结构是建立在模块的基础上。通常，创建定制的第一步是构建模块。

要创建模块，需要完成以下步骤：

1. 创建模块文件夹
2. 创建 etc/module.xml 文件.
3. 创建 registration.php 文件.
4. 运行 bin/magento setup:upgrade脚本安装新模块
5. 检查模块是否正常工作

让我们详细地看一下这些步骤。

创建模块文件夹

Magento 2模块文件夹可以创建在两个地方: app/code 和 vendor 文件夹

根据Magento 2已安装，核心模块可以位于 vendor/magento/magento-*文件夹 或 app/code/Magento/ 文件夹

您应该为您的新模块选择哪些位置？

如果为特定项目构建模块，最好选择应用app/code文件夹并提交到项目的存储库中。

如果你要构建一个可重用的扩展，最好使用composer来创建它，并将你的模块放在 vendor//module-something 文件夹。

在Magento 2每个模块的名称由两部分组成–vendor和模块本身。换句话说，模块分为vendor，所以你需要定义vendor和模块名称。在这个例子中，让我们的vendor名称“Learning”和“firstunit”模块。

 

让我们创建文件夹 app/code/Learning 和这个文件夹里面放一个文件夹：FirstUnit。如果您使用命令行，代码：

1. cd 到根文件夹
2. mkdir app/code/Learning
3. mkdirapp/code/Learning/FirstUnit

确保您有权限在安装中创建文件和文件夹

下一步, 你需要创建 etc/module.xml 文件。 此文件需要模块存在。

此文件包含以下信息：

• 模块名称
• 模块版本
• 模块依赖

模块名称定义的文件夹我们刚刚创建的，因为在Magento 2类名称必须遵循的文件夹结构。因为我们创建了文件夹Learning/FirstUnit, our module name will be Learning_FirstUnit 所有属于这个模块的类将从 Learning\FirstUnit – 示例: Learning\FirstUnit\Observer\Test.

模块版本表示数据库架构和数据的当前版本，并用于升级。 例如，假设您决定在模块中修改表的架构。
你怎么能确保在所有部署代码的情况下会发生这种变化？通过直接SQL查询修改数据库将不起作用。相反，Magento
2已经安装和升级的每一个模块的脚本（可选）。这些脚本包含修改数据库架构或数据的命令。跟踪是否执行脚本或不使用Magento
2模块版本。每次执行新的数据库更改时，您将实现模块的新版本并更改相应的版本 module.xml. Magento的保存在数据库的当前模块的版本，如果数据库中的一个值与 module.xml 不匹配, 它将执行升级代码。

 

依赖。如果一个模块依赖于另一个模块，module.xml 文件将有一个特殊声明，定义当前模块依赖的模块列表。在这个例子中，我们将使我们的模块依赖magento_catalog。

使用以下命令行代码，创建文件夹 app/code/Learning/FirstUnit/etc:

1. mkdir app/code/Learning/FirstUnit/etc

然后把下面的代码：

请注意，在指定的xml文件中：

• 模块名称: Learning_FirstUnit (基于我们创建的文件夹)
• 版本: 0.0.1 (我们的模块的初始版本)
• 依赖: Magento_Catalog. 我们可以有多重依赖。在这种情况下， 我们会把 序列节点下的节点。

创建registration.php 文件

每个模块必须有这个文件，它告诉Magento如何定位模块。继续我们的例子，创建文件app/code/Learning/FirstUnit/registration.php。然后把下面的内容放进去：

2. \Magento\Framework\Component\ComponentRegistrar::MODULE, 'Learning_FirstUnit',
3. __DIR__
4. );

registration.php 是所有模块都遵循相同模式的标准化文件。

唯一不同的是模块名，在我们的例子中是Learning_FirstUnit。

运行 “setup:upgrade” 命令

运行此命令使您的新模块主动通知Magento的存在。

1. php bin/magento setup:upgrade

它应该呼应大量的输出，其中一行应该是Learning_FirstUnit. 验证此行代码是否存在。

检查新模块是否处于激活状态

到目前为止，我们还没有添加任何有用的代码到我们的模块-它仍然是空的（因此无形的）。 为了验证它已被确认，检查文件 app/etc/env.php. 它有一个自动生成模块的列表是活跃的。

手动更改此列表！

1. cat app/etc/env.php | grep Learning_FirstUnit

采用这些步骤，你可以成功地创建Magento 2新模块。