File¶

\nn\t3::File()¶

Methoden rund um das Dateisystem: Lesen, Schreiben, Kopieren, Verschieben und Bereinigen von Dateien.

Overview of Methods¶

\nn\t3::File()->absPath(`$file = NULL`);¶

Absoluter Pfad zu einer Datei auf dem Server.

Gibt den kompletten Pfad ab der Server-Root zurück, z.B. ab /var/www/.... Falls der Pfad bereits absolut war, wird er unverändert zurückgegeben.

\nn\t3::File()->absPath('fileadmin/bild.jpg');                   // => /var/www/website/fileadmin/bild.jpg
\nn\t3::File()->absPath('/var/www/website/fileadmin/bild.jpg');  // => /var/www/website/fileadmin/bild.jpg
\nn\t3::File()->absPath('EXT:nnhelpers');                        // => /var/www/website/typo3conf/ext/nnhelpers/

Außer dem Dateipfad als String können auch alle denkbaren Objekte übergeben werden:

// \TYPO3\CMS\Core\Resource\Folder
\nn\t3::File()->absPath( $folderObject );    => /var/www/website/fileadmin/bild.jpg

// \TYPO3\CMS\Core\Resource\File
\nn\t3::File()->absPath( $fileObject );      => /var/www/website/fileadmin/bild.jpg

// \TYPO3\CMS\Extbase\Domain\Model\FileReference
\nn\t3::File()->absPath( $fileReference );   => /var/www/website/fileadmin/bild.jpg

Existiert auch als ViewHelper:

{nnt3:file.absPath(file:'pfad/zum/bild.jpg')}

@return boolean

\nn\t3::File()->absUrl(`$file = NULL`);¶

Absolute URL zu einer Datei generieren. Gibt den kompletten Pfad zur Datei inkl. https://.../ zurück.

// => https://www.myweb.de/fileadmin/bild.jpg
\nn\t3::File()->absUrl( 'fileadmin/bild.jpg' );

// => https://www.myweb.de/fileadmin/bild.jpg
\nn\t3::File()->absUrl( 'https://www.myweb.de/fileadmin/bild.jpg' );

// => /var/www/vhost/somewhere/fileadmin/bild.jpg
\nn\t3::File()->absUrl( 'https://www.myweb.de/fileadmin/bild.jpg' );

@return string

\nn\t3::File()->addPathSite(`$file`);¶

Gibt Pfad zu Datei / Ordner MIT absoluten Pfad

Beispiel:

\nn\t3::File()->addPathSite('fileadmin/test.jpg');
 // ==> gibt var/www/website/fileadmin/test.jpg zurück

@return string

\nn\t3::File()->cleanFilename(`$filename = ''`);¶

Bereinigt einen Dateinamen

$clean = \nn\t3::File()->cleanFilename('fileadmin/nö:so nicht.jpg'); // 'fileadmin/noe_so_nicht.jpg'

@return string

\nn\t3::File()->copy(`$src = NULL, $dest = NULL, $renameIfFileExists = true`);¶

Kopiert eine Datei. Gibt false zurück, falls die Datei nicht kopiert werden konnte. Gibt (neuen) Dateinamen zurück, falls das Kopieren erfolgreich war.

$filename = \nn\t3::File()->copy('fileadmin/bild.jpg', 'fileadmin/bild-kopie.jpg');

@param string $src    Pfad zur Quelldatei
@param string $dest   Pfad zur Zieldatei
@param boolean $renameIfFileExists    Datei umbenennen, falls am Zielort bereits Datei mit gleichem Namen existiert
@return string|boolean

\nn\t3::File()->createFolder(`$path = NULL`);¶

Einen Ordner im fileadmin/ erzeugen. Um einen Ordner außerhalb des fileadmin anzulegen, die Methode \nn\t3::File()->mkdir() verwenden.

\nn\t3::File()->createFolder('tests');

@return boolean

\nn\t3::File()->download(`$files = NULL, $filename = NULL`);¶

Download einer einzelnen Datei oder eines gezippten Archives.

Download als ZIP erfordert die PHP-Extension gmp. Falls Extension nicht vorhanden ist, wird auf .tar-Variante ausgewichen. Bei Mac verwendet die Funktion aufgrund von Sicherheitswarnungen des Finders grundsätzlich tar

\nn\t3::File()->download( 'fileadmin/test.pdf' );
\nn\t3::File()->download( $fileReference );
\nn\t3::File()->download( $sysFile );
\nn\t3::File()->download( 'fileadmin/test.pdf', 'download.pdf' );

Wird ein Array übergeben, wird ein tar/zip-Download gestartet. Durch Übergabe eines assoziativen Arrays mit Dateiname als key und Pfad im Archiv als value Kann die Datei- und Ordnerstruktur im zip-Archiv bestimmt werden.

\nn\t3::File()->download( ['fileadmin/test-1.pdf', 'fileadmin/test-2.pdf'], 'archive.zip' );
\nn\t3::File()->download( ['fileadmin/test-1.pdf'=>'eins.pdf', 'fileadmin/test-2.pdf'=>'zwei.pdf'], 'archive.zip' );
\nn\t3::File()->download( ['fileadmin/test-1.pdf'=>'zip-folder-1/eins.pdf', 'fileadmin/test-2.pdf'=>'zip-folder-2/zwei.pdf'], 'archive.zip' );

@param mixed $files           String oder Array der Dateien, die geladen werden sollen
@param mixed $filename        Optional: Dateinamen überschreiben beim Download
@return void

\nn\t3::File()->exists(`$src = NULL`);¶

Prüft, ob eine Datei existiert. Gibt absoluten Pfad zur Datei zurück.

\nn\t3::File()->exists('fileadmin/bild.jpg');

Existiert auch als ViewHelper:

{nnt3:file.exists(file:'pfad/zum/bild.jpg')}

@return string|boolean

\nn\t3::File()->extractExifData(`$filename = ''`);¶

EXIF Daten für Datei in JSON speichern.

\nn\t3::File()->extractExifData( 'yellowstone.jpg' );

@return array

\nn\t3::File()->getData(`$file = ''`);¶

Imageinfo + EXIF Data für Datei holen. Sucht auch nach JSON-Datei, die evtl. nach processImage() generiert wurde

@return array

\nn\t3::File()->getExifData(`$filename = ''`);¶

ALLE EXIF Daten für Datei holen.

\nn\t3::File()->getExif( 'yellowstone.jpg' );

@return array

\nn\t3::File()->getFolder(`$file`);¶

Gibt den Ordner zu einer Datei zurück

Beispiel:

\nn\t3::File()->getFolder('fileadmin/test/beispiel.txt');
// ==> gibt 'fileadmin/test/' zurück

@return string

\nn\t3::File()->getImageData(`$filename = ''`);¶

EXIF Bild-Daten für Datei holen.

\nn\t3::File()->getImageData( 'yellowstone.jpg' );

@return array

\nn\t3::File()->getImageSize(`$filename = ''`);¶

imagesize für Datei holen.

\nn\t3::File()->getImageSize( 'yellowstone.jpg' );

@return array

\nn\t3::File()->getLocationData(`$filename = ''`);¶

EXIF GEO-Daten für Datei holen. Adressdaten werden automatisch ermittelt, falls möglich

\nn\t3::File()->getLocationData( 'yellowstone.jpg' );

@return array

\nn\t3::File()->getPath(`$file, $storage = NULL, $absolute = true`);¶

Gibt den Pfad einer Datei anhand eines Dateinamens und der Storage wieder. Beispiel:

\nn\t3::File()->getPath('media/bild.jpg', $storage);
// ==> gibt '/var/www/.../fileadmin/media/bild.jpg' zurück
\nn\t3::File()->getPath('fileadmin/media/bild.jpg');
// ==> gibt '/var/www/.../fileadmin/media/bild.jpg' zurück

@return string

\nn\t3::File()->getPublicUrl(`$obj = NULL, $absolute = false`);¶

Holt Pfad zur Datei, relativ zum Typo3-Installtionsverzeichnis (PATH_site). Kann mit allen Arten von Objekten umgehen.

\nn\t3::File()->getPublicUrl( $falFile );        // \TYPO3\CMS\Core\Resource\FileReference
\nn\t3::File()->getPublicUrl( $fileReference );  // \TYPO3\CMS\Extbase\Domain\Model\FileReference
\nn\t3::File()->getPublicUrl( $folder );         // \TYPO3\CMS\Core\Resource\Folder
\nn\t3::File()->getPublicUrl( $folder, true );   // https://.../fileadmin/bild.jpg

