Access methods -- Méthodes d'accès

Date de publication: le mardi 22 mars 2011 à 12h58
Dernière modification: par Pascal BOYER le dimanche 27 mars 2011 à 21h04

28/09/2010 11:25

versions 3.9, 3.10, 4.x

Based on a set of rules, eZ Publish determines which siteaccess it should use every time it processes an incoming request. The rules must be set up in the global override for the site.ini configuration file: "/settings/override/site.ini.append.php". The behavior of the siteaccess system is controlled by the "MatchOrder" setting within the [SiteAccessSettings] block. This setting controls the way eZ Publish interprets the incoming requests. There are three possible methods: 
En se basant sur un jeu de règles, eZ Publish détermine, pour chaque requête entrante traitée, quel siteaccess utiliser. Les règles doivent être configurées dans la surcharge globale du fichier de configuration site.ini (settings/override/site.ini.append.php). Le comportement du système de siteaccess est contrôlé par le paramètre MatchOrder de la section [SiteAccessSettings]. Ce paramètre définit la façon dont eZ Publish interprète les requêtes entrantes. Il y a trois méthodes possibles:

• URI
• Host
• Port

The following text gives a brief explanation of the different access methods. Please note that the access methods can be combined. The documentation page of the MatchOrder  directive reveals how this can be done. 
Les trois paragraphes suivants expliquent brièvement des différentes méthodes d'accès. Notez que ces méthodes peuvent être combinées. La page de documentation de la directive MatchOrder  explique comment faire.

URI

This is the default setting for the "MatchOrder" directive. When the URI access method is used, the name of the target siteaccess will be the first parameter that comes after the "index.php" part of the requested URL. For example, the following URL will tell eZ Publish to use the "admin" siteaccess: http://www.example.com/index.php/admin. If another siteaccess by the name of "public" exists, then it would be possible to reach it by pointing the browser to the following address: http://www.example.com/index.php/public. If the last part of the URL is omitted then the default siteaccess will be used. The default siteaccess is defined by the DefaultAccess  setting within the [SiteSettings] block. The following example shows how to set up "/settings/override/site.ini.append.php" in order to make eZ Publish use the URI access method and to use a siteaccess called "public" by default: 
C'est la valeur par défaut du paramètre MatchOrder. Lorsque la méthode d'accès URI est utilisée, le nom du siteaccess cible est le premier paramètre présent après la partie index.php de l'URI demandé. Par exemple, l'URI suivant indique à eZ Publish d'utiliser le siteaccess admin: http://www.example.com/index.php/admin. Si un autre siteaccess nommé public existe, alors il est possible de l'atteindre en faisant pointer son navigateur vers l'adresse suivante: http://www.example.com/index.php/public. Lorsque la dernière partie de l'URI est omise, alors le siteaccess par défaut est utilisé. Ce dernier est défini par le paramètre DefaultAccess  du bloc [SiteSettings]. L'exemple qui suit montre comment configurer /settings/override/site.ini.append.php afin que eZ Publish utilise la méthode d'accès URI et utilise, par défaut, le siteaccess nommé public:

...
[SiteSettings]
DefaultAccess=public
[SiteAccessSettings]
MatchOrder=uri
...

The URI access method is typically useful for testing / demonstration purposes. In addition it is quite handy because it doesn't require any configuration of the web server and the DNS server. 
La méthode d'accès URI est particulièrement adaptée aux tests et démonstrations. De plus, elle est pratique car elle ne nécessite aucune configuration des serveurs web et DNS.

Host

