Какова ваша лучшая практика для выполнения одноразовых скриптов?

Вы также можете сделать следующее:

запустите onetime.php и переименуйте его после выполнения.

if ( current_user_can( 'manage_options' ) ) {

    if( ! file_exists( '/path/to/onetime.php' ) )
      return;
    add_action( 'wp_footer', 'ravs_my_onetime_function' ); // выполнить мою функцию на нужном хуке.

}

function ravs_my_onetime_function() {

    // вся моя великолепная одноразовая магия.
    include( '/path/to/onetime.php' );

   // после выполнения переименуйте файл;
   rename( '/path/to/onetime.php', '/path/to/onetime-backup.php');
}

Я создал командный скрипт Phing для этого, в нём нет ничего особенного, кроме загрузки внешнего скрипта для выполнения. Причина, по которой я использовал его через CLI:

• Я не хочу, чтобы он загружался случайно (нужно ввести команду)
• Это безопасно, так как может выполняться вне корневой веб-директории, то есть он может влиять на WP, но WP не может получить доступ к скрипту никаким образом.
• Он не добавляет никакого кода в WP или саму базу данных.

require('..путь к ../wp-blog-header.php');
//куча глобальных переменных WP
define('WP_USE_THEMES', false);
//пользовательский код

Таким образом, вы можете использовать Phing или PHP CLI и спать спокойно. WP-CLI также является хорошей альтернативой, хотя я не помню, можно ли использовать его вне корневой веб-директории.

Поскольку это популярный пост, вот пример скрипта: https://github.com/wycks/WordPhing (run.php)

В идеальных условиях я бы подключился к серверу через SSH и выполнил функцию самостоятельно, используя wp-cli.

Однако это не всегда возможно, поэтому я обычно устанавливаю переменную $_GET и подключаю её к хуку 'init', например:

add_action( 'init', function() {
    if( isset( $_GET['one_time'] ) && $_GET['one_time'] == 'an_unlikely_string' ) {
        do_the_one_time_thing();
    }
});

затем перехожу по ссылке

http://my_blog.com/?one_time=an_unlikely_string

и отключаю хук после выполнения.

Ещё один довольно простой способ запуска одноразового скрипта — использование MU-плагина.

Поместите код в PHP-файл (например, one-time.php), загрузите его в папку MU-плагинов (по умолчанию /wp-content/mu-plugins), настройте права доступа к файлу, запустите плагин (т.е., в зависимости от выбранного хука, вам достаточно просто посетить фронтенд/бэкенд сайта), и всё готово.

Вот шаблон для такого скрипта:

/**
* Главный (и единственный) класс.
*/
class OneTimeScript {

    /**
     * Хук для функции плагина.
     *
     * @type    string
     */
    public static $hook = 'init';


    /**
     * Приоритет функции плагина.
     *
     * @type    int
     */
    public static $priority = 0;


    /**
     * Запуск одноразового скрипта.
     *
     * @hook    self::$hook
     * @return  void
     */
    public static function run() {
        // здесь выполняем одноразовое действие...

        // очистка
        add_action('shutdown', array(__CLASS__, 'unlink'), PHP_INT_MAX);
    } // function run


    /**
     * Удаление файла.
     *
     * @hook    shutdown
     * @return  void
     */
    public static function unlink() {
        unlink(__FILE__);
    } // function unlink

} // class OneTimeScript

add_action(OneTimeScript::$hook, array('OneTimeScript', 'run'), OneTimeScript::$priority);

Без комментариев и дополнительных элементов код выглядит так:

class OneTimeScript {
    public static $hook = 'init';
    public static $priority = 0;

    public static function run() {
        // здесь выполняем одноразовое действие...
        add_action('shutdown', array(__CLASS__, 'unlink'), PHP_INT_MAX);
    } // function run

    public static function unlink() {
        unlink(__FILE__);
    } // function unlink
} // class OneTimeScript
add_action(OneTimeScript::$hook, array('OneTimeScript', 'run'), OneTimeScript::$priority);

Конечно, вы можете создать одноразовый код в виде плагина.

add_action('admin_init', 'one_time_call');
function one_time_call()
{
    /* ВАШИ СКРИПТЫ */
    deactivate_plugins('onetime/index.php'); //деактивировать текущий плагин
}

Вопрос: как активировать этот плагин без нажатия на ссылку "Активировать"?

