eio_rename

(PECL eio >= 0.0.1dev)

eio_renameModifie le nom ou le chemin d'un fichier

Description

resource eio_rename ( string $path , string $new_path [, int $pri = EIO_PRI_DEFAULT [, callable $callback = NULL [, mixed $data = NULL ]]] )

eio_rename() renomme ou déplace un fichier vers un nouvel endroit.

Liste de paramètres

path

Chemin source

new_path

Chemin cible

pri

La priorité de la requête : EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, ou NULL. Si NULL est passé, le paramètre pri, en interne, est défini à EIO_PRI_DEFAULT.

data

représente les données personnalisées passées à la requête.

result

représente la valeur résultante spécifique à la requête ; basiquement, la valeur retournée par l'appel système correspondant.

req

est la ressource optionnelle de la requête qui peut être utilisée avec les fonctions comme eio_get_last_error()

callback

La fonction de rappel callback est appelée lorsque la requête est terminée. Elle doit correspondre au prototype suivant :

  1. void callback(mixed $data, int $result[, resource $req]);

data

Variables arbitraires à passer à la fonction de rappel callback.

Valeurs de retour

eio_rename() retourne la ressource demandée en cas de succès, ou FALSE si une erreur survient.

Exemples

Exemple #1 Exemple avec eio_rename()

  1. <?php
  2. $filename = dirname(__FILE__)."/eio-temp-file.dat";
  3. touch($filename);
  4. $new_filename = dirname(__FILE__)."/eio-temp-file-new.dat";
  5.  
  6. function my_rename_cb($data, $result) {
  7. global $filename, $new_filename;
  8.  
  9. if ($result == 0 && !file_exists($filename) && file_exists($new_filename)) {
  10. @unlink($new_filename);
  11. echo "eio_rename_ok";
  12. } else {
  13. @unlink($filename);
  14. }
  15. }
  16.  
  17. eio_rename($filename, $new_filename, EIO_PRI_DEFAULT, "my_rename_cb", $filename);
  18. eio_event_loop();
  19. ?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

eio_rename_ok
LoadingChargement en cours