eZ Publish 4.5+ : prérequis à une installation normale

Date de publication: le vendredi 9 décembre 2011 à 12h23
Dernière modification: par Pascal BOYER le dimanche 11 décembre 2011 à 13h02

24/03/2011 1:38

Pour versions 4.5+

eZ Publish makes use of and depends on four important things:
eZ Publish utilise et dépend des quatre éléments importants suivants:

1. A web server
   Un serveur web
2. A server-side PHP scripting engine
   Un moteur d'exécution de scripts PHP côté serveur
3. The eZ Components library
   Les bibliothèques eZ Components
4. A database server
   Un serveur de base de données
5. An image conversion system (optional)
   Un système de conversion/gestion d'images (optionnel)

The first three things should be in place before an eZ Publish installation is deployed. The image conversion system is optional and is only needed if you're planning to use eZ Publish with images. The web server and the server-side PHP scripting engine has to run on the same machine. The database server may run on a different computer.
Alors que les trois premiers éléments de la liste ci-dessus doivent être en place préalablement au déploiement de eZ Publish, le système de conversion/gestion d'images n'est nécessaire que si vous projetez de manipuler des images sous eZ Publish. Le serveur web et le moteur d'exécution de scripts PHP côté serveur doivent tourner sur la même machine alors que le serveur de bases de données peut être installé sur une autre machine.

Please also visit the requirements page to check if your operation system is supported.
Veuillez également consulter la page prérequis afin de contrôler que votre système d'exploitation est effectivement supporté.

For the moment, the following software solutions can be used:
Aujourd'hui, les solutions logicielles suivantes peuvent être utilisées:

Web server / Serveur web

