Le funzioni per gestire le cartelle

Le operazioni che è possibile eseguire con le cartelle sono molteplici: in particolare creazione, lettura, verifica dell’esistenza, e non solo. Vediamo alcune delle funzioni che possono consentirci di eseguire tali operazioni.

LA FUNZIONE IS_DIR()

La funzione is_dir() verifica l'esistenza una cartella. Essa accetta come unico parametro una stringa corrispondente al percorso alla cartella (senza il simbolo / alla fine).

Restituisce un valore boleano, TRUE se la cartella esiste.

Esempio:

<?php
$cartella = 'cartella/sottocartella';
if(!is_dir($cartella))
   {
   echo 'La cartella indicata non esiste!';
   }
else
   {
   echo 'La cartella esiste!';
   }
?>

LE FUNZIONI OPENDIR(), READDIR(), CLOSEDIR()

Tali funzioni servono per aprire un cartella, leggerne il contenuto e chiuderla.

La funzione opendir() serve per aprire una cartella. Essa richiede come parametro una stringa indicante il percorso.
Restituisce come return l'identificativo della risorsa in caso di successo, altrimenti FALSE generando un errore di tipo warning.

La funzione readdir() serve per leggere il contenuto di una cartella. Essa richiede come parametro l'identificativo della risorsa ottenuto con opendir().
Tuttavia, essa richiede una specifica esecuzione per ogni file, sottocartella presente, più altri due esecuzioni in cui si estraggono i simboli '.' e '..' (rappresentanti la cartella corrente e la sua cartella madre). Al termine restituirà FALSE.
A tal scopo le varie esecuzioni di readdir() possono essere gestite con il ciclo while().

La funzione closedir() chiude la risorsa. Restituisce TRUE in caso di successo, FALSE in caso di fallimento.

Vediamo il loro utilizzo:

<?php
// indichiamo la cartella da aprire
// il simbolo . indica la cartella corrente
$cartella = '.';

// verifichiamo che la cartella esiste
if(!is_dir($cartella))
   {
   exit('La cartella indicata non esiste!');
   }

// apriamo la cartella
$risorsa = opendir($cartella) or die('impossibile aprire la cartella!');

// con il ciclo while eseguiamo più volte la funzione readdir()
// valorizzando la variabile $file
// fin quando essa non darà come risultato FALSE
while(($file = readdir($risorsa)) !== FALSE) 
   {
   echo $file."<br />";
   }

// chiudiamo la cartella
closedir();
?>

LA FUNZIONE SCANDIR()

La funzione scandir() esegue la lettura dei file e le cartelle presenti in una cartella restituendone i nomi all'interno di un array. Essa è utilizzabile sono nelle versioni di php superiori alla 5. 

Essa accetta due parametri: il primo è una stinga indicante il percorso alla cartella; il secondo opzionale determina l'ordine di estrazione può assumere valori 0, per ordinare alfabeticamente, o 1, per ordinare in sesno inverso.

Restituisce un array i cui elementi sono costituiti dai nomi dei file e cartelle presenti.

Vediamone un esempio:

<?php
// indichiamo la cartella da aprire
// il simbolo . indica la cartella corrente
$cartella = '.';

// verifichiamo che la cartella esiste
if(!is_dir($cartella))
   {
   exit('La cartella indicata non esiste!');
   }

// creaimo un array con tutti i file
$array_file = scandir($cartella) or die ('Impossible leggere la cartella!');

// stampiamo i valori
foreach ($array_file as $key => $value)
   {
   echo $value."<br />";
   }
?>

LA FUNZIONE GLOB()

La funzione glob() serve per elencare i file presenti in una cartella con la possibilità di indicare il tipo di estensione che debbono avere i file. E' attiva solo nelle versioni di php superiori alla 4.3.

Essa accetta due parametri: il primo è una espressione indicante il percorso alla cartella e i file da selezionare; il secondo opzionale è una costante che potrà assumere diversi valori determinando una diversa interpretazione dell'espressione.

Restituisce un array i cui elementi sono costituiti dai file selezionati.

Vediamone il suo utilizzo:

<?php
// selezioniamo solo i file con estensione .php
$array_file = glob('cartella/*.php');

foreach ($array_file as $key => $value)
   {
   echo $value."<br />";
   }
?>

Poniamo che da una cartella contenente delle immagini vogliamo estratte tutti i file .jpg, .jpeg, .bmp, e .gif. 
In tal caso la funzione glob() verrà impiegata con tale sintassi:

<?php
// selezioniamo i file con estensione .jpg, jpeg, .png e .gif
$array_file = glob("immagini/*.{jpg,jpeg,gif,png}", GLOB_BRACE);

foreach ($array_file as $key => $value)
   {
   echo '<img src="'.$value.'">';
   }
?>

Vai alla lezione successiva

Vai alla lezione precedente