nur-sery/nur_src/b/params/_Tparametrable0.php

<?php
namespace nur\b\params;

use nur\A;
use nur\data\types\md_utils;
use nur\data\types\Metadata;

/**
 * Trait _Tparametrable0: implémentation partagée entre {@link Tparametrable1}
 * et {@link Tparametrable} qui doit toujours être écrasée dans les classes
 * dérivées (i.e si les méthodes définies ici sont surchargées, elle ne seront
 * pas disponibles dans les classes dérivées parce qu'écrasées par la directive
 * `use Tparametrable`)
 */
trait _Tparametrable0 {
  static function _get_parametrable_params_schema(): array {
    return self::PARAMETRABLE_PARAMS_SCHEMA;
  }

  private static $parametrable_params_md;
  private static function parametrable_params_md(): Metadata {
    return md_utils::ensure_md(self::$parametrable_params_md
      , self::_get_parametrable_params_schema());
  }

  static function get_parametrable_params_schema(): array {
    return self::parametrable_params_md()->getSchema();
  }

  /**
   * initialiser dans $params les valeurs de $defaults si:
   * - elles ne sont pas nulles (avec $ignoreNulls == true)
   * - elles ne sont pas déjà définies dans $params
   */
  static function set_parametrable_params_defaults(?array &$params, ?array $defaults, bool $ignoreNulls=true): void {
    if ($defaults === null) return;
    foreach ($defaults as $key => $value) {
      if ($value !== null || !$ignoreNulls) {
        A::replace_nx($params, $key, $value);
      }
    }
  }

  function setParametrableParams(?array $params): void {
    $parametrables = $this->getParametrableParamsParametrables();
    $md = self::parametrable_params_md();
    $modifiedKeys = parametrable_utils::set_params($parametrables, $this, $params, $md);
    $this->afterSetParametrableParams($modifiedKeys, $md);
  }

  protected static function was_parametrable_param_modified(array $modifiedKeys, string ...$keys): bool {
    foreach ($modifiedKeys as $key) {
      if (in_array($key, $keys)) return true;
    }
    return false;
  }

  function initParametrableParams(?array $params, bool $setParametrableParams=true): void {
    $parametrables = $this->getParametrableParamsParametrables();
    parametrable_utils::set_defaults($parametrables, $this, self::parametrable_params_md());
    if ($setParametrableParams) $this->setParametrableParams($params);
  }

  /**
   * splitter $params en deux tableaux: les paramètres définis et les autres.
   * ceci n'est utile que si l'on veut traiter à part ces valeurs.
   */
  static function split_parametrable_params(?array $params=null): array {
    if ($params === null) return [null, []];
    $md = self::parametrable_params_md();
    $others = $md->getOthers($params);
    $params = $md->getValues($params);
    return [$params, $others];
  }

  protected function splitParametrableParams(?array $params): array {
    return self::split_parametrable_params($params);
  }

  /**
   * implémentation par défaut à utiliser dans une méthode __call()
   *
   * la constante _AUTO_SETTERS doit être définie.
   *
   * retourner true si la méthode a été appelée, false si elle n'est pas gérée
   * par cette méthode
   *
   * utiliser de cette manière:
   *   function __call(string $name, array $args) {
   *     if ($this->parametrable__call($name, $args, $result)) return $result;
   *     ....
   *     throw IllegalAccessException::not_implemented($name);
   *   }
   */
  function parametrable__call(string $name, array $args, &$result): bool {
    $md = self::parametrable_params_md();
    $auto_getters = self::_AUTO_GETTERS;
    $auto_setters = self::_AUTO_SETTERS;
    if (parametrable_utils::should_call($name, $auto_getters, $auto_setters, $md)) {
      $result = parametrable_utils::call($this, $name, $args, $auto_getters, $auto_setters, $md);
      return true;
    }
    return false;
  }
}