NamespaceDef.php

Go to the documentation of this file.

<?php
 
namespace MediaWiki\ParamValidator\TypeDef;
 
use ApiResult;
use NamespaceInfo;
use Wikimedia\ParamValidator\Callbacks;
use Wikimedia\ParamValidator\ParamValidator;
use Wikimedia\ParamValidator\TypeDef\EnumDef;
 
class NamespaceDef extends EnumDef {
 
    public const PARAM_EXTRA_NAMESPACES = 'param-extra-namespaces';
 
    private $nsInfo;
 
    public function __construct( Callbacks $callbacks, NamespaceInfo $nsInfo ) {
        parent::__construct( $callbacks );
        $this->nsInfo = $nsInfo;
    }
 
    public function validate( $name, $value, array $settings, array $options ) {
        if ( !is_int( $value ) && preg_match( '/^[+-]?\d+$/D', $value ) ) {
            // Convert to int since that's what getEnumValues() returns.
            $value = (int)$value;
        }
 
        return parent::validate( $name, $value, $settings, $options );
    }
 
    public function getEnumValues( $name, array $settings, array $options ) {
        $namespaces = $this->nsInfo->getValidNamespaces();
        $extra = $settings[self::PARAM_EXTRA_NAMESPACES] ?? [];
        if ( is_array( $extra ) && $extra !== [] ) {
            $namespaces = array_merge( $namespaces, $extra );
        }
        sort( $namespaces );
        return $namespaces;
    }
 
    public function normalizeSettings( array $settings ) {
        // Force PARAM_ALL
        if ( !empty( $settings[ParamValidator::PARAM_ISMULTI] ) ) {
            $settings[ParamValidator::PARAM_ALL] = true;
        }
        return parent::normalizeSettings( $settings );
    }
 
    public function checkSettings( string $name, $settings, array $options, array $ret ): array {
        $ret = parent::checkSettings( $name, $settings, $options, $ret );
 
        $ret['allowedKeys'] = array_merge( $ret['allowedKeys'], [
            self::PARAM_EXTRA_NAMESPACES,
        ] );
 
        if ( !empty( $settings[ParamValidator::PARAM_ISMULTI] ) &&
            ( $settings[ParamValidator::PARAM_ALL] ?? true ) !== true &&
            !isset( $ret['issues'][ParamValidator::PARAM_ALL] )
        ) {
            $ret['issues'][ParamValidator::PARAM_ALL] =
                'PARAM_ALL cannot be false or a string for namespace-type parameters';
        }
 
        $ns = $settings[self::PARAM_EXTRA_NAMESPACES] ?? [];
        if ( !is_array( $ns ) ) {
            $type = gettype( $ns );
        } elseif ( $ns === [] ) {
            $type = 'integer[]';
        } else {
            $types = array_unique( array_map( 'gettype', $ns ) );
            $type = implode( '|', $types );
            $type = count( $types ) > 1 ? "($type)[]" : "{$type}[]";
        }
        if ( $type !== 'integer[]' ) {
            $ret['issues'][self::PARAM_EXTRA_NAMESPACES] =
                "PARAM_EXTRA_NAMESPACES must be an integer[], got $type";
        }
 
        return $ret;
    }
 
    public function getParamInfo( $name, array $settings, array $options ) {
        $info = parent::getParamInfo( $name, $settings, $options );
 
        $info['type'] = 'namespace';
        $extra = $settings[self::PARAM_EXTRA_NAMESPACES] ?? [];
        if ( is_array( $extra ) && $extra !== [] ) {
            $info['extranamespaces'] = array_values( $extra );
            if ( isset( $options['module'] ) ) {
                // ApiResult metadata when used with the Action API.
                ApiResult::setIndexedTagName( $info['extranamespaces'], 'ns' );
            }
        }
 
        return $info;
    }
 
}