The host access method makes it possible to map different host/domain combinations to different siteaccesses. This access method requires configuration outside eZ Publish. First of all, the DNS server must be configured to resolve the desired host/domain combinations to the IP address of the web server. Secondly, the web server must be configured to trigger a virtual host configuration (unless eZ Publish is located in the main document root). Please refer to the Virtual Host Setup  part of the installation chapter for information about how to set up a virtual host for eZ Publish. Once the DNS and the web server is configured properly, eZ Publish can be set up to use different siteaccesses based on the host/domain combinations of the incoming requests. The following example shows how to set up "/settings/override/site.ini.append.php" in order to make eZ Publish use the host access method. In addition, it reveals the basic usage of the host matching mechanism. 
La méthode d'accès par hôte permet d'associer différentes combinaisons hôte/domaines à différents siteaccess. Cette méthode d'accès implique des configurations autres que celles de eZ Publish. Tout d'abord, le serveur DNS doit être configuré pour faire correspondre les combinaisons hôte/domaine désirées à l'adresse IP du serveur web. Ensuite, le serveur web doit être configuré pour gérer (to trigger = déclencher) une configuration d'hôte virtuel (à moins que eZ Publish ne soit installé à la racine du site - DocumentRoot). Reportez-vous à la section Configuration du mode VirtualHost  du chapitre Installation & Mise à jour  pour de plus amples informations sur la mise en œuvre d'un hôte virtuel avec eZ Publish. Une fois les serveurs DNS et web configurés correctement, eZ Publish peut être configuré pour utiliser différents siteaccess en se basant sur les combinaisons hôte/domaines des requêtes entrantes. L'exemple qui suit montre comment configurer /settings/override/site.ini.append.php afin que eZ Publish utilise la méthode d'accès par hôte. Cet exemple illustre par ailleurs un usage basique du mécanisme de correspondance d'hôte:

...
[SiteAccessSettings]
MatchOrder=host
HostMatchMapItems[]=www.example.com;public
HostMatchMapItems[]=admin.example.com;admin
...

The example above tells eZ Publish to use the "public" siteaccess if the requested URL starts with "www.example.com". In other words, the configuration files in "/settings/siteaccess/public" will be used. If the requested URL starts with "admin.example.com", then the admin siteaccess will be used. The example above demonstrates only a fragment of the host matching capabilities of eZ Publish. Please refer to the reference documentation for a full explanation of the HostMatchType  directive. 
L'exemple ci-dessus indique à eZ Publish d'utiliser le siteaccess public si l'URI demandé commence par www.example.com. En d'autres termes, les fichiers de configuration placés dans /settings/siteaccess/public/ seront utilisés. Si l'URI demandé commence par admin.example.com alors c'est le siteaccess admin qui sera utilisé. Cet exemple ne montre qu'un fragment des possibilités de correspondance d'hôte de eZ Publish. Reportez-vous à la documentation de référence de la directive HostMatchType  pour des explications détaillées.

Port

The port access method makes it possible to map different ports to different siteaccesses. This access method requires configuration outside eZ Publish. The web server must be configured to listen to the desired ports (by default, a web server typically listens for requests on port 80, which is the standard port for HTTP traffic). In addition, the firewall will most likely have to be opened so that the traffic on port 81 actually reaches the web server. The following example shows how to set up "/settings/override/site.ini.append.php" in order to make eZ Publish use the port access method. It also shows how to map different ports to different siteaccesses. 
La méthode d'accès par port permet d'associer différents ports à différents siteaccess. Cette méthode d'accès implique des configurations autres que celle de eZ Publish. Le serveur web doit être configuré pour écouter sur les ports désirés (par défaut, un serveur web écoute sur le port 80 qui est le port standard du trafic HTTP). De plus, le firewall devra vraisemblablement laisser passer le trafic sur le port 81 (voir l'exemple ci-dessous) pour que le serveur web puisse être atteint. L'exemple qui suit montre comment configurer /settings/override/site.ini.append.php afin que eZ Publish utilise la méthode d'accès par port. Il illustre également comment associer différents ports à différents siteaccess.

...
[SiteAccessSettings]
MatchOrder=port
 
[PortAccessSettings]
80=public
81=admin
...
 

The example above tells eZ Publish to use the "public" siteaccess if the requested URL is sent to the web server using port 80. In other words, the configuration files inside "/settings/siteaccess/public" will be used. If the URL is requested on port 81 (usually by appending a :81 to the URL, like this: http://www.example.com:81), then the admin siteaccess will be used. 
L'exemple ci-dessus indique à eZ Publish d'utiliser le siteaccess public lorsque l'URI demandé est envoyé sur le port 80 du serveur web. En clair, les fichiers de configuration placés dans /settings/siteaccess/public/ seront utilisés. Si l'URI est demandé sur le port 81 (généralement en ajoutant :81 à l'URI, comme ceci: http://www.example.com:81), alors c'est le siteaccess admin qui sera utilisé.

Commentaires