# Coppermine Photo Gallery v1.5.x: Documentation and Manual

# Installation - Questions Fréquemment Posées (FAQ)

Lire cette FAQ est une bonne idée pour essayer de résoudre des problèmes particuliers. Malgré tout, celà ne rend pas le reste de la documentation obsolète - Si vous ne trouvez pas de réponse ici, assurez vous d'avoir lu l'entière documentation. Cherchez attentivement sur le forum d'aide avant de commencer une nouvelle demande d'aide sur le forum.

## Table des matières:

- Quels sont les minimum requis pour pouvoir installer et utiliser Coppermine 1.5.x ?
- Qu'est ce qu' ImageMagick et comment puis-je me le procurer?
- Qu'est ce que GD et comment puis-je me le procurer?
- Comment savoir quelle version de PHP j'ai?
- Comment savoir quelle version de GD j'ai?
- Quelle est la différence entre GD1 et GD2?
- Comment activer GD sur mon serveur Windows?
- Comment activer ImageMagick sur mon serveur Windows?
- Quelles sont les étapes pour faire fonctionner Coppermine?
- Comment pui-je installer ImageMagick ou GD?
- Je n'ai pas beaucoup de place sur le serveur. Y at'il une "isntallation minimale"?
- Lors de l'installation j'ai l'erreur `Fatal error: Call to undefined function: imagecreatefromjpeg() in /include/picmgmt.inc.php on line 168`. Qu'est ce que cela signifie?
- Lors de l'installation j'ai l'erreur `Warning: mkdir(dummy) [function.mkdir]: Permission denied in /your/path/to/coppermine/install.php on line 126`. Qu'est ce que cela signifie?

## Quels sont les minimum requis pour l'utilisation de Coppermine 1.5.x ?

- N'importe quel serveur web, Apache recommandé (il a été rapporté que Coppermine fonctionne avec Apache, Microsoft Internet Information Server (IIS), Roxen WebServer, Abyss, JanaServer)
- PHP 4.3.0 ou supérieur, PHP 5 est supporté
- La librairies graphiqueGD ou Image Magick
- mySQL 3.23.23 ou supérieur (4.1 recommandé). Ne confondez pas la version de l'api client (qui est affichée dans le phpinfo) avec la version de MySQL version!

## Qu'est ce que GD et comment me le procurer?

GD est une librairie graphique qui permets à PHP de faire de la manipulation d'images. Si vous tournez sur votre propre serveur vous pouvez la télécharger à l'adresse www.boutell.com/gd/. Vous devrez recompiler PHP sur les systèmes (L)Unix, en fonction de votre configuration Apache. Les versions les plus récentes de PHP intègrent GD dans leur package. Dans la plupart des systèmes Windows, vous pouvez l'activer dans le fichier php.ini. Si vous avez souscrit à un hébergement web, vérifiez auprès de votre hébergeur si GD/GD2 est disponibles pour votre site. Si ce n'est pas le cas, demandez à votre hébergeur si vous pouvez l'avoir ou cherchez un autre hébergeur. GD/GD2 est la fonction standard chez la plupart des hébergeurs.

## Qu'est ce qu'ImageMagick et comment se le procurer?

ImageMagick est une autre librairie graphique comme GD/GD2 pour la manipulation d'images. Si vous tournez sur votre propre serveur, vus pouvez la télécharger à cette adresse imagemagick.org. Il y a des sources executables disponibles pour Unix, Linux, Mac et Windows, tout comme des packages binares pour plusieurs systèmes d'exploitation de serveurs. Vous ne pouvez pas installer ImageMagick si vous avez souscrit à un hébergement web.

[haut de page]

## Comment savoir quelle version de PHP j'ai?

