type, mirroring getMetadataFieldDefs() output. */ private const TYPES = [ 'title' => 'text', 'rating' => 'text', 'tags' => 'tags', 'featured' => 'boolean', ]; private MediaController $controller; protected function setUp(): void { // parseFilterClause / sanitizeFilterValue are pure — no Grav container. $this->controller = (new ReflectionClass(MediaController::class))->newInstanceWithoutConstructor(); } /** @return array{0: string, 1: string, 2: string|list}|null */ private function parse(string $clause): ?array { $ref = new ReflectionClass(MediaController::class); $method = $ref->getMethod('parseFilterClause'); return $method->invoke($this->controller, $clause, self::TYPES, 2000); } #[Test] public function three_part_clause_parses_field_operator_value(): void { $this->assertSame(['rating', '>=', '3'], $this->parse('rating:>=:3')); } #[Test] public function two_part_clause_infers_operator_from_type(): void { // text field defaults to equality... $this->assertSame(['rating', '==', '3'], $this->parse('rating:3')); // ...a tags field defaults to membership. $this->assertSame(['tags', 'contains', 'sunset'], $this->parse('tags:sunset')); } #[Test] public function value_may_contain_colons(): void { // explode(limit: 3) keeps colons in the value intact. $this->assertSame(['title', '==', 'a:b:c'], $this->parse('title:==:a:b:c')); } #[Test] public function in_operator_splits_value_into_a_set(): void { $this->assertSame(['tags', 'in', ['city', 'mountain']], $this->parse('tags:in:city,mountain')); } #[Test] public function unknown_field_is_ignored_leniently(): void { $this->assertNull($this->parse('bogus:==:x')); } #[Test] public function unsupported_operator_is_rejected(): void { $this->expectException(ValidationException::class); $this->parse('rating:~=:3'); } #[Test] public function tags_field_rejects_scalar_operator(): void { $this->expectException(ValidationException::class); $this->parse('tags:>:3'); } #[Test] public function malformed_field_name_is_rejected(): void { $this->expectException(ValidationException::class); $this->parse('bad field!:==:x'); } #[Test] public function value_is_stripped_of_tags(): void { // strip_tags removes markup; the parser never emits raw HTML. $this->assertSame(['title', '==', 'hello'], $this->parse('title:==:hello')); } #[Test] public function boolean_filter_value_becomes_a_real_bool(): void { // A boolean is stored natively, so `?filter=featured:true` has to // compare against `true` rather than the string 'true'. $this->assertSame(['featured', '==', true], $this->parse('featured:true')); $this->assertSame(['featured', '==', true], $this->parse('featured:1')); $this->assertSame(['featured', '==', false], $this->parse('featured:false')); $this->assertSame(['featured', '==', false], $this->parse('featured:0')); } #[Test] public function boolean_in_filter_coerces_each_value(): void { $this->assertSame(['featured', 'in', [true, false]], $this->parse('featured:in:1,0')); } #[Test] public function boolean_filter_rejects_another_value(): void { $this->expectException(ValidationException::class); $this->parse('featured:yes'); } }