Magento 2.4如何为system.xml自定义字段设置店铺URL默认值？

由于Magento的system.xml是静态配置文件，无法直接设置动态的店铺URL作为默认值，需要通过以下两种方案实现：

方案一：安装/升级脚本初始化默认值 #

适合需要一次性设置默认值，后续店铺URL变更无需自动同步的场景。

1. 定义system.xml字段
   在模块的etc/adminhtml/system.xml中添加自定义字段：

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Config:etc/system_file.xsd">
    <system>
        <section id="custom_section" translate="label" type="text" sortOrder="10" showInDefault="1" showInWebsite="1" showInStore="1">
            <label>自定义配置</label>
            <group id="general" translate="label" type="text" sortOrder="10" showInDefault="1" showInWebsite="1" showInStore="1">
                <label>通用设置</label>
                <field id="store_url" translate="label" type="text" sortOrder="10" showInDefault="1" showInWebsite="1" showInStore="1">
                    <label>店铺URL</label>
                    <comment>默认值为当前店铺基础URL</comment>
                </field>
            </group>
        </section>
    </system>
</config>

2. 编写InstallData脚本
   在模块的Setup/InstallData.php中获取店铺URL并写入配置默认值：

<?php
namespace YourVendor\YourModule\Setup;

use Magento\Framework\Setup\InstallDataInterface;
use Magento\Framework\Setup\ModuleContextInterface;
use Magento\Framework\Setup\ModuleDataSetupInterface;
use Magento\Store\Model\StoreManagerInterface;
use Magento\Framework\App\Config\ScopeConfigInterface;
use Magento\Framework\App\Config\ConfigResource\ConfigInterface;

class InstallData implements InstallDataInterface
{
    private $storeManager;
    private $configResource;

    public function __construct(
        StoreManagerInterface $storeManager,
        ConfigInterface $configResource
    ) {
        $this->storeManager = $storeManager;
        $this->configResource = $configResource;
    }

    public function install(ModuleDataSetupInterface $setup, ModuleContextInterface $context)
    {
        $setup->startSetup();
        
        // 获取默认店铺的基础URL
        $baseUrl = $this->storeManager->getStore()->getBaseUrl();
        
        // 写入配置默认值，路径格式为「section/group/field」
        $this->configResource->saveConfig(
            'custom_section/general/store_url',
            $baseUrl,
            ScopeConfigInterface::SCOPE_TYPE_DEFAULT,
            0
        );

        $setup->endSetup();
    }
}

执行模块安装命令后，该配置字段的默认值会被设置为当前店铺URL。

方案二：自定义后端模型动态加载默认值 #

适合需要实时同步店铺URL，每次加载配置页面时自动填充最新店铺URL（当字段无值时）的场景。

1. 修改system.xml添加后端模型
   在字段节点中加入backend_model配置：

<field id="store_url" translate="label" type="text" sortOrder="10" showInDefault="1" showInWebsite="1" showInStore="1">
    <label>店铺URL</label>
    <comment>默认值为当前店铺基础URL</comment>
    <backend_model>YourVendor\YourModule\Model\Config\Backend\StoreUrl</backend_model>
</field>

2. 创建后端模型类
   在Model/Config/Backend/StoreUrl.php中实现动态赋值逻辑：

<?php
namespace YourVendor\YourModule\Model\Config\Backend;

use Magento\Framework\App\Config\Value;
use Magento\Store\Model\StoreManagerInterface;

class StoreUrl extends Value
{
    protected $storeManager;

    public function __construct(
        \Magento\Framework\Model\Context $context,
        \Magento\Framework\Registry $registry,
        \Magento\Framework\App\Config\ScopeConfigInterface $config,
        \Magento\Framework\App\Cache\TypeListInterface $cacheTypeList,
        StoreManagerInterface $storeManager,
        \Magento\Framework\Model\ResourceModel\AbstractResource $resource = null,
        \Magento\Framework\Data\Collection\AbstractDb $resourceCollection = null,
        array $data = []
    ) {
        $this->storeManager = $storeManager;
        parent::__construct($context, $registry, $config, $cacheTypeList, $resource, $resourceCollection, $data);
    }

    // 字段加载时，若未设置值则自动填充当前店铺URL
    protected function _afterLoad()
    {
        if (!$this->getValue()) {
            $store = $this->storeManager->getStore($this->getScopeId());
            $this->setValue($store->getBaseUrl());
        }
        return parent::_afterLoad();
    }
}

这样每次打开配置页面时，如果该字段未设置值，会自动显示当前店铺的最新URL。

内容的提问来源于stack exchange，提问作者Dev.s