Submit a Pull Request Report a Bug

finfo_open

finfo::__construct

(PHP >= 5.3.0, PHP 7, PHP 8, PECL fileinfo >= 0.1.0)

finfo_open -- finfo::__construct — Erstellt eine neue fileinfo Ressource

Beschreibung

Prozeduraler Stil

finfo_open ( int $options = FILEINFO_NONE , string $magic_file = ? ) : resource

Objektorientierter Stil (constructor):

public finfo::__construct ( int $options = FILEINFO_NONE , string $magic_file = ? )

Diese Funktion öffnet eine magische Datenbank und gibt ihre Ressource zurück.

Parameter-Liste

options

Eine oder eine Trennung verschiedener Fileinfo- Konstanten

magic_file

Name 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.

Rückgabewerte

Gibt bei Erfolg eine magische Datenbank-Ressource zurück. Im Fehlerfall wird false zurückgegeben.

Anmerkungen

Warnung

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_file und die MAGIC- Umgebungsvariable nicht gesetzt), sofern keine benutzerdefinierte magische Datenbank benötigt wird.

Beispiele

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

Siehe auch

finfo_close() - Schließt eine fileinfo Ressource

add a note

User Contributed Notes 10 notes

down

illusivefingers at gmail dot com ¶

12 years ago


I am running Windows 7 with Apache.  It took hours to figure out why it was not working.

First, enable the php_fileinfo.dll extension in you php.ini. You'll also need the four magic files that are found in the following library:

http://sourceforge.net/projects/gnuwin32/files/file/4.23/file-4.23-bin.zip/download

An environment variable or a direct path to the file named "magic" is necessary, without any extension.  

Then, make sure that xdebug is either turned off or set the ini error_reporting to not display notices or warnings for the script.

Hope this saves someone a few hours of frustration!

down

Anonymous ¶

10 years ago


For most common image files:
<?php
function minimime($fname) {
    $fh=fopen($fname,'rb');
    if ($fh) { 
        $bytes6=fread($fh,6);
        fclose($fh); 
        if ($bytes6===false) return false;
        if (substr($bytes6,0,3)=="\xff\xd8\xff") return 'image/jpeg';
        if ($bytes6=="\x89PNG\x0d\x0a") return 'image/png';
        if ($bytes6=="GIF87a" || $bytes6=="GIF89a") return 'image/gif';
        return 'application/octet-stream';
    }
    return false;
}
?>

down

php at brudaswen dot de ¶

15 years ago


Since it costed me some time to find the needed magic database files for Windows, just a hint:

The last release of the GnuWin32 project with both needed files (magic and magic.mime) currently was "file-4.23".
All releases after 4.23 to 4.25-1 did not contain both needed files.

Hope that helps.

down

olivier dot berger at it-sudparis dot eu ¶

13 years ago


On my Debian squeeze system, the path needed is like :
<?php 
 $finfo = new finfo(FILEINFO_MIME, "/usr/share/misc/magic.mgc");
?>

down

ian at createanet dot co dot uk ¶

16 years ago


Couldn't get finfo to return the mimetype in the way expected so i made a function to do it with system()

<?php 
function get_mime_type($filepath) {
    ob_start();
    system("file -i -b {$filepath}");
    $output = ob_get_clean();
    $output = explode("; ",$output);
    if ( is_array($output) ) {
        $output = $output[0];
    }
    return $output;
}
?>

hope it works for other people too

down

dario dot borreguero at gmail dot com ¶

16 years ago


Platform: WinXP-SP2, PHP5.2.5, MySQL 5.0, Apache 2.2.8

After reading former notes, I wasn't able to load my magic database: 'magic.mime' file (donwloaded from GnuWin32 project, zipped with the binary files v4.21). I always got an invalid $finfo object or finfo_open(...) returned FALSE.

In order to be able to load the 'magic.mime' file, Fileinfo library (bundled in PHP5.2.5) also requires 'magic' file.

For example:
1. Database:
  c:\php\magic.mime
  c:\php\magic

2. PHP Code:
<?php
  $filname = 'c:\php\php.ini';
  $finfo = new finfo(FILEINFO_MIME, 'c:\php\magic');
  if (!$finfo) return false;
  echo $finfo->file($filename);
?>

For further info see: http://pecl.php.net/bugs/bug.php?id=7555

Pay attention to comments added by 'christophe dot charron dot xul at gmail dot com'

NOTE: Before upgrading to PHP5.2.5, I was working with PHP5.2.1 and it only required 'magic.mime' file.

down

php at kingsquare dot nl ¶

16 years ago


The current version (1.04) doesnt support a different mime.magic database than the server default.

(the documentation is thus not correct)
Ubuntu default location is '/usr/share/file/magic'. In order for the examples to work all finfo_open()-commands must be issued with the extra location accordingly:
<?php
$file = "/path/to/file.jpg";
$handle = finfo_open(FILEINFO_MIME, '/usr/share/file/magic');
$mime_type = finfo_file($handle,$file);
?>

down

-1

mark at dynom dot nl ¶

15 years ago


It seems there is quite some inconsistency in distributions and loading of magic files.

On Archlinux, the file is located here:
/usr/share/misc/file/magic.mgc

But this:

<?php
$fi = new finfo(FILEINFO_MIME, '/usr/share/misc/file/magic');
$fi->file('/tmp/fubar.txt');
?>

Actually segfaults, where if I type the full name (including the file extension:)

<?php
$fi = new finfo(FILEINFO_MIME, '/usr/share/misc/file/magic.mgc'); // added ".mgc"
$fi->file('/tmp/fubar.txt');
?>

It works as expected, so I guess something goes wrong with "A .mime and/or .mgc suffix is added if needed."

down

-4

tularis at php dot net ¶

17 years ago


On Windows systems people might find that this always returns "application/x-dpkg".
There are 2 ways of solving this problem:
1. Get the mime-magic database file from GnuWin32 at <http://sourceforge.net/projects/gnuwin32/>
2. You can manually "fix" the mime-magic file by editing it and escaping all lines starting with !, thus changing each one to \!

down

-8

franssen dot roland at gmail dot com ¶

13 years ago


Notice FileInfo::__construct() has strange behavior in PHP < 5.3.1 when a 2nd parameter is set explicitly, e.g.;

<?php
$fileInfo = new finfo(FILEINFO_MIME, null);
?>

Expected result:
----------------
object(finfo)#2 (0) { }

Actual result:
--------------
Warning: finfo::finfo(): Failed to load magic database at ''. in *** on line ***
object(finfo)#2 (0) { }

See http://bugs.php.net/bug.php?id=51732

add a note