2017 © Pedro Peláez
 

library blob-mimes

A comprehensive MIME and file extension tool for PHP.

image

blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  • Sunday, July 15, 2018
  • by joshstoik1
  • Repository
  • 4 Watchers
  • 8 Stars
  • 1,407 Installations
  • PHP
  • 2 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 15 Versions
  • 9 % Grown

The README.md

blob-mimes

DEPRECATED: This project is no longer actively maintained. Please see Righteous MIMEs instead., (*1)

A comprehensive MIME and file extension tool for PHP. Finally!, (*2)

 , (*3)

Table of Contents

  1. Features
  2. Requirements
  3. Installation
  4. Reference
  5. License

 , (*4)

Features

It should be simple, but MIME types and file extensions are wildly inconsistent. Attempting to derive and/or correct that information when, e.g. verifying a file upload, is a nightmare in any programming language., (*5)

blob-mimes is a PHP library with a comprehensive MIME/ext database and simple helpers to access that information in a variety of ways:, (*6)

  • Pull MIME information based on a file name or extension;
  • Pull file extensions for a given MIME type;
  • Pull MIME information from a local file and verify its extension matches the actual content;

The database is compiled from the following sources:, (*7)

 , (*8)

Requirements

blob-mimes requires PHP 7.0+ with the following modules:, (*9)

  • BCMath
  • DOM
  • Fileinfo
  • Filter
  • JSON
  • MBString
  • SimpleXML

UTF-8 is used for all string encoding. This could create conflicts on environments using something else., (*10)

The build script additionally requires cURL., (*11)

 , (*12)

Installation

Install via Composer:, (*13)

composer require "blobfolio/blob-mimes:dev-master"

 , (*14)

Reference

check_ext_and_mime()

Verify that a file extension and MIME type belong together. Because technology is always evolving and the MIME standard is always changing, this will consider some/thing and some/x-thing equivalent., (*15)

Arguments

  • (string) File extension
  • (string) MIME type
  • (bool) (optional) Soft pass. If TRUE, the check will return TRUE if it lacks information about either the extension or MIME type.

Returns

Returns TRUE or FALSE., (*16)

Example

$foo = blobfolio\mimes\mimes::check_ext_and_mime('jpeg', 'image/jpeg'); //TRUE
$foo = blobfolio\mimes\mimes::check_ext_and_mime('jpeg', 'image/gif'); //FALSE

 , (*17)

finfo()

Pull path and type information for a file, using its name and/or content. If it is determined that the file is incorrectly named, alternative names with the correct file extension(s) are suggested., (*18)

Arguments

  • (string) Path
  • (string) (optional) Nice name. If provided, the nice name will be treated as the filename. This can be useful if passing a temporary upload, for example. Default: NULL

Returns

Returns all file information that can be derived according to the format below., (*19)

Example

print_r(blobfolio\mimes\mimes::finfo('../wp/img/blobfolio.svg'));
/*
array(
    [dirname] => /var/www/blob-common/wp/img
    [basename] => blobfolio.svg
    [extension] => svg
    [filename] => blobfolio
    [path] => /var/www/blob-common/wp/img/blobfolio.svg
    [mime] => image/svg+xml
    [suggested_filename] => array()
)
*/

 , (*20)

get_extension()

Retrieve information about a file extension., (*21)

Arguments

  • (string) File extension

Returns

Returns the information or FALSE. Note: The first MIME entry will always be the official (or most conventional) media type., (*22)

print_r(blobfolio\mimes\mimes::get_extension('jpeg'));
/*
array(
    [ext] => jpeg
    [mime] => array(
        0 => image/jpeg
        1 => image/pjpeg
    )
)
*/

 , (*23)

get_extensions()

Retrieve information about all known file extensions., (*24)

Arguments

N/A, (*25)

Returns

Returns a MIME database organized by extension., (*26)

 , (*27)

get_mime()

Retrieve information about a MIME type., (*28)

Arguments

  • (string) MIME type

Returns

Returns the information or FALSE., (*29)

Example

print_r(blobfolio\mimes\mimes::get_mime('image/jpeg'));
/*
array(
    [mime] => image/jpeg
    [ext] => array(
        0 => jpeg
        1 => jpg
        2 => jpe
    )
    [source] => array(
        0 => Apache
        1 => Nginx
        2 => freedesktop.org
    )
)
*/

 , (*30)

get_mimes()

Retrieve information about all known MIME types., (*31)

Arguments

N/A, (*32)

Returns

Returns a MIME database organized by type. Note: The first extension should be the most common for the type., (*33)

 , (*34)

License

Copyright © 2018 Blobfolio, LLC <hello@blobfolio.com>, (*35)

This work is free. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2., (*36)

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004

Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>

Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

0. You just DO WHAT THE FUCK YOU WANT TO.

Donations

Bitcoin QR If you have found this work useful and would like to contribute financially, Bitcoin tips are always welcome!

1Af56Nxauv8M1ChyQxtBe1yvdp2jtaB1GF

The Versions

15/07 2018

dev-master

9999999-dev https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2 WTFPL

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

17/06 2018

8.0.0

8.0.0.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

WTFPL

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

21/05 2018

dev-7.0_Next

dev-7.0_Next https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

WTFPL

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

02/04 2018

1.3.2

1.3.2.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

WTFPL

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

01/01 2018

1.3.1

1.3.1.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

WTFPL

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

03/07 2017

1.3.0

1.3.0.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

WTFPL

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

01/05 2017

1.2.0

1.2.0.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

11/04 2017

1.1.4

1.1.4.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

01/04 2017

1.1.3

1.1.3.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

09/03 2017

1.1.2

1.1.2.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

07/03 2017

1.1.1

1.1.1.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

28/02 2017

1.1.0

1.1.0.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2

The Requires

 

The Development Requires

by Josh Stoik

extensions files mimes suffix

24/01 2017

1.0.1

1.0.1.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2

The Requires

 

by Josh Stoik

extensions files mimes suffix

24/01 2017

1.0.0

1.0.0.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2

The Requires

 

by Josh Stoik

extensions files mimes suffix

16/01 2017

v0.5

0.5.0.0 https://github.com/Blobfolio/blob-mimes

A comprehensive MIME and file extension tool for PHP.

  Sources   Download

GPLv2

The Requires

 

by Josh Stoik

extensions files mimes suffix