Chdir - Manual - PHP

update page now

• Downloads
• Documentation
• Get Involved
• Help
• 

Search docs PHP 8.5.4 Released! Getting Started Introduction A simple tutorial Language Reference Basic syntax Types Variables Constants Expressions Operators Control Structures Functions Classes and Objects Namespaces Enumerations Errors Exceptions Fibers Generators Attributes References Explained Predefined Variables Predefined Exceptions Predefined Interfaces and Classes Predefined Attributes Context options and parameters Supported Protocols and Wrappers Security Introduction General considerations Installed as CGI binary Installed as an Apache module Session Security Filesystem Security Database Security Error Reporting User Submitted Data Hiding PHP Keeping Current Features HTTP authentication with PHP Cookies Sessions Handling file uploads Using remote files Connection handling Persistent Database Connections Command line usage Garbage Collection DTrace Dynamic Tracing Function Reference Affecting PHP's Behaviour Audio Formats Manipulation Authentication Services Command Line Specific Extensions Compression and Archive Extensions Cryptography Extensions Database Extensions Date and Time Related Extensions File System Related Extensions Human Language and Character Encoding Support Image Processing and Generation Mail Related Extensions Mathematical Extensions Non-Text MIME Output Process Control Extensions Other Basic Extensions Other Services Search Engine Extensions Server Specific Extensions Session Extensions Text Processing Variable and Type Related Extensions Web Services Windows Only Extensions XML Manipulation GUI Extensions Keyboard Shortcuts? This help j Next menu item k Previous menu item g p Previous man page g n Next man page G Scroll to bottom g g Scroll to top g h Goto homepage g s Goto search(current page) / Focus search box chroot » « Directory Functions

• Preface
• Function Reference
• File System Related Extensions
• Directories
• Directory Functions

Change language: English German Spanish French Italian Japanese Brazilian Portuguese Russian Turkish Ukrainian Chinese (Simplified) Other chdir

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

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.

See Also

• getcwd() - Gets the current working directory

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug ＋add a note

User Contributed Notes 1 note

up down 10 nesk at xakep dot ru ¶5 years ago When working with FFI under a PHP ZTS environment, there is no standard way to change the directory with libraries (dll/so/dylib/etc), so to get around this problem, you should use something like this polyfill: <?php $directory = 'path/to/libraries'; switch (\PHP_OS_FAMILY) { case 'Windows': \FFI::cdef('extern unsigned char SetDllDirectoryA(const char* lpPathName);', 'kernel32.dll') ->SetDllDirectoryA($directory) ; break; case 'Linux': case 'BSD': \FFI::cdef('int setenv(const char *name, const char *value, int overwrite);') ->setenv('LD_LIBRARY_PATH', $directory, 1) ; break; case 'Darwin': \FFI::cdef('int setenv(const char *name, const char *value, int overwrite);') ->setenv('DYLD_LIBRARY_PATH', $directory, 1) ; break; } ?> ＋add a note

• Directory Functions
  • chdir
  • chroot
  • closedir
  • dir
  • getcwd
  • opendir
  • readdir
  • rewinddir
  • scandir

↑ and ↓ to navigate • Enter to select • Esc to close • / to open Press Enter without selection to search using Google