Fichier store.inc.php

File: gestion des store

doc

Un espace documentaire, ou store, correspond à:
  - un identifiant et un titre,
  - un espace physique de stockage (ou instance) en local et un autre sur le web, chacun défini par:
    - un ou 2 noms de serveurs, le premier pour le visualiseur, le seconde pour le résolveur, évt. identiques
    - le protocole (http|https) de l'espace http hébergeant le stockage, par défaut http
    - le chemin du répertoire yamldoc sur le serveur qui permet de définir l'url du visualiseur
    - un chemin du stockage sur le serveur à partir du répertoire yamldoc

En sapi<>'cli' le nom du serveur http permet de déterminer le store et l'instance.

3 cas d'utilisation de cette classe:

  1) en sapi <> 'cli', le store et son instance sont déterminés par le nom du serveur
    puis utilisé par Store::id() ou Store::storepath()
  
  2) le store est défini par un appel à Store::setStoreid(), l'instance est définie
    si sapi<>'cli' alors par le nom du serveur
    sinon par le fichier place.inc.php dépendant de l'implémentation du code 
  
  3) appel de Store::viewerUrl() avec un storeid en paramètre, l'instance est définie comme dans le cas 2
    à la différence du cas 2, il n'y a pas d'initialisation

Le cas 1 fonctionne en sapi<>'cli' car en cli le nom du serveur n'est pas défini.
Les cas 2 et 3 fonctionnent en sapi=='cli' mais nécessite alors le fichier place.inc.php
qui définit le lieu d'éxécution.

journal

2/4/2020:
  amélioration de la doc
4/1/2019:
  modification de Store:$definition et Store::ids() pour tenir compte de la possibilité
  d'avoir différents serveurs pour une instance et une place (georef.eu + id.georef.eu)
29/7/2018:
  création