Appunti su PHP

§ 1. Directories (php.net manual)

Le funzioni appartenenti a questo gruppo hanno a che fare con gli oggetti della classe Directory. Gli oggetti della classe Directory sono istanziati per mezzo della funzione dir() ed hanno le seguenti proprietà e metodi:

• Properties
  • public string $path - la directory aperta;
  • public resource $handle - la risorsa che può essere usata con altre funzioni quali readdir(), rewinddir(), e closedir();
• Methods
  • public void close([resource $dir_handle])
  • public string read([resource $dir_handle])
  • public void rewind([resource $dir_handle])

Nel seguito proverò ad utilizzare tutti questi membri

§ 2. Funzioni

Le funzioni che hanno a che fare con le directories sono le seguenti:

• chdir - cambia la directory corrente;
• chroot - cambia la root directory;
• closedir - chiude il directory handle;
• dir - restituisce un istanza di Directory;
• getcwd - ottiene la directory corrente;
• opendir - apre la directory indicata nel directory handle;
• readdir - legge le entries della directory indicata nel directory handle;
• rewinddir - riavvolge la directory indicata nel directory handle;
• scandir - elenca i file e le directories all'interno di uno specifico path;
• is_dir - dice se un filename è una directory;

Nel seguito proverò tutte queste funzioni

§ 2.1 chdir

change directory

bool chdir(string $directory)

• Con echo getcwd(); visualizzo la directory corrente;
• con chdir(".."); risalgo di una posizione nell'albero delle directory
• con echo getcwd( ) visualizzo la nuova directory corrente;
• con chd("./TestPages" ) mi riposiziono sulla directory corrente precedente;
• con echo getcwd( ) verifico di aver ripristinato la situazione iniziale;

§ 2.2 chroot

change root directory

bool chroot(string $directory)

Questa funzione non è implementata sulle piattaforma Windows

§ 2.3 closedir

Chiude uno specifico directory handler

void closedir([resource $dir_handle])

§ 2.4 dir

Crea una istanza della classe Directory

Directory dir(string $directory [, resource $context]

Non ho la più pallida idea di cosa sia l'oggetto resource, ma dal momento che è un parametro opzionale, per il momento, sorvolo.

Provo ad esplorare tutte le proprietà pubbliche e i metodi di una istanza di Directory

• con $dir=dir(getcwd()) istanzio un oggetto della classe Directory;
• con echo $dir->path visualizzo il contenuto della proprietà path;
• con var_dump($dir->handle) visualizzo il contenuto della proprietà handle;
• con echo $dir->read() verifico cosa restituisce il metodo read;
• con echo $dir->read() verifico cosa restituisce il metodo read chiamato una seconda volta;
• con $dir->rewind() riposizione il puntatore usato da read sulla prima entry della directory;
• con $dir->close() chiudo il directory handler;

Ora ho capito che il metodo read() restituisce la prima entry della Directory e posiziona un puntatore sul successivo elemento. Quando non ci sono più elementi da leggere restituisce false.

A questo punto provo a fare un loop di questo tipo:

while(($entry=$dir->read()!== false){echo $entry."
";}

Nota: L'ordine di restituzione delle directory del metodo read dipende dal sistema operativo.

§ 2.5 getcwd

get current work directory

string getcwd(void)

      echo getcwd()."<br>";

§ 2.6 opendir

§ 2.7 readdir

§ 2.9 rewinddir

§ 2.10 scandir

Elenca i file e le directory in uno specificato path

array scandir (string $directory [, int $sorting_order=SCANDIR_SORT_ASCENDING[, resource $context]]])

Restituisce un array di file e directory dalla $directory

Al momento mi sembra la funzione più utile.

I possibili ordinamenti sono:

Ecco un esempio d'uso della funzione scandir:

§ 2.11 is_dir

Dice se il filename è una directory

bool is_dir (string $filename)

Per provare questa funzione:

• con $dir=dir($dirname) istanzio un oggetto della classe contenente sia fileordinari che directory ;
• con while($filename=$dir->read()){if (is_dir($dirname.$file)){echo $filename}} elenco tutte le directory contenute in $dir;
• con $dir->rewind() riposizione il puntatore usato da read sulla prima entry della directory;
• con while($filename=$dir->read()){if (!is_dir($dirname.$file)){echo $filename}} elenco tutti i file ordinari contenuti in $dir;

Stessa funzione utilizzando scandir() al posto di $read->read():

• con $elenco=scandir($dirname);
• con foreach($elenco as $filename){if (is_dir($dirname.$file)){echo $filename}} elenco tutte le directory contenute in $dir;
• con foreach($elenco as $filename){if (!is_dir($dirname.$file)){echo $filename}} elenco tutti i file ordinari contenuti in $dir;