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

# Installation et Configuration

## Comment Installer le script

- Décompressez l'archive en préservant la structure des répertoires.
  Vous pouvez (et vous devirez) renommer le répertoire de Coppermine, mais pas les fichiers ou les dossiers qu'il contient.
- Téléchargez tous les fichiers sur votre serveur Web (En vous assurant d'utiliser le bon mode FTP)
- Parametrez les permissions pour les répertoires "albums" et "include" dans le répertoire ou se trouvent vos fichiers Coppermine
  Habituellement, vous devrez utiliser la commande CHMOD, et régler les permission sur 755 (ou 777, en fonction de la configuration de votre serveur).
  Chez certains hébergeurs gratuits(Free par exemple) la commande CHMOD n'est pas active. Vous pourez néanmoins installer Coppermine sans problèmes dans la plupart des cas
  Cette étape est très importante et ne doit pas être négligée!
- Assurez vous d'avoir les informations correctes à propos de votr ebase de donnée
  - Vous devez connaitre le nom de la base de donnée ainsi que les détails du compte utilisateur MySQL avec lequel Coppermine se connectera à la base de donnée. La Base de Donée et l'utilisateur doivent déjà exister, et l'utilisateur doit avoir accès à cette base de donnée. Coppermine ne créera pas la base de donnée pour vous, mais il créera les tables dans la base de donnée pendant l'installation, vous n'aurez pas besoin d'ajouter vous même de tables.
- Lancez 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 necessaires demandées.
- Confirmez que vous avez entré toutes les informations correctes à propos de la base de donnée utilisée pour votre installation de Coppermine.
  Si il n'y a pas de base de donnée existante pour votre site Web, vous devrez en crée une, ou votr ehébergeur devra en créer une pour vous. Votre hébergeur est le mieux placé pour vour fournir les instructions pour que vous puissiez faire ceci. Pour l'installation, vous devrez connaître le chemin d'accès au serveur de la base de donnée qui sera utilisée par Coppermine et les détails du compte utilisateur MySQL avec lequel Coppermine se connectera à la base de donnée. Vous devrez avoir le chemin d'accès au serveur de la base de donnée (habituellement 'localhost'), votre nom d'utilisateur MySQL, le mot de passe MySQL, et le nom de la base de donnée MySQL avant d'installer Coppermine. L'utilisateur qui installe Coppermine doit avoir les droits d'accès à cette base de donnée.
  Si vous utilisez une base de donnée nouvellement crée, vous n'avez pas besoin d'ajouter manuellement des tables. Coppermine créera les tables necessaires pendant le processus d'installation.

## Ce que fait l'Installeur

Après avoir fait quelques vérifications de base, l'installeur créer les tables necessaires dans la base de donnée 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ée que vous avez entrés lors de l'installation. Si vous deviez changer vos données de connection 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'existance 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-Installeurs (comme Fantastico)
  Cmprenez ce qui ne va pas avec eux, et pourquoi vous ne devriez pas les utiliser ainsi que ce que vous devrez faire si vous avez utilisé un auto-installeur
- FAQ d'Installation
  Questions fréquemment posée relatives à l'installation de Coppermine. Lisez là d'abbord 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 quelque raison qu ece soit) - Vous aurez ici les instructions pour ce faire.
- Premiers pas (premières étapes après l'installation)
  Bien, vous avez installé Coppermine avec succès? Et maintenant - voici une autre courte page qui vous permettra de configurer Coppermine et d'y placer du contenu en en temps record.

## Configuration du serveur

Lors de l'installation de Coppermine, vous pouriez être confrontés à des problèmes qui ne sont pas directement liés à Coppermine, mais à la configuration de votr eserveur. Par conséquent, cette section de la documentation ne peut que donner un aperçu sur la question de la configuration des serveurs. Nous ne pouvons que formuler des recommandations, mais il est au-delà de la portée du support de Coppermine 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 concience 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'installeur vous préviendra simplement de ce fait , mais il continuera.