Page MenuHomeWickedGov Phorge
Files F4186765

RdbmsTypeHintsTest.php
No OneTemporary
Actions

Size
2 KB
Referenced Files
None
Subscribers
None

RdbmsTypeHintsTest.php
View Options

<?php
// phpcs:disable
/*
* Some RDBMS interfaces have methods with rather complicated Phan annotations. This test ensures
* that future versions of Phan still handle them correctly, and that future developers don't mess
* them up.
*
* If Phan reports new issues or unused suppressions in this file, DO NOT just fix the errors,
* and instead make sure that your patch is not breaking the annotations.
*/
die( 'This file should never be loaded' );
class RdbmsTypeHintsTest {
function testExpr( \Wikimedia\Rdbms\IDatabase $db ) {
$conds = [];
$expr = $db->expr( 'a', '=', 1 );
// Return value of ->and() etc. must be used
// @phan-suppress-next-line PhanPluginUseReturnValueKnown
$expr->and( 'a', '=', 1 );
// Typo in the operator
// @phan-suppress-next-line PhanTypeMismatchArgumentProbablyReal
$conds[] = $db->expr( 'a', '=<', 1 );
// We accept lots of types, but not all
// @phan-suppress-next-line PhanTypeMismatchArgumentProbablyReal
$conds[] = $db->expr( 'a', '=', new \stdClass );
// Empty arrays are not allowed
// @phan-suppress-next-line PhanTypeMismatchArgument
$conds[] = $db->expr( 'a', '=', [] );
// Null in arrays is not allowed (unlike in the `$qb->where( 'a' => [ ... ] )` syntax)
// @phan-suppress-next-line PhanTypeMismatchArgument
$conds[] = $db->expr( 'a', '=', [ 1, null, 2 ] );
// Associative arrays are not allowed
// @phan-suppress-next-line PhanTypeMismatchArgument
$conds[] = $db->expr( 'a', '=', [ 'a' => 1, 'b' => 2 ] );
// Arrays with gaps are not allowed (unlike in the `$qb->where( 'a' => [ ... ] )` syntax)
// @phan-suppress-next-line PhanTypeMismatchArgument
$conds[] = $db->expr( 'a', '=', array_unique( [ 1, 1, 2, 2 ] ) );
}
/**
* @suppress PhanParamTooFewInPHPDoc
*/
function testSelectConds( \Wikimedia\Rdbms\IDatabase $db ) {
// Missing key for array value
// @phan-suppress-next-line PhanTypeMismatchArgument
$db->select( 'a', 'b', [ [ 1, 2, 3 ] ] );
// Empty array value
// @phan-suppress-next-line PhanTypeMismatchArgument
$db->select( 'a', 'b', [ 'x' => [] ] );
// Unexpected key for IExpression value
// @phan-suppress-next-line PhanTypeMismatchArgument
$db->select( 'a', 'b', [ 'x' => $db->expr( 'x', '=', 1 ) ] );
// Nested array in array value
// @phan-suppress-next-line PhanTypeMismatchArgument
$db->select( 'a', 'b', [ 'x' => [ 1, 2, [ 3 ] ] ] );
// Associative arrays are not allowed
// @phan-suppress-next-line PhanTypeMismatchArgument
$db->select( 'a', 'b', [ 'x' => [ 'a' => 1, 'b' => 2 ] ] );
}
}

File Metadata

Mime Type
text/x-php
Expires
Aug 20 2026, 15:42 (11 w, 5 d ago)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
bd/91/0e37bb35a6e562ba11ed8fac3f99
Default Alt Text
RdbmsTypeHintsTest.php (2 KB)

Event Timeline