Currently, only the Apache web server is supported. On Linux/UNIX based systems, it is recommended to use the latest version of the 2.2.x branch (applies also to cluster mode). Note that it must run in "prefork" mode instead of "threaded" mode - the reason for this is because some of the libraries that PHP extensions use might not be thread-safe.
Actuellement, seul le serveur web Apache est supporté et l'usage de la dernière version de la branche 2.2.x est recommandé sur les systèmes Linux/UNIX (ceci s'applique également pour le mode cluster). Retenez qu'Apache doit s'exécuter en mode prefork et non en mode threaded (pour des raisons de librairies PHP qui n'offrent pas toutes les garanties de fiabilité en mode threaded).

On Windows, it is recommended to use MS IIS 7 (with Microsoft URL Rewrite Module 1.1 ). (Apache 2.x for Windows is not supported since it only exists in "threaded" mode.)
Sous windaube il est recommandé d'utiliser MS IIS 7 (associé au module Microsoft URL Rewrite Module 1.1). (la version windows d'Apache 2.x n'existant qu'en mode threaded, celle-ci n'est pas supportée).

The Apache web server is the most popular web server on the planet. It is free, open source and can be downloaded from http://www.apache.org. 
Apache, logiciel libre et open source, est le plus populaire des serveurs web de la planète et ses sources sont disponibles sur cette page: apache.org

Server-side PHP scripting engine / Moteur d'exécution de scripts PHP côté serveur

Since most of the eZ Publish system is written using the PHP scripting language, a PHP (hypertext pre-processor) server-side engine is needed. Make sure you have PHP 5.1.6 or later.
Le système eZ Publish étant écrit presque entièrement en PHP, un moteur d'exécution de scripts PHP est nécessaire côté serveur. Assurez-vous que la version de PHP dont vous disposez soit au minimum la version 5.1.6

Note that it is strongly recommended to use the latest version of the 5.x branch, which is PHP 5.2.17 at the time of writing. The reason for this is that eZ Publish runs faster on PHP 5.2 than on PHP 5.1. In addition, some extensions may require PHP 5.2 (for example, the eZ Flow extension that comes together with eZ Publish). Make sure you use the PHP version that is required for your specific eZ Components version.
Il est fortement recommandé d'utiliser la dernière version de la branche 5.x de PHP, à savoir la version 5.2.17 à l'heure d'écrire ces lignes. La raison de ceci est que, d'une part, eZ Publish est plus rapide avec une version 5.2 qu'avec une version 5.1 et que, d'autre part, certaines extensions peuvent requérir PHP 5.2 (comme par exemple l'extension eZ Flow incluse à eZ Publish). Assurez-vous de bien utiliser la version de PHP requise par votre version spécifique de eZ Components .

PHP is free software and can be downloaded from http://www.php.net. The following table reveals which functionality PHP needs to have compiled-in support for. 
PHP est un logiciel libre que vous pouvez télécharger sur http://www.php.net Le tableau ci-après présente les fonctionnalités devant être compilées et supportées par PHP:

Zlib extension / Extension Zlib

Make sure that zlib support in PHP is enabled, otherwise the setup wizard will not be able to unpack downloaded packages during the installation process. 
Assurez-vous que le support par PHP de l'extension zlib soit activé car sinon l'assistant d'installation ne pourra pas décompresser les paquets téléchargés lors du processus d'installation de eZ Publish.

DOM extension / Extension DOM

In most cases, DOM functions are enabled by default as they are included in the PHP core. However, some Linux distributions have PHP without compiled-in support for DOM. Instead, they provide DOM as a shared module in a separate RPM package called "php-xml". 
Bien que dans la plupart des cas les fonctions DOM soient activées par défaut, puisqu'incluses dans le coeur de PHP, certaines distributions de Linux proposent PHP sans son support. En revanche, elles proposent d'installer DOM en tant que module partagé à partir d'un paquet nommé php-xml.

PHP CLI / Interface de Ligne de Commande pour PHP

It is strongly recommended to have PHP CLI installed, otherwise some features like notifications, delayed search indexing, upgrade scripts, the collaboration system (content approval), clearing caches from within the command line, etc. will not work. 
Il est fortement recommandé d'installer l' Interface de Ligne de Commande CLI pour PHP, sinon certaines fonctionnalités comme les notifications , l'indexation atermoyée, les scripts de mise à jour, le système de collaboration (approbation de contenu), l'effacement des caches en ligne de commande, etc... ne fonctionneront pas.

CURL

It is recommended to enable CURL support, otherwise some features like outbound connections via proxy and SSL support for eZSoap will not work.
Il est également recommandé d'activer le support de CURL afin que les fonctionnalités telles que la connexion via un proxy et le support SSL pour eZSoap fonctionnent.

PHP memory limit issue / Problème lié à la quantité de mémoire allouée à PHP

eZ Publish needs at least 64 MB in order to complete the setup wizard. If you are using PHP 5.2.0 or earlier version, you'll have to increase the default "memory_limit" setting which is located in the "php.ini" configuration file. (Don't forget to restart Apache after editing "php.ini".) Normal operation requires about 16 MB. However, it is highly recommended that you keep the 64 MB setting since eZ Publish consumes a lot more memory as soon as you reindex the search, execute upgrade scripts, etc. Multilingual sites will also require at least 64 MB.
eZ Publish a besoin d'au moins 64 Méga octets de mémoire pour exécuter l'assistant graphique d'installation. Si vous utilisez une version 5.2.0 (ou antérieure) de PHP alors vous devez augmenter la valeur de la directive memory_limit du fichier de configuration php.ini (n'oubliez pas de relancer Apache chaque fois que vous modifiez ce fichier). Bien que 16 Méga octets de mémoire soient normalement suffisant, il est très fortement recommandé de conserver 64 MB comme valeur de la directive memory_limit car eZ Publish consomme beaucoup de mémoire dès que vous ré-indexez la recherche, exécutez des scripts de mise à jour, etc... Les sites multilingue requièrent également au moins 64 MB.

If you are using PHP 5.2.1 or later, there is no need to change the default "memory_limit" setting (it is set to 128 MB by default).
Si vous utilisez une version 5.2.1 (ou plus récente) de PHP il n'est pas nécessaire d'augmenter la valeur du paramètre memory_limit, celui-ci valant alors 128 MB par défaut.

PHP timezone / Fuseau horaire de PHP

