allow_subdirectory_install()

Q: allow_subdirectory_install() はどのファイルで定義されていますか？

allow_subdirectory_install() は WordPress のコアファイルで定義されており、通常 wp-admin/includes/network.php にあります。

Q: allow_subdirectory_install() を wp-config.php に記述する必要がありますか？

いいえ、この関数自体は wp-config.php には記述せず、SUBDOMAIN_INSTALL の定義と合わせて動作します。

2025/6/21 Saturday

allow_subdirectory_install() は、WordPress のマルチサイト機能を設定する際に、サブディレクトリ型のインストールを許可するかどうかを決定する関数です。

マルチサイトを有効にする場合、サブディレクトリ型（example.com/site1/ のような形式）とサブドメイン型（site1.example.com のような形式）の 2 種類が選択可能ですが、この関数を使用すると、サブディレクトリ型を有効にできます。

機能の説明

この関数は何をするのか？

allow_subdirectory_install() は、WordPress のマルチサイトをセットアップするときに、サブディレクトリ型のインストールを許可するかどうかを決定するために使用されます。この関数が true を返すと、WordPress はサブディレクトリ型のインストールを許可します。

いつ使うのか？

WordPress マルチサイトのセットアップ時
wp-config.php に設定を追加する際に、サブディレクトリ型のインストールを許可するかどうかを明示する場合

シンプルなコード例

if (allow_subdirectory_install()) {
    echo "サブディレクトリ型のマルチサイトインストールが許可されています。";
} else {
    echo "サブディレクトリ型のマルチサイトインストールは許可されていません。";
}

allow_subdirectory_install() を呼び出し、その戻り値を確認します。
true の場合、サブディレクトリ型のインストールが許可されていることを表示します。
false の場合、サブディレクトリ型のインストールが許可されていないことを表示します。

使い方の説明

この関数は通常 wp-config.php の設定と連携して動作します。
マルチサイトを設定する際に wp-config.php に以下のコードを追加することで、サブディレクトリ型のインストールを有効にできます。

define('SUBDOMAIN_INSTALL', false);

SUBDOMAIN_INSTALL を false に設定すると、サブディレクトリ型のマルチサイトが有効になります。
これにより、allow_subdirectory_install() が true を返すようになります。

一緒に使うことが多い関連タグ

`is_multisite()`

マルチサイト機能が有効かどうかを判定する。

if (is_multisite()) {
    echo "WordPress マルチサイトが有効です。";
}

`define('MULTISITE', true);`

WordPress のマルチサイト機能を有効にする。

define('MULTISITE', true);
define('SUBDOMAIN_INSTALL', false);

`define('SUBDOMAIN_INSTALL', true);`

サブドメイン型のマルチサイトを有効にする。

define('SUBDOMAIN_INSTALL', true);

追加情報で取得したい場合

現在のサイトの URL 形式を確認する

サブディレクトリ型かサブドメイン型かを判定するには、以下のコードを使用します。

if (defined('SUBDOMAIN_INSTALL') && SUBDOMAIN_INSTALL) {
    echo "このサイトはサブドメイン型のマルチサイトです。";
} else {
    echo "このサイトはサブディレクトリ型のマルチサイトです。";
}

想定されるトラブル

サブディレクトリ型のインストールが許可されない

解決方法

wp-config.php に define('SUBDOMAIN_INSTALL', false); が適切に設定されているか確認する。
allow_subdirectory_install() の戻り値を確認し、false になっている場合は wp-config.php を修正する。