delete_site_meta_by_key()


WordPressの関数delete_site_meta_by_key()は、サイトメタデータをキーに基づいて削除するために使用されます。

構文

delete_site_meta_by_key( string $meta_key );
  • $meta_key(string)—削除するメタデータのキーを指定します。

例1:基本的なメタデータの削除

特定のメタキーを持つサイトメタデータを削除します。

delete_site_meta_by_key('custom_site_option');

例2:プラグイン無効化時のメタデータ削除

プラグインが無効化されたときにメタデータをクリーンアップします。

register_deactivation_hook(__FILE__,function(){delete_site_meta_by_key('plugin_temp_data');});

例3:マルチサイトでの使用

ネットワーク全体から特定のメタデータを削除します。

if(is_multisite()){delete_site_meta_by_key('network_wide_setting');}

例4:バッチ処理での削除

複数のサイトを処理する際にメタデータを削除します。

foreach(get_sites()as$site){switch_to_blog($site->blog_id);delete_site_meta_by_key('old_cache');}

例5:条件付き削除

特定の条件を満たす場合にのみメタデータを削除します。

if(get_site_meta(get_current_blog_id(),'expired_flag',true)){delete_site_meta_by_key('expired_flag');}

例6:エラーハンドリング

削除操作の結果をチェックします。

$result=delete_site_meta_by_key('test_key');if(false===$result){error_log('削除に失敗しました');}

例7:フックとの連携

削除後にアクションを実行します。

add_action('delete_site_meta_by_key',function($meta_key){//追加処理},10,1);delete_site_meta_by_key('trigger_key');

注意事項

  • この関数はマルチサイト環境でのみ使用可能です。
  • 重要なデータを削除する前にバックアップを取ってください。
  • 権限管理を適切に行ってください。

関連機能：