Page MenuHomeWickedGov Phorge
Files F5985463

AbstractSchemaValidator.php
No OneTemporary
Actions

Size
3 KB
Referenced Files
None
Subscribers
None

AbstractSchemaValidator.php
View Options

<?php
/**
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
namespace MediaWiki\DB;
use JsonSchema\Validator;
use Seld\JsonLint\DuplicateKeyException;
use Seld\JsonLint\JsonParser;
use Seld\JsonLint\ParsingException;
use function class_exists;
use function file_get_contents;
use function is_array;
use function is_object;
/**
* Validate abstract schema json files against their JSON schema.
*
* This is used for static validation from the command-line via
* generateSchemaSql.php, generateSchemaChangeSql, and the PHPUnit structure test suite
* (AbstractSchemaValidationTest).
*
* The files are normally read by the generateSchemaSql.php and generateSchemaSqlChange.php maintenance scripts.
*
* @since 1.38
*/
class AbstractSchemaValidator {
/**
* @var callable(string):void
*/
private $missingDepCallback;
/**
* @param callable(string):void $missingDepCallback
*/
public function __construct( callable $missingDepCallback ) {
$this->missingDepCallback = $missingDepCallback;
}
/**
* @codeCoverageIgnore
* @return bool
*/
public function checkDependencies(): bool {
if ( !class_exists( Validator::class ) ) {
( $this->missingDepCallback )(
'The JsonSchema library cannot be found, please install it through composer.'
);
return false;
}
if ( !class_exists( JsonParser::class ) ) {
( $this->missingDepCallback )(
'The JSON lint library cannot be found, please install it through composer.'
);
return false;
}
return true;
}
/**
* @param string $path file to validate
* @return bool true if passes validation
* @throws AbstractSchemaValidationError on any failure
*/
public function validate( string $path ): bool {
$contents = file_get_contents( $path );
$jsonParser = new JsonParser();
try {
$data = $jsonParser->parse( $contents, JsonParser::DETECT_KEY_CONFLICTS );
} catch ( DuplicateKeyException $e ) {
throw new AbstractSchemaValidationError( $e->getMessage(), $e->getCode(), $e );
} catch ( ParsingException $e ) {
throw new AbstractSchemaValidationError( "$path is not valid JSON", $e->getCode(), $e );
}
// Regular schema's are arrays, schema changes are objects.
if ( is_array( $data ) ) {
$schemaPath = __DIR__ . '/../../docs/abstract-schema.schema.json';
} elseif ( is_object( $data ) ) {
$schemaPath = __DIR__ . '/../../docs/abstract-schema-changes.schema.json';
} else {
throw new AbstractSchemaValidationError( "$path is not a supported JSON object" );
}
$validator = new Validator;
$validator->check( $data, (object)[ '$ref' => 'file://' . $schemaPath ] );
if ( $validator->isValid() ) {
// All good.
return true;
}
$out = "$path did not pass validation.\n";
foreach ( $validator->getErrors() as $error ) {
$out .= "[{$error['property']}] {$error['message']}\n";
}
throw new AbstractSchemaValidationError( $out );
}
}

File Metadata

Mime Type
text/x-php
Expires
Sat, Oct 3, 23:47 (2 w, 3 d ago)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
67/20/94e5835ed63c44639e3215477b4e
Default Alt Text
AbstractSchemaValidator.php (3 KB)

Event Timeline