PHP Manual
后退 |  | 前进

# LXXII. Mimetype Functions

# 简介

警告
This extension has been deprecated as the PECL extension fileinfo provides the same functionality (and more) in a much cleaner way.

The functions in this module try to guess the content type and encoding of a file by looking for certain magic byte sequences at specific positions within the file. While this is not a bullet proof approach the heuristics used do a very good job.

This extension is derived from Apache mod_mime_magic, which is itself based on the `file` command maintained by Ian F. Darwin. See the source code for further historic and copyright information.

# 需求

无需外部库文件就可以加入本扩展模块的支持。

# 安装

You must compile PHP with the configure switch --with-mime-magic to get support for mime-type functions. The extension needs a copy of the simplified `magic` file that is distributed with the Apache httpd.

> 注: The configure option has been changed from --enable-mime-magic to --with-mime-magic since PHP 4.3.2

> 注: This extension is not capable of handling the fully decorated `magic` file that generally comes with standard Linux distro's and is supposed to be used with recent versions of `file` command.

> Note to Win32 Users: In order to use this module on a Windows environment, you must set the path to the bundled `magic.mime` file in your `php.ini`.

> 例子 1. Setting the path to `magic.mime`
>     mime_magic.magicfile = "$PHP_INSTALL_DIR\magic.mime"

> Remember to substitute the `$PHP_INSTALL_DIR` for your actual path to PHP in the above example. e.g. `c:\php`

# 运行时配置

这些函数的行为受 `php.ini` 的影响。

表格 1. Mimetype configuration options

Name | Default | Changeable | Changelog
--- | --- | --- | ---
mime_magic.debug | "0" | PHP_INI_SYSTEM | Available since PHP 5.0.0.
mime_magic.magicfile | "/path/to/php/magic.mime" | PHP_INI_SYSTEM | Available since PHP 4.3.0.

有关 PHP_INI_* 常量进一步的细节与定义参见 附录 H。

以下是该配置选项的简要解释。

mime_magic.debug bool

  Enable/disable debugging.

mime_magic.magicfile string

  The path to the magic.mime file.

# 资源类型

本扩展模块未定义任何资源类型。

# 预定义常量

本扩展模块未定义任何常量。

后退 | 起点 | 前进
mhash | 上一级 | mime_content_type