(PHP >= 5.3.0, PECL fileinfo >= 0.1.0)
finfo_open -- finfo::__construct — Erstellt eine neue fileinfo Ressource
Prozeduraler Stil
$options = FILEINFO_NONE
[, string $magic_file = NULL
]] )Objektorientierter Stil (constructor):
Diese Funktion öffnet eine magische Datenbank und gibt ihre Ressource zurück.
optionsEine oder eine Trennung verschiedener Fileinfo- Konstanten
magic_fileName einer magischen Datenbankdatei, gewöhnlich ungefähr so: /path/to/magic.mime. Falls nicht spezifiziert, wird die MAGIC-Umgebungsvariable verwendet. Falls die Umgebungsvariable nicht gesetzt ist, wird die PHP-eigene magische Datenbank benutzt.
Übergibt NULL oder eine leere Zeichenfolge gleichbedeutend mit dem Standardwert.
Gibt bei Erfolg eine magische Datenbank-Ressource zurück. Im Fehlerfall wird FALSE zurückgegeben.
Das Format der erwarteten magischen Datenbankressource änderte sich in PHP 5.3.11 und 5.4.1. Infolge dessen wurde die interne magische Datenbank aufgerüstet. Dieser Code ist am effektivsten, wenn eine externe Datenbank benutzt wird: Das Lesen aus einer älteren magischen Datenbank wird nun fehlschlagen. Auch einige Textdarstellungen der MIME-Typen wurden geändert. Für PHP würde zum Beispiel "PHP script, ASCII text" statt "PHP script text" zurück gegeben.
Hinweis:
Das Benutzen der eingebundenen magischen Datenbank wird generell empfohlen (
magic_fileund die MAGIC- Umgebungsvariable nicht gesetzt), sofern keine benutzerdefinierte magische Datenbank benötigt wird.
Beispiel #1 Objektorientierter Stil
<?php
/*
Setup für die Rückgabe von MIME-Typ und Encoding
unter Verwendung der angegebenen Datenbank /usr/share/misc/magic
*/
$finfo = new finfo(FILEINFO_MIME, "/usr/share/misc/magic");
/* Pfad zu einer Datei */
$filename = "/usr/local/something.txt";
/*
Ermittelt den MIME-Typ der Datei, beispielsweise
text/plain; charset=us-ascii
*/
echo $finfo->file($filename);
?>
Beispiel #2 Prozeduraler Stil
<?php
/*
Setup für die Rückgabe von MIME-Typ und Encoding
unter Verwendung der angegebenen Datenbank /usr/share/misc/magic
*/
$finfo = finfo_open(FILEINFO_MIME, "/usr/share/misc/magic");
if (!$finfo) {
echo "Öffnen der fileinfo-Datenbank fehlgeschlagen";
exit();
}
/* Pfad zu einer Datei */
$filename = "/usr/local/something.txt";
/*
Ermittelt den MIME-Typ der Datei, beispielsweise
text/plain; charset=us-ascii
*/
echo finfo_file($finfo, $filename);
/* Verbindung schließen */
finfo_close($finfo);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
text/plain; charset=us-ascii