You need to set the "date.timezone" value in the "php.ini" configuration file. If this setting is not specified, you will most likely receive error messages like "It is not safe to rely on the system's timezone settings" when running eZ Publish on PHP 5. The following example shows how the corresponding line in "php.ini" looks like:
Vous devez définir la valeur de la directive date.timezone du fichier de configuration php.ini car, mal définie, vous obtiendrez alors très vraisemblablement des messages d'erreur du genre It is not safe to rely on the system's timezone settings lorsque vous tenterez de faire fonctionner eZ Publish sur votre plate-forme PHP 5. L'exemple ci-dessous montre comment configurer cette directive pour le fuseau horaire Europe/Paris ( Ndt: cas fréquent pour des sites hébergés en France):

date.timezone = Europe/Paris

Refer to the PHP documentation for the list of supported timezones. Don't forget to restart Apache after editing "php.ini".
Référez-vous à la documentation de PHP pour connaître la liste des fuseaux horaires supportés. N'oubliez pas de relancer Apache chaque fois que vous modifiez le fichier  php.ini.

eZ Components library / La librairie eZ Components

eZ Publish is an object-oriented application where each class definition is stored in a separate PHP source file. Instead of having a list of needed includes at the beginning of each source file, eZ Publish 4 makes use of the __autoload() function. When eZ Publish is installed, all class definitions of the eZ Publish kernel will have their paths listed in the "autoload/ezp_kernel.php" file. In addition, the "autoload/ezp_extension.php" file will contain an array of paths for class definitions that are a part of the extensions that come with eZ Publish. These arrays will most likely need to be updated in the future (for example, when you install new extensions or configure existing ones using the "Setup - Extensions" part of the administration interface). The minimum eZ Components version required with eZ Publish 4.5 is "ezcomponents-ezp45", containing a fix to the package system. In particular, you need to install the File and Base components ("ezcBase" and "ezcFile"), otherwise eZ Publish will not be able to update autoload arrays.
eZ Publish est une application orientée objet dans laquelle chaque définition de classe possède son propre fichier PHP. Plutôt que de définir, au début de chaque fichier source, une liste des inclusions nécessaires, eZ Publish 4 utilise la fonction __autoload(). Lorsque eZ Publish est installé, les chemins de toutes les définitions de classe du noyau sont listés dans le fichier autoload/ ezp_kernel.php. Par ailleurs, le fichier autoload/ ezp_extension.php contient un tableau des chemins menant aux définitions des classes relatives aux extensions de eZ Publish. Ces tableaux devront être mis à jour par la suite (lorsque vous installez, par exemple, de nouvelles extensions ou que vous en configurez certaines par le biais de l'interface Extensions de l'onglet Administration de l'interface d'administration). Pour cela, il est indispensable qu'au minimum la version ezcomponents-ezp45 (contenant des corrections de bugs) soit installée avec eZ Publish 4.6 et vous devez en particulier installer les composants File et Base ( ezcBase et ezcFile) sans quoi eZ Publish sera dans l'incapacité de mettre à jour ces tableaux autochargés.

eZ Components is an enterprise ready general purpose PHP components library used independently or together for PHP application development. eZ Components can be downloaded from http://ezcomponents.org/download. In the future, eZ Components will be bundled with eZ Publish. Refer to http://ezcomponents.org/docs/install for information about how to install eZ Components.
eZ Components est une bibliothèque de composants PHP à usage général et destinés aux entreprises (???). Ces composants sont utilisés indépendemment ou conjointement dans le cadre du développement d'applications PHP. eZ Components, qui peut être téléchargée à partir de la page http://ezcomponents.org/download, sera prochainement incorporée à eZ Publish. Référez-vous à cette page de documentation eZ Components : Installer (pour utiliser eZ Publish 4.0) pour de plus amples information sur la démarche d'installation de cette bibliothèque.

Important note / Note importante

Starting from version 2008.1, the eZ Components library requires PHP version 5.2.1 or higher.
La version 2008.1 des librairies eZ Components requière une version 5.2.1 ou supérieure de PHP.

Database server / Serveur de bases de données

