Λειτουργίες συστήματος αρχείων
Nette\Utils\FileSystem είναι μια στατική κλάση, η οποία περιέχει χρήσιμες συναρτήσεις για την εργασία με ένα σύστημα αρχείων. Ένα πλεονέκτημα σε σχέση με τις εγγενείς συναρτήσεις της PHP είναι ότι πετάνε εξαιρέσεις σε περίπτωση σφαλμάτων.
Εγκατάσταση:
composer require nette/utils
Τα ακόλουθα παραδείγματα υποθέτουν ότι έχει οριστεί το ακόλουθο ψευδώνυμο κλάσης:
use Nette\Utils\FileSystem;
Manipulation
copy(string $origin, string $target, bool $overwrite=true): void
Αντιγράφει ένα αρχείο ή έναν ολόκληρο κατάλογο. Αντικαθιστά τα
υπάρχοντα αρχεία και καταλόγους από προεπιλογή. Εάν το $overwrite
έχει οριστεί σε false
και ένα $target
υπάρχει ήδη, δημιουργεί
μια εξαίρεση Nette\InvalidStateException
. Πετάει μια εξαίρεση
Nette\IOException
σε περίπτωση σφάλματος.
FileSystem::copy('/path/to/source', '/path/to/dest', overwrite: true);
createDir(string $directory, int $mode=0777): void
Δημιουργεί έναν κατάλογο αν δεν υπάρχει, συμπεριλαμβανομένων των
γονικών καταλόγων. Πετάει μια εξαίρεση Nette\IOException
σε περίπτωση
σφάλματος.
FileSystem::createDir('/path/to/dir');
delete(string $path): void
Διαγράφει ένα αρχείο ή έναν ολόκληρο κατάλογο αν υπάρχει. Εάν ο
κατάλογος δεν είναι άδειος, διαγράφει πρώτα τα περιεχόμενά του. Πετάει
μια εξαίρεση Nette\IOException
σε περίπτωση σφάλματος.
FileSystem::delete('/path/to/fileOrDir');
makeWritable(string $path, int $dirMode=0777, int $fileMode=0666): void
Ορίζει δικαιώματα αρχείων στο $fileMode
ή δικαιώματα καταλόγων
στο $dirMode
. Διατρέχει αναδρομικά και θέτει δικαιώματα και σε όλα
τα περιεχόμενα του καταλόγου.
FileSystem::makeWritable('/path/to/fileOrDir');
open(string $path, string $mode): resource
Ανοίγει το αρχείο και επιστρέφει τον πόρο. Η παράμετρος $mode
λειτουργεί όπως η εγγενής συνάρτηση fopen()
. Εάν προκύψει σφάλμα,
δημιουργεί την εξαίρεση Nette\IOException
.
$res = FileSystem::open('/path/to/file', 'r');
read(string $file): string
Διαβάζει το περιεχόμενο ενός $file
. Εκπέμπει εξαίρεση
Nette\IOException
σε περίπτωση σφάλματος.
$content = FileSystem::read('/path/to/file');
readLines(string $file, bool $stripNewLines=true): \Generator
Διαβάζει το περιεχόμενο του αρχείου γραμμή προς γραμμή. Σε αντίθεση
με την εγγενή συνάρτηση file()
, δεν διαβάζει ολόκληρο το αρχείο στη
μνήμη, αλλά το διαβάζει συνεχώς, έτσι ώστε να μπορούν να διαβαστούν
αρχεία μεγαλύτερα από τη διαθέσιμη μνήμη. Το $stripNewLines
καθορίζει
αν θα αφαιρεθούν οι χαρακτήρες αλλαγής γραμμής \r
και \n
.
Σε περίπτωση σφάλματος, δημιουργεί μια εξαίρεση Nette\IOException
.
$lines = FileSystem::readLines('/path/to/file');
foreach ($lines as $lineNum => $line) {
echo "Line $lineNum: $line\n";
}
rename(string $origin, string $target, bool $overwrite=true): void
Μετονομάζει ή μετακινεί ένα αρχείο ή έναν κατάλογο που καθορίζεται
από το $origin
στο $target
. Αντικαθιστά τα υπάρχοντα αρχεία και
καταλόγους από προεπιλογή. Εάν το $overwrite
έχει οριστεί σε
false
και το $target
υπάρχει ήδη, προκαλεί εξαίρεση
Nette\InvalidStateException
. Πετάει εξαίρεση Nette\IOException
σε περίπτωση
σφάλματος.
FileSystem::rename('/path/to/source', '/path/to/dest', overwrite: true);
write(string $file, string $content, int $mode=0666): void
Γράφει το $content
σε ένα $file
. Πετάει μια εξαίρεση
Nette\IOException
σε περίπτωση σφάλματος.
FileSystem::write('/path/to/file', $content);
Διαδρομές
isAbsolute(string $path): bool
Καθορίζει αν το $path
είναι απόλυτο.
FileSystem::isAbsolute('../backup'); // false
FileSystem::isAbsolute('/backup'); // true
FileSystem::isAbsolute('C:/backup'); // true
joinPaths(string …$segments): string
Ενώνει όλα τα τμήματα της διαδρομής και κανονικοποιεί το αποτέλεσμα.
FileSystem::joinPaths('a', 'b', 'file.txt'); // 'a/b/file.txt'
FileSystem::joinPaths('/a/', '/b/'); // '/a/b/'
FileSystem::joinPaths('/a/', '/../b'); // '/b'
normalizePath(string $path): string
Κανονικοποιεί τα ..
και .
και τα διαχωριστικά καταλόγων
στη διαδρομή.
FileSystem::normalizePath('/file/.'); // '/file/'
FileSystem::normalizePath('\file\..'); // '/file'
FileSystem::normalizePath('/file/../..'); // '/..'
FileSystem::normalizePath('file/../../bar'); // '/../bar'
unixSlashes(string $path): string
Μετατρέπει τις κάθετες γραμμές σε /
που χρησιμοποιούνται στα
συστήματα Unix.
$path = FileSystem::unixSlashes($path);
platformSlashes(string $path): string
Μετατρέπει τις κάθετες γραμμές σε χαρακτήρες συγκεκριμένους για την
τρέχουσα πλατφόρμα, δηλ. \
στα Windows και /
αλλού.
$path = FileSystem::platformSlashes($path);