Просто добавьте activate_plugins('onetime/index.php'); в functions.php

Или используйте must-use плагины: http://codex.wordpress.org/Must_Use_Plugins

Попробуйте разные действия для выполнения одноразового плагина:

1. admin_init - после инициализации админки

2. init - инициализация WordPress

3. wp - когда WordPress загружен

Иногда я использовал функцию, подключенную к деактивации плагина.

Смотрите здесь Обновление старых ссылок на красивые постоянные ссылки для пользовательских типов записей

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

Нет необходимости удалять файл при деактивации — WordPress не будет его включать. Кроме того, если вы захотите запустить его снова, вы можете это сделать. Просто активируйте и деактивируйте его снова.

А иногда я использовал временные данные (transient), как в ответе @fischi. Например, здесь запрос для создания товаров WooCommerce из изображений или здесь Удаление/замена тегов img в контенте записей для автоматически публикуемых постов

Комбинация обоих подходов может быть альтернативой.

Другой способ — установить глобальную wp_option, когда работа завершена, и проверять эту опцию каждый раз при выполнении хука init.

function my_one_time_function() {
    // Выходим, если работа уже выполнена.
    if ( get_option( 'my_one_time_function', '0' ) == '1' ) {
        return;
    }

    /***** ВЫПОЛНИТЕ ВАШУ ОДНОРАЗОВУЮ РАБОТУ *****/

    // Добавляем или обновляем wp_option
    update_option( 'my_one_time_function', '1' );
}
add_action( 'init', 'my_one_time_function' );

Естественно, вам не нужно хранить этот код вечно (даже если это просто чтение из базы данных), поэтому вы можете удалить его после завершения работы. Также вы можете вручную изменить значение этой опции на 0, если вам нужно повторно выполнить код.

Использование wp-cli eval-file — это отличный способ. Вы даже можете выполнять его на удаленной системе (используя ssh-алиас через '@') с локальным скриптом.

Если ваш код находится в файле one-time.php в корневой директории WordPress, и у вас есть доступ к командной строке на системе, против которой нужно выполнить команду, вы можете сделать так:

wp eval-file one-time.php

Если файл one-time.php находится локально, и вы хотите выполнить его на удаленном WordPress, используя @, команда будет выглядеть так:

wp @remote eval-file - < one-time.php

Мой подход немного отличается. Я предпочитаю добавлять одноразовые скрипты как функцию в файл function.php моей темы и запускать их по определенному GET-запросу.

if ( isset($_GET['linkupdate']) ) {
    add_action('init', 'link_update', 10);
}
function link_update() {
  // Одноразовый скрипт
   die;
}

Чтобы запустить этот скрипт, просто перейдите по URL "www.sitename.com/?linkupdate"

Пока что этот метод отлично работает для меня...

Есть ли у этого способа какие-либо недостатки? Просто интересно...

Я просто использую один пользовательский шаблон страницы товара, который не задействован и не подключен ни к чему на публичном сервере.

Например, если у меня есть страница с отзывами, которая не опубликована (в черновике или другом статусе), но привязана к шаблону отдельной страницы, например single-testimonial.php — я могу разместить функции внутри этого файла, загрузить страницу через preview, и функция (или что-то другое) будет запущена один раз. Также очень легко вносить изменения в функцию при отладке.

Это действительно просто, и я предпочитаю такой подход использованию хука init, потому что у меня больше контроля над тем, когда и как функция запускается. Просто мои личные предпочтения.

На всякий случай, если это поможет, вот что я сделал, и это хорошо работает:

add_action( 'init', 'upsubscriptions_setup');

function upsubscriptions_setup()
{
    $version = get_option('upsubscriptions_setup_version');

    // Если версия еще не записана в БД
    if (!$version) {
        add_option('upsubscriptions_setup_version', '0.1');
        $version = get_option('upsubscriptions_setup_version');
    }

    if (version_compare($version, "0.1") <= 0) {
        // выполнить действия
        update_option('upsubscriptions_setup_version', '0.2');
    }

    if (version_compare($version, "0.2") <= 0) {
        // выполнить действия
        update_option('upsubscriptions_setup_version', '0.3');
    }

    if (version_compare($version, "0.3") <= 0) {
        // выполнить действия
        update_option('upsubscriptions_setup_version', '0.4');
    }

    // и т.д.
}