eZ Publish stores miscellaneous data structures and actual content using a database. This means that a database server has to be available for eZ Publish at all times. Follow this link to the eZ Publish requirements page to find which database solutions eZ Publish is compatible with.
eZ Publish stockant divers formats de données et de contenus dans une base de données, cela implique qu'un serveur de bases de données soit en permanence disponible pour eZ Publish. Consulter la page prérequis afin de savoir avec quels serveurs de bases de données est compatible eZ Publish.

The setup wizard will automatically detect the database server as long as it is running on the same computer that functions as the web server. eZ Publish 4 requires a UTF-8 database. 
L'assistant graphique de configuration détecte automatiquement le serveur de bases de données à partir du moment où ce dernier tourne sur la même machine que celle faisant office de serveur web. eZ Publish 4 requière une base de données compatible avec le jeux de caractères UTF-8.

Note that eZ Publish 4 does not support clustering for PostgreSQL databases. The clustering code is optimized for best performance and focused on MySQL databases using the InnoDB storage engine. 
Retenez que eZ Publish ne supporte pas le mode clustering avec les bases de données PostgreSQL. Le code de clustering est optimisé pour obtenir de meilleures performances mais n'est disponible que pour les bases de données MySQL utilisant le moteur de stockage InnoDB.

Even if you are not going to run eZ Publish in a clustered environment, the use of InnoDB is required. This storage engine makes it possible to use transaction-safe tables in a MySQL database. (Database transaction support is enabled by default in eZ Publish. This feature makes the system less vulnerable to database errors and inconsistencies due to aborted requests.) Contact your database administrator if you are unsure about whether InnoDB is available on your server.
Quand bien même vous utilisez eZ Publish dans un environnement clusterisé, l'usage du moteur InnoDB est requis car il rend possible l'utilisation, avec une base de données MySQL, de tables à transactions sécurisées. Le support des transactions de base de données est activé par défaut dans eZ Publish. Cette fonction rend le système moins vulnérable aux erreurs de la base de données et aux incohérences provoquées par les requêtes qui échouent. Contactez l'administrateur de votre base de données pour savoir si le moteur InnoDB est disponible sur votre serveur.

If you want to use PostgreSQL, make sure the "pgcrypto" module is installed. On Linux/UNIX, you may need to install a separate package called "postgresql-contrib" (refer to the PostgreSQL documentation for more information), which contains the "pgcrypto" module. The "pgcrypto" module provides cryptographic functions for PostgreSQL, including the "digest" function, which is needed for eZ Publish. When setting up a PostgreSQL database for eZ Publish, you will have to register these functions in the database. Refer to the "Setting up a database" part of the "Installing eZ Publish on a Linux/UNIX based system" and "Installing eZ Publish on Windows" documentation pages (depending on the target OS) for more information.
Si vous utilisez le gestionnaire de bases de données PostgreSQL, assurez-vous que le module pgcrypto soit bien installé. Sur les plates-formes UNIX/Linux, vous devez installer un package nommé postgresql-contrib (référez-vous à la documentation de PostgreSQL pour de plus amples informations) contenant le module pgcrypto. Ce module fournit des fonctions cryptographiques pour PostgreSQL dont la fonction digest nécessaire à eZ Publish. Lorsque vous définissez une base de données PostgreSQL pour eZ Publish, vous devez enregistrer ces fonctions dans la base de données. Référez-vous, pour de plus amples informations, au chapitre Setting up a database des documents Installing eZ Publish on a Linux/UNIX based system et Installing eZ Publish on Windows (en fonction de votre système d'exploitation - Ndt: vous pouvez également vous référer à l'article « eZ publish : installer la version 4.0 » si vous êtes sous Linux/UNIX).

