nur-sery/src/schema/input/Input.php

<?php
namespace nur\sery\schema\input;

#XXX available permet de préciser qu'une valeur doit exister et être non vide
# pour être considérée. en faire un paramètre, à moins que ce soit au niveau du
# type qu'il faille le gérer?
use nulib\cl;

/**
 * Class Input: accès à une valeur
 *
 * cette implémentation lit depuis et écrit dans une référence
 */
class Input {
  const ALLOW_EMPTY = true;

  function __construct(&$dest=null, ?array $params=null) {
    $this->dest =& $dest;
    $allowEmpty = cl::get($params, "allow_empty");
    if ($allowEmpty === null) $allowEmpty = static::ALLOW_EMPTY;
    $this->allowEmpty = $allowEmpty;
  }

  protected $dest;

  /** tester si la valeur existe sans tenir compte de $allowEmpty */
  function exits($key=null): bool {
    if ($key === null) return true;
    $dest = $this->dest;
    return $dest !== null && array_key_exists($key, $dest);
  }

  /**
   * @var bool comment considérer une chaine vide: "" si allowEmpty, null sinon
   */
  protected $allowEmpty;

  /** tester si la valeur est disponible en tenant compte de $allowEmpty */
  function available($key=null): bool {
    if ($key === null) return true;
    $dest = $this->dest;
    if ($dest === null || !array_key_exists($key, $dest)) return false;
    return $this->allowEmpty || $dest[$key] !== "";
  }

  function get($key=null) {
    $dest = $this->dest;
    if ($key === null) return $dest;
    if ($dest === null || !array_key_exists($key, $dest)) return null;
    $value = $dest[$key];
    if ($value === "" && !$this->allowEmpty) return null;
    return $value;
  }

  function set($value, $key=null): void {
    if ($key === null) $this->dest = $value;
    else $this->dest[$key] = $value;
  }
}