# Coppermine Photo Gallery v1.5.x: Documentation et manuel

# 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, cela 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.

## Vue d'ensemble de la FAQ:

- Quels sont les minimums 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 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 ?
- Comment puis-je installer ImageMagick ou GD?
- Comment savoir quelle version de PHP j'ai ?
- Quelles sont les étapes pour faire fonctionner Coppermine ?
- Quel est le mode FTP dois-je utiliser ?

## Quels sont les minimums requis pour pouvoir installer et utiliser 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é
- Les librairies graphiques GD ou ImageMagick
- 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 !

## Librairies graphique

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

GD est une librairie graphique qui permet à PHP de faire de la manipulation d'image. La bibliothèque a été initialement développée par Thomas Boutell et est actuellement maintenu par Pierre-A. Joye sous l'égide de PHP.net. Si vous tournez sur votre propre serveur vous pouvez la télécharger à l'adresse libgd.org. 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 puis-je me le procurer ?

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

### 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 lancez-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 dans un 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. 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, elle créera des images de meilleure qualité (images intermédiaires et vignettes).

Voici un exemple pris sur w-nailer: a propos du redimensionnement (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'une 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 totalement 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 d’en chercher un autre, qui soit un meilleur hébergeur.

### Comment activer GD sur mon serveur Windows ?

GD 1.x 2.x font normalement partie intégrante de toute distribution standard 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".
Occasionnellement, 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émarrer 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'auto-hé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 beaucoup de choses à prendre en compte. Le forum 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 nécessaires pour lancer les exécutables d'ImageMagick.

### Comment puis-je installer ImageMagick ou GD ?

Vous ne pouvez installer ImageMagic ou GD que si vous faites tourner votre 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.

[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 placez-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 dans un 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 administrateur de Coppermine.

## 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 permet 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ées à 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'assistant d'installation (basiquement les tables MySQL vont être créées 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 nécessaire, 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 comme administrateur en utilisant l'IDentifiant et le mot de passe que vous avez défini lors de l'installation. Identifié en tant qu'administrateur, cliquez sur le bouton CONFIG du menu administrateur pour commencer à personnaliser votre Galerie Photo Coppermine comme suggéré dans la section "Démmarage" de la documentation.
10. Testez votre nouvelle installation, créez quelques catégories, sous-catégories, et albums. Téléchargez 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 aux questions que vous pourriez avoir au début. La lecture de la documentation prend 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.

## Quel est le mode FTP dois-je utiliser ?

File Transfer Protocol (FTP) est utilisé pour échanger et manipuler des fichiers sur un réseau informatique. Un client FTP peut se connecter à un serveur FTP pour manipuler des fichiers sur ce serveur.

Il existe deux modes de transfert différents FTP.

Toutes les images (. Jpg,. Gif,. Png, etc) doit être transféré sous forme binaire, tous les fichiers qui contiennent du texte (php, htm, css, js, etc) en mode ASCII. La plupart des clients FTP ont un mode «auto» qui va utiliser le mode approprié pour chaque fichier; si votre client FTP à un mode "Auto", utilisez-le. Ce mode est particulièrement utile, pour installer Coppermine puisque le paquet contient un mélange de type de fichier. Si votre client ne dispose pas d'un mode «Auto», passer le à "binaire". Pour de plus amples renseignements, veuillez consulter le manuel de votre client FTP ou lire l'article Wikipedia concernant le FTP.