DocumentaçãoCommerceGuia de configuração

Tipos de configuração

Last update: Fri May 19 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined
  • undefined

Estender tipos de configuração

Para estender um tipo de configuração existente, você só precisa criar um arquivo de configuração no módulo.

Por exemplo, para adicionar um observador de eventos, crie app/code/{VendorName}/{ModuleName}/etc/events.xml um novo observador.

Como o tipo de configuração do evento existe no Commerce, o carregador e o events.xsd a validação do esquema já está presente e funcional.

Seu novo events.xml é automaticamente coletado do módulo e mesclado com outros events.xml para outros módulos.

Criar tipos de configuração

Para criar um tipo de configuração, você deve adicionar no mínimo:

  • Um carregador
  • Esquema de validação XSD
  • Arquivos de configuração XML

Por exemplo, para introduzir um adaptador para um novo servidor de pesquisa que permita que as extensões configurem como suas entidades são indexadas nesse servidor, crie:

  • Um carregador
  • Um arquivo de esquema XSD
  • Um arquivo de configuração nomeado adequadamente. Por exemplo, search.xml. Esse arquivo é lido e validado em relação ao esquema.
  • Quaisquer outras classes necessárias para o seu trabalho.
INFO
Se os novos módulos tiverem uma search.xml são mesclados com seu arquivo quando ele é carregado.

Exemplos de uso

Para criar um tipo de configuração:

  1. Crie seu arquivo XSD.

  2. Crie seu arquivo XML.

  3. Defina o objeto de configuração em seu di.xml.

    O exemplo a seguir do módulo Magento_Sales di.xml ilustra como um objeto de configuração deve ser semelhante a.

    code language-xml 
    <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">

    <type name="Magento\Sales\Model\Order\Pdf\Config\Reader">
        <arguments>
            <argument name="fileName" xsi:type="string">pdf.xml</argument>
            <argument name="converter" xsi:type="object">Magento\Sales\Model\Order\Pdf\Config\Converter</argument>
            <argument name="schemaLocator" xsi:type="object">Magento\Sales\Model\Order\Pdf\Config\SchemaLocator</argument>
        </arguments>
    </type>

    <virtualType name="pdfConfigDataStorage" type="Magento\Framework\Config\Data">
        <arguments>
            <argument name="reader" xsi:type="object">Magento\Sales\Model\Order\Pdf\Config\Reader</argument>
            <argument name="cacheId" xsi:type="string">sales_pdf_config</argument>
        </arguments>
    </virtualType>

    <type name="Magento\Sales\Model\Order\Pdf\Config">
        <arguments>
            <argument name="dataStorage" xsi:type="object">pdfConfigDataStorage</argument>
        </arguments>
    </type>
</config>
    • O primeiro nó do tipo define o nome de arquivo do Reader, associado Converter e SchemaLocator classes.
    • Em seguida, a variável pdfConfigDataStorage nó do tipo virtual anexa a classe reader a uma instância de Magento\Framework\Config\Data.
    • E, por fim, o nó do último tipo anexa esse tipo de dados de configuração virtual ao Magento\Sales\Model\Order\Pdf\Config classe, que é usada para a leitura real dos valores nesses pdf.xml arquivos.

  4. Definir um leitor por extensão Magento\Framework\Config\Reader\Filesystem e reescreva os seguintes parâmetros:

    code language-php 
    $_idAttributes // Array of node attribute IDs.

Exemplo:

<?php
/**
 * Copyright © Magento, Inc. All rights reserved.
 * See COPYING.txt for license details.
 */

namespace Vendor\ModuleName\Model\Config;

use Magento\Framework\Config\Reader\Filesystem;

class Reader extends Filesystem
{
    /**
     * List of identifier attributes for merging
     *
     * @var array
     */
    protected $_idAttributes = [
         '</path/to/node_in_your_xml_file>'        => '<identifierAttributeName>',
         '</path/to/other/node_in_your_xml_file>'  => '<identifierAttributeName>',
    ];
}
INFO
Se preferir criar sua própria versão do leitor, faça isso implementando o \Magento\Framework\Config\ReaderInterface. Consulte leitor de configuração Magento_Analytics

Após definir seu leitor, use-o para coletar, mesclar, validar e converter os arquivos de configuração em uma representação interna de matriz.

Validar um tipo de configuração

Cada arquivo de configuração é validado em relação a um esquema específico para seu tipo de configuração. Exemplo: eventos que, em versões anteriores do Commerce, foram configurados no config.xml, agora estão configurados em events.xml.

Os arquivos de configuração podem ser validados antes (opcional) e depois de qualquer mesclagem de vários arquivos que afetem o mesmo tipo de configuração. A menos que as regras de validação dos arquivos individuais e mesclados sejam idênticas, você deve fornecer dois esquemas para validar os arquivos de configuração:

  • Esquema para validar um indivíduo
  • Esquema para validar um arquivo mesclado

Os novos arquivos de configuração devem ser acompanhados por esquemas de validação XSD. Um arquivo de configuração XML e seu arquivo de validação XSD devem ter o mesmo nome.

Se você precisar usar dois arquivos XSD para um único arquivo XML, os nomes dos esquemas deverão ser reconhecíveis e associados ao arquivo XML.
Se você tiver uma events.xml arquivo e um primeiro events.xsd arquivo, os arquivos XSD para o arquivo mesclado events.xml arquivo pode ser nomeado events_merged.xsd.
Para garantir a validação de um arquivo XML pelo arquivo XSD apropriado, você deve adicionar o Uniform Resource Name (URN) ao arquivo XSD no arquivo XML. Por exemplo:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager:etc/config.xsd">

O IDE pode validar os arquivos de configuração tanto no tempo de execução quanto durante o desenvolvimento.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c