如何让自定义类仅在指定WooCommerce动作触发以优化性能

问题背景 #

现有基于WooCommerce自定义结账字段创建动态目录的类，页面刷新时可正常生成目录，但希望仅在woocommerce_order_status_completed、woocommerce_order_status_changed或woocommerce_thankyou（对应需求中的woocommerce_thankyou_page）这些WooCommerce动作触发时运行，避免每次页面加载都执行以提升效率，自行尝试绑定动作未成功。

原有代码（页面刷新触发） #

//add_action( 'plugins_loaded', array( 'pos__URL', 'init' ));    //uncomment to trigger on page refresh
class pos__URL {

public static function init() {
    $POS__sys_URL = __CLASS__;
    new $POS__sys_URL;
}

public function __construct()
{
add_action('init', array($this, 'pos__URL_Field'));
}

public function pos__URL_Field()
{
    //--------to access the value----start-----
    $orders = wc_get_orders(array(
        'customer_id' => get_current_user_id(),
        'return' => 'ids',
    ));
    //add the id of the custom meta field that lies in the order
    $meta_data = array();
    foreach ($orders as $order_id) {
      $meta_data[$order_id] = get_post_meta($order_id, '_engx_text_field_id', true);
    }
    //--------to access the value----end-----
    
    if( isset($meta_data[$order_id]) ) { //is the field set
    
        $curdir = getcwd(); //delcare variables
        
        if (!file_exists($meta_data[$order_id])) {

            if( mkdir( $curdir . "/" . $meta_data[$order_id], 0777) ) {
                    
                    //below section for for testing purposes to see if the command ran - and yes shows correctly and creates directory as expected IF the POS url is set - (triggers at the moment on page refresh)
                    echo "directory created";         //comment out when done testing
                }else{                              
                    echo "directory NOT created";     //comment out when done testing
                }
            }
    }else{
        
    if( empty($meta_data[$order_id]) ) {
        //do nothing
    }
  }
}
} //end class

错误代码问题分析 #

1. add_action( 'woocommerce_order_status_changed', array('pos__URL') ); 回调格式错误，未指定具体类方法，也未绑定到类实例
2. 仍保留init动作绑定，导致页面刷新时仍会触发逻辑
3. 遍历所有用户订单的逻辑冗余，触发目标钩子时已有明确的订单ID，无需全局遍历

正确实现代码 #

class pos__URL {

    public static function init() {
        new self();
    }

    public function __construct() {
        // 绑定目标WooCommerce钩子，指定回调方法
        add_action('woocommerce_order_status_completed', array($this, 'pos__URL_Field'));
        add_action('woocommerce_order_status_changed', array($this, 'pos__URL_Field'));
        add_action('woocommerce_thankyou', array($this, 'pos__URL_Field')); // WooCommerce官方感谢页钩子为woocommerce_thankyou
    }

    public function pos__URL_Field($order_id) {
        // 直接获取当前触发钩子的订单元数据，无需遍历所有订单
        $dir_name = get_post_meta($order_id, '_engx_text_field_id', true);
        
        // 验证目录名是否存在且非空，提前终止无效逻辑
        if (empty($dir_name)) {
            return;
        }

        $curdir = getcwd();
        $full_path = $curdir . "/" . $dir_name;

        // 检查目录是否已存在，不存在则创建（支持递归创建父目录）
        if (!file_exists($full_path)) {
            if (mkdir($full_path, 0777, true)) {
                echo "directory created"; // 测试用，完成后注释
            } else {
                echo "directory NOT created"; // 测试用，完成后注释
            }
        }
    }
}

// 初始化类
add_action('plugins_loaded', array('pos__URL', 'init'));

关键优化点 #

• 钩子绑定：在构造函数中直接绑定目标WooCommerce钩子，所有钩子都会传递$order_id参数，直接使用该参数获取对应订单的元数据
• 逻辑简化：去掉全局遍历用户订单的冗余操作，仅处理当前触发钩子的订单，大幅提升执行效率
• 路径安全：添加递归创建目录的支持（mkdir第三个参数true），避免因父目录不存在导致创建失败
• 参数验证：先检查目录名是否为空，提前终止无效逻辑，减少不必要的资源消耗

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