copy(3) [php man page]

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)

RENAME(3)								 1								 RENAME(3)

rename - Renames a file or directory

SYNOPSIS

       bool rename (string  $oldname, string  $newname, [resource  $context])

DESCRIPTION

	Attempts to rename $oldname to $newname, moving it between directories if necessary. If $newname exists, it will be overwritten.

PARAMETERS

	      o $oldname
		-

	      Note

		      The old name. The wrapper used in $oldname must match the wrapper used in $newname.

	      o $newname
		- The new name.

	      o $context
		-

	      Note

		     Context support was added with PHP 5.0.0. For a description of contexts, refer to "Streams".

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.1	|						    |
       |	|						    |
       |	| rename(3)  can  now rename files across drives in |
       |	| Windows.					    |
       |	|						    |
       | 5.0.0	|						    |
       |	|						    |
       |	| rename(3) can now also  be  used  with  some	URL |
       |	| wrappers. Refer to "Supported Protocols and Wrap- |
       |	| pers" for a listing  of  which  wrappers  support |
       |	| rename(3).					    |
       |	|						    |
       | 4.3.3	|						    |
       |	|						    |
       |	| rename(3)  may now be able to rename files across |
       |	| partitions on *nix based  systems,  provided	the |
       |	| appropriate permissions are held. Warnings may be |
       |	| generated if the destination	filesystem  doesn't |
       |	| permit chown() or chmod() system calls to be made |
       |	| on files  --	for  example,  if  the	destination |
       |	| filesystem is a FAT filesystem.		    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      Example with rename(3)

	      <?php
	      rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
	      ?>

SEE ALSO

       copy(3), unlink(3), move_uploaded_file(3).

PHP Documentation Group 														 RENAME(3)