Php/docs/function.chdir
chdir
(PHP 4, PHP 5, PHP 7)
chdir — Change directory
Description
chdir
( string $directory
) : bool
Changes PHP's current directory to
directory
.
Parameters
directory
- The new current directory
Return Values
Returns TRUE
on success or FALSE
on failure.
Errors/Exceptions
Throws an error of level E_WARNING
on failure.
Examples
Example #1 chdir() example
<?php// current directoryecho getcwd() . "\n";chdir('public_html');// current directoryecho getcwd() . "\n";?>
The above example will output something similar to:
/home/vincent /home/vincent/public_html
Notes
Caution
If the PHP interpreter has been built with ZTS (Zend Thread Safety) enabled,
any changes to the current directory made through chdir()
will be invisible to the operating system. All built-in PHP functions will
still respect the change in current directory; but external library
functions called using FFI will not. You
can tell whether your copy of PHP was built with ZTS enabled using
php -i or the built-in constant
PHP_ZTS
.