summaryrefslogtreecommitdiff
path: root/ext/mime_magic
diff options
context:
space:
mode:
Diffstat (limited to 'ext/mime_magic')
-rw-r--r--ext/mime_magic/DEPRECATED36
-rw-r--r--ext/mime_magic/EXPERIMENTAL2
-rw-r--r--ext/mime_magic/config.m43
3 files changed, 39 insertions, 2 deletions
diff --git a/ext/mime_magic/DEPRECATED b/ext/mime_magic/DEPRECATED
new file mode 100644
index 0000000000..d4d42e6f92
--- /dev/null
+++ b/ext/mime_magic/DEPRECATED
@@ -0,0 +1,36 @@
+This extension is deprecated, please use the fileinfo extension
+from PECL instead.
+
+Back when i implemented mime_magic there was no library interface
+to the file utilities functionality. The only way to get the
+functionality in place was to get the file sources and replace
+the input and output routines within with code interfacing to
+your own stuff. This work was originally done by the developers
+of apache mod_magic, the mime_magic extension just replaced the
+apache specific parts with their PHP counterparts.
+
+Now that the codebase of the file utilities is cleanly devided
+into the libmagic library and the file utility built upon it
+the original hack is no longer needed. Using libmagic and the
+fileinfo extension does not only provide a cleaner interface
+to files functionality but also additional functionality so
+that theres no reason to keep around mime_magic anymore.
+
+To keep existing code originaly coded for mime_magic without
+changes you may add the following compatibility wrapper function
+to your codebase:
+
+function mime_content_type($file) {
+ static $finfo = false;
+
+ if ($finfo === false) {
+ $finfo = finfo_open(MAGIC_MIME);
+ }
+
+ if (is_resource($file)) {
+ $buf = fread($fp, 65536);
+ return finfo_buffer($buf);
+ } else {
+ return finfo_file($file);
+ }
+} \ No newline at end of file
diff --git a/ext/mime_magic/EXPERIMENTAL b/ext/mime_magic/EXPERIMENTAL
index e69de29bb2..add2b3b7e6 100644
--- a/ext/mime_magic/EXPERIMENTAL
+++ b/ext/mime_magic/EXPERIMENTAL
@@ -0,0 +1,2 @@
+this extension never left the "experimental" status
+and is now superseded by PECL::fileinfo
diff --git a/ext/mime_magic/config.m4 b/ext/mime_magic/config.m4
index 1682399501..0e53bc5d56 100644
--- a/ext/mime_magic/config.m4
+++ b/ext/mime_magic/config.m4
@@ -4,8 +4,7 @@ dnl
PHP_ARG_WITH(mime-magic, whether to include mime_magic support,
[ --with-mime-magic[=FILE]
- Include mime_magic support. FILE is the optional
- pathname to the magic.mime file.])
+ Include mime_magic support (deprecated)])
if test "$PHP_MIME_MAGIC" != "no"; then