Page MenuHomeWickedGov Phorge
Files F1432519

ContentHandlerFactory.php
No OneTemporary
Actions

Size
5 KB
Referenced Files
None
Subscribers
None

ContentHandlerFactory.php
View Options

<?php
/**
* @license GPL-2.0-or-later
* @file
*/
namespace MediaWiki\Content;
use InvalidArgumentException;
use MediaWiki\Exception\MWUnknownContentModelException;
use MediaWiki\HookContainer\HookContainer;
use MediaWiki\HookContainer\HookRunner;
use Psr\Log\LoggerInterface;
use Wikimedia\ObjectFactory\ObjectFactory;
/**
* @since 1.35
* @ingroup Content
* @author Art Baltai
*/
final class ContentHandlerFactory implements IContentHandlerFactory {
/**
* @var string[]|callable[]
*/
private $handlerSpecs;
/**
* @var ContentHandler[] Registry of ContentHandler instances by model id
*/
private $handlersByModel = [];
private ObjectFactory $objectFactory;
private HookRunner $hookRunner;
private LoggerInterface $logger;
/**
* @since 1.35
* @internal Please use MediaWikiServices::getContentHandlerFactory instead
*
* @param string[]|callable[] $handlerSpecs An associative array mapping each known
* content model to the ObjectFactory spec used to construct its ContentHandler.
* This array typically comes from $wgContentHandlers.
* @param ObjectFactory $objectFactory
* @param HookContainer $hookContainer
* @param LoggerInterface $logger
*/
public function __construct(
array $handlerSpecs,
ObjectFactory $objectFactory,
HookContainer $hookContainer,
LoggerInterface $logger
) {
$this->handlerSpecs = $handlerSpecs;
$this->objectFactory = $objectFactory;
$this->hookRunner = new HookRunner( $hookContainer );
$this->logger = $logger;
}
/**
* @param string $modelID
*
* @return ContentHandler
* @throws MWUnknownContentModelException If no handler is known for the model ID.
*/
public function getContentHandler( string $modelID ): ContentHandler {
if ( empty( $this->handlersByModel[$modelID] ) ) {
$contentHandler = $this->createForModelID( $modelID );
$this->logger->info(
"Registered handler for {$modelID}: " . get_class( $contentHandler )
);
$this->handlersByModel[$modelID] = $contentHandler;
}
return $this->handlersByModel[$modelID];
}
/**
* Define HandlerSpec for ModelID.
* @param string $modelID
* @param callable|string $handlerSpec
*
* @internal
*/
public function defineContentHandler( string $modelID, $handlerSpec ): void {
if ( !is_callable( $handlerSpec ) && !is_string( $handlerSpec ) ) {
throw new InvalidArgumentException(
"ContentHandler Spec for modelID '{$modelID}' must be callable or class name"
);
}
unset( $this->handlersByModel[$modelID] );
$this->handlerSpecs[$modelID] = $handlerSpec;
}
/**
* Get defined ModelIDs
*
* @return string[]
*/
public function getContentModels(): array {
$modelsFromHook = [];
$this->hookRunner->onGetContentModels( $modelsFromHook );
$models = array_merge( // auto-registered from config and MediaWikiServices or manual
array_keys( $this->handlerSpecs ),
// incorrect registered and called: without HOOK_NAME_GET_CONTENT_MODELS
array_keys( $this->handlersByModel ),
// correct registered: as HOOK_NAME_GET_CONTENT_MODELS
$modelsFromHook );
return array_unique( $models );
}
/**
* @return string[]
*/
public function getAllContentFormats(): array {
$formats = [];
foreach ( $this->handlerSpecs as $model => $class ) {
$formats += array_fill_keys(
$this->getContentHandler( $model )->getSupportedFormats(),
true );
}
return array_keys( $formats );
}
public function isDefinedModel( string $modelID ): bool {
return in_array( $modelID, $this->getContentModels(), true );
}
/**
* Create ContentHandler for ModelID
*
* @param string $modelID The ID of the content model for which to get a handler.
* Use CONTENT_MODEL_XXX constants.
*
* @return ContentHandler The ContentHandler singleton for handling the model given by the ID.
*
* @throws MWUnknownContentModelException If no handler is known for the model ID.
*/
private function createForModelID( string $modelID ): ContentHandler {
$handlerSpec = $this->handlerSpecs[$modelID] ?? null;
if ( $handlerSpec !== null ) {
return $this->createContentHandlerFromHandlerSpec( $modelID, $handlerSpec );
}
return $this->createContentHandlerFromHook( $modelID );
}
/**
* @param string $modelID
* @param ContentHandler $contentHandler
*
* @throws MWUnknownContentModelException
*/
private function validateContentHandler( string $modelID, $contentHandler ): void {
if ( $contentHandler === null ) {
throw new MWUnknownContentModelException( $modelID );
}
if ( !is_object( $contentHandler ) ) {
throw new InvalidArgumentException(
"ContentHandler for model {$modelID} wrong: non-object given."
);
}
if ( !$contentHandler instanceof ContentHandler ) {
throw new InvalidArgumentException(
"ContentHandler for model {$modelID} must supply a ContentHandler instance, "
. get_class( $contentHandler ) . ' given.'
);
}
}
/**
* @param string $modelID
* @param callable|string $handlerSpec
*
* @return ContentHandler
* @throws MWUnknownContentModelException
*/
private function createContentHandlerFromHandlerSpec(
string $modelID, $handlerSpec
): ContentHandler {
/**
* @var ContentHandler $contentHandler
*/
$contentHandler = $this->objectFactory->createObject(
$handlerSpec,
[
'assertClass' => ContentHandler::class,
'allowCallable' => true,
'allowClassName' => true,
'extraArgs' => [ $modelID ],
]
);
$this->validateContentHandler( $modelID, $contentHandler );
return $contentHandler;
}
/**
* @param string $modelID
*
* @return ContentHandler
* @throws MWUnknownContentModelException
*/
private function createContentHandlerFromHook( string $modelID ): ContentHandler {
$contentHandler = null;
// @phan-suppress-next-line PhanTypeMismatchArgument Type mismatch on pass-by-ref args
$this->hookRunner->onContentHandlerForModelID( $modelID, $contentHandler );
$this->validateContentHandler( $modelID, $contentHandler );
'@phan-var ContentHandler $contentHandler';
return $contentHandler;
}
}

File Metadata

Mime Type
text/x-php
Expires
Sat, May 16, 21:53 (1 d, 3 h)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
42/b5/180e5ccd2bdf907a3853c2b203ec
Default Alt Text
ContentHandlerFactory.php (5 KB)

Event Timeline