closedir()

Introduction

La fonction closedir en PHP est une fonction précieuse qui vous aide à libérer les ressources système allouées au flux de répertoire. Cette fonction est essentielle pour prévenir les fuites mémoire et garantir que votre code s'exécute correctement. Cependant, il est indispensable de bien comprendre son utilisation pour éviter tout comportement inattendu dans votre code.

Comprendre la fonction closedir

La fonction closedir() ferme un handle de répertoire précédemment ouvert par opendir(). Une fois le handle fermé, vous ne pouvez plus lire les entrées avec readdir() tant que vous n'avez pas rouvert le répertoire.

La syntaxe de la fonction PHP closedir()

closedir(resource $dir_handle): void

• $dir_handle — le handle de répertoire retourné par opendir(). Ce paramètre est optionnel : s'il est omis, PHP ferme le dernier handle de répertoire ouvert par opendir().

La fonction ne retourne aucune valeur (void). Elle libère simplement la ressource système sous-jacente ; il n'y a donc rien à stocker dans une variable.

Fermer un handle de répertoire

Lorsque vous travaillez avec un grand nombre de fichiers, il est essentiel de fermer le handle de répertoire pour libérer les ressources système. Si vous ne fermez pas le handle, votre code consommera de plus en plus de mémoire, ce qui pourrait conduire à un épuisement des ressources.

Pour fermer un handle de répertoire, utilisez la fonction closedir. Elle prend un seul paramètre : une ressource représentant le handle de répertoire que vous souhaitez fermer.

Un flux de travail typique est le suivant : ouvrir le répertoire, lire ses entrées, puis fermer le handle. Voici un exemple complet et exécutable qui liste le répertoire courant et ferme toujours le handle :

Exemple de la fonction closedir() en PHP

<?php

$dir_handle = opendir('.');

if ($dir_handle !== false) {
    while (($entry = readdir($dir_handle)) !== false) {
        echo $entry . "\n";
    }
    closedir($dir_handle);
}

L'exécution de ce code sur un répertoire contenant index.php et style.css affiche quelque chose comme :

.
..
index.php
style.css

On ouvre d'abord le répertoire avec opendir(), on lit chaque entrée avec readdir() dans une boucle, puis on libère le handle avec closedir().

Toujours fermer le handle avec try...finally

Si le code qui traite les entrées peut lever une exception, enveloppez-le dans un bloc try...finally afin que le handle soit fermé même en cas d'erreur :

<?php

$dir_handle = opendir('/path/to/directory');

if ($dir_handle !== false) {
    try {
        // Do something with the directory handle that might throw
        while (($entry = readdir($dir_handle)) !== false) {
            // process $entry
        }
    } finally {
        closedir($dir_handle);
    }
}

Le bloc finally s'exécute que la boucle se termine normalement ou qu'une exception soit levée, garantissant ainsi la libération de la ressource.

Erreurs courantes avec closedir

Une erreur courante lors de l'utilisation de closedir est de tenter de fermer un handle de répertoire deux fois. Une fois le handle fermé, il ne peut pas être fermé à nouveau. Toute tentative en ce sens déclenchera un avertissement.

Une autre erreur fréquente est de ne pas vérifier si le handle de répertoire est valide avant de le fermer. opendir() retourne false en cas d'échec ; vérifiez donc toujours que le handle n'est pas false (comme dans les exemples ci-dessus) avant de le passer à closedir(). Passer un handle invalide déclenche une TypeError ou un avertissement selon la version de PHP.

Un troisième écueil est d'oublier que la fermeture du handle ne supprime ni ne modifie le répertoire — elle libère uniquement la ressource utilisée pour l'itérer. Les fichiers sur le disque ne sont pas touchés.

Fonctions associées

• opendir() — ouvre un handle de répertoire pour la lecture.
• readdir() — lit la prochaine entrée d'un handle de répertoire ouvert.
• rewinddir() — remet le handle au début du répertoire.
• scandir() — retourne toutes les entrées d'un répertoire sous forme d'array en un seul appel (pas de handle à fermer manuellement).

Conclusion

La fonction closedir() est essentielle pour libérer les ressources système allouées à un flux de répertoire. L'utiliser correctement — en vérifiant la validité du handle et en encapsulant les opérations dans un bloc try...finally — prévient les avertissements et les fuites mémoire. Respecter ces bonnes pratiques garantit que votre code PHP s'exécute de manière efficace et fiable.

Pratique