Depercating mime_magic in favor of PECL::fileinfo

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