Répertoire PHP

Les fonctions de répertoire PHP, comme leur nom l'indique, sont un ensemble de fonctions utilisées pour récupérer des détails, les modifier et récupérer des informations sur divers répertoires du système de fichiers et leur contenu spécifique. De nombreuses opérations peuvent être effectuées sur les répertoires comme la création, la suppression, la modification du répertoire de travail actuel, la liste des fichiers présents dans le répertoire, etc. Aucune installation distincte n'est requise pour ces fonctions car elles font partie du noyau PHP. Mais pour activer la fonction chroot(), nous devons configurer l'option –enable-chroot-func.

PUBLICITÉ Cours populaire dans cette catégorie DEVELOPPEUR PHP - Spécialisation | Série de 8 cours | 3 tests simulés

Commencez votre cours de développement de logiciels libres

Développement Web, langages de programmation, tests de logiciels et autres

Fonctions de l'annuaire PHP

Passons en revue quelques-unes des fonctions de base du répertoire PHP comme ci-dessous :

1. Créer un nouveau répertoire

Nous utilisons la fonction mkdir() pour créer un nouveau répertoire dans le script de programmation PHP.

Syntaxe :

mkdir($dir_path,$mode,$recursive_flag,$context);

où,

• $dir_path est soit le chemin relatif, soit le chemin absolu où le nouveau répertoire spécifié sera créé.
• $mode est le paramètre qui prendra des valeurs octales qui déterminera le niveau dans lequel le répertoire nouvellement créé sera accessible.
• $recursive est un champ de type flag qui a 2 valeurs vraies ou fausses qui peuvent nous permettre ou non de créer des répertoires imbriqués.
• $context est similaire à ce que nous avons avec PHP unlink() comme avoir un flux pour spécifier certains protocoles, etc. Cela renverra également uniquement une valeur booléenne qui sera vraie si l'exécution est terminée avec succès et fausse sinon.

Exemple :

<?php
mkdir("/articles/");
echo("Directory created");
?>

Sortie :

Ceci est un exemple de base pour montrer la création d'un répertoire dans le chemin dont nous avons besoin. Assurez-vous que le chemin dispose d'autorisations suffisantes, sinon une erreur « autorisation refusée » sera générée.

2. Répertorier le contenu d'un annuaire

Nous utilisons opendir() et readdir() pour ouvrir le lien du répertoire et le lire respectivement. L'étape 1 consistera à ouvrir le répertoire et l'étape 2 consistera à le lire.

Étape 1 : Pour ouvrir le lien du répertoire, opendir() est la fonction que nous utilisons pour effectuer cette étape. Il nécessite deux arguments d'entrée comme spécifié ci-dessous.

Syntaxe :

opendir($dir_path,$context);

• $dir_path est le chemin du répertoire qui doit être ouvert.
• $context est un paramètre facultatif où nous pouvons spécifier si un flux de contexte est présent.

Cela renvoie la valeur des données de ressource en sortie. Cet ID de ressource qu'il fournit est utilisé dans nos étapes de traitement ultérieures, sinon nous obtenons une erreur car l'ID de ressource n'est pas valide.

Étape 2 : Pour lire le contenu du répertoire, readdir() est la fonction qui est utilisée à cet effet et elle doit être appelée de manière récursive jusqu'à ce que la fin du répertoire soit atteinte par le répertoire poignée.

Exemple :

<?php
$direct = "/files/";
if (is_dir($direct)){
if ($td = opendir($direct)){
while (($file = readdir($td)) !== false){
echo "filename:" . $file . "<br>";
}
closedir($td);
}
}
?>

Sortie :

Dans cet exemple, nous déclarons d'abord le chemin du répertoire qui doit être lu. Nous vérifions dans l'instruction if si le répertoire est présent, puis nous ouvrons le contenu du répertoire et le lisons. La sortie affiche les noms de fichiers présents dans le répertoire.

3. Pour fermer un répertoire

Nous utilisons la fonction closeir() afin de fermer un répertoire après avoir lu son contenu.

Syntaxe :

$dir_handle = opendir($dir_path);
...
...
closedir($dir_handle);

Exemple :

<?php
$dir = "/file1";
if (is_dir($dir)) {
if ($dh = opendir($dir)) {
$direc = readdir($dh);
echo("File present inside directory are:" .direc);
closedir($dh);
echo("Closed directory");
}
}
?>

Sortie :

Dans cet exemple, nous déclarons d'abord le chemin de notre répertoire. Ensuite, en utilisant l'instruction conditionnelle if, nous vérifions si le chemin est valide et si oui, alors nous ouvrons le répertoire, lisons ses variables puis le fermons. Ainsi, toute opération peut être effectuée entre l'ouverture et la fermeture de l'annuaire.

4. Pour changer le répertoire actuel

Nous utilisons la fonction chdir() pour changer le répertoire de travail actuel vers lequel elle pointe.

Syntaxe :

chdir(directory)

Il ne nécessite qu'un seul paramètre qui est le répertoire vers lequel le répertoire de travail actuel doit être pointé. Il renvoie vrai en cas de réussite et faux en cas d'échec de la modification du répertoire.

Exemple :

<?php
// Get current directory
echo getcwd()."\n";
// Change directory
chdir("/workspace/test");
// Get current directory
echo getcwd();
?>

Sortie :

In this example, we are first printing the present working directory. Then we are changing the same using chdir function to “test” directory and printing the same on the output. Hence make sure the entire path we are giving here exists.

5. To Change the Directory Path of Root

We use the function chroot() for changing the root directory of the ongoing process to the directory path we pass as an argument in this function. Also, the present working directory path will be changed to “/”. To perform this function one needs root permission/privileges.

Syntax:

chroot(directory)

Example:

<?php
// Changing root directory path
chroot("/change/path/dir/");
// Displaying present directory
echo getcwd();
?>

Output:

In this example, we are first using the chroot function to change the path of the root directory. Next, we are displaying the present working directory which will be now changed to home path.

6. To Reset the Directory Handle

For this purpose, we are using rewinddir() function which can reset the directory handle initially created by opendir() function.

Syntax:

rewinddir(directory)

It accepts only the directory path as its input argument which is used to tell the directory handle resource path which was opened with opendir() previously. This is an optional parameter which if not specified then the previous link used by the opendir() will be considered.

Example:

<?php
$direc = "/file/";
// To open the directory and read its contents
if (is_dir($direc)){
if ($place = opendir($direc)){
// List files in images directory
while (($file = readdir($place)) !== false){
echo "filename:" . $file . "\n";
}
rewinddir();
echo("Using the function rewinddir\n");
// List files again
while (($file = readdir($place)) !== false){
echo "filename:" . $file . "\n";
}
closedir($place);
echo("Closed directory");
}
}
?>

Output:

In this example first, we are specifying the directory path and if statement we are using to verify if the directory path is present or not. If the directory is present then we are opening and reading the contents of the file and printing the same. Now the file handler will stop printing since it reached the end of file pointer. When we use the rewinddir() function it resets the file handler and hence when we print the directory contents it prints the same output again.

Conclusion

We have gone through some of the basic and important PHP directory functions commonly used in this article. We also noticed that a few of these functions are dependant on each other. For example, we cannot use readdir() without using opendir(). Few other functions which are used are dir(), scandir() and getcwd().

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!