Langage de programmation - PHP - Référence de procédures et fonctions

COPY	Copie
PHP 4+

Syntaxe

function copy($source, $dest);

function copy($source, $dest, $context);

Paramètres

Nom	Description
$source	Ce paramètre permet d'indiquer l'emplacement où se situe le fichier à copier.
$dest	Ce paramètre permet d'indiquer le nouvel emplacement du fichier à copier. N.B.: Si un fichier existe déjà à l'emplacement spécifié, il sera remplacer à moins qu'il soit verrouillé par un autre processus, et dans cette situation, il n'y aura donc aucune copie de fichiers ayant été faite.
$context	Ce paramètre permet d'indiquer une ressource de contexte valide.

Retour

Valeur	Description
FALSE	Cette valeur permet d'indiquer qu'une erreur est survenu.
TRUE	Ces valeurs permettent d'indiquer que l'opération s'est bien passé.

Description

Cette fonction permet d'effectuer la copie d'un fichier d'un emplacement source vers un emplacement destination.

Remarques

Fichier de destination existant : Si le fichier de destination existe déjà, il sera écrasé s'il dispose des permissions suffisantes et s'il n'a pas les permissions suffisantes, il retournera «FALSE».
Fichier de destination existant et Linux : Si vous n'avez pas fixer correctement vos permissions, vous pouvez être obligé de supprimer avec la fonction «unlink()» un fichier avant de pouvoir le copié.
Fichier à distance : A partir de PHP version 4.3.0 et si le gestionnaire de fichiers à distance est activé, vous pouvez indiquer des fichiers à distances (comme par exemple avec un lien URL http://).
Lorsqu'une erreur se produit, la fonction «error_get_last()» permet d'obtenir des informations supplémentaires sur la dernières erreurs.
Si le fichier n'existe pas, il retournera un message d'erreur : «[function.copy]: failed to open stream: No such file or directory» par l'entremise de la fonction «error_get_last()».
Si vous n'avez pas les permissions nécessaire, vous recevrez un message d'erreur «[function.copy]: failed to open stream: Permission denied [file]» par l'entremise de la fonction «error_get_last()».

Exemple

L'exemple suivant permet de copier le fichier «texta.txt» en «textb.txt» et indique si des erreurs se sont produites :


									<?php
if(!@copy('texta.txt','textb.txt')) {
    $errors = error_get_last();
    echo "Type d'erreur: ".$errors['type']."<br />";
    echo "Message d'erreur: ".$errors['message'];
} else {
    echo "Le fichier a été copié avec succès";
}
?>

Voir également

Langage de programmation - PHP - Référence de procédures et fonctions - move_uploaded_file
Langage de programmation - PHP - Référence de procédures et fonctions - rename

Références

PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 381

Dernière mise à jour : Mercredi, le 25 mars 2015

Section courante

A propos

Section administrative du site

COPY