PowerMail启用随机文件名失败求助：上传文件需唯一命名

我来帮你排查这个文件名随机化失效的问题，试试下面这些方案：

1. 先确认TypoScript配置路径是否正确 #

你当前的配置可能缺少了父级路径，导致Powermail没读取到这个设置。正确的配置应该把file节点嵌套在plugin.tx_powermail.settings下面，修改你的setup.txt代码为：

plugin.tx_powermail.settings {
    # File upload settings
    file {
        folder = {$plugin.tx_powermail.settings.misc.uploadFolder}
        size = {$plugin.tx_powermail.settings.misc.uploadSize}
        extension = {$plugin.tx_powermail.settings.misc.uploadFileExtensions}
        randomizeFileName = 1
    }
}

修改后一定要清除TYPO3的所有缓存（包括配置缓存和页面缓存），很多时候配置不生效都是缓存没清导致的。

2. 检查配置是否被覆盖 #

进入TYPO3后台的模板模块，选择信息/修改 -> 模板分析，搜索randomizeFileName，看看这个配置项有没有被其他更高优先级的设置（比如插件局部配置、其他扩展的TypoScript）覆盖。如果搜索结果里显示值不是1，那就是被覆盖了，需要找到覆盖的地方调整。

3. 确认Powermail版本兼容性 #

randomizeFileName这个配置项是在较新的Powermail版本中引入的，如果你的版本比较旧，可能不支持这个设置。可以查看你当前的Powermail版本，对比官方文档确认是否支持该配置，必要时升级到最新稳定版。

4. 用钩子自定义实现文件名随机化（兜底方案） #

如果上面的方法都没用，可以通过Powermail的钩子来强制修改文件名。

首先在你的自定义扩展的Configuration/TypoScript/setup.txt里添加钩子注册：

plugin.tx_powermail.settings.hooks.uploadFile {
    10 = Vendor\YourExtension\Hooks\RandomizeFileNameHook
}

然后创建对应的PHP钩子类（路径：typo3conf/ext/your_extension/Classes/Hooks/RandomizeFileNameHook.php）：

<?php
namespace Vendor\YourExtension\Hooks;

use In2code\Powermail\Domain\Model\File;
use In2code\Powermail\Utility\FileUtility;

class RandomizeFileNameHook
{
    public function manipulateFile(File $file, array $settings): File
    {
        // 获取原文件名和后缀
        $originalName = $file->getName();
        $extension = pathinfo($originalName, PATHINFO_EXTENSION);
        
        // 生成唯一随机文件名
        $randomName = uniqid('powermail_upload_', true) . '.' . $extension;
        
        // 更新文件对象的名称（邮件中会显示这个名称）
        $file->setName($randomName);
        
        // 重命名服务器上的实际文件
        $uploadFolder = FileUtility::getUploadFolder($settings);
        $originalPath = $uploadFolder . '/' . $originalName;
        $newPath = $uploadFolder . '/' . $randomName;
        
        if (file_exists($originalPath)) {
            rename($originalPath, $newPath);
        }
        
        return $file;
    }
}

这个方法会在文件上传完成后强制替换成唯一文件名，确保重复上传的文件也有不同的名称，同时邮件里显示的也是随机后的名字。

5. 检查邮件模板的文件名输出 #

最后确认一下你的Powermail邮件模板，是不是用了正确的变量来输出文件名。模板里应该使用{file.name}来获取处理后的文件名，避免直接使用原始文件名变量。

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