如何为wp_handle_upload的unique_filename_callback传递自定义参数

核心原因 #

你定义的generate_filename是普通函数，它的作用域和外部的$prod_name、$orderId相互独立，所以无法直接读取这两个变量，导致生成的文件名只有扩展名。

解决方案：使用闭包（匿名函数）+ use关键字 #

PHP的闭包可以通过use关键字将外部变量引入函数作用域，这样就能在回调里正常使用$prod_name和$orderId了。同时建议对用户输入的变量进行文件名安全处理，避免非法字符导致的问题。

修改后的代码如下：

$prod_name = sanitize_file_name($_POST['productName']);
$orderId = sanitize_file_name($_POST['orderId']);

$upload = wp_handle_upload( 
    $_FILES[ 'product_image' ], 
    array( 
        'test_form' => false,
        'unique_filename_callback'  => function( $dir, $name, $ext ) use ( $orderId, $prod_name ) {
            // 现在可以正常访问外部变量
            $name =  $orderId . '__' . $prod_name . $ext;
            return $name;
        }
    ) 
);

额外说明 #

• 安全处理：使用sanitize_file_name()函数过滤用户输入的变量，确保文件名符合系统规范，避免包含特殊字符或恶意内容。
• 闭包优势：相比全局变量方案，闭包不会污染全局作用域，也避免了变量名冲突的风险，是更安全的实现方式。
• 唯一性保障：如果担心生成的文件名重复，可以在回调内添加判断逻辑，比如检查目标目录下是否已存在同名文件，若存在则追加数字后缀。

内容的提问来源于stack exchange，提问作者Mr.Coder