Description


This function lists Apache MIME types.


We strongly recommend that you use the following UAPI function instead of this function:


cPanel & WHM version 60 or later does not list PHP versions with MIME types when the user or domain enables PHP-FPM. The system displays only the custom MIME types that you or third parties added.


Examples 




https://hostname.example.com:2087/cpsess###########/json-api/cpanel?cpanel_jsonapi_user=user&cpanel_jsonapi_apiversion=2&cpanel_jsonapi_module=Mime&cpanel_jsonapi_func=listmime&system=no



$cpanel = new CPANEL(); // Connect to cPanel - only do this once.
 
// List mime types associated with Apache
$list_mime = $cpanel->api2(
    'Mime', 'listmime', 
    array(
        'system'     => 'no',
  ) 
);

 



my $cpliveapi = Cpanel::LiveAPI->new(); # Connect to cPanel - only do this once.
 
# List mime types associated with Apache
my $list_mime = $cpliveapi->api2(
    'Mime', 'listmime',
    { 
        'system'     => 'no',
 }
);

 




cpapi2 --user=username Mime listmime system=no



{
  "cpanelresult": {
    "apiversion": 2,
    "func": "listmime",
    "data": [
      {
        "extension": ".hat",
        "origin": "user",
        "type": "hat/silly",
        "ext": ".hat"
      }
    ],
    "event": {
      "result": 1
    },
    "module": "Mime"
  }
}



Parameters

ParameterTypeDescriptionPossible valuesExample
systemstring

Whether to show system-defined MIME types.

This parameter defaults to yes.

  • yes — Show all MIME types.
  • no — Show only user-defined MIME types.
no
userstring

Whether to show user-defined MIME types.

This parameter defaults to yes .

  • yes — Show all MIME types.
  • no — Show only system-defined MIME types.
no

Returns

Return TypeDescriptionPossible valuesExample
extensionstringThe file extension.

A valid file extension.

.txt
originstringWhether the MIME type is user-defined or system-defined.
  • system — System-defined MIME type.
  • user — User-defined MIME type.
system
typestringThe MIME type.A valid MIME type.text/plain
extstringThe file extension.A valid file extension..txt
reasonstring

A reason for failure.

This function only returns a reason value if it failed.


A string that describes the error.

This is an error message.
resultBoolean

Whether the function succeeded.

  • 1 — The function succeeded.
  • 0 — The function failed.
1