update_site_option()


WordPress関数update_site_option()は、サイトオプションを更新するために使用されます。この関数は特定のサイトオプションの値をデータベースに保存します。

シンタックス

update_site_option( string $option, mixed $value );

引数の説明:

  • $option (string) — 更新するオプション名。
  • $value (mixed) — 新しい値。この値は配列や文字列、整数など任意の形式で指定可能。

例 1. サイトオプションの更新

次のコードは、特定のオプションの値を更新します。

<?php update_site_option( 'example_option', '新しい値' ); ?>

例 2. 配列形式の値を保存

配列として保存したい場合の例です。

<?php
update_site_option( 'example_array', array( 'key1' => 'value1', 'key2' => 'value2' ) );
?>

例 3. サイトの設定を条件に基づいて変更

条件によってオプションの値を変更する例です。

<?php
if ( is_multisite() ) {
    update_site_option( 'example_option', 'マルチサイト用の値' );
}
?>

例 4. 現在の値を取得して更新

現在の値を取得して、その値を加工して保存する場合。

<?php
$current_value = get_site_option( 'example_option' );
update_site_option( 'example_option', $current_value . ' - 更新済み' );
?>

例 5. サイト全体のオプションをリセット

既存の値を空にリセットする場合。

<?php update_site_option( 'example_option', '' ); ?>

注意事項

  • update_site_option()は、マルチサイトインストールで主に使用されます。シングルサイトではupdate_option()を使用してください。
  • 不適切な値を渡すと予期しない動作を引き起こす可能性があります。引数は正確に指定してください。

関連機能：