diff options
Diffstat (limited to 'www/wiki/includes/media/MediaHandlerFactory.php')
-rw-r--r-- | www/wiki/includes/media/MediaHandlerFactory.php | 101 |
1 files changed, 101 insertions, 0 deletions
diff --git a/www/wiki/includes/media/MediaHandlerFactory.php b/www/wiki/includes/media/MediaHandlerFactory.php new file mode 100644 index 00000000..543dc80d --- /dev/null +++ b/www/wiki/includes/media/MediaHandlerFactory.php @@ -0,0 +1,101 @@ +<?php +/** + * Media-handling base classes and generic functionality. + * + * This program 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 2 of the License, or + * (at your option) any later version. + * + * This program 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 this program; if not, write to the Free Software Foundation, Inc., + * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. + * http://www.gnu.org/copyleft/gpl.html + * + * @file + * @ingroup Media + */ + +/** + * Class to construct MediaHandler objects + * + * @since 1.28 + */ +class MediaHandlerFactory { + + /** + * Default, MediaWiki core media handlers + * + * @var array + */ + private static $coreHandlers = [ + 'image/jpeg' => JpegHandler::class, + 'image/png' => PNGHandler::class, + 'image/gif' => GIFHandler::class, + 'image/tiff' => TiffHandler::class, + 'image/webp' => WebPHandler::class, + 'image/x-ms-bmp' => BmpHandler::class, + 'image/x-bmp' => BmpHandler::class, + 'image/x-xcf' => XCFHandler::class, + 'image/svg+xml' => SvgHandler::class, // official + 'image/svg' => SvgHandler::class, // compat + 'image/vnd.djvu' => DjVuHandler::class, // official + 'image/x.djvu' => DjVuHandler::class, // compat + 'image/x-djvu' => DjVuHandler::class, // compat + ]; + + /** + * @var array + */ + private $registry; + + /** + * Instance cache of MediaHandler objects by mimetype + * + * @var MediaHandler[] + */ + private $handlers; + + public function __construct( array $registry ) { + $this->registry = $registry + self::$coreHandlers; + } + + protected function getHandlerClass( $type ) { + if ( isset( $this->registry[$type] ) ) { + return $this->registry[$type]; + } else { + return false; + } + } + + /** + * @param string $type mimetype + * @return bool|MediaHandler + */ + public function getHandler( $type ) { + if ( isset( $this->handlers[$type] ) ) { + return $this->handlers[$type]; + } + + $class = $this->getHandlerClass( $type ); + if ( $class !== false ) { + /** @var MediaHandler $handler */ + $handler = new $class; + if ( !$handler->isEnabled() ) { + wfDebug( __METHOD__ . ": $class is not enabled\n" ); + $handler = false; + } + } else { + wfDebug( __METHOD__ . ": no handler found for $type.\n" ); + $handler = false; + } + + $this->handlers[$type] = $handler; + return $handler; + } +} |