CHOWN(3)								 1								  CHOWN(3)

chown - Changes file owner

SYNOPSIS

       bool chown (string  $filename, mixed  $user)

DESCRIPTION

	Attempts to change the owner of the file $filename to user $user. Only the superuser may change the owner of a file.

PARAMETERS

	      o $filename
		- Path to the file.

	      o $user
		- A user name or number.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Simple chown(3) usage

	      <?php

	      // File name and username to use
	      $file_name= "foo.php";
	      $path = "/home/sites/php.net/public_html/sandbox/" . $file_name ;
	      $user_name = "root";

	      // Set the user
	      chown($path, $user_name);

	      // Check the result
	      $stat = stat($path);
	      print_r(posix_getpwuid($stat['uid']));

	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [name] => root
		  [passwd] => x
		  [uid] => 0
		  [gid] => 0
		  [gecos] => root
		  [dir] => /root
		  [shell] => /bin/bash
	      )

NOTES

       Note

	      This function will not work on remote files as the file to be examined must be accessible via the server's filesystem.

       Note

	      When  safe  mode is enabled, PHP checks whether the files or directories being operated upon have the same UID (owner) as the script
	      that is being executed.

SEE ALSO

       chmod(3), chgrp(3).

PHP Documentation Group 														  CHOWN(3)