<?php // This file is part of Moodle - http://moodle.org/ // // Moodle is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Moodle is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with Moodle. If not, see <http://www.gnu.org/licenses/>. /** * Class to manage the custom filetypes list that is stored in a config variable. * * @package core * @copyright 2014 The Open University * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ defined('MOODLE_INTERNAL') || die(); require_once($CFG->libdir . '/filelib.php'); /** * Class to manage the custom filetypes list that is stored in a config variable. * * @copyright 2014 The Open University * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ abstract class core_filetypes { /** @var array Cached MIME types for current request */ protected static $cachedtypes; /** * Gets default MIME types that are included as standard. * * Note: Use the function get_mimetypes_array to access this data including * any customisations the user might have made. * * @return array Default (pre-installed) MIME type information */ protected static function get_default_types() { return array( 'xxx' => array('type' => 'document/unknown', 'icon' => 'unknown'), '3gp' => array('type' => 'video/quicktime', 'icon' => 'quicktime', 'groups' => array('video'), 'string' => 'video'), '7z' => array('type' => 'application/x-7z-compressed', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive'), 'aac' => array('type' => 'audio/aac', 'icon' => 'audio', 'groups' => array('audio', 'html_audio', 'web_audio'), 'string' => 'audio'), 'accdb' => array('type' => 'application/msaccess', 'icon' => 'base'), 'ai' => array('type' => 'application/postscript', 'icon' => 'eps', 'groups' => array('image'), 'string' => 'image'), 'aif' => array('type' => 'audio/x-aiff', 'icon' => 'audio', 'groups' => array('audio'), 'string' => 'audio'), 'aiff' => array('type' => 'audio/x-aiff', 'icon' => 'audio', 'groups' => array('audio'), 'string' => 'audio'), 'aifc' => array('type' => 'audio/x-aiff', 'icon' => 'audio', 'groups' => array('audio'), 'string' => 'audio'), 'applescript' => array('type' => 'text/plain', 'icon' => 'text'), 'asc' => array('type' => 'text/plain', 'icon' => 'sourcecode'), 'asm' => array('type' => 'text/plain', 'icon' => 'sourcecode'), 'au' => array('type' => 'audio/au', 'icon' => 'audio', 'groups' => array('audio'), 'string' => 'audio'), 'avi' => array('type' => 'video/x-ms-wm', 'icon' => 'avi', 'groups' => array('video', 'web_video'), 'string' => 'video'), 'bmp' => array('type' => 'image/bmp', 'icon' => 'bmp', 'groups' => array('image'), 'string' => 'image'), 'c' => array('type' => 'text/plain', 'icon' => 'sourcecode'), 'cct' => array('type' => 'shockwave/director', 'icon' => 'flash'), 'cpp' => array('type' => 'text/plain', 'icon' => 'sourcecode'), 'cs' => array('type' => 'application/x-csh', 'icon' => 'sourcecode'), 'css' => array('type' => 'text/css', 'icon' => 'text', 'groups' => array('web_file')), 'csv' => array('type' => 'text/csv', 'icon' => 'spreadsheet', 'groups' => array('spreadsheet')), 'dv' => array('type' => 'video/x-dv', 'icon' => 'quicktime', 'groups' => array('video'), 'string' => 'video'), 'dmg' => array('type' => 'application/octet-stream', 'icon' => 'unknown'), 'doc' => array('type' => 'application/msword', 'icon' => 'document', 'groups' => array('document')), 'bdoc' => array('type' => 'application/x-digidoc', 'icon' => 'document', 'groups' => array('archive')), 'cdoc' => array('type' => 'application/x-digidoc', 'icon' => 'document', 'groups' => array('archive')), 'ddoc' => array('type' => 'application/x-digidoc', 'icon' => 'document', 'groups' => array('archive')), 'docx' => array('type' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'icon' => 'document', 'groups' => array('document')), 'docm' => array('type' => 'application/vnd.ms-word.document.macroEnabled.12', 'icon' => 'document'), 'dotx' => array('type' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.template', 'icon' => 'document'), 'dotm' => array('type' => 'application/vnd.ms-word.template.macroEnabled.12', 'icon' => 'document'), 'dcr' => array('type' => 'application/x-director', 'icon' => 'flash'), 'dif' => array('type' => 'video/x-dv', 'icon' => 'quicktime', 'groups' => array('video'), 'string' => 'video'), 'dir' => array('type' => 'application/x-director', 'icon' => 'flash'), 'dxr' => array('type' => 'application/x-director', 'icon' => 'flash'), 'eps' => array('type' => 'application/postscript', 'icon' => 'eps'), 'epub' => array('type' => 'application/epub+zip', 'icon' => 'epub', 'groups' => array('document')), 'fdf' => array('type' => 'application/vnd.fdf', 'icon' => 'pdf'), 'flac' => array('type' => 'audio/flac', 'icon' => 'audio', 'groups' => array('audio', 'html_audio', 'web_audio'), 'string' => 'audio'), 'flv' => array('type' => 'video/x-flv', 'icon' => 'flash', 'groups' => array('video', 'web_video'), 'string' => 'video'), 'f4v' => array('type' => 'video/mp4', 'icon' => 'flash', 'groups' => array('video', 'web_video'), 'string' => 'video'), 'fmp4' => array('type' => 'video/mp4', 'icon' => 'mpeg', 'groups' => array('html_video', 'video', 'web_video'), 'string' => 'video'), 'gallery' => array('type' => 'application/x-smarttech-notebook', 'icon' => 'archive'), 'galleryitem' => array('type' => 'application/x-smarttech-notebook', 'icon' => 'archive'), 'gallerycollection' => array('type' => 'application/x-smarttech-notebook', 'icon' => 'archive'), 'gdraw' => array('type' => 'application/vnd.google-apps.drawing', 'icon' => 'image', 'groups' => array('image')), 'gdoc' => array('type' => 'application/vnd.google-apps.document', 'icon' => 'document', 'groups' => array('document')), 'gsheet' => array('type' => 'application/vnd.google-apps.spreadsheet', 'icon' => 'spreadsheet', 'groups' => array('spreadsheet')), 'gslides' => array('type' => 'application/vnd.google-apps.presentation', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'gif' => array('type' => 'image/gif', 'icon' => 'gif', 'groups' => array('image', 'web_image', 'optimised_image'), 'string' => 'image'), 'gtar' => array('type' => 'application/x-gtar', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive'), 'tgz' => array('type' => 'application/g-zip', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive'), 'gz' => array('type' => 'application/g-zip', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive'), 'gzip' => array('type' => 'application/g-zip', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive'), 'h' => array('type' => 'text/plain', 'icon' => 'sourcecode'), 'h5p' => array('type' => 'application/zip.h5p', 'icon' => 'h5p', 'string' => 'archive'), 'hpp' => array('type' => 'text/plain', 'icon' => 'sourcecode'), 'hqx' => array('type' => 'application/mac-binhex40', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive'), 'htc' => array('type' => 'text/x-component', 'icon' => 'markup'), 'html' => array('type' => 'text/html', 'icon' => 'html', 'groups' => array('web_file')), 'xhtml' => array('type' => 'application/xhtml+xml', 'icon' => 'html', 'groups' => array('web_file')), 'htm' => array('type' => 'text/html', 'icon' => 'html', 'groups' => array('web_file')), 'ico' => array('type' => 'image/vnd.microsoft.icon', 'icon' => 'image', 'groups' => array('image'), 'string' => 'image'), 'ics' => array('type' => 'text/calendar', 'icon' => 'text'), 'isf' => array('type' => 'application/inspiration', 'icon' => 'isf'), 'ist' => array('type' => 'application/inspiration.template', 'icon' => 'isf'), 'java' => array('type' => 'text/plain', 'icon' => 'sourcecode'), 'jar' => array('type' => 'application/java-archive', 'icon' => 'archive'), 'jcb' => array('type' => 'text/xml', 'icon' => 'markup'), 'jcl' => array('type' => 'text/xml', 'icon' => 'markup'), 'jcw' => array('type' => 'text/xml', 'icon' => 'markup'), 'jmt' => array('type' => 'text/xml', 'icon' => 'markup'), 'jmx' => array('type' => 'text/xml', 'icon' => 'markup'), 'jnlp' => array('type' => 'application/x-java-jnlp-file', 'icon' => 'markup'), 'jpe' => array('type' => 'image/jpeg', 'icon' => 'jpeg', 'groups' => array('image', 'web_image', 'optimised_image'), 'string' => 'image'), 'jpeg' => array('type' => 'image/jpeg', 'icon' => 'jpeg', 'groups' => array('image', 'web_image', 'optimised_image'), 'string' => 'image'), 'jpg' => array('type' => 'image/jpeg', 'icon' => 'jpeg', 'groups' => array('image', 'web_image', 'optimised_image'), 'string' => 'image'), 'jqz' => array('type' => 'text/xml', 'icon' => 'markup'), 'js' => array('type' => 'application/x-javascript', 'icon' => 'text', 'groups' => array('web_file')), 'json' => array('type' => 'application/json', 'icon' => 'text'), 'latex' => array('type' => 'application/x-latex', 'icon' => 'text'), 'm' => array('type' => 'text/plain', 'icon' => 'sourcecode'), 'mbz' => array('type' => 'application/vnd.moodle.backup', 'icon' => 'moodle'), 'mdb' => array('type' => 'application/x-msaccess', 'icon' => 'base'), 'mht' => array('type' => 'message/rfc822', 'icon' => 'archive'), 'mhtml' => array('type' => 'message/rfc822', 'icon' => 'archive'), 'mov' => array('type' => 'video/quicktime', 'icon' => 'quicktime', 'groups' => array('video', 'web_video', 'html_video'), 'string' => 'video'), 'movie' => array('type' => 'video/x-sgi-movie', 'icon' => 'quicktime', 'groups' => array('video'), 'string' => 'video'), 'mw' => array('type' => 'application/maple', 'icon' => 'math'), 'mws' => array('type' => 'application/maple', 'icon' => 'math'), 'm3u' => array('type' => 'audio/x-mpegurl', 'icon' => 'mp3', 'groups' => array('audio'), 'string' => 'audio'), 'm3u8' => array('type' => 'application/x-mpegURL', 'icon' => 'mpeg', 'groups' => array('media_source')), 'mp3' => array('type' => 'audio/mp3', 'icon' => 'mp3', 'groups' => array('audio', 'html_audio', 'web_audio'), 'string' => 'audio'), 'mp4' => array('type' => 'video/mp4', 'icon' => 'mpeg', 'groups' => array('html_video', 'video', 'web_video'), 'string' => 'video'), 'm4v' => array('type' => 'video/mp4', 'icon' => 'mpeg', 'groups' => array('html_video', 'video', 'web_video'), 'string' => 'video'), 'm4a' => array('type' => 'audio/mp4', 'icon' => 'mp3', 'groups' => array('audio', 'html_audio', 'web_audio'), 'string' => 'audio'), 'mpeg' => array('type' => 'video/mpeg', 'icon' => 'mpeg', 'groups' => array('video', 'web_video'), 'string' => 'video'), 'mpd' => array('type' => 'application/dash+xml', 'icon' => 'mpeg', 'groups' => array('media_source')), 'mpe' => array('type' => 'video/mpeg', 'icon' => 'mpeg', 'groups' => array('video', 'web_video'), 'string' => 'video'), 'mpg' => array('type' => 'video/mpeg', 'icon' => 'mpeg', 'groups' => array('video', 'web_video'), 'string' => 'video'), 'mpr' => array('type' => 'application/vnd.moodle.profiling', 'icon' => 'moodle'), 'nbk' => array('type' => 'application/x-smarttech-notebook', 'icon' => 'archive'), 'notebook' => array('type' => 'application/x-smarttech-notebook', 'icon' => 'archive'), 'odt' => array('type' => 'application/vnd.oasis.opendocument.text', 'icon' => 'writer', 'groups' => array('document')), 'ott' => array('type' => 'application/vnd.oasis.opendocument.text-template', 'icon' => 'writer', 'groups' => array('document')), 'oth' => array('type' => 'application/vnd.oasis.opendocument.text-web', 'icon' => 'oth', 'groups' => array('document')), 'odm' => array('type' => 'application/vnd.oasis.opendocument.text-master', 'icon' => 'writer'), 'odg' => array('type' => 'application/vnd.oasis.opendocument.graphics', 'icon' => 'draw'), 'otg' => array('type' => 'application/vnd.oasis.opendocument.graphics-template', 'icon' => 'draw'), 'odp' => array('type' => 'application/vnd.oasis.opendocument.presentation', 'icon' => 'impress', 'groups' => array('presentation')), 'otp' => array('type' => 'application/vnd.oasis.opendocument.presentation-template', 'icon' => 'impress', 'groups' => array('presentation')), 'ods' => array('type' => 'application/vnd.oasis.opendocument.spreadsheet', 'icon' => 'calc', 'groups' => array('spreadsheet')), 'ots' => array('type' => 'application/vnd.oasis.opendocument.spreadsheet-template', 'icon' => 'calc', 'groups' => array('spreadsheet')), 'odc' => array('type' => 'application/vnd.oasis.opendocument.chart', 'icon' => 'chart'), 'odf' => array('type' => 'application/vnd.oasis.opendocument.formula', 'icon' => 'math'), 'odb' => array('type' => 'application/vnd.oasis.opendocument.database', 'icon' => 'base'), 'odi' => array('type' => 'application/vnd.oasis.opendocument.image', 'icon' => 'draw'), 'oga' => array('type' => 'audio/ogg', 'icon' => 'audio', 'groups' => array('audio', 'html_audio', 'web_audio'), 'string' => 'audio'), 'ogg' => array('type' => 'audio/ogg', 'icon' => 'audio', 'groups' => array('audio', 'html_audio', 'web_audio'), 'string' => 'audio'), 'ogv' => array('type' => 'video/ogg', 'icon' => 'video', 'groups' => array('html_video', 'video', 'web_video'), 'string' => 'video'), 'pct' => array('type' => 'image/pict', 'icon' => 'image', 'groups' => array('image'), 'string' => 'image'), 'pdf' => array('type' => 'application/pdf', 'icon' => 'pdf', 'groups' => array('document')), 'php' => array('type' => 'text/plain', 'icon' => 'sourcecode'), 'pic' => array('type' => 'image/pict', 'icon' => 'image', 'groups' => array('image'), 'string' => 'image'), 'pict' => array('type' => 'image/pict', 'icon' => 'image', 'groups' => array('image'), 'string' => 'image'), 'png' => array('type' => 'image/png', 'icon' => 'png', 'groups' => array('image', 'web_image', 'optimised_image'), 'string' => 'image'), 'pps' => array('type' => 'application/vnd.ms-powerpoint', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'ppt' => array('type' => 'application/vnd.ms-powerpoint', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'pptx' => array('type' => 'application/vnd.openxmlformats-officedocument.presentationml.presentation', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'pptm' => array('type' => 'application/vnd.ms-powerpoint.presentation.macroEnabled.12', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'potx' => array('type' => 'application/vnd.openxmlformats-officedocument.presentationml.template', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'potm' => array('type' => 'application/vnd.ms-powerpoint.template.macroEnabled.12', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'ppam' => array('type' => 'application/vnd.ms-powerpoint.addin.macroEnabled.12', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'ppsx' => array('type' => 'application/vnd.openxmlformats-officedocument.presentationml.slideshow', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'ppsm' => array('type' => 'application/vnd.ms-powerpoint.slideshow.macroEnabled.12', 'icon' => 'powerpoint', 'groups' => array('presentation')), 'ps' => array('type' => 'application/postscript', 'icon' => 'pdf'), 'pub' => array('type' => 'application/x-mspublisher', 'icon' => 'publisher', 'groups' => array('presentation')), 'qt' => array('type' => 'video/quicktime', 'icon' => 'quicktime', 'groups' => array('video', 'web_video'), 'string' => 'video'), 'ra' => array('type' => 'audio/x-realaudio-plugin', 'icon' => 'audio', 'groups' => array('audio', 'web_audio'), 'string' => 'audio'), 'ram' => array('type' => 'audio/x-pn-realaudio-plugin', 'icon' => 'audio', 'groups' => array('audio'), 'string' => 'audio'), 'rar' => array('type' => 'application/x-rar-compressed', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive'), 'rhb' => array('type' => 'text/xml', 'icon' => 'markup'), 'rm' => array('type' => 'audio/x-pn-realaudio-plugin', 'icon' => 'audio', 'groups' => array('audio'), 'string' => 'audio'), 'rmvb' => array('type' => 'application/vnd.rn-realmedia-vbr', 'icon' => 'video', 'groups' => array('video'), 'string' => 'video'), 'rtf' => array('type' => 'text/rtf', 'icon' => 'text', 'groups' => array('document')), 'rtx' => array('type' => 'text/richtext', 'icon' => 'text'), 'rv' => array('type' => 'audio/x-pn-realaudio-plugin', 'icon' => 'audio', 'groups' => array('video'), 'string' => 'video'), 'scss' => array('type' => 'text/x-scss', 'icon' => 'text', 'groups' => array('web_file')), 'sh' => array('type' => 'application/x-sh', 'icon' => 'sourcecode'), 'sit' => array('type' => 'application/x-stuffit', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive'), 'smi' => array('type' => 'application/smil', 'icon' => 'text'), 'smil' => array('type' => 'application/smil', 'icon' => 'text'), 'sqt' => array('type' => 'text/xml', 'icon' => 'markup'), 'svg' => array('type' => 'image/svg+xml', 'icon' => 'image', 'groups' => array('image', 'web_image'), 'string' => 'image'), 'svgz' => array('type' => 'image/svg+xml', 'icon' => 'image', 'groups' => array('image', 'web_image'), 'string' => 'image'), 'swa' => array('type' => 'application/x-director', 'icon' => 'flash'), 'swf' => array('type' => 'application/x-shockwave-flash', 'icon' => 'flash'), 'swfl' => array('type' => 'application/x-shockwave-flash', 'icon' => 'flash'), 'sxw' => array('type' => 'application/vnd.sun.xml.writer', 'icon' => 'writer'), 'stw' => array('type' => 'application/vnd.sun.xml.writer.template', 'icon' => 'writer'), 'sxc' => array('type' => 'application/vnd.sun.xml.calc', 'icon' => 'calc'), 'stc' => array('type' => 'application/vnd.sun.xml.calc.template', 'icon' => 'calc'), 'sxd' => array('type' => 'application/vnd.sun.xml.draw', 'icon' => 'draw'), 'std' => array('type' => 'application/vnd.sun.xml.draw.template', 'icon' => 'draw'), 'sxi' => array('type' => 'application/vnd.sun.xml.impress', 'icon' => 'impress', 'groups' => array('presentation')), 'sti' => array('type' => 'application/vnd.sun.xml.impress.template', 'icon' => 'impress', 'groups' => array('presentation')), 'sxg' => array('type' => 'application/vnd.sun.xml.writer.global', 'icon' => 'writer'), 'sxm' => array('type' => 'application/vnd.sun.xml.math', 'icon' => 'math'), 'tar' => array('type' => 'application/x-tar', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive'), 'tif' => array('type' => 'image/tiff', 'icon' => 'tiff', 'groups' => array('image'), 'string' => 'image'), 'tiff' => array('type' => 'image/tiff', 'icon' => 'tiff', 'groups' => array('image'), 'string' => 'image'), 'tex' => array('type' => 'application/x-tex', 'icon' => 'text'), 'texi' => array('type' => 'application/x-texinfo', 'icon' => 'text'), 'texinfo' => array('type' => 'application/x-texinfo', 'icon' => 'text'), 'ts' => array('type' => 'video/MP2T', 'icon' => 'mpeg', 'groups' => array('video', 'web_video'), 'string' => 'video'), 'tsv' => array('type' => 'text/tab-separated-values', 'icon' => 'text'), 'txt' => array('type' => 'text/plain', 'icon' => 'text', 'defaulticon' => true), 'vtt' => array('type' => 'text/vtt', 'icon' => 'text', 'groups' => array('html_track')), 'wav' => array('type' => 'audio/wav', 'icon' => 'wav', 'groups' => array('audio', 'html_audio', 'web_audio'), 'string' => 'audio'), 'webm' => array('type' => 'video/webm', 'icon' => 'video', 'groups' => array('html_video', 'video', 'web_video'), 'string' => 'video'), 'wmv' => array('type' => 'video/x-ms-wmv', 'icon' => 'wmv', 'groups' => array('video'), 'string' => 'video'), 'asf' => array('type' => 'video/x-ms-asf', 'icon' => 'wmv', 'groups' => array('video'), 'string' => 'video'), 'wma' => array('type' => 'audio/x-ms-wma', 'icon' => 'audio', 'groups' => array('audio'), 'string' => 'audio'), 'xbk' => array('type' => 'application/x-smarttech-notebook', 'icon' => 'archive'), 'xdp' => array('type' => 'application/vnd.adobe.xdp+xml', 'icon' => 'pdf'), 'xfd' => array('type' => 'application/vnd.xfdl', 'icon' => 'pdf'), 'xfdf' => array('type' => 'application/vnd.adobe.xfdf', 'icon' => 'pdf'), 'xls' => array('type' => 'application/vnd.ms-excel', 'icon' => 'spreadsheet', 'groups' => array('spreadsheet')), 'xlsx' => array('type' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 'icon' => 'spreadsheet', 'groups' => array('spreadsheet')), 'xlsm' => array('type' => 'application/vnd.ms-excel.sheet.macroEnabled.12', 'icon' => 'spreadsheet', 'groups' => array('spreadsheet')), 'xltx' => array('type' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.template', 'icon' => 'spreadsheet'), 'xltm' => array('type' => 'application/vnd.ms-excel.template.macroEnabled.12', 'icon' => 'spreadsheet'), 'xlsb' => array('type' => 'application/vnd.ms-excel.sheet.binary.macroEnabled.12', 'icon' => 'spreadsheet'), 'xlam' => array('type' => 'application/vnd.ms-excel.addin.macroEnabled.12', 'icon' => 'spreadsheet'), 'xml' => array('type' => 'application/xml', 'icon' => 'markup'), 'xsl' => array('type' => 'text/xml', 'icon' => 'markup'),> 'yaml' => array('type' => 'application/yaml', 'icon' => 'markup'), 'zip' => array('type' => 'application/zip', 'icon' => 'archive', 'groups' => array('archive'), 'string' => 'archive') > 'yml' => array('type' => 'application/yaml', 'icon' => 'markup'), ); >} /** * Given a mimetype - return a valid file extension for it. * * @param $mimetype string * @return string|bool False if the mimetype was not known, a string indicating a valid file extension otherwise. It may not * be the only valid file extension - just the first one found. */ public static function get_file_extension($mimetype) { $types = self::get_types(); foreach ($types as $extension => $info) { if ($info['type'] == $mimetype) { return $extension; } } return false; } /** * Gets all the current types. * * @return array Associative array from extension to array of data about type */ public static function &get_types() { // If it was already done in this request, use cache. if (self::$cachedtypes) { return self::$cachedtypes; } // Get defaults. $mimetypes = self::get_default_types(); // Get custom file types. $custom = self::get_custom_types(); // Check value is an array. if (!is_array($custom)) { debugging('Invalid $CFG->customfiletypes (not array)', DEBUG_DEVELOPER); $custom = array(); } foreach ($custom as $customentry) { // Each entry is a stdClass object similar to the array values above. if (empty($customentry->extension)) { debugging('Invalid $CFG->customfiletypes entry (extension field required)', DEBUG_DEVELOPER); continue; } // To delete a standard entry, set 'deleted' to true. if (!empty($customentry->deleted)) { unset($mimetypes[$customentry->extension]); continue; } // Check required fields. if (empty($customentry->type) || empty($customentry->icon)) { debugging('Invalid $CFG->customfiletypes entry ' . $customentry->extension . ' (type and icon fields required)', DEBUG_DEVELOPER); continue; } // Build result array. $result = array('type' => $customentry->type, 'icon' => $customentry->icon); if (!empty($customentry->groups)) { if (!is_array($customentry->groups)) { debugging('Invalid $CFG->customfiletypes entry ' . $customentry->extension . ' (groups field not array)', DEBUG_DEVELOPER); continue; } $result['groups'] = $customentry->groups; } if (!empty($customentry->string)) { if (!is_string($customentry->string)) { debugging('Invalid $CFG->customfiletypes entry ' . $customentry->extension . ' (string field not string)', DEBUG_DEVELOPER); continue; } $result['string'] = $customentry->string; } if (!empty($customentry->defaulticon)) { if (!is_bool($customentry->defaulticon)) { debugging('Invalid $CFG->customfiletypes entry ' . $customentry->extension . ' (defaulticon field not bool)', DEBUG_DEVELOPER); continue; } $result['defaulticon'] = $customentry->defaulticon; } if (!empty($customentry->customdescription)) { if (!is_string($customentry->customdescription)) { debugging('Invalid $CFG->customfiletypes entry ' . $customentry->extension . ' (customdescription field not string)', DEBUG_DEVELOPER); continue; } // As the name suggests, this field is used only for custom entries. $result['customdescription'] = $customentry->customdescription; } // Track whether it is a custom filetype or a modified existing // filetype. if (array_key_exists($customentry->extension, $mimetypes)) { $result['modified'] = true; } else { $result['custom'] = true; } // Add result array to list. $mimetypes[$customentry->extension] = $result; } self::$cachedtypes = $mimetypes; return self::$cachedtypes; } /** * Gets custom types from config variable, after decoding the JSON if required. * * @return array Array of custom types (empty array if none) */ protected static function get_custom_types() { global $CFG; if (!empty($CFG->customfiletypes)) { if (is_array($CFG->customfiletypes)) { // You can define this as an array in config.php... return $CFG->customfiletypes; } else { // Or as a JSON string in the config table. return json_decode($CFG->customfiletypes); } } else { return array(); } } /** * Sets the custom types into config variable, encoding into JSON. * * @param array $types Array of custom types * @throws coding_exception If the custom types are fixed in config.php. */ protected static function set_custom_types(array $types) { global $CFG; // Check the setting hasn't been forced. if (array_key_exists('customfiletypes', $CFG->config_php_settings)) { throw new coding_exception('Cannot set custom filetypes because they ' . 'are defined in config.php'); } if (empty($types)) { unset_config('customfiletypes'); } else { set_config('customfiletypes', json_encode(array_values($types))); } // Clear the cached type list. self::reset_caches(); } /** * Clears the type cache. This is not needed in normal use as the * set_custom_types function automatically clears the cache. Intended for * use in unit tests. */ public static function reset_caches() { self::$cachedtypes = null; } /** * Gets the default types that have been deleted. Returns an array containing * the defaults of all those types. * * @return array Array (same format as get_mimetypes_array) */ public static function get_deleted_types() { $defaults = self::get_default_types(); $deleted = array(); foreach (self::get_custom_types() as $customentry) { if (!empty($customentry->deleted)) { $deleted[$customentry->extension] = $defaults[$customentry->extension]; } } return $deleted; } /** * Adds a new entry to the list of custom filetypes. * * @param string $extension File extension without dot, e.g. 'doc' * @param string $mimetype MIME type e.g. 'application/msword' * @param string $coreicon Core icon to use e.g. 'document' * @param array $groups Array of group strings that this type belongs to * @param string $corestring Custom lang string name in mimetypes.php * @param string $customdescription Custom description (plain text/multilang) * @param bool $defaulticon True if this should be the default icon for the type * @throws coding_exception If the extension already exists, or otherwise invalid */ public static function add_type($extension, $mimetype, $coreicon, array $groups = array(), $corestring = '', $customdescription = '', $defaulticon = false) { // Check for blank extensions or incorrectly including the dot. $extension = (string)$extension; if ($extension === '' || $extension[0] === '.') { throw new coding_exception('Invalid extension .' . $extension); } // Check extension not already used. $mimetypes = get_mimetypes_array(); if (array_key_exists($extension, $mimetypes)) { throw new coding_exception('Extension ' . $extension . ' already exists'); } // For default icon, check there isn't already something with default icon // set for that MIME type. if ($defaulticon) { foreach ($mimetypes as $type) { if ($type['type'] === $mimetype && !empty($type['defaulticon'])) { throw new coding_exception('MIME type ' . $mimetype . ' already has a default icon set'); } } } // Get existing custom filetype list. $customs = self::get_custom_types(); // Check if there's a 'deleted' entry for the extension, if so then get // rid of it. foreach ($customs as $key => $custom) { if ($custom->extension === $extension) { unset($customs[$key]); } } // Set up config record for new type. $newtype = self::create_config_record($extension, $mimetype, $coreicon, $groups, $corestring, $customdescription, $defaulticon); // See if there's a default value with this extension. $needsadding = true; $defaults = self::get_default_types(); if (array_key_exists($extension, $defaults)) { // If it has the same values, we don't need to add it. $defaultvalue = $defaults[$extension]; $modified = (array)$newtype; unset($modified['extension']); ksort($defaultvalue); ksort($modified); if ($modified === $defaultvalue) { $needsadding = false; } } // Add to array and set in config. if ($needsadding) { $customs[] = $newtype; } self::set_custom_types($customs); } /** * Updates an entry in the list of filetypes in config. * * @param string $extension File extension without dot, e.g. 'doc' * @param string $newextension New file extension (same if not changing) * @param string $mimetype MIME type e.g. 'application/msword' * @param string $coreicon Core icon to use e.g. 'document' * @param array $groups Array of group strings that this type belongs to * @param string $corestring Custom lang string name in mimetypes.php * @param string $customdescription Custom description (plain text/multilang) * @param bool $defaulticon True if this should be the default icon for the type * @throws coding_exception If the new extension already exists, or otherwise invalid */ public static function update_type($extension, $newextension, $mimetype, $coreicon, array $groups = array(), $corestring = '', $customdescription = '', $defaulticon = false) { // Extension must exist. $extension = (string)$extension; $mimetypes = get_mimetypes_array(); if (!array_key_exists($extension, $mimetypes)) { throw new coding_exception('Extension ' . $extension . ' not found'); } // If there's a new extension then this must not exist. $newextension = (string)$newextension; if ($newextension !== $extension) { if ($newextension === '' || $newextension[0] === '.') { throw new coding_exception('Invalid extension .' . $newextension); } if (array_key_exists($newextension, $mimetypes)) { throw new coding_exception('Extension ' . $newextension . ' already exists'); } } // For default icon, check there isn't already something with default icon // set for that MIME type (unless it's this). if ($defaulticon) { foreach ($mimetypes as $ext => $type) { if ($ext !== $extension && $type['type'] === $mimetype && !empty($type['defaulticon'])) { throw new coding_exception('MIME type ' . $mimetype . ' already has a default icon set'); } } } // Delete the old extension and then add the new one (may be same). This // will correctly handle cases when a default type is involved. self::delete_type($extension); self::add_type($newextension, $mimetype, $coreicon, $groups, $corestring, $customdescription, $defaulticon); } /** * Deletes a file type from the config list (or, for a standard one, marks it * as deleted). * * @param string $extension File extension without dot, e.g. 'doc' * @throws coding_exception If the extension does not exist, or otherwise invalid */ public static function delete_type($extension) { // Extension must exist. $mimetypes = get_mimetypes_array(); if (!array_key_exists($extension, $mimetypes)) { throw new coding_exception('Extension ' . $extension . ' not found'); } // Get existing custom filetype list. $customs = self::get_custom_types(); // Remove any entries for this extension. foreach ($customs as $key => $custom) { if ($custom->extension === $extension && empty($custom->deleted)) { unset($customs[$key]); } } // If it was a standard entry (doesn't have 'custom' set) then add a // deleted marker. if (empty($mimetypes[$extension]['custom'])) { $customs[] = (object)array('extension' => $extension, 'deleted' => true); } // Save and reset cache. self::set_custom_types($customs); } /** * Reverts a file type to the default. May only be called on types that have * default values. This will undelete the type if necessary or set its values. * If the type is already at default values, does nothing. * * @param string $extension File extension without dot, e.g. 'doc' * @return bool True if anything was changed, false if it was already default * @throws coding_exception If the extension is not a default type. */ public static function revert_type_to_default($extension) { $extension = (string)$extension; // Check it actually is a default type. $defaults = self::get_default_types(); if (!array_key_exists($extension, $defaults)) { throw new coding_exception('Extension ' . $extension . ' is not a default type'); } // Loop through all the custom settings. $changed = false; $customs = self::get_custom_types(); foreach ($customs as $key => $customentry) { if ($customentry->extension === $extension) { unset($customs[$key]); $changed = true; } } // Save changes if any. if ($changed) { self::set_custom_types($customs); } return $changed; } /** * Converts function parameters into a record for storing in the JSON value. * * @param string $extension File extension without dot, e.g. 'doc' * @param string $mimetype MIME type e.g. 'application/msword' * @param string $coreicon Core icon to use e.g. 'document' * @param array $groups Array of group strings that this type belongs to * @param string $corestring Custom lang string name in mimetypes.php * @param string $customdescription Custom description (plain text/multilang) * @param bool $defaulticon True if this should be the default icon for the type * @return stdClass Record matching the parameters */ protected static function create_config_record($extension, $mimetype, $coreicon, array $groups, $corestring, $customdescription, $defaulticon) { // Construct new entry. $newentry = (object)array('extension' => (string)$extension, 'type' => (string)$mimetype, 'icon' => (string)$coreicon); if ($groups) { if (!is_array($groups)) { throw new coding_exception('Groups must be an array'); } foreach ($groups as $group) { if (!is_string($group)) { throw new coding_exception('Groups must be an array of strings'); } } $newentry->groups = $groups; } if ($corestring) { $newentry->string = (string)$corestring; } if ($customdescription) { $newentry->customdescription = (string)$customdescription; } if ($defaulticon) { $newentry->defaulticon = true; } return $newentry; } }