wp_get_ready_cron_jobs()


WordPressのwp_get_ready_cron_jobs()関数は、準備が完了したcronジョブの配列を取得するために使用されます。スケジュールされたタスクの中で実行待ち状態のものを確認できます。

構文

wp_get_ready_cron_jobs();
  • (array) — 実行準備が整ったcronジョブの配列。ジョブが存在しない場合は空の配列を返します。

例1: 準備済みcronジョブの取得

基本的な使用例。準備が完了したcronジョブを取得します。

$ready_cron_jobs = wp_get_ready_cron_jobs();

例2: cronジョブの存在チェック

準備済みのcronジョブがあるかどうかを確認します。

if(!empty(wp_get_ready_cron_jobs())){echo'ジョブが存在します';}

例3: cronジョブの数をカウント

準備済みのcronジョブの数を数えます。

$job_count = count(wp_get_ready_cron_jobs());

例4: 特定のcronジョブを確認

特定のcronジョブが準備されているかチェックします。

$jobs = wp_get_ready_cron_jobs();if(isset($jobs['my_custom_job'])){/*処理*/}

例5: cronジョブの詳細をログに出力

準備済みcronジョブの詳細をデバッグログに記録します。

error_log(print_r(wp_get_ready_cron_jobs(),true));

例6: 準備済みジョブの実行

準備が整ったcronジョブを手動で実行します。

foreach(wp_get_ready_cron_jobs()as$hook=>$job){do_action($hook);}

例7: 特定のフックを持つジョブをフィルタリング

特定のフック名を持つ準備済みジョブのみを取得します。

$filtered_jobs = array_filter(wp_get_ready_cron_jobs(),function($job){return$job['hook']==='my_hook';});

注意点

  • この関数はデータベースから直接情報を取得しません。メモリ内のcron配列をチェックします。
  • マルチサイト環境では、サイトごとに異なる結果が返される場合があります。
  • cronジョブの実行タイミングはサーバーの負荷状況に影響されることがあります。

関連機能: