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

# Installation et configuration

## Comment faire pour installer le script

### Minimums requis

Assurez-vous que vous avez le minimums requis pour exécuter Coppermine sur votre serveur.

### Décompressez l'archive en préservant la structure des répertoires

Vous pouvez (et devriez) renommer le dossier Coppermine, mais pas les fichiers ou dossiers à l'intérieur.

Détails

Vous avez besoin d'une application qui peut décompresser une archive, comme 7-Zip si votre OS ne supporte pas la décompression du paquetage (Windows XP ou plus récent support les fichiers zip, la plupart des distributions Linux Desktop viennent avec des clients correspondant comme File Roller). Dans certains application de compression / décompression comme Win Zip il y a une possibilité qui permet à l'utilisateur de préciser si la structure des dossiers dans les archives devraient être conservées intactes, ou si tous les fichiers contenus dans l'archive doit être décompressée dans un dossier unique, sans sous-dossiers. Pour Coppermine, l'option préservant la structure des dossiers doit être activée.

Un bon endroit pour décompresser votre copie du paquetage de Coppermine est le bureau ou dans un autre dossier temporaire. Dans cette explication, nous supposerons que vous avez décompressé l'archive sur le bureau.

Après l’avoir décompressé, vous devriez avoir un dossier sur votre bureau nommé `cpg15x`. Vous êtes les bienvenus (et encouragé) à changer le nom de ce dossier pour quelque chose qui est plus logique pour une utilisation sur internet, mais assurez-vous d'utiliser un nom qui soit en toute sécurité sur le Web: ne pas utiliser des caractères spéciaux, sauf le tiret (`-`) et le trait de soulignement (`_`), n'utilisez pas d'espaces, ne pas utiliser les caractères accentués, les trémas et les autres caractères spéciaux. Eviter les lettres capitales si possibles. En fait, vous devriez n’utiliser que les caractères alphanumérique latin (de`a` à `z` et `0` à `9`). Cette recommandation ne s'applique pas seulement pour le dossier Coppermine, mais n'importe quel dossier ou fichier que vous téléchargez sur un serveur web.

Voici une liste de noms de conforme pour le dossier:

