WordPress - Cron Jobs

Tài liệu tham khảo: https://developer.wordpress.org/plugins/cron/

• Những điểm lưu ý chính
• Debug Cron Job
• Tạo cron job đầu tiên
• Xóa cron job khi không sử dụng
• Set cron job hosting thay vì sử dụng mặc định

Những điểm lưu ý chính

• Cron Job dựa theo action page load của người dùng/bot.

Đó là lý do tại sao nhiều người khuyên set disable cron mặc định của WordPress, và set access bằng cron cố định do công cụ hosting cung cấp.

• Cron Job được set không có nghĩa là 100% sẽ chạy ở thời điểm dự kiến, mà thực tế được xếp hàng (queue) và chạy ở thời điểm page load tiếp theo.

Hiểu nôm na, giả sử ta lên lịch hàng ngày backup vào 7:00, nhưng thời điểm đó KHÔNG có người/bot truy cập, thì khi lần tiếp theo có truy cập (ví dụ 07:05), hệ thống sẽ thực thi cả những action cron nào chưa chạy.

• Cron Job nếu không dùng thì cần viết function để xóa cron tránh trường hợp cron job thừa chạy tốn tài nguyên.

Debug Cron Job

Sử dụng plugin WP Crontrol là cách tốt nhất để xem bằng giao diện admin trông như thế nào.

Tạo Cron Job đầu tiên

Dưới đây là 1 cron job đầu tiên, bao gồm các function custom sau:

- ct_cron_jobs_init - dùng wp_next_scheduled() kiểm tra cron có chưa, nếu chưa thì dùng wp_schedule_event() để set
- ct_cron_job_example - tên của action sẽ chạy khi cron job chạy - nó chỉ là tên của action, không cần function thực sự
- ct_cron_job_run_action - là function sẽ chạy vào hook ct_cron_job_example để thực thi nhiệm vụ

Ta có thể cần edit để tạo ra 1 thời gian lặp lại (ví dụ: mỗi 2 phút - 2minutes) để đăng ký với WordPress. Mặc định WordPress cung cấp sẵn: hourly, twicedaily, daily, weekly

Code mẫu toàn bộ

add_filter('cron_schedules', 'ct_cron_schedules');
/**
 * Set khung giờ riêng (2 phút/lần)
 */
function ct_cron_schedules($schedules)
{
	// Default: hourly, twicedaily, daily, weekly
	// Add new settings
	$schedules['2minutes'] = array(
		'interval' => 2 * MINUTE_IN_SECONDS,
		'display' => __('Every 2 minutes', 'ct-test-theme')
	);

	return $schedules;
}

add_action('init', 'ct_cron_jobs_init');
/**
  * Tạo cron job, thực ra là chạy cron với do_action('ct_cron_job_example')
  */
function ct_cron_jobs_init()
{
	if (!wp_next_scheduled('ct_cron_job_example')) {
		// Schedule the event
		wp_schedule_event(time(), '2minutes', 'ct_cron_job_example');
	}
}

add_action('ct_cron_job_example', 'ct_cron_job_run_action');

/**
  * Thực thi 1 function cụ thể mỗi khi do_action('ct_cron_job_example') chạy
  */
function ct_cron_job_run_action()
{
	error_log(__FUNCTION__ . ':: Run with timestamp ' . time());
}

Kết quả nhận được trong file wp-content/debug.log

[29-Jan-2022 13:46:06 UTC] ct_cron_job_run_action:: Run with timestamp1643463966
[29-Jan-2022 13:46:28 UTC] ct_cron_job_run_action:: Run with timestamp1643463988
[29-Jan-2022 13:48:11 UTC] ct_cron_job_run_action:: Run with timestamp 1643464091
[29-Jan-2022 13:50:33 UTC] ct_cron_job_run_action:: Run with timestamp 1643464233
[29-Jan-2022 13:52:35 UTC] ct_cron_job_run_action:: Run with timestamp 1643464355
[29-Jan-2022 13:54:36 UTC] ct_cron_job_run_action:: Run with timestamp 1643464476
[29-Jan-2022 13:56:37 UTC] ct_cron_job_run_action:: Run with timestamp 1643464597
[29-Jan-2022 13:58:38 UTC] ct_cron_job_run_action:: Run with timestamp 1643464718
[29-Jan-2022 14:00:27 UTC] ct_cron_job_run_action:: Run with timestamp 1643464827
[29-Jan-2022 14:02:47 UTC] ct_cron_job_run_action:: Run with timestamp 1643464967
[29-Jan-2022 14:05:49 UTC] ct_cron_job_run_action:: Run with timestamp 1643465149
[29-Jan-2022 14:07:50 UTC] ct_cron_job_run_action:: Run with timestamp 1643465270
[29-Jan-2022 14:09:51 UTC] ct_cron_job_run_action:: Run with timestamp 1643465391
[29-Jan-2022 14:11:52 UTC] ct_cron_job_run_action:: Run with timestamp 1643465512

Xóa cron job khi không sử dụng

Khi không có sử dụng nữa, hãy xóa action đi. Xóa action thì tất cả function đang chèn vào nó sẽ không hoạt động.

delete_action( 'ct_cron_job_example', 'ct_cron_jobs_deactivate_hook' );
// clean the scheduler
function ct_cron_jobs_deactivate_hook() {
  wp_clear_scheduled_hook( 'ct_cron_job_example' );
}

Set cron job hosting thay vì sử dụng mặc định

Xem tài liệu: https://developer.wordpress.org/plugins/cron/hooking-wp-cron-into-the-system-task-scheduler/

Một ví dụ triển khai cron job trên hosting/VPS: https://easyengine.io/tutorials/wordpress/wp-cron-crontab/

Mục tiêu: Đảm bảo vào đúng thời điểm dự kiến luôn luôn chạy được Cron Job thay vì dồn Cron Job lại vào lần truy cập kế tiếp.