74 lines
1.7 KiB
PHP
74 lines
1.7 KiB
PHP
|
<?php
|
||
|
|
|
||
|
|
namespace MediaWiki\User\TempUser;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Helper for TempUserConfig representing string patterns with "$1" indicating
|
||
|
|
* variable substitution.
|
||
|
|
*
|
||
|
|
* @internal
|
||
|
|
*/
|
||
|
|
class Pattern {
|
||
|
|
/** @var string */
|
||
|
|
private $debugName;
|
||
|
|
/** @var string */
|
||
|
|
private $pattern;
|
||
|
|
/** @var string */
|
||
|
|
private $prefix;
|
||
|
|
/** @var string */
|
||
|
|
private $suffix;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @param string $debugName The name of the pattern, for use in error messages
|
||
|
|
* @param string $pattern The pattern itself
|
||
|
|
*/
|
||
|
|
public function __construct( string $debugName, string $pattern ) {
|
||
|
|
$this->debugName = $debugName;
|
||
|
|
$this->pattern = $pattern;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Does the pattern match the given name?
|
||
|
|
* @param string $name
|
||
|
|
* @return bool
|
||
|
|
*/
|
||
|
|
public function isMatch( string $name ) {
|
||
|
|
$this->init();
|
||
|
|
$match = true;
|
||
|
|
if ( $this->prefix !== '' ) {
|
||
|
|
$match = str_starts_with( $name, $this->prefix );
|
||
|
|
}
|
||
|
|
if ( $match && $this->suffix !== '' ) {
|
||
|
|
$match = str_ends_with( $name, $this->suffix )
|
||
|
|
&& strlen( $name ) >= strlen( $this->prefix ) + strlen( $this->suffix );
|
||
|
|
}
|
||
|
|
return $match;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Substitute the serial number into the pattern.
|
||
|
|
*
|
||
|
|
* @param string $mappedSerial
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public function generate( $mappedSerial ) {
|
||
|
|
$this->init();
|
||
|
|
return $this->prefix . $mappedSerial . $this->suffix;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Initialise the prefix and suffix
|
||
|
|
*/
|
||
|
|
private function init() {
|
||
|
|
if ( $this->prefix === null ) {
|
||
|
|
$varPos = strpos( $this->pattern, '$1' );
|
||
|
|
if ( $varPos === false ) {
|
||
|
|
throw new \MWException( __CLASS__ .
|
||
|
|
"pattern {$this->debugName} must be of the form \"prefix \$1 suffix\"" );
|
||
|
|
}
|
||
|
|
$this->prefix = substr( $this->pattern, 0, $varPos );
|
||
|
|
$this->suffix = substr( $this->pattern, $varPos + strlen( '$1' ) );
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|