Add coalesce filtering

[bakura10]

@Ocramius that was the idea

[Ocramius]

@bakura10 it's very near to what I was suggesting as well.

I'd suggest using a key that is not a valid property name (such as $in, since $$in is not a valid variable declaration symbol), which prevents collisions.

Additionally, why not extending it to all searchable fields?

[coveralls]

Coverage decreased (-3.61%) when pulling 12a3c11 on id into ea12a93 on master.

[bakura10]

How do you define a searchable field? The issue is that some people could try to filter by arbitrary key and making your database suffer if field is not indexed. By only restricting to "ids" (which is what you want often), it ensures filtering is done on an indexed fields. Regarding filtering arbitrary fields, we already have this through the Paginator plugin: https://github.com/zf-fr/zfr-rest/blob/master/src/ZfrRest/Mvc/Controller/Plugin/PaginatorWrapper.php#L68

But at least, you have full control over which fields make searchable.

[coveralls]

Coverage decreased (-3.37%) when pulling 12a3c11 on id into ea12a93 on master.

[Ocramius]

But at least, you have full control over which fields make searchable.

Good point. I think restricting by ID is fine for now then, but we may need to open an issue to support the other cases as well ("searchable" property in mappings?)

[bakura10]

Yep, the searchable mapping is a very nice idea.

Anyway, tests and docs were added. Ready for final review!

[Ocramius]

@bakura10 can you simply add the isSearchable or such to the mappings, and simply forward it to hasIdentifier for now?

[Ocramius]

$ids plox

[bakura10]

isn't this strange?

[Ocramius]

The point is having something that EXPLICITLY cannot be an entity field: the regex for valid property names is something like /([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]+)/: the default value provided by zfr-rest should not match against this regex.

[coveralls]

Coverage increased (+0.16%) when pulling 34638f7 on id into c31696b on master.

[coveralls]

Coverage increased (+0.16%) when pulling 34638f7 on id into c31696b on master.