Magento 2：如何实现自定义模块在首页自动加载？

嘿，作为Magento 2新手能成功搭建自定义模块还能正常访问，这已经超棒啦！想让首页加载时自动调用这个模块的功能，我给你两种实用的方法，一步步来就行：

这种方式是通过Magento的布局系统，在首页的布局文件里添加你的模块区块：

1. 先在你的模块目录下创建首页布局文件，路径是：
   app/code/[你的命名空间]/[你的模块名]/view/frontend/layout/cms_index_index.xml
   （记得把[你的命名空间]和[你的模块名]替换成你实际的名称，比如你原来的模块是modulename，命名空间是Custom的话，路径就是app/code/Custom/Modulename/view/frontend/layout/cms_index_index.xml）

2. 在这个XML文件里写入以下代码，用来指定调用你的模块区块和模板：

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
        <!-- 把模块内容插入到首页的content容器里，你也可以换成其他容器比如page.top等 -->
        <referenceContainer name="content">
            <block class="[你的命名空间]\[你的模块名]\Block\Test" name="modulename_index_test" template="[你的命名空间]_[你的模块名]::test.phtml" />
        </referenceContainer>
    </body>
</page>

3. 如果你还没有对应的区块类，得创建一个：
   路径：app/code/[你的命名空间]/[你的模块名]/Block/Test.php
   代码如下：

<?php
namespace [你的命名空间]\[你的模块名]\Block;

class Test extends \Magento\Framework\View\Element\Template
{
    // 这里可以放你原来控制器里的业务逻辑代码
    // 比如如果原来的控制器有数据处理，就迁移到这里来
}

4. 最后创建模板文件，把你原来控制器要输出的内容放进去：
   路径：app/code/[你的命名空间]/[你的模块名]/view/frontend/templates/test.phtml
   比如原来控制器里的输出内容，直接复制到这个模板里就行。

如果你不想折腾代码文件，直接在后台操作也能实现：

• 登录Magento后台，进入内容 > 页面，找到默认的CMS首页
• 点击编辑，在「内容」区域切换到代码模式（点击右上角的</>按钮）
• 插入以下代码，调用你的模块区块：

{{block class="[你的命名空间]\[你的模块名]\Block\Test" template="[你的命名空间]_[你的模块名]::test.phtml"}}

• 保存页面，然后刷新缓存。

不管用哪种方法，做完后一定要：

• 清空Magento缓存：后台可以去系统 > 工具 > 缓存管理，勾选所有缓存点击「刷新」；或者用命令行执行bin/magento cache:flush
• 检查所有文件的路径、命名空间是否和实际一致，别写错大小写，Magento对路径和命名空间的大小写是敏感的！

内容的提问来源于stack exchange，提问作者Md Amanullah