magento2中文教程之di.xml文件详解

di.xml 文件配置对象管理器注入哪些依赖项。 您还可以使用 di.xml 指定敏感配置设置。

使用区域和应用入口位置

每个模块都可以有一个全局的和特定于区域的 di.xml 文件。 Magento 读取系统中声明的所有 di.xml 配置文件,并通过附加所有节点将它们合并在一起。

作为一般规则,区域特定的 di.xml 文件应配置表示层的依赖项,而模块的全局 di.xml 文件应配置其余的依赖项。

Magento 在以下阶段加载配置:

初始 (app/etc/di.xml)
全局 (<moduleDir>/etc/di.xml)
区域特定 (<moduleDir>/etc/<area>/di.xml)
这些领域是:

  • adminhtml
  • frontend
  • graphql
  • webapi_rest
  • webapi_soap
  • crontab
    在引导过程中,每个应用程序入口点都会为请求的区域加载适当的 di.xml 文件。

例子:

在 index.php 中,\Magento\Framework\App\Http 类根据 URL 中提供的前端名称加载区域。

在 static.php 中,\Magento\Framework\App\StaticResource 类也根据请求中的 URL 加载区域。

在 cron.php 中,\Magento\Framework\App\Cron 类总是加载 crontab 区域。

类型配置
类型配置描述了一个对象的生活方式以及如何实例化它。

您可以通过以下方式在 di.xml 配置节点中配置类型:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <virtualType name="moduleConfig" type="Magento\Core\Model\Config">
        <arguments>
            <argument name="type" xsi:type="string">system</argument>
        </arguments>
    </virtualType>
    <type name="Magento\Core\Model\App">
        <arguments>
            <argument name="config" xsi:type="object">moduleConfig</argument>
        </arguments>
    </type>
</config>

前面的示例声明了以下类型:

moduleConfig:扩展 Magento\Core\Model\Config 类型的虚拟类型。
Magento\Core\Model\App:此类型的所有实例都接收一个 moduleConfig 实例作为依赖项。

Virtual types

虚拟类型允许您更改特定可注入依赖项的参数并更改特定类的行为。 这允许您使用自定义类,而不会影响依赖于原始类的其他类。

该示例为 Magento\Core\Model\Config 创建了一个虚拟类型,并将 system 指定为 type 的构造函数参数。
构造函数参数
您可以在参数节点的 di.xml 中配置类构造函数参数。 对象管理器在创建过程中将这些参数注入到类中。 XML 文件中配置的参数名称必须与配置类中构造函数中的参数名称相对应。

以下示例创建 Magento\Core\Model\Session 的实例,并将类构造函数参数 $sessionName 设置为 adminhtml 的值:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Magento\Core\Model\Session">
        <arguments>
            <argument name="sessionName" xsi:type="string">adminhtml</argument>
        </arguments>
    </type>
</config>

参数类型

节点格式:
<argument xsi:type="object">{typeName}</argument>

<argument xsi:type="object" shared="{shared}">{typeName}</argument>
创建 typeName 类型的实例并将其作为参数传入。 您可以将任何类名、接口名或虚拟类型作为 typeName 传递。

设置共享属性定义了创建的实例的生活方式。 请参阅对象生活方式配置。

string

节点格式:
<argument xsi:type="string">{strValue}</argument>

<argument xsi:type="string" translate="true">{strValue}</argument>
Magento 将此参数节点的任何值解释为字符串。

boolean

节点格式:
<argument xsi:type="boolean">{boolValue}</argument>
number

节点格式:
<argument xsi:type="number">{numericValue}</argument>

此类型的可接受值包括:整数、浮点数或数字字符串。

init_parameter

节点格式:
<argument xsi:type="init_parameter">{Constant::NAME}</argument>

这是由 Constant::NAME 表示的全局应用程序初始化参数。

const

节点格式:
<argument xsi:type="const">{Constant::NAME}</argument>

这是由 Constant::NAME 表示的常量值。

null

节点格式:
<argument xsi:type="null"/>

这表示空值。

array

节点格式:
节点格式如下:

<argument xsi:type="array">
  <item name="someKey" xsi:type="<type>">someVal</item>
</argument>

Magento 使用与项目对应的元素构建一个数组,并将其作为参数传递。 数组可以包含无限数量的项,每个数组项可以是任何对象类型,包括数组本身。

当 Magento 合并给定范围的配置文件时,具有相同名称的数组参数会合并到一个新数组中。

当 Magento 稍后通过更具体的范围或通过代码加载新配置时,新配置中的任何数组定义将替换加载的配置而不是合并。

参数示例

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Magento\Example\Type">
        <arguments>
            <!-- Pass simple string -->
            <argument name="stringParam" xsi:type="string">someStringValue</argument>
            <!-- Pass instance of Magento\Some\Type -->
            <argument name="instanceParam" xsi:type="object">Magento\Some\Type</argument>
            <!-- Pass true -->
            <argument name="boolParam" xsi:type="boolean">1</argument>
            <!-- Pass 1 -->
            <argument name="intParam" xsi:type="number">1</argument>
            <!-- Pass application init argument, named by constant value -->
            <argument name="globalInitParam" xsi:type="init_parameter">Magento\Some\Class::SOME_CONSTANT</argument>
            <!-- Pass constant value -->
            <argument name="constantParam" xsi:type="const">Magento\Some\Class::SOME_CONSTANT</argument>
            <!-- Pass null value -->
            <argument name="optionalParam" xsi:type="null"/>
            <!-- Pass array -->
            <argument name="arrayParam" xsi:type="array">
                <!-- First element is value of constant -->
                <item name="firstElem" xsi:type="const">Magento\Some\Class::SOME_CONSTANT</item>
                <!-- Second element is null -->
                <item name="secondElem" xsi:type="null"/>
                <!-- Third element is a subarray -->
                <item name="thirdElem" xsi:type="array">
                    <!-- Subarray contains scalar value -->
                    <item name="scalarValue" xsi:type="string">ScalarValue</item>
                    <!-- and application init argument -->
                    <item name="globalArgument " xsi:type="init_parameter">Magento\Some\Class::SOME_CONSTANT</item>
                </item>
            </argument>
        </arguments>
    </type>
</config>

更多magento教程参考:
Magento2.x企业级开发实战

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,744评论 6 502
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,505评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,105评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,242评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,269评论 6 389
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,215评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,096评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,939评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,354评论 1 311
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,573评论 2 333
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,745评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,448评论 5 344
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,048评论 3 327
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,683评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,838评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,776评论 2 369
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,652评论 2 354

推荐阅读更多精彩内容