set_include_path

関数名：set_include_path（）

該当するバージョン：すべてのPHPバージョン

関数の説明：set_include_path（）関数は、PHPの含まれたファイル検索パスを設定するために使用されます。付属のファイル検索パスを設定することにより、ファイルを含めるときにPHPをより柔軟で便利にすることができます。

構文：set_include_path（string $ new_include_path）：string | false

パラメーター：

• $ new_include_path：設定するファイル検索パスが含まれています。これは、コロン（:)分離された文字列、または複数のパスを含む配列です。

返品値：

• 含まれたファイル検索パスが正常に設定されている場合、新しい検索パス文字列が返されます。
• 設定が失敗した場合、falseが返されます。

例：

1. 単一のパスを設定します。

 $path = '/path/to/includes'; $result = set_include_path($path); if ($result !== false) { echo "包含文件搜索路径已设置为： $result"; } else { echo "设置包含文件搜索路径失败"; }

2. 複数のパスを設定します：

 $paths = array( '/path/to/includes1', '/path/to/includes2', '/path/to/includes3' ); $result = set_include_path(implode(':', $paths)); if ($result !== false) { echo "包含文件搜索路径已设置为： $result"; } else { echo "设置包含文件搜索路径失败"; }

3. 現在含まれているファイル検索パスを取得します。

 $currentPath = get_include_path(); echo "当前的包含文件搜索路径为： $currentPath";

注：

• 付属のファイル検索パスを設定すると、パスに相対パスが含まれている場合、現在のスクリプトファイルが配置されているディレクトリに比べて解析されます。
• 設定されたパスが無効または存在しない場合、ファイルを含めるときにエラーが発生します。
• 含まれているファイル検索パスが設定されていない場合、デフォルトでは、PHPは現在のスクリプトファイルが配置されているディレクトリで検索されます。