rex_type::cast: Explizite Angabe der möglichen Werte möglich

[gharlan]

closes #5848

Bei rex_get(), rex_post() etc. ist es neu möglich, explizit die möglichen Werte anzugeben:

$value = rex_get('mykey', ['foo', 'bar', 'baz']);

• $value ist danach definitiv einer der drei Werte.
• Wenn mykey nicht gesetzt ist, oder einen anderen Wert enthält, dann wird $value den ersten Wert aus dem Array erhalten (also 'foo'). Das ist konsistent zu dem Verhalten bei anderen Cast-Typen.
• Optional kann aber auch ein anderer Default-Wert angegeben werden (der nicht im Array sein muss), z.b. null:

  $value = rex_get('mykey', ['foo', 'bar', 'baz'], null);

• Es können auch Int-Werte im Array sein:

  $value = rex_get('mykey', [10, 20, 50, 100]);

[gharlan]

Mir fällt noch ein, dass es auch mit Enums funktionieren sollte:

enum View: string {
    case Grid = 'grid';
    case List = 'list';
}

$view = rex_get('view', View::cases());

Hier sollte $view anschließend eines der Enum-"Objekte" sein. Passe den PR noch entsprechend an.

Edit: erledigt.

[gharlan]

Man kann es übrigens auch verschachtelt in Array-Shapes nutzen:

$options = rex_post('options', [
    ['foo', 'int', 2],
    ['view', ['grid', 'list']],
]);

$options ist danach ein Array mit den beiden Keys foo (irgendein integer) und view (einer der beiden Werte).