php man page for copy

COPY(3) 								 1								   COPY(3)

copy - Copies file

SYNOPSIS
       bool copy (string  $source, string  $dest, [resource  $context])

DESCRIPTION
	Makes a copy of the file $source to $dest.

	If you wish to move a file, use the rename(3) function.

PARAMETERS
	      o $source
		- Path to the source file.

	      o $dest
		-  The	destination  path.  If $dest is a URL, the copy operation may fail if the wrapper does not support overwriting of existing
		files.

	      Warning

		      If the destination file already exists, it will be overwritten.

	      o $context
		- A valid context resource created with stream_context_create(3).

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

CHANGELOG
       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.4	|						    |
       |	|						    |
       |	|  Changed the $context parameter to actually  have |
       |	| an effect. Previously, any $context was ignored.  |
       |	|						    |
       | 5.3.0	|						    |
       |	|						    |
       |	|		Added context support.		    |
       |	|						    |
       | 4.3.0	|						    |
       |	|						    |
       |	|  Both  $source  and  $dest may now be URLs if the |
       |	| "fopen wrappers" have been enabled. See  fopen(3) |
       |	| for more details.				    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES
       Example #1

	      copy(3) example

	      <?php
	      $file = 'example.txt';
	      $newfile = 'example.txt.bak';

	      if (!copy($file, $newfile)) {
		  echo "failed to copy $file...
";
	      }
	      ?>

SEE ALSO
       move_uploaded_file(3), rename(3), The section of the manual about handling file uploads.

PHP Documentation Group 														   COPY(3)