dismiss Step into the future! Click here to switch to the beta php.net site
downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | conferences | my php.net

search for in the

closedir> <chdir
[edit] Last updated: Fri, 28 Jun 2013

view this page in

chroot

(PHP 4 >= 4.0.5, PHP 5)

chrootChange the root directory

Description

bool chroot ( string $directory )

Changes the root directory of the current process to directory, and changes the current working directory to "/".

This function is only available to GNU and BSD systems, and only when using the CLI, CGI or Embed SAPI. Also, this function requires root privileges.

Parameters

directory

The path to change the root directory to.

Return Values

Returns TRUE on success or FALSE on failure.

Examples

Example #1 chroot() example

<?php
chroot
("/path/to/your/chroot/");
echo 
getcwd();
?>

The above example will output:

/

Notes

Note: This function is not implemented on Windows platforms.



add a note add a note User Contributed Notes chroot - [1 notes]
up
-3
nmmm at nmmm dot nu
1 year ago
on my system this function is missing (Linux, php-cli), so I did:

if ( function_exists("chroot") ){
       chroot($chroot);
       server_log("chroot() to $chroot", 1);
}else{
       server_log("Can not chroot(). Will try live without it.");
}

 
show source | credits | stats | sitemap | contact | advertising | mirror sites