Magento 2 模块开发基础部分 - 目录
本文主要描述如何创建一个最简单的模块。
模块 (Module) 也就是一个包含特定业务子目录（区块blocks、控制器controllers、模型models、帮助文件helper、配置相关etc）的文件夹。etc 目录包含有后台权限控制（admin acl）、后台菜单配置、其它配置文件。模块一般在 app/code 目录，全路径: app/code/， Vendor 是企业名称如 Baidu。下面创建一个可以执行的模块并显示 “Hello World”。
基础部分主要内容有
- 创建控制器（Controller）
- 创建模型（Model)
- 创建视图（View)
- 后台菜单（Admin Menu）
- 参数配置（Configuration）
- 后台网格（Grid）
创建 Hello World 模块
创建模块需要完成如下几步：
- 创建模块目录
- 添加
etc/module.xml文件 - 添加
etc/registration.php文件 - 启用模块
第一步： 新建模块文件夹
模块命名格式 VendorName_ModuleName。前一部分是公司名后面是模块名：如：Magento_HelloWorld、 Aqrun_PdfInvoice。我们创建如下目录：
app/code/Aqrun/HelloWorld
第二步：添加 etc/module.xml 文件
然后需要新建 etc 目录并添加 module.xml 文件
app/code/Aqrun/HelloWorld/etc/module.xml
内容：
第三步：添加 etc/registration.php 文件
这一步添加 registration.php 文件
app/code/Aqrun/HelloWorld/registration.php
内容：
第四步：启用模块
完成第三步时我们已经创建了 HelloWorld 模块，这一步我们启用它。
使用如下命令可以查看到我们模块处于未启用（Disabled）列表
php bin/magento module:status
未启用模块列表会显示出： Aqrun_HelloWorld
启用指定模块运行：
php bin/magento module:enable Aqrun_HelloWorld
另一种启用模块的方式是编辑 app/etc/config.php 文件， 把你的模块加到这个文件的列表里：
...
'Aqrun_HelloWorld' => 1,
...
完成这一步之后浏览器打开你的网站或许会显示错误信息，可以运行如下命令更新模块
php bin/magento setup:upgrade
刷新浏览器如果页面内容错乱没有样式或以执行静态内容发布命令
php bin/magento setup:static-content:deploy
接下来添加一个控制器测试模块
添加控制器之前需要还要给模块增加一个路由配置
Magento的路由格式有三个部分：前端名称（Frontname）、控制器（Controller）、动作（Action）。如下：
http://mag.dev/index.php/frontname/controller/action
路由配置信息在 routes.xml 文件中 app/code/Aqrun/HelloWorld/etc/frontend/routes.xml
这是前端由配置在 frontend/ 目录，后台路由在 adminhtml/ 目录
内容如下：
这个路由配置的URL路径就会是 http://mag.dev/helloworld/*
然后继续添加控制器和动作
新建路径及文件：app/code/Aqrun/HelloWorld/Controller/Index/Test.php
代码：
namespace Aqrun\HelloWorld\Controller\Index;
class Test extends \Magento\Framework\App\Action\Action
{
protected $_pageFactory;
public function __construct(
\Magento\Framework\App\Action\Context $context,
\Magento\Framework\View\Result\PageFactory $pageFactory
){
$this->_pageFactory = $pageFactory;
return parent::__construct($context);
}
public function execute()
{
echo "Hello World";
exit;
}
}
然后执行 php bin/magento cache:clean
浏览器打开链接 http://mag.dev/helloworld/index/test 测试结果
就会显示 Hello World。下一部分内容了解如何创建完整的控制器