register_uninstall_hook() の使い方｜説明・引数・注意点

フック（アクション・フィルター）

register_uninstall_hook() は、プラグインが削除（アンインストール）されたときに実行する関数を登録する関数です。

2026.10.03

説明

register_uninstall_hook() は、プラグインが削除（アンインストール）されたときに実行する関数を登録する関数です。

register_uninstall_hook( string $file, callable $callback ): void

戻り値はありません。

register_uninstall_hook( __FILE__, 'myplugin_uninstall' );
function myplugin_uninstall() {
	delete_option( 'myplugin_version' );
}

コールバックに、無名関数（クロージャ）を渡している。登録情報は、データベースに保存されるが、クロージャはシリアライズできず、エラーになる場合がある。関数名の文字列か、静的メソッドを指定する。
フックの中で、呼んでいる。ファイルの直下で、呼ぶ。
uninstall.php がある場合は、uninstall.php だけが実行され、register_uninstall_hook() で登録した関数は呼ばれない。どちらか一方にする。
データを消す処理で、権限や、確認を考えていない。

NG例

register_uninstall_hook( __FILE__, function () {
	delete_option( 'my_setting' ); // 無名関数は、使えない
} );

OK例

register_uninstall_hook( __FILE__, 'my_uninstall' );
function my_uninstall() {
	delete_option( 'my_setting' );
}