php man page for chown

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)