Known issue with running PHP5.3 on MySQL: Some people (like Windows users with both IPv4 and IPv6 installed ) experience problems connecting to the database server using host names like "localhost"... If you experience problems, try using IPv4 address like "127.0.0.1". This is due to a connectivity problem when running PHP5.3 on MySQL. So, please replace the database server name "localhost" with the IP address of the machine, or "127.0.0.1", which is reserved for the local host.
Problèmes connus avec le couple PHP 5.3 / MySQL: certaines personnes (comme par exemple les utilisateurs windows utilisant IPv4 ET IPv6) rencontrent des problèmes de connexion au serveur de base de données via des noms d'hôtes tels que localhost... Le cas échéant, essayez d'utiliser des adresses IP de type 127.0.0.1. Ce problème de connexion est engendré par l'exécution de PHP 5.3 en association avec MySQL. La solution de contournement consiste donc à remplacer le nom de serveur de base de données localhost par l'adresse IP de la machine locale, à savoir 127.0.0.1.

Oracle compatibility / Compatibilité avec Oracle

The version 1.8 of the eZ Publish Extension for Oracle® Database makes it possible to use Oracle as a database for eZ Publish 4.0.1 and higher. Note that earlier versions of the extension are not compatible with eZ Publish 4.
La version 1.8 de l' extension eZ Publish pour les bases de données Oracle® permet d'utiliser un serveur de bases de données Oracle avec les versions 4.0.1 et ultérieures d'eZ Publish. Retenez que les versions antérieures de cette extension ne sont pas compatibles avec eZ Publish 4.

Image conversion system (optional) / Système de conversion d'images (optionnel)

In order to scale, convert or modify images, eZ Publish needs to make use of an image conversion system. One of the following software packages (both are free) can be used:
Pour redimentionner, convertir ou modifier des images, eZ Publish utilise un système de conversion d'images. L'un de ces deux logiciels (tous deux libres) peut être utilisé:

• GD2 (comes with PHP)
  GD2 (fourni avec PHP)

• ImageMagick (http://www.imagemagick.org)
  ImageMagick (ImageMagick en français)

ImageMagick supports more formats than GD and usually produces better results (better scaling, etc.). The setup wizard will automatically detect the pre-installed image conversion system(s).
ImageMagick supporte plus de formats d'images que GD et produits habituellement de meilleurs résultats (meilleur redimentionnement, etc...). L'interface graphique d'installation détecte automatiquement le(s) système(s) de conversion d'images présent(s) sur le serveur.

The installation and setup of required software solutions (outlined above) is far beyond the scope of this document. Please refer to the homepage and documentation of the different software solutions.
L'installation et la configuration des logiciels requis par eZ Publish (et énumérés ci-dessus) dépassent largement le cadre de cet article. Aussi, référez-vous aux documentations présentes sur les sites de ces logiciels.

Limitation on some file systems when storing large number of content files / Limitation du nombre d'objets stockés sur certains systèmes de fichiers

eZ Publish stores all disc related content (eg Images, PDF's etc) in var/storage like the structure from content tree, creating one folder for each object. In most file systems used under Linux (especially ext2 + ext3) there exists a hard LIMIT TO 32000 directories per folder. So it is not possible to store more than 31999 objects under one folder.
eZ Publish stocke tous les contenus de type image, PDF, video/audio etc... sous le répertoire var/storage/ et ceci de manière similaire à la structure de l'arborescence des contenus du site. eZ Publish crée donc un dossier pour chaque objet enregistré sous var/storage/. Sur la plupart des systèmes de fichiers Linux (en particulier ext2 et ext3) il n'est pas possible de créer plus de 32 000  dossiers par répertoire. Il n'est donc pas possible de créer plus de 31 999 objets dans un même répertoire.

To get around this limitation without changing the file system, you can split your content tree so that you don't have more than 32k content files (example: images) in the same folder.
Afin de contourner cette limite sans devoir changer de système de fichiers, vous pouvez diviser votre arborescence de telle manière qu'il n'y ait pas plus de 32 000 fichiers (des images par exemple) sous le même dossier.

Examples of file systems that supports more file/folder entries per folder.
Voici deux exemples de systèmes de fichiers supportant une quantité plus importante de fichiers par répertoire:

- ReiserFS: environ 1.2 million par répertoire

- ZFS: 2^48 (colossale: 281 474 976 710 656 !)

Commentaires