L'accès direct aux dossiers contenant les attachements sur le serveur chora est possible grâce au lien SMB fourni à cet effet dans l'interface de chora lors de l'affichage d'une liste de fichiers attachés. Ce lien a la forme : smb://server/<ENVIRONMENT>/<identifiant numérique de la collection>
Configuration sur le serveur
Pour que l'ouverture de ces liens fonctionne avec le protocole SMB, vous devrez créer un partage Windows pour chaque environnement de votre application sur le serveur hébergeant chora :
—celui-ci devra avoir comme racine le dossier /files/<ENVIRONMENT> (le chemin est ici donné à partir de la racine de votre installation).
—Il devra être nommé exactement comme l'environnement de l'application (correspondant à la valeur de la constante ENVIRONMENT).
Dans le cas d'un serveur d'hébergement fonctionnant sous GNU/Linux, Un*x, FreeBSD (recommandé en production), ou macOS X, un tel partage pourra être configuré à l'aide du logiciel libre Samba :
https://www.samba.org/
Voici un exemple minimal de partage pour l'environnement
aurorae dans le fichier
smb.conf de SAMBA 4 :
[aurorae]
path = /usr/local/www/webapp/files/aurorae/
comment = Chora Repository for aurorae
available = yes
create mask = 0777
directory mask = 0777
browseable = yes
read only = no
Veuillez noter que la configuration de droits d'accès (ACLs) et/ou de règles de sécurité réseau est généralement nécessaire pour limiter l'accès au serveur, aux collections ou si vous vous trouvez sur un domaine : une telle configuration peut être effectuée de différentes manières et sort du cadre de la présente documentation.
Configuration des clients
Sous macOS X, GNU/Linux, Un*x ou encore FreeBSD, de nombreux programmes supportent l'ouverture de tels liens côté client. Parmi ceux disposant d'une interface graphique, il faut citer les gestionnaires de fichiers des environnements de bureau Gnome (Nautilus), KDE ou encore XFce.
Toutefois —et paradoxalement, dans le cas de clients fonctionnant sous Microsoft Windows, les liens SMB ne sont pas reconnus par l'explorateur de fichiers (explorer.exe) qui s'attend plutôt à trouver un chemin réseau de type UNC. Pour pouvoir ouvrir les liens SMB avec ce dernier (comme on le ferait pour un chemin UNC de type serversharefile), il faut configurer au préalable les clients :
—s'assurer que le script opensmblink.bat fourni dans /binaries/smb/ (qui réécrit les chemins SMB vers UNC) se trouve à l'emplacement indiqué dans le fichier /binaries/smb/smb.reg (par défaut, ce chemin est c:/wamp64/www/webapp/binaries/smb/opensmblink.bat : nous vous conseillons de le modifier vers C:/smb/opensmblink.bat après avoir préalablement copié le script opensmblink.bat dans C:/smb : les / doivent être remplacés par des doubles anti-slashes !)
—ajouter les informations nécessaires pour l'ouverture des liens SMB avec ce script à la base de registre de Windows (pour cela, effectuez un clic droit sur le fichier fourni /binaries/smb/smb.reg, puis choisissez Fusionner et confirmez...)
Vous trouverez un lien pour tester la fonction d'ouverture des liens SMB dans l'interface de gestion de l'application (rubrique tests unitaires).