- `gallery`
- `pictures`
- `images`
- `multimedia`
- `galerie` (Si la majorité des utilisateurs parle l'allemand, le mot allemand pour la gallery est Galerie est avec celle du `L` au milieu)

Le nom du dossier vous choisissez ici correspondra plus tard à l'URL de votre galerie, il est donc conseillé de choisir un nom facile à mémoriser. Vous obtenez un petit bonus supplémentaire en termes de convivialité pour les moteurs de recherche si vous choisissez un nom descriptif de votre `galerie`. Ne vous préoccupé pas de choisir un nom pour le dossier dans lequel Coppermine résidera: vous pouvez toujours changer le nom du dossier du dit dossier à un stade ultérieur.

### Envoyez tous les fichiers sur votre serveur web

Il est obligatoire de télécharger tous les dossiers et les fichiers qui sont avec le paquetage de Coppermine sur le serveur web.
Détails

Utilisez votre application FTP pour transférer le dossier décompressé dans le premier étape de votre serveur Web. Ne pas utiliser d’add-ons ou autre pour navigateur afin de télécharger les fichiers, mais utilise une application FTP réelle. Ne vous fiez pas aux outils basiques intégrés dans les éditeurs WYSIWYG comme MS Frontpage ou Dreamweaver, comme ceux intégrés qui ont tendance à "embellir" les fichiers de code, les invalidants de cette manière. Les éditeurs et les outils dont ils disposent sont OK mais d'autres fins, ils causent souvent des problèmes lorsqu'ils sont utilisés avec des scripts pré-fait comme Coppermine, c'est pourquoi l'équipe de développement de Coppermine recommande vivement de ne pas utiliser ces éditeurs WYSIWYG. Si vous n'avez pas encore d’application FTP, jetez un œil à la liste des outils recommandés par les développeurs. de Coppermine. N’utiliser pas d’applications comme WebFTP: bien que ces applications soit très bien pour un envoi occasionnel lorsque vous êtes loin de votre maison et n'avez pas accès à un ordinateur, vous avez le plein contrôle, WebFTP n'est pas bon à être utilisé pour installer un paquetage comme Coppermine en raison des limitations intégré dans ce type d’applications.

Pour utiliser votre application FTP, vous aurez bien sûr besoin de connaître les informations FTP de votre espace web. Si vous n'êtes pas sûr de ces informations, demandez à votre hébergeur pour avoir de l'aide.

Assurez-vous d'utiliser le bon mode FTP lors du téléchargement.

Si vous prévoyez de faire en sorte que Coppermine soit la page de démarrage de votre site, vous n'avez pas nécessairement besoin de mettre les fichiers de Coppermine dans un dossier distinct: vous pouvez télécharger le contenu du paquetage de Coppermine à la racine de votre serveur.

### Définissez les autorisations de "albums" et "include" des dossiers de votre répertoire Coppermine

Définissez des autorisations au niveau du système de fichier pour le script Coppermine. Coppermine à besoins d'accès en écriture pour certains dossiers de Coppermine. La définition des autorisations peut parfois être difficile pour les débutants, c'est pourquoi une section distincte de la documentation a été crée expliquant en détail les permissions.
Habituellement, vous devez appliquer la commande chmod, en fixant les permissions à 755 (ou 777, selon la configuration de votre serveur).
Cette étape est très importante et ne doit pas être négligé !

### Assurez-vous d'avoir des informations correctes concernant votre base de données

vous devez connaître le nom de la base ainsi que les détails du compte utilisateur MySQL avec lequel Coppermine doit se connecter à la base de données. La base de données et le nom d'utilisateur doivent déjà exister, et l'utilisateur doit avoir accès à la base de données appropriée. Coppermine ne créera pas la base de données pour vous, mais créera les tables dans la base de données lors de l'installation, il n'est pas nécessaire en ce qui vous concerne d’ajoutiez toutes les tables par vous-même.
Détails
Si aucune base de données n’existe pour votre site web, vous devez en créer une, ou la faire crée pour vous par votre hébergeur. Votre hébergeur est le plus apte à vous fournir des instructions sur la façon de s'y prendre. Pour l'installation, vous aurez besoin de connaître le chemin d'accès du serveur de la base de données que vous voulez utiliser avec Coppermine et les détails du compte utilisateur MySQL à travers lequel Coppermine se connectera au serveur. Vous devez avoir le chemin du serveur de base de données (généralement 'localhost'), votre nom d'utilisateur MySQL, le mot de passe MySQL, et enfin le nom de la base de données MySQL avant d'installer Coppermine. L'utilisateur installant Coppermine doit avoir tous les droits d'accès correspondant à cette base de données.
Si vous utilisez une base de données nouvellement créée, il n'est pas nécessaire pour vous d'ajouter manuellement toutes les tables. Coppermine va créer les tables nécessaires dans la base de données pendant le processus d'installation.

### Exécuter le script d'installation sur votre serveur

Entrez l'URL suivante dans la barre d'adresse de votre navigateur: `http://votre_serveur/votre_repertoire_Coppermine/install.php` (votre_serveur = votre site web, votre_repertoire_Coppermine = le répertoire dans lequel vous avez téléchargé les fichiers Coppermine.) Suivez les instructions de l'écran d'installation et entrez les informations nécessaires demandées.
Exemple
Si votre site est `exemple.com` et le nom de votre dossier contenant Coppermine est "`galerie`", l'adresse que vous auriez à taper serait `http://exemple.com/galerie/install.php`

## Ce que fait l'installateur

Après avoir fait quelques vérifications de base, l'installateur crée les tables nécessaires dans la base de données et les remplis avec les valeurs par défaut. Il crée le fichier include/config.inc.php dans le répertoire Coppermine sur votre serveur et qui contient les détails concernant votre base de données que vous avez entrés lors de l'installation. Si vous deviez changer vos données de connexion MySQL plus tard (par exemple si vous changez le mot de passe de votre compte utilisateur MySQL ou si vous migrez vers un autre serveur), vous devrez modifier le fichier include/config.inc.php manuellement pour prendre en compte ces changements. Le fichier include/config.inc.php empêche aussi que le script d'installation soit lancé une deuxième fois: si l'installeur est lancé, une vérification de l'existence de ce fichier est faite - si oui, l'installeur est arrêté et l'utilisateur est redirigé vers la page d'index.

## Information complémentaires

Il y a d'autres éléments et informations relatifs à l'installation:

- Auto-installateur (comme Fantastico)
  Découvrez ce qui ne va pas avec eux, et pourquoi vous ne devriez pas les utiliser et ce que vous devrez faire si vous avez utilisé un auto-installateur
- FAQ d'installation
  Questions fréquemment posée relatives à l'installation de Coppermine. A lire en premier avant de poser des questions !
- Désinstallation
  Même si nous sommes persuadés que Coppermine convient à tout le monde, vous pourriez vouloir le désinstaller (pour une raison quelconque) - Vous aurez ici les instructions pour faire cette opération.
- Démarrage (premières étapes après l'installation)
  Alors vous avez réussi à installer Coppermine ? Et maintenant - Voici une autre courte page qui vous permettra de configurer Coppermine et d'y placer du contenu en un temps record.

## Configuration du serveur

Lors de l'installation de Coppermine, vous pourriez être confrontés à des problèmes qui ne sont pas directement liés à Coppermine, mais à la configuration de votre serveur. Par conséquent, cette section de la documentation ne peut que donner qu’un bref aperçu sur la question de la configuration des serveurs. Nous ne pouvons que formuler des recommandations, mais c’est au-delà de la portée du support de Coppermine que de conseiller comment configurer un serveur web. Cela étant dit: si vous avez des questions liées à la configuration du serveur, demandez de l'aide à votre hébergeur plutôt que de poser vos questions sur le forum de Coppermine.

### register_globals

Dans les anciennes versions de PHP, le paramétrage par défaut pour register_globals était "on", ce qui a amené beaucoup de programmeurs PHP à produire des codes non sécurisés (simplement parce qu'ils n'avaient pas consciences des dangers de en terme de sécurité de leur manière de coder). En conséquence, il y avait beaucoup de scripts qui s'appuient sur la variable serveur "register_globals" sur "on". Toutefois, comme de nombreuses attaques ont été menées avec des scripts malveillants qui comptent sur register_globals activé, il est conseillé de désactivez cette fonctionnalité dans la configuration des paramètres PHP de votre serveur Web. Dans les versions récentes de PHP, le réglage par défaut est "off". Toutefois, votre hébergeur peut avoir laissé register_globals sur "on" pour vous permettre d'exécuter des scripts obsolètes qui s'appuient sur register_globals.

Pour que les choses soient absolument claires: Coppermine n'a pas besoin de register_globals=on, mais il peut fonctionner avec les deux paramétrages de register_gloabls "on" ou "off". Il y a juste un impact concernant la sécurité avec la variable paramétrée sur "on" dont nous voulons vous prévenir. Si votre serveur Web a register_globals = on, l'installateur vous préviendra simplement de ce fait, mais il continuera de toute façon.

L'équipe de développement de Coppermine recommande fortement de mettre `register_globals` à off sur votre serveur. Cependant, nous ne pouvons pas vous dire comment accomplir ceci: il s'agit d'un paramètre du serveur, et non d’un paramètre de Coppermine. Habituellement (lorsque vous êtes en hébergement mutualisé), vous pouvez demander à votre hébergeur pour mettre `register_globals` pour vous sur votre serveur. Un bon hébergeur devrait le faire pour vous ou vous dire comment accomplir cette (s’il vous permet de configurer votre serveur). S'il vous plaît ne poser pas de question concernant `register_globals` sur le forum d'aide de Coppermine - C'est au-delà de la compétence du forum d’aide.

Il n'y aura pas d'impact négatif concernant votre installation de Coppermine si vous laissez `register_globals` est activé: il n'y a que vous (l'administrateur), qui verrez le message écrit qui met en garde sur les dangers qui se trouvent avec `register_globals`. Il pourrait toutefois y avoir un impact pour d'autres applications sur votre espace web - Nous ne pouvons pas le dire avec certitude.