array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'function.chdir.php', 1 => 'chdir', 2 => 'ディレクトリを変更する', ), 'up' => array ( 0 => 'ref.dir.php', 1 => 'ディレクトリ 関数', ), 'prev' => array ( 0 => 'ref.dir.php', 1 => 'ディレクトリ 関数', ), 'next' => array ( 0 => 'function.chroot.php', 1 => 'chroot', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/dir/functions/chdir.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

chdir

(PHP 4, PHP 5, PHP 7, PHP 8)

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 を確認してください。

参考