Как удалить remove_action или remove_filter с внешними классами?

Когда плагин создает экземпляр класса через new MyClass();, он должен присвоить его уникально названной переменной. Таким образом, экземпляр класса будет доступен.

Например, если используется $myclass = new MyClass();, то можно сделать так:

global $myclass;
remove_action( 'wp_footer', array( $myclass, 'my_action' ) );

Это работает, потому что плагины подключаются в глобальном пространстве имен, поэтому неявные объявления переменных в основном теле плагина становятся глобальными переменными.

Если плагин не сохраняет идентификатор нового класса где-либо, то технически это ошибка. Один из основных принципов объектно-ориентированного программирования — объекты, на которые нет ссылок в переменных, могут быть удалены или уничтожены.

PHP, однако, не делает этого так, как Java, потому что PHP — это неполная реализация ООП. Переменные экземпляров — это просто строки с уникальными именами объектов. Они работают только благодаря способу взаимодействия имен переменных с оператором ->. Поэтому использование просто new class() действительно может работать, но это глупо. :)

Итак, главный вывод: никогда не используйте new class();. Вместо этого делайте $var = new class(); и убедитесь, что эта переменная $var доступна для других частей кода.

Обновление спустя годы:

Я часто встречал плагины, использующие что-то похожее на паттерн "Одиночка" (Singleton). Они создают метод getInstance() для получения единственного экземпляра класса. Это, пожалуй, лучшее решение. Пример плагина:

class ExamplePlugin
{
    protected static $instance = NULL;

    public static function getInstance() {
        NULL === self::$instance and self::$instance = new self;
        return self::$instance;
    }
}

При первом вызове getInstance() создается экземпляр класса, и его указатель сохраняется. Это можно использовать для подключения действий.

Одна из проблем — нельзя вызывать getInstance() внутри конструктора. Это связано с тем, что new вызывает конструктор до установки $instance, поэтому вызов getInstance() из конструктора приведет к бесконечному циклу и все сломает.

Обходной путь — не использовать конструктор (или хотя бы не вызывать getInstance() в нем), а явно создать функцию "init" в классе для настройки действий. Например:

public static function init() {
    add_action( 'wp_footer', array( ExamplePlugin::getInstance(), 'my_action' ) );
}

В таком случае, после определения класса, инициализация плагина становится простой:

ExamplePlugin::init();

Функция init начинает добавлять действия и при этом вызывает getInstance(), который создает экземпляр класса и гарантирует его единственность. Если у вас нет функции init, можно просто вызвать:

ExamplePlugin::getInstance();

Чтобы ответить на исходный вопрос, удаление этого хука извне (например, из другого плагина) можно выполнить так:

remove_action( 'wp_footer', array( ExamplePlugin::getInstance(), 'my_action' ) );

Поместите этот код в функцию, подключенную к хуку plugins_loaded, и он отменит действие, добавленное исходным плагином.

Лучшим решением здесь будет использование статического класса. Следующий код демонстрирует это:

class MyClass {
    function __construct() {
        add_action( 'wp_footer', array( $this, 'my_action' ) );
    }
    function my_action() {
        print '<h1>' . __class__ . ' - ' . __function__ . '</h1>';
    }
}
new MyClass();


class MyStaticClass {
    public static function init() {
        add_action( 'wp_footer', array( __class__, 'my_action' ) );
    }
    public static function my_action() {
        print '<h1>' . __class__ . ' - ' . __function__ . '</h1>';
    }
}
MyStaticClass::init();

function my_wp_footer() {
    print '<h1>my_wp_footer()</h1>';
}
add_action( 'wp_footer', 'my_wp_footer' );

function mfields_test_remove_actions() {
    remove_action( 'wp_footer', 'my_wp_footer' );
    remove_action( 'wp_footer', array( 'MyClass', 'my_action' ), 10 );
    remove_action( 'wp_footer', array( 'MyStaticClass', 'my_action' ), 10 );
}
add_action( 'wp_head', 'mfields_test_remove_actions' );

Если запустить этот код из плагина, можно заметить, что метод статического класса, а также функция будут удалены из wp_footer.

2 небольшие PHP-функции для удаления фильтров/действий с "анонимными" классами: https://github.com/herewithme/wp-filters-extras/

Вышеуказанные решения выглядят устаревшими, пришлось написать своё...

// Функция для удаления действия класса из хука WordPress
function remove_class_action ($action,$class,$method) {
    global $wp_filter ;
    if (isset($wp_filter[$action])) {
        $len = strlen($method) ;
        foreach ($wp_filter[$action] as $pri => $actions) {
            foreach ($actions as $name => $def) {
                if (substr($name,-$len) == $method) {
                    if (is_array($def['function'])) {
                        if (get_class($def['function'][0]) == $class) {
                            if (is_object($wp_filter[$action]) && isset($wp_filter[$action]->callbacks)) {
                                unset($wp_filter[$action]->callbacks[$pri][$name]) ;
                            } else {
                                unset($wp_filter[$action][$pri][$name]) ;
                            }
                        }
                    }
                }
            }
        }
    }
}

