update_option()


WordPressのupdate_option()関数は、指定したオプション値をデータベースに保存または更新するために使用されます。この関数はオプションが存在しない場合、新しいオプションを作成します。

構文

update_option( string $option, mixed $value, bool $autoload = true );

引数の説明:

  • $option (string) — 更新または作成するオプションの名前。
  • $value (mixed) — 保存または更新する値。文字列、配列、数値など。
  • $autoload (bool) — オプションを自動ロードするかどうかを指定します (デフォルトはtrue)。

例 1. 基本的なオプションの設定

以下のコードは、カスタムオプションを設定します。

update_option( 'custom_option_name', 'カスタム値' );

例 2. 配列の保存

配列データをオプションとして保存します。

update_option( 'custom_array_option', array( 'キー1' => '値1', 'キー2' => '値2' ) );

例 3. 既存のオプションの更新

既存のオプションを新しい値で更新します。

update_option( 'site_name', get_bloginfo( 'name' ) . ' - Updated' );

例 4. 自動ロードを無効にする

自動ロードを無効にした状態でオプションを保存します。

update_option( 'non_autoload_option', '値', false );

例 5. 条件付きでオプションを更新

オプションが存在しない場合にのみ保存します。

if ( ! get_option( 'conditional_option' ) ) {
    update_option( 'conditional_option', '初期値' );
}

注意事項

  • データベースの負担を軽減するため、自動ロードを無効にすることを検討してください。
  • $optionには一意の名前を使用する必要があります。

関連機能：