Λειτουργίες συστήματος αρχείων
Nette\Utils\FileSystem είναι μια κλάση, η οποία περιέχει χρήσιμες λειτουργίες για την εργασία με ένα σύστημα αρχείων. Ένα πλεονέκτημα σε σχέση με τις εγγενείς συναρτήσεις της PHP είναι ότι σε περίπτωση σφαλμάτων πετάνε εξαιρέσεις.
Αν θέλετε να αναζητήσετε αρχεία στο δίσκο, χρησιμοποιήστε το Finder.
Εγκατάσταση:
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);
Στατική έναντι μη στατικής προσέγγισης
Για να αντικαταστήσετε εύκολα την κλάση FileSystem
με μια άλλη
κλάση, για παράδειγμα για σκοπούς δοκιμών, χρησιμοποιήστε τη μη
στατική:
class AnyClassUsingFileSystem
{
public function __construct(
private FileSystem $fileSystem,
) {
}
public function readConfig(): string
{
return $this->fileSystem->read(/* ... */);
}
...
}