copy
(PHP 4, PHP 5)
copy — Copia arquivo
Descrição
bool copy
( string $origem
, string $destino
[, resource $context
] )
Faz uma cópia do arquivo origem para destino .
Se você quiser mover um arquivo, utilize a função rename().
Parâmetros
- origem
-
Caminho para o arquivo de origem.
- destino
-
O caminho de destino. Se o destino for uma URL, a cópia pode falhar se o wrapper não suportar a sobrescrita de arquivos existentes.
AvisoSe o arquivo de destino já existir, ele será sobrescrito.
- context
-
Um válido resource de contexto criado com stream_context_create().
Valor Retornado
Retorna TRUE em caso de sucesso ou FALSE em falhas.
Histórico
Versão | Descrição |
---|---|
5.3.0 | Adicionado suporte à contexto. |
4.3.0 | Ambos origem e destino podem ser URLs se "fopen wrappers" tenham sido habilitados. Veja fopen() para mais detalhes. |
Exemplos
Example#1 exemplo do copy()
<?php
$file = 'example.txt';
$newfile = 'example.txt.bak';
if (!copy($file, $newfile)) {
echo "falha ao copiar $file...\n";
}
?>