copy

(PHP 4, PHP 5)

copy — Kopiert eine Datei

Beschreibung

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

Kopiert Datei source nach dest.

Wenn sie eine Datei verschieben möchten, nutzen sie die rename() Funktion.

Parameter-Liste

source

Pfad zu der Quelldatei.

dest

Der Zielpfad. Wenn dest ein URL ist, kann der Kopiervorgang fehlschlagen, wenn der Wrapper nicht das Überschreiben existierender Dateien unterstützt.

Warnung

Wenn die Zieldatei schon existiert, wird sie überschrieben.

context

Eine gültige Context Ressource, die mit stream_context_create() erzeugt wurde.

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Changelog

Version Beschreibung
5.3.4 Der context Parameter wurde geändert, so dass er nun auch wirkt. Zuvor wurde jeglicher context ignoriert.
5.3.0 Context Ünterstützung wurde hinzugefügt.
4.3.0 Sowohl source als auch dest können nun URLs sein, wenn die "fopen wrappers" aktiviert wurden. Siehe fopen() für weitere Einzelheiten.

Beispiele

Beispiel #1 copy() Beispiel

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

if (!copy($file, $newfile)) {
    echo "copy $file schlug fehl...\n";
}
?>

Siehe auch