pimcore doc – Guide d’installation et de mise à niveau
Cet article est une traduction en français de la documentation officielle de Pimcore concernant l’installation du CMS et de ses mises à niveau.
Guide d’installation et de mise à niveau | Développer avec Pimcore | Guide de l’administrateur | Guide de l’utilisateur | Extensions | Développer pour Pimcore | F.A.Q | Archive
[Cette page est une traduction de la documentation de Pimcore : http://www.pimcore.org/wiki/display/PIMCORE/Installation+and+Upgrade+Guide]
Ce tutoriel montre comment installer pimcore sur un environnement LAMP classique. Avant de commencer, consulter d’abord la configuration système requise.
Voir aussi les screencasts rapides et intuitifs.
Télécharger et copier sur le serveur
Tout d’abord télécharger la dernière version.
Extraire les fichiers dans le répertoire racine (Pimcore ne peut pas fonctionner dans un sous-dossier) sur votre serveur (Si vous voulez savoir pourquoi, lisez la F.A.Q).
Si vous voulez le mettre dans un répertoire différent (par exemple, en dehors du répertoire racine pour des questions de sécurité), il n’y a pas de problème – il suffit d’adapter le chemin d’accès pimcore/config/startup.php dans votre fichier de démarrage (index.php).
Astuce: Extraire l’archive directement sur le serveur, si possible, parce que, l’énorme quantité de fichiers via FTP / SFTP, prendrait un certain temps à charger.
Configuration d’Apache
Le package d’installation contient déjà le fichier .htaccess. Si tout s’est bien passé lors du transfert vers le serveur, vous devriez déjà l’avoir à la racine de votre serveur. Si ce n’est pas le cas, vous pouvez l’obtenir directement à partir du package de téléchargement.
Le système de fichiers (Permissions)
Pimcore nécessite un accès en écriture dans les répertoires suivants : /website/var et /pimcore. Si vous utilisez des plugins, il faut aussi un accès en écriture pour le répertoire /plugins.
Si vous savez quel utilisateur exécute php, il suffit de donner l’accès en écriture à l’utilisateur php. Exécutez les commandes suivantes dans votre terminal (par exemple via SSH…) :
Sur les systèmes Debian (et la plupart des autres distributions Linux), la plupart du temps l’utilisateur www-data exécute les fichiers php, il suffit d’exécuter les commandes suivantes dans votre répertoire d’installation.
chown -R www-data:www-data website/var pimcore plugins
Si vous ne connaissez pas l’utilisateur, vous pouvez changer les permissions: (*Attention: * Utiliser cette commande uniquement pour le dévéloppement, et non pour la production !) :
chmod -R 0777 website/var chmod -R 0777 pimcore
Si vous n’avez pas d’accès en ligne de commande, vous pouvez aussi le faire avec votre client FTP/ SFTP (par exemple FileZilla est idéal pour FTP / SFTP) :
Mysql
Pimcore a besoin d’une base de données Mysql, la seule chose dont vous devez vous assurer, c’est que la base de données utilise l’encodage UTF-8 comme jeu de caractère. Si vous créez une nouvelle base de données, elle doit avoir le jeu de caractères UTF8_general_ci.
* Remarque: * Vous devez créer la base de données manuellement.
Configurer le script de maintenance
Pour utiliser les fonctions programmées (comme ordonnancement, sauvegarde, plugins…) de Pimcore, vous devez configurer une tâche planifiée (cron).
Nous vous recommandons d’exécuter les tâches toutes les 5 minutes, mais ça pourrait toutes les 10 minutes. Vous pouvez également démarrer les tâches toutes les minutes, s’il y en a d’actif. Pimcore n’exécute que celles qui sont actives.
Pour les systèmes Linux avec le cron-daemon installé, vous pouvez utiliser ce qui suit pour l’installation:
Passez à l’utilisateur qui doit exécuter la tâche, puis tapez crontab -e dans le terminal. Maintenant votre éditeur de système devrait s’ouvrir. Ajoutez la ligne suivante à la fin:
*/5 * * * * /path/to/php-cli /path/to/pimcore/cli/maintenance.php
NOTE: S’il vous plaît assurez-vous que l’utilisateur qui exécute la tâche à bien la permission d’écrire dans /website/var. Si ce n’est pas possible, vous pouvez utiliser des outils comme par exemple sudo :
*/5 * * * * sudo -u php /usr/bin/php /path/to/pimcore/cli/maintenance.php
S’il vous plaît, comprenez que nous ne pouvons offrir des solutions pour d’avantage de systèmes d’exploitation.
Si vous voulez que vos tâches de maintenance s’exécute en multithread, et si vous voulez utiliser le gestionnaire de tâches multhreaded de pimcore, vous devez activer pcntl en php. Si pcntl n’est pas disponible, les tâches sont traitées de manière séquentielle.
Il y a quelques options disponibles (pour le débogage, …) pour le script de maintenance, utilisez la commande suivante pour obtenir une vue d’ensemble :
/path/to/php-cli /path/to/pimcore/cli/maintenance.php --help Usage: maintenance.php [ options ] --job|-j <string> call just a specific job(s), use "," (comma) to execute more than one job (valid options: scheduledtasks, youtubepreview, logmaintenance, sanitycheck, cleanupoldpidfiles, versioncleanup, and plugin classes if you want to call a plugin maintenance) --manager|-m <string> force a specific manager (valid options: procedural, daemon) --verbose|-v show detailed information during the maintenance (for debug, ...) --help|-h display this help
Il y a beaucoup plus d’options disponibles comme donner des tâches à exécuter :
/path/to/php-cli /path/to/pimcore/cli/maintenance.php -j scheduledtasks,logmaintenance
Avec ces seuls arguments les 2 tâches définies sont exécutées, tous les autres seront ignorés. Cela vous permet de planifier vos tâches de manière plus détaillée. Pour plus d’informations, voir le message d’aide help-message.
Installation web
Maintenant, nous sommes prêts à lancer le programme d’installation Web si tout est ok, vous devriez être en mesure de lancer l’installateur avec l’adresse http://www.votre-domaine.com/install/
Maintenant, il suffit de suivre le programme d’installation.
Le programme d’installation ne s’affiche pas. Que faire ?
Comme vous pouvez l’imaginer, il pourrait y avoir plusieurs raisons pour lesquelles ça ne marche pas. Tout d’abord vérifier la configuration système requise. Ensuite, suivez les instructions ci-dessus l’étape par étape et vérifier que tout est conforme.
Vérifiez également le journal de débogage dans /website/var/log/debug.log il vous donnera infomation détaillées sur l’état de Pimcore.
Virtual Hosts (Windows)
Assurez-vous d’avoir les bons paramètres, en particulier :
Allowoverride All
<VirtualHost *:80> DocumentRoot "C:/sites/pimcore" ServerName pimcore.local <directory "C:/sites/pimcore"> Allowoverride All allow from all </directory> </VirtualHost>
Après l’installation (optionnel mais conseillé)
Ouvrez « Configuration » -> « Système » dans l’administration, et configurer votre nouveau système installé.
On vous recommande de saisir les options suivantes:
- Fuseau horaire
- Chemin vers le binaire PHP-CLI
- Langues (pour le site Web ou des données dans les objets)
- Connectivité HTTP
- …