eZ Publish 4.0 : prérequis à une installation normale

Date de publication: le vendredi 9 décembre 2011 à 12h23
Dernière modification: par Pascal BOYER le vendredi 9 décembre 2011 à 17h09

02/09/2010 2:55

versions 4.0

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.x branch. 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.x est recommandé sur les systèmes Linux/UNIX. 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 the latest version of the 1.3 branch. (Apache 2.x for Windows is not supported since it only exists in "threaded" mode.)
Sous windaube il est recommandé d'utiliser la dernière version stable de la branche 1.3 (la version windows de Apache 2.x n'existant qu'en mode threaded).

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 preprocessor) 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.5 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.5 à 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 du paramètre memory_limit du fichier de configuration php.ini (n'oubliez pas de relancer Apache chaque fois que vous modifiez le fichier php.ini). Bien que 16 Méga octets de mémoire soient normalement suffisant, il est très fortement recommandé de conserver 64 MB comme valeur du paramètre 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). This requires eZ Components version 2007.1.1 or higher to be installed. 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() . Lorsqu'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 d'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, la version 2007.1.1 (ou plus récente) de eZ Components doit être installée 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.

• MySQL 4.1 or later, 5.x (recommended)
  MySQL 4.1 ou supérieur. MySQL 5 est recommandé.

• PostgreSQL 7.3 or later
  PostgreSQL ). 7.3 ou supérieur

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 d'installation 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 aves 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).

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.

Commentaires