@return string

\nn\t3::File()->getRelativePathInStorage(`$file, $storage = NULL`);¶

Gibt den relativen Pfad einer Datei zur angegebenen Storage wieder.

Beispiel:

\nn\t3::File()->getRelativePathInStorage('fileadmin/media/bild.jpg', $storage);
// ==> gibt 'media/bild.jpg' zurück

@return string

\nn\t3::File()->getStorage(`$file, $createIfNotExists = false`);¶

Findet ein passendes sys_file_storage zu einem Datei- oder Ordnerpfad. Durchsucht dazu alle sys_file_storage-Einträge und vergleicht, ob der basePath des Storages zum Pfad der Datei passt.

\nn\t3::File()->getStorage('fileadmin/test/beispiel.txt');
\nn\t3::File()->getStorage( $falFile );
\nn\t3::File()->getStorage( $sysFileReference );
// gibt ResourceStorage mit basePath "fileadmin/" zurück

@return ResourceStorage

\nn\t3::File()->isAllowed(`$filename = NULL`);¶

Gibt an, ob der Dateityp erlaubt ist

\nn\t3::File()->isForbidden('bild.jpg'); => gibt 'true' zurück
\nn\t3::File()->isForbidden('hack.php'); => gibt 'false' zurück

@return boolean

\nn\t3::File()->isConvertableToImage(`$filename = NULL`);¶

Gibt an, ob die Datei in ein Bild konvertiert werden kann

\nn\t3::File()->isConvertableToImage('bild.jpg');    => gibt true zurück
\nn\t3::File()->isConvertableToImage('text.ppt');    => gibt false zurück

@return boolean

\nn\t3::File()->isExternalVideo(`$url = NULL`);¶

Gibt an, ob es ein Video auf YouTube / Vimeo ist. Falls ja, wird ein Array mit Angaben zum Einbetten zurückgegeben.

\nn\t3::File()->isExternalVideo('http://...');

@return array|boolean

\nn\t3::File()->isFolder(`$file`);¶

Gibt zurück, ob angegebener Pfad ein Ordner ist

Beispiel:

\nn\t3::File()->isFolder('fileadmin'); // => gibt true zurück

@return boolean

\nn\t3::File()->isForbidden(`$filename = NULL`);¶

Gibt an, ob der Dateityp verboten ist

\nn\t3::File()->isForbidden('bild.jpg');     => gibt 'false' zurück
\nn\t3::File()->isForbidden('hack.php');     => gibt 'true' zurück
\nn\t3::File()->isForbidden('.htaccess');    => gibt 'true' zurück

@return boolean

\nn\t3::File()->isVideo(`$filename = NULL`);¶

Gibt an, ob die Datei ein Video ist

\nn\t3::File()->isVideo('pfad/zum/video.mp4');       => gibt true zurück

@return boolean

\nn\t3::File()->mkdir(`$path = ''`);¶

Einen Ordner anlegen

\nn\t3::File()->mkdir( 'fileadmin/mein/ordner/' );
\nn\t3::File()->mkdir( '1:/mein/ordner/' );

@return boolean

\nn\t3::File()->move(`$src = NULL, $dest = NULL`);¶

Verschiebt eine Datei

\nn\t3::File()->move('fileadmin/bild.jpg', 'fileadmin/bild-kopie.jpg');

@return boolean

\nn\t3::File()->moveUploadedFile(`$src = NULL, $dest = NULL`);¶

Eine Upload-Datei ins Zielverzeichnis verschieben.

Kann absoluter Pfad zur tmp-Datei des Uploads sein – oder ein TYPO3\CMS\Core\Http\UploadedFile, das sich im Controller über $this->request->getUploadedFiles() holen lässt.

\nn\t3::File()->moveUploadedFile('/tmp/xjauGSaudsha', 'fileadmin/bild-kopie.jpg');
\nn\t3::File()->moveUploadedFile( $fileObj, 'fileadmin/bild-kopie.jpg');

@return string

\nn\t3::File()->normalizePath(`$path`);¶

Löst ../../-Angaben in Pfad auf. Funktioniert sowohl mit existierenden Pfaden (per realpath) als auch nicht-existierenden Pfaden.

\nn\t3::File()->normalizePath( 'fileadmin/test/../bild.jpg' );       =>   fileadmin/bild.jpg

@return string

