PHP マニュアル: ディレクトリを変更する

説明

bool chdir(string $directory)

PHP のカレントディレクトリを directory に変更します。

パラメータ

directory: 新しいカレントディレクトリ

戻り値

成功した場合に true を、失敗した場合に false を返します。

エラー / 例外

失敗した場合は E_WARNING レベルのエラーが発生します。

例

例1 chdir の例

<?php

// カレントディレクトリ
echo getcwd() . "\n";

chdir('public_html');

// カレントディレクトリ
echo getcwd() . "\n";

?>

上の例の出力は、たとえば以下のようになります。

/home/vincent
/home/vincent/public_html

注意

警告

PHP インタプリタが ZTS (Zend Thread Safety) を有効にしてビルドされている場合、 chdir 関数を使って行った現在のディレクトリの変更はオペレーティングシステムには見えません。全てのPHPのビルトイン関数は、現在のディレクトリの変更を尊重しますが、 FFI を使って呼び出された外部ライブラリはそうではありません。あなたの PHP で ZTS が有効かどうかを調べるには、php -i コマンドを使うか、ビルトイン定数PHP_ZTS を確認してください。

参考

getcwd