Funzioni del filesystem
Nette\Utils\FileSystem è una classe che contiene funzioni utili per lavorare con il filesystem. Un vantaggio rispetto alle funzioni native di PHP è che lanciano eccezioni in caso di errori.
Per cercare i file sul disco, utilizzare il Finder.
Installazione:
Gli esempi seguenti presuppongono che sia stato definito il seguente alias di classe:
Manipolazione
copy (string $origin, string $target, bool $overwrite=true): void
Copia un file o un'intera directory. Sovrascrive i file e le directory esistenti per impostazione predefinita. Se
$overwrite
è impostato su false
e un $target
esiste già, lancia un'eccezione
Nette\InvalidStateException
. Lancia un'eccezione Nette\IOException
se si verifica un errore.
createDir (string $directory, int $mode=0777): void
Crea una directory se non esiste, comprese le directory parentali. Lancia un'eccezione Nette\IOException
se si
verifica un errore.
delete (string $path): void
Elimina un file o un'intera directory, se esistente. Se la directory non è vuota, ne cancella prima il contenuto. Lancia
un'eccezione Nette\IOException
se si verifica un errore.
makeWritable (string $path, int $dirMode=0777, int $fileMode=0666): void
Imposta i permessi dei file a $fileMode
o i permessi delle directory a $dirMode
. Esegue una
ricerca ricorsiva e imposta i permessi anche sull'intero contenuto della directory.
open (string $path, string $mode): resource
Apre il file e restituisce la risorsa. Il parametro $mode
funziona come la funzione nativa fopen()
. Se si verifica un errore, viene sollevata
l'eccezione Nette\IOException
.
read (string $file): string
Legge il contenuto di un file $file
. Lancia un'eccezione Nette\IOException
se si verifica un
errore.
readLines (string $file, bool $stripNewLines=true): \Generator
Legge il contenuto del file riga per riga. A differenza della funzione nativa file()
, non legge l'intero file in
memoria, ma lo legge continuamente, in modo da poter leggere file più grandi della memoria disponibile. Il parametro
$stripNewLines
specifica se eliminare i caratteri di interruzione di riga \r
e \n
. In caso
di errore, solleva un'eccezione Nette\IOException
.
rename (string $origin, string $target, bool $overwrite=true): void
Rinomina o sposta un file o una directory specificata da $origin
a $target
. Sovrascrive i file e
le directory esistenti per impostazione predefinita. Se $overwrite
è impostato su false
e
$target
esiste già, lancia un'eccezione Nette\InvalidStateException
. Lancia un'eccezione
Nette\IOException
se si verifica un errore.
write (string $file, string $content, int $mode=0666): void
Scrive il file $content
in un file $file
. Lancia un'eccezione Nette\IOException
se si
verifica un errore.
Percorsi
isAbsolute (string $path): bool
Determina se il sito $path
è assoluto.
joinPaths (string …$segments): string
Unisce tutti i segmenti del percorso e normalizza il risultato.
normalizePath (string $path): string
Normalizza ..
e .
e i separatori di directory nel percorso.
unixSlashes (string $path): string
Converte gli slash in /
utilizzati nei sistemi Unix.
platformSlashes (string $path): string
Converte gli slash in caratteri specifici della piattaforma corrente, ad esempio \
su Windows e /
altrove.
resolvePath (string $basePath, string $path): string
Deriva il percorso finale da $path
relativo alla directory di base $basePath
. I percorsi assoluti
(/foo
, C:/foo
) vengono lasciati invariati (normalizza solo gli slash), i percorsi relativi vengono
aggiunti al percorso di base.
Approccio statico e non statico
Per sostituire facilmente la classe FileSystem
con un'altra classe, ad esempio a scopo di test, utilizzarla in
modo non statico: