Shopware 6 媒体路径MD5生成中的“ad”黑名单机制解析-php教程-PHP中文网

Shopware 6 媒体路径MD5生成中的“ad”黑名单机制解析

聖光之護

发布： 2025-09-18 11:00:49

原创

521人浏览过

Shopware 6 媒体路径MD5生成中的“ad”黑名单机制解析

Shopware 6在生成媒体文件路径时，会基于MD5哈希值进行处理，并特意将路径切片中出现的“ad”替换为“g0”。这一机制旨在规避广告拦截器可能将包含“ad”的路径误识别为广告内容，从而导致图片等媒体文件无法正常加载，确保用户体验和网站内容的完整性。

Shopware 6 媒体路径生成策略概述

在现代电商平台中，媒体文件的存储和访问是核心功能之一。shopware 6 采用了一种策略来生成媒体文件的路径，以确保路径的唯一性和可管理性。其核心思想是利用内容的md5哈希值来构造文件路径，这不仅有助于避免文件命名冲突，还能在一定程度上分散文件存储，提高性能。然而，shopware 6 在此基础上增加了一个独特的处理环节，即对生成的md5路径进行“黑名单”过滤。

MD5路径生成与黑名单机制

Shopware 6 的媒体路径生成逻辑主要体现在 AbstractPathNameStrategy.php 文件中，通过 generateMd5Path 方法实现。该方法首先计算输入值的MD5哈希，然后将这个32位的哈希字符串切分成多个2字符的片段，并取前三个片段来构造路径。

private $blacklist = [
    'ad' => 'g0',
];

protected function generateMd5Path(string $fromValue): string
{
    $md5hash = md5($fromValue);

    // 将MD5哈希切分为2字符的片段，并取前3个
    $md5hashSlices = \array_slice(str_split($md5hash, 2), 0, 3);

    // 遍历切片，检查是否存在于黑名单中，并进行替换
    $md5hashSlices = array_map(
        function ($slice) {
            return \array_key_exists($slice, $this->blacklist) ? $this->blacklist[$slice] : $slice;
        },
        $md5hashSlices
    );

    // 使用斜杠连接处理后的切片，形成最终路径
    return implode('/', $md5hashSlices);
}

登录后复制

从上述代码中可以看出，$blacklist 数组中定义了一个关键的映射关系：'ad' => 'g0'。这意味着，如果MD5哈希值的前三个2字符切片中，有任何一个恰好是“ad”，它将被替换为“g0”。