\nn\t3::File()->process(`$fileObj = '', $processing = [], $returnProcessedImage = false`);¶

Berechnet ein Bild über maxWidth, maxHeight etc. Einfache Version von \nn\t3::File()->processImage() Kann verwendet werden, wenn es nur um das Generieren von verkleinerten Bilder geht ohne Berücksichtigung von Korrekturen der Kamera-Ausrichtung etc.

Da die Crop-Einstellungen in FileReference und nicht File gespeichert sind, funktioniert cropVariant nur bei Übergabe einer FileReference.

\nn\t3::File()->process( 'fileadmin/imgs/portrait.jpg', ['maxWidth'=>200] );
\nn\t3::File()->process( '1:/bilder/portrait.jpg', ['maxWidth'=>200] );
\nn\t3::File()->process( $sysFile, ['maxWidth'=>200] );
\nn\t3::File()->process( $sysFile, ['maxWidth'=>200, 'absolute'=>true] );
\nn\t3::File()->process( $sysFileReference, ['maxWidth'=>200, 'cropVariant'=>'square'] );

Mit dem Parameter $returnProcessedImage = true wird nicht der Dateipfad zum neuen Bild sondern das processedImage-Object zurückgegeben.

\nn\t3::File()->process( 'fileadmin/imgs/portrait.jpg', ['maxWidth'=>200], true );

@return string

\nn\t3::File()->processImage(`$filenameOrSysFile = '', $processing = []`);¶

Kann direkt nach dem upload_copy_move() aufgerufen werden. Korrigiert die Ausrichtung des Bildes, die evtl. in EXIF-Daten gespeichert wurde. Für einfach maxWidth-Anweisungen die Methode \nn\t3::File()->process() verwenden.

Anweisungen für $processing:

correctOrientation => Drehung korrigieren (z.B. weil Foto vom Smartphone hochgeladen wurde)

@return string

\nn\t3::File()->read(`$src = NULL`);¶

Holt den Inhalt einer Datei

\nn\t3::File()->read('fileadmin/text.txt');

@return string|boolean

\nn\t3::File()->relPath(`$path = ''`);¶

relativen Pfad (vom aktuellen Script aus) zum einer Datei / Verzeichnis zurück. Wird kein Pfad angegeben, wird das Typo3-Root-Verzeichnis zurückgegeben.

\nn\t3::File()->relPath( $file );        => ../fileadmin/bild.jpg
\nn\t3::File()->relPath();               => ../

@return string

\nn\t3::File()->resolvePathPrefixes(`$file = NULL, $absolute = false`);¶

EXT: Prefix auflösen zu relativer Pfadangabe

\nn\t3::File()->resolvePathPrefixes('EXT:extname');                  => /typo3conf/ext/extname/
\nn\t3::File()->resolvePathPrefixes('EXT:extname/');                 => /typo3conf/ext/extname/
\nn\t3::File()->resolvePathPrefixes('EXT:extname/bild.jpg');         => /typo3conf/ext/extname/bild.jpg
\nn\t3::File()->resolvePathPrefixes('1:/uploads/bild.jpg', true);    => /var/www/website/fileadmin/uploads/bild.jpg

@return string

\nn\t3::File()->sendDownloadHeader(`$filename = '', $filesize = NULL`);¶

PHP Header für Download senden. Wenn die Datei physisch existiert, wird die filesize automatisch ermittelt.

\nn\t3::File()->sendDownloadHeader( 'download.jpg' );
\nn\t3::File()->sendDownloadHeader( 'pfad/zur/datei/download.jpg' );
\nn\t3::File()->sendDownloadHeader( 'fakedatei.jpg', 1200 );

@return void

\nn\t3::File()->size(`$src = NULL`);¶

Gibt Dateigröße zu einer Datei in Bytes zurück Falls Datei nicht exisitert, wird 0 zurückgegeben.

\nn\t3::File()->size('fileadmin/bild.jpg');

@return integer

\nn\t3::File()->stripPathSite(`$file, $prefix = false`);¶

Gibt Pfad zu Datei / Ordner OHNE absoluten Pfad. Optional kann ein Prefix angegeben werden.

Beispiel:

