1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
|
<?php
namespace MediaWiki\Rest;
use LogicException;
/**
* A handler base class which unpacks parameters from the path template and
* passes them as formal parameters to run().
*
* run() must be declared in the subclass. It cannot be declared as abstract
* here because it has a variable parameter list.
*
* @stable to extend
* @package MediaWiki\Rest
*/
abstract class SimpleHandler extends Handler {
public function execute() {
$paramSettings = $this->getParamSettings();
$validatedParams = $this->getValidatedParams();
$unvalidatedParams = [];
$params = [];
foreach ( $this->getRequest()->getPathParams() as $name => $value ) {
$source = $paramSettings[$name][self::PARAM_SOURCE] ?? 'unknown';
if ( $source !== 'path' ) {
$unvalidatedParams[] = $name;
$params[] = $value;
} else {
$params[] = $validatedParams[$name];
}
}
if ( $unvalidatedParams ) {
throw new LogicException(
'Path parameters were not validated: ' . implode( ', ', $unvalidatedParams )
);
}
// @phan-suppress-next-line PhanUndeclaredMethod
return $this->run( ...$params );
}
}
|