wmde / WikibaseDataModelServices

src/Statement/StatementGuidValidator.php

<?php

namespace Wikibase\DataModel\Services\Statement;

use Wikibase\DataModel\Entity\EntityIdParser;
use Wikibase\DataModel\Entity\EntityIdParsingException;
use Wikibase\DataModel\Statement\StatementGuid;

/**
 * @since 1.1
 *
 * @license GPL-2.0-or-later
 * @author Katie Filbert < aude.wiki@gmail.com >
 */
class StatementGuidValidator {

	/**
	 * @var EntityIdParser
	 */
	private $entityIdParser;

	public function __construct( EntityIdParser $entityIdParser ) {
		$this->entityIdParser = $entityIdParser;
	}

	/**
	 * Validates a statement guid
	 *
	 * @since 0.4
	 *
	 * @param string $guid
	 *
	 * @return bool
	 */
	public function validate( $guid ) {
		if ( !$this->validateFormat( $guid ) ) {
			return false;
		}

		$guidParts = explode( StatementGuid::SEPARATOR, $guid );

		if ( !$this->validateStatementGuidPrefix( $guidParts[0] ) || !$this->validateGuid( $guidParts[1] ) ) {
			return false;
		}

		return true;
	}

	/**
	 * Basic validation for statement guid format
	 *
	 * @since 0.4
	 *
	 * @param string $guid
	 *
	 * @return bool
	 */
	public function validateFormat( $guid ) {
		if ( !is_string( $guid ) ) {

The condition is_string($guid) is always true.

			return false;
		}

		$keyParts = explode( '$', $guid );

		if ( count( $keyParts ) !== 2 ) {
			return false;
		}

		return true;
	}

	/**
	 * Validate the second part of a statement guid, after the $
	 *
	 * @since 0.4
	 *
	 * @param string $guid
	 *
	 * @return bool
	 */
	private function validateGuid( $guid ) {
		return (bool)preg_match(
			'/^\{?[A-Z\d]{8}-[A-Z\d]{4}-[A-Z\d]{4}-[A-Z\d]{4}-[A-Z\d]{12}\}?\z/i',
			$guid
		);
	}

	/**
	 * Validate the statement guid prefix is a valid entity id
	 *
	 * @since 0.4
	 *
	 * @param string $prefixedId
	 *
	 * @return bool
	 */
	private function validateStatementGuidPrefix( $prefixedId ) {
		try {
			$this->entityIdParser->parse( $prefixedId );
			return true;
		} catch ( EntityIdParsingException ) {
			return false;
		}
	}

}