save_post フックの使い方説明・引数・注意点
save_post は、投稿が保存(作成・更新)されたときに実行されるアクションです。カスタムフィールドの保存などに使います。
説明
save_post は、投稿が保存(作成・更新)されたときに実行されるアクションです。カスタムフィールドの保存などに使います。
基本構文
do_action( 'save_post', int $post_id, WP_Post $post, bool $update )
引数
$post_id:投稿ID$post:WP_Postオブジェクト$update:更新ならtrue、新規ならfalse
戻り値
値は返しません。
使い方(サンプル)
add_action( 'save_post', function( $post_id ) {
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
return;
}
if ( ! current_user_can( 'edit_post', $post_id ) ) {
return;
}
update_post_meta( $post_id, 'my_key', 'value' );
} );
注意点
- 自動保存・リビジョンでも呼ばれるため、
DOING_AUTOSAVEやwp_is_post_revision()で除外します。 - nonce検証と権限チェックを必ず行います。
- フック内で
wp_update_post()を呼ぶと無限ループになります。
実務での使いどころ
- メタボックスで入力したカスタムフィールドの値を、保存するとき。
- 投稿の保存をきっかけに、キャッシュの削除や通知を行うとき。
- 特定の投稿タイプの保存時だけ、処理を行うとき(
save_post_{post_type})。
よくあるミスと対策
- 自動保存(
DOING_AUTOSAVE)やリビジョンでも実行され、処理が何度も走る。 - nonceと権限(
current_user_can( 'edit_post', $post_id ))の確認をしていない。 - フックの中で
wp_update_post()を呼び、無限ループになる。呼ぶ前にフックを外し、呼んだ後に付け直します。 - すべての投稿タイプで実行される。特定の投稿タイプだけに絞りたいときは、
save_post_{post_type}を使います。
NG例
add_action( 'save_post', function ( $post_id ) {
wp_update_post( array( 'ID' => $post_id, 'post_title' => '更新' ) ); // 無限ループになる
} );
OK例
add_action( 'save_post', 'my_save_post' );
function my_save_post( $post_id ) {
if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
return;
}
if ( wp_is_post_revision( $post_id ) ) {
return;
}
if ( ! current_user_can( 'edit_post', $post_id ) ) {
return;
}
// nonceの確認と、保存処理
}
使い分け早見表
| フック | 実行されるタイミング |
|---|---|
save_post |
投稿タイプを問わず、投稿の保存時(新規投稿画面を開いたときに作られる自動下書きでも実行される) |
save_post_{post_type} |
指定した投稿タイプの、保存時のみ(save_post より先に実行される) |
wp_after_insert_post |
投稿に加えて、タームやメタの保存も終わった後(WordPress 5.6以降) |
PR エックスサーバー
WordPressを、速く・止まらずに運営したい方へ
サーバー選びを間違えると、表示が遅い・サイトが止まるリスクがあります
こんなお悩みはありませんか?
- どのレンタルサーバーを選べばよいか分からない
- 表示が遅い・サイトが落ちるのが心配
- WordPressの設定やセキュリティに自信がない
サーバーは、あとから乗り換えると、データの移行やドメインの設定に手間がかかります。表示が遅い、突然止まるといったトラブルは、訪問者が離れる原因にもなります。最初に、稼働率の保証や実績を確認して選ぶのが安全です。
エックスサーバーなら、WordPressの運営に強いレンタルサーバーを、迷わず選べます。国内でWordPressを利用して運用されているサイトの集計(Dataprovider.com調べ、2025年6月)で、国内シェアNo.1と公式サイトに記載されています。
選ばれるポイント
- WordPressサイトの国内シェアNo.1。実績で選びたいときの安心材料(Dataprovider.com調べ、2025年6月)
- サイトが止まりにくい。月間稼働率99.99%以上を保証し、下回ると月額費用の一部を返金
- 攻撃に強い。WordPressを狙った攻撃の99%以上を未然に防ぐ機能(2024年9月15日〜11月15日の当社調べ)
- ドメイン代を節約できる。独自ドメインが永久無料(対象ドメイン・契約期間などの条件あり)
- テーマ選びも安心。人気テーマ「Cocoon」の開発・提供元が運営
- 10日間の無料お試しで、契約前に操作や表示の速さを確かめられる
10日間の無料お試しで、契約前に試せます
10日間無料でお試し
広告(アフィリエイト)を含みます。特長は2026年11月8日時点の公式サイトの記載で、数値・順位は各調査・調べの時点のものです。料金・条件は公式サイトでご確認ください。
関連項目
wp_insert_post()、add_meta_box()、wp_is_post_revision()、wp_update_post()、current_user_can()
本記事は情報提供を目的としています。WordPress本体やテーマ・プラグインのバージョンによって動作が異なる場合があるため、本番環境に反映する前に、必ずテスト環境で動作を確認してください。