\nn\t3::File()->stripPathSite('var/www/website/fileadmin/test.jpg');         ==>  fileadmin/test.jpg
\nn\t3::File()->stripPathSite('var/www/website/fileadmin/test.jpg', true);   ==>  var/www/website/fileadmin/test.jpg
\nn\t3::File()->stripPathSite('fileadmin/test.jpg', true);                   ==>  var/www/website/fileadmin/test.jpg
\nn\t3::File()->stripPathSite('fileadmin/test.jpg', '../../');               ==>  ../../fileadmin/test.jpg

@return string

\nn\t3::File()->suffix(`$filename = NULL`);¶

Gibt den Suffix der Datei zurück

\nn\t3::File()->suffix('bild.jpg');  => gibt 'jpg' zurück

@return string

\nn\t3::File()->type(`$filename = NULL`);¶

Gibt die Art der Datei anhand des Datei-Suffixes zurück

\nn\t3::File()->type('bild.jpg');    => gibt 'image' zurück
\nn\t3::File()->type('text.doc');    => gibt 'document' zurück

@return string

\nn\t3::File()->uniqueFilename(`$filename = ''`);¶

Erzeugt einen eindeutigen Dateinamen für die Datei, falls im Zielverzeichnis bereits eine Datei mit identischem Namen existiert.

$name = \nn\t3::File()->uniqueFilename('fileadmin/01.jpg');  // 'fileadmin/01-1.jpg'

@return string

\nn\t3::File()->unlink(`$file = NULL`);¶

Löscht eine Datei komplett vom Sever. Löscht auch alle sys_file und sys_file_references, die auf die Datei verweisen. Zur Sicherheit können keine PHP oder HTML Dateien gelöscht werden.

\nn\t3::File()->unlink('fileadmin/bild.jpg');                    // Pfad zum Bild
\nn\t3::File()->unlink('/abs/path/to/file/fileadmin/bild.jpg');  // absoluter Pfad zum Bild
\nn\t3::File()->unlink('1:/my/image.jpg');                       // Combined identifier Schreibweise
\nn\t3::File()->unlink( $model->getImage() );                 // \TYPO3\CMS\Extbase\Domain\Model\FileReference
\nn\t3::File()->unlink( $falFile );                              // \TYPO3\CMS\Core\Resource\FileReference

@return boolean

\nn\t3::File()->write(`$path = NULL, $content = NULL`);¶

Einen Ordner und/oder Datei erzeugen. Legt auch die Ordner an, falls sie nicht existieren.

\nn\t3::File()->write('fileadmin/some/deep/folder/');
\nn\t3::File()->write('1:/some/deep/folder/');
\nn\t3::File()->write('fileadmin/some/deep/folder/file.json', 'TEXT');

@return boolean

File¶

\nn\t3::File()¶

Overview of Methods¶

\nn\t3::File()->absPath($file = NULL);¶

\nn\t3::File()->absUrl($file = NULL);¶

\nn\t3::File()->addPathSite($file);¶

\nn\t3::File()->cleanFilename($filename = '');¶

\nn\t3::File()->copy($src = NULL, $dest = NULL, $renameIfFileExists = true);¶

\nn\t3::File()->createFolder($path = NULL);¶

\nn\t3::File()->download($files = NULL, $filename = NULL);¶

\nn\t3::File()->exists($src = NULL);¶

\nn\t3::File()->extractExifData($filename = '');¶

\nn\t3::File()->getData($file = '');¶

\nn\t3::File()->getExifData($filename = '');¶

\nn\t3::File()->getFolder($file);¶

\nn\t3::File()->getImageData($filename = '');¶

\nn\t3::File()->getImageSize($filename = '');¶

\nn\t3::File()->getLocationData($filename = '');¶

\nn\t3::File()->getPath($file, $storage = NULL, $absolute = true);¶

\nn\t3::File()->getPublicUrl($obj = NULL, $absolute = false);¶

\nn\t3::File()->getRelativePathInStorage($file, $storage = NULL);¶

\nn\t3::File()->getStorage($file, $createIfNotExists = false);¶

\nn\t3::File()->isAllowed($filename = NULL);¶

\nn\t3::File()->isConvertableToImage($filename = NULL);¶

\nn\t3::File()->isExternalVideo($url = NULL);¶

\nn\t3::File()->isFolder($file);¶

\nn\t3::File()->isForbidden($filename = NULL);¶

\nn\t3::File()->isVideo($filename = NULL);¶

\nn\t3::File()->mkdir($path = '');¶

