wp_next_scheduled()
Повертає мітку часу (timestamp), коли має спрацювати наступне за розкладом cron завдання. Дозволяє перевірити, чи є в крон зазначене завдання.
Основа для:
wp_schedule_single_event()
wp_schedule_single_event()
1 раз – 0.001667 сек
(дуже повільно) | 50000 разів – 3.12 сек
(швидко) |
PHP 7.2.5, WP 4.9.8
(дуже повільно) | 50000 разів – 3.12 сек
(швидко) |
PHP 7.2.5, WP 4.9.8
Хуків немає.
Повертає
int|false
. число або false: Мітка часу UNIX наступної вказаної події. Якщо подія не знайдено, поверне false.
Використання
wp_next_scheduled ($ hook, $ args);
-
$hook
(рядок) (обов’язковий) - Назва хука, який буде виконано після настання часу події.
-
$args
(масив) -
Аргументи, які мають бути передані у функцію, яка підключена до хука. add_action
() .
За замовчуванням: array()
Приклади
#1 Перевірка наявності cron завдання перед реєстрацією нової
Зазвичай події реєструються під час активації плагіна. Але це завжди зручно.
// Переконаємося, що події немає, перш ніж реєструвати нове cron завдання. if ( ! wp_next_scheduled( 'my_hourly_event' ) ) { wp_schedule_event( time(), 'hourly', 'my_hourly_event'); } // додаємо функцію до вказаного хука add_action('my_hourly_event', 'do_this_hourly'); function do_this_hourly() { // робимо щось кожну годину }
Інші приклади дивіться в описі wp_schedule_event() .
список змін
З версії 2.1.0 | Введено. |
Код wp_next_scheduled() wp next scheduled WP 6.0.2
function wp_next_scheduled( $hook, $args = array() ) { $next_event = wp_get_scheduled_event($hook, $args); if ( ! $next_event ) { return false; } return $next_event->timestamp; }