В таких случаях WordPress добавляет хэш (уникальный идентификатор) к имени функции и сохраняет его в глобальной переменной $wp_filter. Поэтому если вы используете функцию remove_filter, ничего не произойдет. Даже если вы добавите имя класса к имени функции, например remove_filter('plugins_loaded', ['MyClass', 'my_action']). Единственное, что можно сделать — это вручную удалить все хуки my_action из глобальной переменной $wp_filter.

Вот функция для этого:

function my_remove_filter($tag, $function_name, $priority = 10){

    global $wp_filter;

    if( isset($wp_filter[$tag]->callbacks[$priority]) and !empty($wp_filter[$tag]->callbacks[$priority]) ){

        $wp_filter[$tag]->callbacks[$priority] = array_filter($wp_filter[$tag]->callbacks[$priority], function($v, $k) use ($function_name){

            return ( stripos($k, $function_name) === false );

        }, ARRAY_FILTER_USE_BOTH );
    }
}

Используйте ее следующим образом:

my_remove_filter('plugins_loaded', 'my_action');

Это не универсальное решение, а конкретно для темы Avada и WooCommerce, которое, как я думаю, может быть полезно другим людям:

function remove_woo_commerce_hooks() {
    global $avada_woocommerce;
    remove_action( 'woocommerce_single_product_summary', array( $avada_woocommerce, 'add_product_border' ), 19 );
}
add_action( 'after_setup_theme', 'remove_woo_commerce_hooks' );

Я нашёл этот Gist, который делал то, что мне нужно:

function remove_class_hook( $tag, $class_name = '', $method_name = '', $priority = 10 ) {
    global $wp_filter;
    $is_hook_removed = false;
    if ( ! empty( $wp_filter[ $tag ]->callbacks[ $priority ] ) ) {
        $methods = array_filter(wp_list_pluck(
            $wp_filter[ $tag ]->callbacks[ $priority ],
            'function'
        ), function ($method) {
            /**
             * Разрешаем только массивы и строки для хуков, так как мы
             * ищем конкретный метод класса для удаления. И метод класса
             * в любом случае передаётся в виде строки.
             */
            return is_string($method) || is_array($method);
        });
        $found_hooks = ! empty( $methods ) ? wp_list_filter( $methods, array( 1 => $method_name ) ) : array();
        foreach( $found_hooks as $hook_key => $hook ) {
            if ( ! empty( $hook[0] ) && is_object( $hook[0] ) && get_class( $hook[0] ) === $class_name ) {
                $wp_filter[ $tag ]->remove_filter( $tag, $hook, $priority );
                $is_hook_removed = true;
            }
        }
    }
    return $is_hook_removed;
}

Эта функция основана на ответе @Digerkam. Добавлена проверка, является ли $def['function'][0] строкой, и в итоге она заработала у меня.

Также использование $wp_filter[$tag]->remove_filter() делает её более стабильной.

function remove_class_action($tag, $class = '', $method, $priority = null) : bool {
    global $wp_filter;
    if (isset($wp_filter[$tag])) {
        $len = strlen($method);

        foreach($wp_filter[$tag] as $_priority => $actions) {

            if ($actions) {
                foreach($actions as $function_key => $data) {

                    if ($data) {
                        if (substr($function_key, -$len) == $method) {

                            if ($class !== '') {
                                $_class = '';
                                if (is_string($data['function'][0])) {
                                    $_class = $data['function'][0];
                                }
                                elseif (is_object($data['function'][0])) {
                                    $_class = get_class($data['function'][0]);
                                }
                                else {
                                    return false;
                                }

                                if ($_class !== '' && $_class == $class) {
                                    if (is_numeric($priority)) {
                                        if ($_priority == $priority) {
                                            //if (isset( $wp_filter->callbacks[$_priority][$function_key])) {}
                                            return $wp_filter[$tag]->remove_filter($tag, $function_key, $_priority);
                                        }
                                    }
                                    else {
                                        return $wp_filter[$tag]->remove_filter($tag, $function_key, $_priority);
                                    }
                                }
                            }
                            else {
                                if (is_numeric($priority)) {
                                    if ($_priority == $priority) {
                                        return $wp_filter[$tag]->remove_filter($tag, $function_key, $_priority);
                                    }
                                }
                                else {
                                    return $wp_filter[$tag]->remove_filter($tag, $function_key, $_priority);
                                }
                            }

                        }
                    }
                }
            }
        }

    }

    return false;
}

Пример использования:

Точное совпадение

add_action('plugins_loaded', function() {
    remove_class_action('plugins_loaded', 'MyClass', 'my_action', 0);
});

Любой приоритет

add_action('plugins_loaded', function() {
    remove_class_action('plugins_loaded', 'MyClass', 'my_action');
});

Любой класс и любой приоритет

add_action('plugins_loaded', function() {
    remove_class_action('plugins_loaded', '', 'my_action');
});