chdir
(PHP 4, PHP 5, PHP 7)
chdir — ディレクトリを変更する
説明
chdir
( string $directory
) : bool
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
を確認してください。