copy

(PHP 4, PHP 5)

copy — Copia un fichero

Descripción

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

Realiza un copia del fichero source a dest.

Si se quiere mover un fichero, use la función rename().

Parámetros

source

Ruta al fichero de origen.

dest

La ruta de destino. Si dest es un URL, la operación de copiado puede fallar si la envoltura no admite la sobrescritura de ficheros existentes.

Advertencia

Si el fichero destino ya existe, será sobrescrito.

context

Un recurso de contexto válido creado con stream_context_create().

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Historial de cambios

Versión Descripción
5.3.4 Se cambió el parámetro context para que realmente tenga efecto. Anteriormente, se ignoraba cualquier context.
5.3.0 Se añadió el soporte para el contexto.
4.3.0 source y dest ahora pueden ser URL si han sido habilitadas las "envolturas fopen". Véase fopen() para más detalles.

Ejemplos

Ejemplo #1 Ejemplo de copy()

<?php
$fichero = 'ejemplo.txt';
$nuevo_fichero = 'ejemplo.txt.bak';

if (!copy($fichero, $nuevo_fichero)) {
    echo "Error al copiar $fichero...\n";
}
?>

Ver también