chdir
PHP function
Edit on GitHub ✎
(PHP 4, PHP 5, PHP 7, PHP 8)
Change directory
Description
chdir(string $directory): bool
Changes PHP's current directory to directory.
Parameters
directoryThe new current directory
Return Values
Success
Errors/Exceptions
Throws an error of level E_WARNING on failure.
Examples
chdir() example
php
<?php
// current directory
echo getcwd() . "\n";
chdir('public_html');
// current directory
echo getcwd() . "\n";
?>The above example will output something similar to:
output
/home/vincent
/home/vincent/public_htmlNotes
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.