Si vous n'avez pas déjà installé Coppermine, créez un fichier vide nommé "info.php". ajoutez le code suivant dans ce fichier: `<?php phpinfo(); ?>`. Sauvegardez le fichier et téléchargez le sur votre serveur, puis lacez le depuis votre navigateur (exemple. http://www.votresite.com/info.php). La toute première ligne devrait être "PHP Version X.Y.Z"
Merci de noter: laisser le fichier info.php sur votre serveur peut présenter un risque en matière de sécurité; il vous faudra soit l'effacer soit le placer dansun dossier protégé par mot de passe!
Si vous avez déjà installé Coppermine, vous trouverez un fichier phpinfo (phpinfo.php) dans le répertoire de Coppermine. Identifiez vous comme administrateur dans votre galerie Coppermine et pointez simplement (entrez l'URL) avec votre navigateur sur http://votresite.com/votre_repertoire_coppermine/phpinfo.php ou cliquez sur le lien phpinfo dans le menu administrateurde Coppermine.

## Comment savoir quelle version de GD j'ai?

Si vous n'avez pas encore installé Coppermine, créez un fichier vide nommé "info.php", placez-y le code suivant: `<?php phpinfo(); ?>`. Sauvegardez le fichier et téléchargez le sur votre serveur, puis lacez le depuis votre navigateur (exemple. http://www.votredomaine.com/info.php). Cherchez un tableau comme celui-ci:

gd

GD Support | enabled
GD Version | 1.6.2 or higher
FreeType Support | enabled
FreeType Linkage | with TTF library
JPG Support | enabled
PNG Support | enabled
WBMP Support | enabled

Merci de noter: laisser le fichier info.php sur votre serveur peut présenter un risque en matière de sécurité; il vous faudra soit l'effacer soit le placer dansun dossier protégé par mot de passe!
Si vous avez déjà installé Coppermine, vous trouverez un fichier phpinfo (phpinfo.php) dans le répertoire de Coppermine. Identifiez vous comme administrateur dans votre galerie Coppermine et pointez simplement (entrez l'URL) avec votre navigateur sur http://votresite.com/votre_repertoire_coppermine/phpinfo.php ou cliquez sur le lien phpinfo dans le menu administrateurde Coppermine. Puis cherchez sur la page la section concernant GD.

## Quelle est la différence entre GD1 et GD2?

GD2 est une version plus récente que GD1 et, de ce fait, qui créear des images de meilleure qualité (images intermédiaires et vignettes).

Voici un exemple pris sur w-nailer: a propos du redimmensionnement (Taille de l'image originale: 1024 x 768 pixels):
GD 1.8.4: ImageCreate ImageCopyResized 128 x 96 pixels | GD 2.0.1: ImageCreateTrueColor ImageCopyResampled 128 x 96 pixels

La mise à jour de la librairie graphique GD après l'installation de Coppermine n'affectera pas les images crées précédemment. Elle n'aura d'effets que sur celles crées après la mise à jour. Sauf si vous faite tourner votre propre serveur, vous ne pourrez pas mettre à jour ou installer la librairie graphique GD - seul votre hébergeur le peut!

La différence essentielle entre GD 1 et GD 2 réside dans la profondeur des couleurs: GD1 ne supporte qu'ine profondeur limité de couleurs de 256 couleurs par image. Il en résulte une qualité d'image très limité.

Actuellement, la librairie graphique GD1 est totallement dépassée et ne devrait se trouver que sur les très vielles installations. Si vous êtes hébergés, vous devriez avoir GD2. Si votre hébergeur ne vous offre que GD1, il est peut être temps de chercher un autre, et meilleur, hébergeur.

### Comment activer GD sur mon serveur Windows?

GD 1.x 2.x font normalement partie intégrante de toute distribution standart de PHP sous Windows
Pour vérifier si vous l'avez, allez dans le répertoire ou vous avez installé PHP, allez dans le sous-répertoire "extensions" et regardez si vous avez un fichier nommé "php_gd2.dll".
Occasionnellent, vous devrez modifier votre fichier php.ini (normalement situé dans le répertoire windows) et enlevez le ";" se trouvant au début de la ligne:
`extension=php_gd2.dll` (à la fin du fichier). Cela forcera PHP à charger l'extension GD2.
A chaque fois que vous modifiez le fichiez php.ini, n'oubliez pas que vous devez redémarer votre serveur pour que les modifications soient prises en compte.
ImageMagick est beaucoup plus compliqué à utiliser sous Windows
Greg

Note complémentaire: L'équipe de développement de Coppermine ne recommande pas l'autohébergement. Nous ne sommes pas en train de vous encourager à faire tourner votre propre serveur si vous n'avez pas les connaissances pour. Nous laissons ce paragraphe dans la FAQ uniquement pour servir de référence. Comprenez que nous ne pouvons pas vous conseiller sur les problèmes liés à la configuration des serveurs.

### Comment activer ImageMagick sur mon serveur Windows?

ImageMagick est beaucoup plus compliqué à configurer sur Windows. Il y a beaucoups de choses à prendre en compte. Le foum d'aide de Coppermine n'est pas le bon endroit pour demander de l'aide pour l'installer, puisque le forum concerne Coppermine et non "Comment configurer un serveur" (la plupart des personnes sur le forum de Coppermine ne font pas tourner leur propre serveur, mais ont un hébergement web chez un hébergeur). A la place, essayez de trouver un forum d'aide sur Internet qui traite de ce sujet particulier.

Le chemin d'accès vers ImageMagick ne doit pas contenir d'espaces ou de caractère spéciaux. Vous devez vous assurer que l'utilisateur utilisé par le serveur a les droit necessaires pour lancer les executables d'ImageMagick.

## Quelles sont les étapes pour faire fonctionner Coppermine?

Comme expliqué dans la section Installation:

1. Téléchargez Coppermine
2. Décompressez l'archive sur votre disque dur
3. Téléchargez le contenu du dossier Coppermine sur votre serveur (vous pouvez placer les fichiers à la racine du site ou dans un répertoire avec le nom que vous choisirez).
4. CHMOD (CHangez le MODe de configuration des permissions) les dossiers "include" et "albums" de votre dossier Coppermine nouvellement téléchargé ainsi que tous leurs sous-dossiers pour leur donner l'accès en lecture/écriture. Si votre hébergeur ne vous permets pas de le faire, vous devrez certainement chercher sur le net pour télécharger et installer une application FTP pour vous facilité la tâche.
   Pour plus de détails, lisez la section concernant les permissions.
5. Créez une base de donnée à l'aide des outils de management de votre site si vous n'en avez pas encore. Vous n'aurez pas à ajouter de tables à la base de donnée nouvellement crée. Coppermine les créera pour vous. Si vous avez déjà une base de donnée sur votre site, vous pourrez l'utiliser telle quelle.
6. Si vous faites une installation sur un serveur Yahoo, lisez ceci auparavant.
7. Allez avec votre navigateur à l'adresse http://www.votresite.com/votre_repertoire_coppermine/install.php et suivez les instructions de l'asistant d'installation (basiquement les tables MySQL vont être créer et la table de configuration sera remplie avec les valeurs par défaut)
8. Après une installation réussie, vous pouvez effacer le fichier install.php de votre site web, mais ce n'est pas necessaire, puisque Coppermine vérifie que l'installeur n'est pas lancé une deuxième fois.
9. Allez depuis votre navigateur à l'adresse http://www.votresite.com/votre_repertoire_coppermine/ , et identifiez vous cimme administrateur en utilisant l'IDentifiant et le Motd e Passe que vous avez défini lirs de l'installation. Identifié en tant qu'administrateur, cliquez sur le bouton CONFIG du menu administrateur pour commencer à personnaliser votre Galerie Pgoto Coppermine comme suggéré dans la section "Pour commencer" de la documentation.
10. Testez votre nouvelle installation, créez quelques categories, sous-categories, et albums. Téléchagez quelques images (pas trop pour le moment), et vérifiez que tout fonctionne correctement.
11. Allez avec votre navigateur à l'adresse http://www.votresite.com/votre_repertoire_coppermine/docs/ et LISEZ la documentation. La documentation inclue à CPG1.5.x a été mise à jour depuis les versions précédentes pour vous aider à résoudre les problèmes et répondre qux questions que vous pourriez avoir au début. La lecture de la documentation prends quelques minutes. Résoudre des problèmes par la suite peut prendre des jours voire des semaines.
12. Si vous avez installé Coppermine dans un sous-répertoire de votre site, faites un lien vers votre page d'accueil.

## Comment installer ImageMagick ou GD?

Vous ne pouvez installer ImageMagic ou GD que si vous faites tourner otre propre serveur ou si vous avez au moins un accès shell à votre serveur. Si votre site est hébergé chez un hébergeur vous pouvez uniquement contacter votre hébergeur et lui demander de l'installer pour vous. Si il refuse, choisissez un autre hébergeur ou utilisez GD à la place.

## Je n'ai pas beaucoups de lace sur le serveu. Y at'il une "installation minimale"?

C'est bien sur contradictoire: avoir une galerie photo implique généralement l'utilisation d'un espace considérable pour le stockage des images, mais si vous ne souaitez mettre en ligne que quelques images avec peu de place restante sur le serveur, il ya quelques fichiers que vous n'aurez pas besoin de télécharger sur le serveur ou qui peuvent être effacés si pas nécessaires. Il est bien sur recommandé que seuls les utilisateurs expérimentés fassent une installation minimale; en cas de doute, faites une installation complète.

1. Enlevez tous les fichiers langues que vous n'utilisez pas (si tous les utilisateurs sont du même pays)
   Il est recommandé de toujours laisser le fichier langue Anglaise même si vos utilisateurs utilisent une autre langue, Juste pour que vous, comme administrateur, puissiez temporairement passer à l'Anglais sans problèmes. Si vous avez besoin d'utiliser la fonction de substitution de langue, vous devrez aussi laisser le fichier langue anglaise.
   Effacez tous les fichiers dans le sous-dossier "lang" de votre installation Coppermine sauf votrelangue.php (exemple: si vous utilisez le français, effacez tous les fichiers sauf /lang/french.php).
2. Effacez les parties non nécessaires de la documentation Effacez la documentation que vous n'utilisez pas, par exemple, les sous-dossiers langues de la documentation que vous n'utilisez pas.
   Si vous n'utilisez que le Français, effacez les dossiers `docs/en/` and `docs/de/` etc.
3. Effacez tous les themes non necesaires
   Effacez tous les themes dont vous n'avez pas besoin du répertoire "themes". Si cous utilisez un theme personnalisé il est recommandé de garder le theme classic pour des raisons d'administration.
   Si vous utilisez le theme "Eyeball" qui est livré avec Coppermine, vous pouvez sans problème effacer les sous-dossiers "classic", "fruity", "hardwired", "igames", "mac_ox_x", "project_vii", "rainy_day" et "water_drop" de votre répertoire "themes".
4. Effacer les fichiers Bridge
   Le pack Coppermine inclue des fichiers bridge utilisés pour l'intégration de Coppermine avec des applications forum comme phpBB, SMF etc. Vous pouvez sans problèmes effacer certains fichiers du répertoire bridge; si vous utilisez l'intégration avec un forum, vous ne garderez que le fichier bridge correspondant. Si vous n'utilisez aucune intégration, gardez le fichier coppermine.inc.php. Le fichier udb_base.php est nécesaire pour toutes les configurations et ne doit pas être effacé.
5. Effacer les drapeaux
   Si vous n'utilisez pas "la sélection de langues par drapeaux" qui peut être activée pour les themes, vous pouvez effacer le répertoire contenant les images des drapeaux (/votre_repertoire_coppermine/images/flags/). Si vous utilisez les drapeaux, vous pouvez bien entendu effacer les drapeaux que vous n'utilisez pas.
6. Effacer les fichiers qui ne sont utiles que pour l'Installation ou la mise à jour
   Une fois que Coppermine a été installé et "fonctionne correctement", vous pouvez sans problèmes effacer les fichiers qui ne sont nécessaires que pour l'Installationy: Dans le répertoire racine de Coppermine, effacez install.php, update.php. Vous pouvez aussi effacer le répertoire "sql".
   Si vous voulez mettre à jour votre installation Coppermine plus tard, (lorsqu'une nouvelle version est publiée), vous devrez bien entendu re-télécharger les fichiers update.php ainsiq que le répertoire sql sur votre serveur.
7. Choisissez de n'afficher que les images originales et les vignettes.
   C'est l'option nqui vous fera gagner le plus de place sur le serveur si elle est utilisée correctement, voici donc les instructions détaillées:
   - Déterminez la résolution maximale que vous autoriserez. Ce devra être quelque chose de sensé qui correspond à la taille des écrans de la majorité des utilisateurs (et dépend égallement de votre thème). Nous recommandons 800 pixels (Nous utiliserons cette valeur dans cet exemple de configuration)
   - Paramétrez "Crée des images intermédiaures" sur "non".
   - Paramétrez "Hauteur ou largeur maximale pour une image intérmédiaire" à "800".
   - Paramétrez "Larheur ou hauteur maximal pour les images téléchargées (pixels)" à "800".
   - paramétrez "Redimensionner automatiquement les images qui sont plus grandes que la largeur ou la hauteur maximale" sur "Oui: Tout le monde ". Il en résultera le redimensionnement des grosses images pendant le téléchargement.
   - Les paramètres de configuration ci-dessus ne seront pris en comte que pour les téléchargements à venir. Si vous avez déjà des images dans votre galerie, faites comme suggéré plus haut puis utilisez les outils d'administration pour effacer les images intermédiaires.
8. Désactivez les logs Les fichiers logs vont prendre de la place. Dans la page de configuration de Coppermine, allez tout au bas de la page et désactivez le logs.
9. Effacez les plugins dont vous n'avez pas besoin Il y a plusieurs plugis livrés avec Coppermine. Effacez les si vous n'en avez pas besoin, vous gagnerez ainsi un peu d'espace sur le serveur. N'effacez pas le répertoire plugins - effacez seulement les sous dossiers dont vous n'avez pas besoin.

### Lors de l'Installation j'ai l'erreur `Fatal error: Call to undefined function: imagecreatefromjpeg() in /include/picmgmt.inc.php on line 168`. Qu'est ce que ca signifie ?

Cette erreur signifie que la version PHP installée sur votre serveur ne supporte pas la librairie graphique GD1/GD2 .
Si vous savez qu'ImageMagick est installé sur votre serveur, vous pouvez essayer de l'utiliser à la place. Sinon, vous devrez trouver un autre hébergeur, ou convaincre le votre d'intaller GD1/GD2 (La librairie graphique GD ets maintenant un composant standart de PHP et devrait normalement être installé et disponible). Coppermine ne feut pas fonctionner sans GD ou ImageMagik

### Lors de l'Installation j'ai l'erreur `Warning: mkdir(dummy) [function.mkdir]: Permission denied in /your/path/to/coppermine/install.php on line 126`. Qu'est ce que ca signifie ?

Le script doit avoir les droits pour créer et effacer des fichiers.

- Su les serveurs Unix/linux:
  Faites un CHMOD à 755 (rwxr-xr-x) pour le répertoire Coppermine (et tous ses sous-répertoires. Pour plus de détails sur le CHMOD: regardez dans cet excellent tutoriel
- Sur Windows/IIS:
  Vérifiez que l'utilisateur utilisé par le serveur pour lancer les scripts PHP (habituellement appelé IUSR) a les droit ssuffisant pour lire, executer, modifier, effacer dans le répertoire de Coppermine. Pour savoir comment, demandez votre hébergeur ou lisez la documentation de votr eserveur si vous faites tourner votre propre serveur.
- Sur Windows/Apache:
  Vérifiez le compte utilisé par Apache et configuirez les droits dans le sytsème de fichiers.

Pour plus de détails, lisez la section sur les droits et permissions.