From 60ab13ff84416fd68dfcad97c8f1e3a0095ea390 Mon Sep 17 00:00:00 2001
From: Jephte Clain <Jephte.Clain@univ-reunion.fr>
Date: Fri, 28 Mar 2025 15:39:05 +0400
Subject: [PATCH] modifs.mineures sans commentaires

---
 php/src/ref/schema/ref_input.php  | 42 +++++++++++++++++++++++++++++++
 php/src/ref/schema/ref_schema.php | 20 +++++++++++++++
 2 files changed, 62 insertions(+)
 create mode 100644 php/src/ref/schema/ref_input.php

diff --git a/php/src/ref/schema/ref_input.php b/php/src/ref/schema/ref_input.php
new file mode 100644
index 0000000..b7b00b9
--- /dev/null
+++ b/php/src/ref/schema/ref_input.php
@@ -0,0 +1,42 @@
+<?php
+namespace nulib\ref\schema;
+
+class ref_input {
+  const ACCESS_AUTO = 0, ACCESS_KEY = 1, ACCESS_PROPERTY = 2;
+
+  const INPUT_PARAMS_SCHEMA = [
+    "access_type" => ["int", self::ACCESS_AUTO, "type d'accès: clé ou propriété"],
+    "allow_empty" => ["bool", true, "la chaine vide est-elle autorisée?"],
+    "allow_null" => ["bool", true, "la valeur null est-elle autorisée?"],
+  ];
+
+  const ACCESS_PARAMS_SCHEMA = [
+    "allow_empty" => ["bool", true, "la chaine vide est-elle autorisée?"],
+    "allow_null" => ["bool", null, "la valeur null est-elle autorisée?"],
+    "allow_false" => ["bool", null, "la valeur false est-elle autorisée?"],
+    "protect_dest" => ["bool", null, "faut-il protéger la destination?"],
+  ];
+
+  const VALUE_ACCESS_PARAMS_SCHEMA = [
+    "allow_null" => ["bool", false],
+    "allow_false" => ["bool", true],
+    "protect_dest" => ["bool", false],
+  ];
+
+  const ARRAY_ACCESS_PARAMS_SCHEMA = [
+    "allow_null" => ["bool", true],
+    "allow_false" => ["bool", false],
+    "protect_dest" => ["bool", true],
+    "key_prefix" => ["?string", null, "préfixe des clés pour les méthodes ensureXxx()"],
+    "key_suffix" => ["?string", null, "suffixe des clés pour les méthodes ensureXxx()"],
+  ];
+
+  const PROPERTY_ACCESS_PARAMS_SCHEMA = [
+    "allow_null" => ["bool", true],
+    "allow_false" => ["bool", false],
+    "protect_dest" => ["bool", true],
+    "key_prefix" => ["?string", null, "préfixe des clés pour les méthodes ensureXxx()"],
+    "key_suffix" => ["?string", null, "suffixe des clés pour les méthodes ensureXxx()"],
+    "map_names" => ["bool", true, "faut-il mapper les clés en camelCase?"]
+  ];
+}
diff --git a/php/src/ref/schema/ref_schema.php b/php/src/ref/schema/ref_schema.php
index f1af52e..bc100b1 100644
--- a/php/src/ref/schema/ref_schema.php
+++ b/php/src/ref/schema/ref_schema.php
@@ -44,18 +44,38 @@ class ref_schema {
     "invalid" => "Cette valeur est invalide",
   ];
 
+  const PARAMS_SCHEMA = [
+    "analyze" => ["bool", true, "faut-il analyser la valeur?"],
+    "reanalyze" => ["bool", true, "faut-il forcer l'analyse de la valeur?"],
+    "normalize" => ["bool", true, "faut-il normaliser la valeur?"],
+    "renormalize" => ["bool", true, "faut-il forcer la normalisation de la valeur?"],
+    "throw" => ["bool", true, "faut-il lancer une exception en cas d'erreur?"],
+    //...ref_input::INPUT_PARAMS_SCHEMA,
+  ];
+
   /** @var array clés supplémentaires de schéma de la nature scalaire */
   const SCALAR_NATURE_METASCHEMA = [
   ];
 
+  const SCALAR_PARAMS_SCHEMA = [
+  ];
+
   /** @var array clés supplémentaires de schéma de la nature associative */
   const ASSOC_NATURE_METASCHEMA = [
     "ensure_array" => ["bool", false, "faut-il s'assurer que le tableau destination est non nul?"],
+    "ensure_assoc" => ["bool", true, "faut-il s'assurer que le tableau destination est associatif?"],
     "ensure_keys" => ["bool", true, "faut-il s'assurer que toutes les clés existent?"],
     "ensure_order" => ["bool", true, "faut-il s'assurer que les clés soient dans l'ordre?"],
   ];
 
+  const ASSOC_PARAMS_SCHEMA = [
+    //...self::ASSOC_NATURE_METASCHEMA,
+  ];
+
   /** @var array clés supplémentaires de schéma de la nature liste */
   const LIST_NATURE_METASCHEMA = [
   ];
+
+  const LIST_PARAMS_SCHEMA = [
+  ];
 }