\nn\t3::File()->move($src = NULL, $dest = NULL);¶

\nn\t3::File()->moveUploadedFile($src = NULL, $dest = NULL);¶

\nn\t3::File()->normalizePath($path);¶

\nn\t3::File()->process($fileObj = '', $processing = [], $returnProcessedImage = false);¶

\nn\t3::File()->processImage($filenameOrSysFile = '', $processing = []);¶

\nn\t3::File()->read($src = NULL);¶

\nn\t3::File()->relPath($path = '');¶

\nn\t3::File()->resolvePathPrefixes($file = NULL, $absolute = false);¶

\nn\t3::File()->sendDownloadHeader($filename = '', $filesize = NULL);¶

\nn\t3::File()->size($src = NULL);¶

\nn\t3::File()->stripPathSite($file, $prefix = false);¶

\nn\t3::File()->suffix($filename = NULL);¶

\nn\t3::File()->type($filename = NULL);¶

\nn\t3::File()->uniqueFilename($filename = '');¶

\nn\t3::File()->unlink($file = NULL);¶

\nn\t3::File()->write($path = NULL, $content = NULL);¶

\nn\t3::File()->absPath(`$file = NULL`);¶

\nn\t3::File()->absUrl(`$file = NULL`);¶

\nn\t3::File()->addPathSite(`$file`);¶

\nn\t3::File()->cleanFilename(`$filename = ''`);¶

\nn\t3::File()->copy(`$src = NULL, $dest = NULL, $renameIfFileExists = true`);¶

\nn\t3::File()->createFolder(`$path = NULL`);¶

\nn\t3::File()->download(`$files = NULL, $filename = NULL`);¶

\nn\t3::File()->exists(`$src = NULL`);¶

\nn\t3::File()->extractExifData(`$filename = ''`);¶

\nn\t3::File()->getData(`$file = ''`);¶

\nn\t3::File()->getExifData(`$filename = ''`);¶

\nn\t3::File()->getFolder(`$file`);¶

\nn\t3::File()->getImageData(`$filename = ''`);¶

\nn\t3::File()->getImageSize(`$filename = ''`);¶

\nn\t3::File()->getLocationData(`$filename = ''`);¶

\nn\t3::File()->getPath(`$file, $storage = NULL, $absolute = true`);¶

\nn\t3::File()->getPublicUrl(`$obj = NULL, $absolute = false`);¶

\nn\t3::File()->getRelativePathInStorage(`$file, $storage = NULL`);¶

\nn\t3::File()->getStorage(`$file, $createIfNotExists = false`);¶

\nn\t3::File()->isAllowed(`$filename = NULL`);¶

\nn\t3::File()->isConvertableToImage(`$filename = NULL`);¶

\nn\t3::File()->isExternalVideo(`$url = NULL`);¶

\nn\t3::File()->isFolder(`$file`);¶

\nn\t3::File()->isForbidden(`$filename = NULL`);¶

\nn\t3::File()->isVideo(`$filename = NULL`);¶

\nn\t3::File()->mkdir(`$path = ''`);¶

\nn\t3::File()->move(`$src = NULL, $dest = NULL`);¶

\nn\t3::File()->moveUploadedFile(`$src = NULL, $dest = NULL`);¶

\nn\t3::File()->normalizePath(`$path`);¶

\nn\t3::File()->process(`$fileObj = '', $processing = [], $returnProcessedImage = false`);¶

\nn\t3::File()->processImage(`$filenameOrSysFile = '', $processing = []`);¶

\nn\t3::File()->read(`$src = NULL`);¶

\nn\t3::File()->relPath(`$path = ''`);¶

\nn\t3::File()->resolvePathPrefixes(`$file = NULL, $absolute = false`);¶

\nn\t3::File()->sendDownloadHeader(`$filename = '', $filesize = NULL`);¶

\nn\t3::File()->size(`$src = NULL`);¶

\nn\t3::File()->stripPathSite(`$file, $prefix = false`);¶

\nn\t3::File()->suffix(`$filename = NULL`);¶

\nn\t3::File()->type(`$filename = NULL`);¶

\nn\t3::File()->uniqueFilename(`$filename = ''`);¶

\nn\t3::File()->unlink(`$file = NULL`);¶

\nn\t3::File()->write(`$path = NULL, $content = NULL`);¶