1 files changed, 81 insertions, 0 deletions
diff --git a/www/wiki/includes/api/ApiValidatePassword.php b/www/wiki/includes/api/ApiValidatePassword.php
new file mode 100644
index 00000000..943149da
--- /dev/null
+++ b/www/wiki/includes/api/ApiValidatePassword.php
@@ -0,0 +1,81 @@
+<?php
+
+use MediaWiki\Auth\AuthManager;
+
+/**
+ * @ingroup API
+ */
+class ApiValidatePassword extends ApiBase {
+
+	public function execute() {
+		$params = $this->extractRequestParams();
+
+		// For sanity
+		$this->requirePostedParameters( [ 'password' ] );
+
+		if ( $params['user'] !== null ) {
+			$user = User::newFromName( $params['user'], 'creatable' );
+			if ( !$user ) {
+				$encParamName = $this->encodeParamName( 'user' );
+				$this->dieWithError(
+					[ 'apierror-baduser', $encParamName, wfEscapeWikiText( $params['user'] ) ],
+					"baduser_{$encParamName}"
+				);
+			}
+
+			if ( !$user->isAnon() || AuthManager::singleton()->userExists( $user->getName() ) ) {
+				$this->dieWithError( 'userexists' );
+			}
+
+			$user->setEmail( (string)$params['email'] );
+			$user->setRealName( (string)$params['realname'] );
+		} else {
+			$user = $this->getUser();
+		}
+
+		$validity = $user->checkPasswordValidity( $params['password'] );
+		$r['validity'] = $validity->isGood() ? 'Good' : ( $validity->isOK() ? 'Change' : 'Invalid' );
+		$messages = array_merge(
+			$this->getErrorFormatter()->arrayFromStatus( $validity, 'error' ),
+			$this->getErrorFormatter()->arrayFromStatus( $validity, 'warning' )
+		);
+		if ( $messages ) {
+			$r['validitymessages'] = $messages;
+		}
+
+		Hooks::run( 'ApiValidatePassword', [ $this, &$r ] );
+
+		$this->getResult()->addValue( null, $this->getModuleName(), $r );
+	}
+
+	public function mustBePosted() {
+		return true;
+	}
+
+	public function getAllowedParams() {
+		return [
+			'password' => [
+				ApiBase::PARAM_TYPE => 'password',
+				ApiBase::PARAM_REQUIRED => true
+			],
+			'user' => [
+				ApiBase::PARAM_TYPE => 'user',
+			],
+			'email' => null,
+			'realname' => null,
+		];
+	}
+
+	protected function getExamplesMessages() {
+		return [
+			'action=validatepassword&password=foobar'
+				=> 'apihelp-validatepassword-example-1',
+			'action=validatepassword&password=querty&user=Example'
+				=> 'apihelp-validatepassword-example-2',
+		];
+	}
+
+	public function getHelpUrls() {
+		return 'https://www.mediawiki.org/wiki/Special:MyLanguage/API:Validatepassword';
+	}
+}