chdir

Change directory

&reftitle.description; `bool` `chdir` `string` `directory`

Changes PHP's current directory to `directory`.

&reftitle.parameters;

`directory`

- The new current directory

&reftitle.returnvalues;

&return.success;

&reftitle.errors;

Throws an error of level `E_WARNING` on failure.

&reftitle.examples;

### `chdir` example

    <?php

    // current directory
    echo getcwd() . "\n";

    chdir('public_html');

    // current directory
    echo getcwd() . "\n";

    ?>

&example.outputs.similar;

    /home/vincent
    /home/vincent/public_html

&reftitle.notes;

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`.

&reftitle.seealso;

- `getcwd`