Documentation
Installation de UwAmp
UwAmp est disponible sous 3 formes, exe, rar et zip.
Pour le format Zip et Rar il vous suffit simplement de décompresser l'archive dans le dossier que vous souhaitez, en utilisant votre outils de décompression favoris.
Attention : l'archive Rar est de type Solid et certain décompresseur alternatif n'arrive pas à le décompresser.
Pour le format Exe il s'agit d'une installation de type NSIS avec compression LZMA.
Pour désinstaller UwAmp il suffit simplement de supprimer le répertoire.
Les archives sont disponibles ici
http://www.uwamp.com/?page=download
UwAmp fonctionnement général
Organisation des dossiers
Dans le dossier UwAmp il y a 4 dossiers :
bin : contient le serveur Web, les bases de données et les versions de PHP
phpapps : contient des applications préinstallé php tel que phpmyadmin.
utils : contient des outils en plus.
www : le répertoire contenant vos sites internet.
UwAmp : l'interface de control du serveur, c'est cet executable que vous devez lancer pour démarrer le serveur.
Démarrer le serveur
Pour lancer le serveur il suffit de lancer l'exécutable UwAmp.exe puis de cliquer sur démarrer afin de démarrer les serveurs Apache et MySQL.
Configuration des fichiers à la main
Si vous souhaitez configurer à la main les fichiers de configuration veuilliez configurer les fichiers indiqué ci-dessous :
Fichier de configuration apache : bin/apache/conf/httpd_uwamp.conf
Fichier de configuration PHP : bin/php/php_[*]/php_uwamp.ini
Fichier de configuration MySQL : database/mysql-*/my_uwamp.ini
Compte root MySQL
Compte MySQL par défaut :
utilisateur "root"
mot de passe "root"
Utilisation des macros
Introduction
UwAmp utilise un système de macro pour les fichiers de configuration, les macros sont automatiquement appliqué lorsque le serveur est démarré depuis l'interface de control de UwAmp.
Vous pouvez utiliser les macros dans tous les fichiers de configuration dont le nom contient "_uwamp" ainsi que dans l'interface de configuration Apache de UwAmp. Les macros sont remplacé lorsque le serveur Apache est démarré depuis UwAmp
Liste des macros
{APACHEPATH}
Chemin absolu vers le dossier Apache : UwAmp\apache
{DOCUMENTPATH}
Chemin absolu vers le dossier www de UwAmp : UwAmp\www
{PHPPATH}
Chemin absolu vers le dossier PHP de la version sélectionné dans l'interface principal de UwAmp : UwAmp\bin\php\php_[CURRENT VERSION]\
{PHPAPACHE2FILE}
Chemin absolue vers la dll apache 2 de la version courant de PHP : UwAmp\bin\php\CURRENT PHP IN UWAMP CONTROL\CURRENT apache2.dll
{PHPEXTPATH}
Chemin absolue vers le dossier contenant les extensions PHP de la version courante : UwAmp\bin\php\php_[CURRENT VERSION]\ext
{PHPMODULENAME}
Nom du module PHP de la version courante pour PHP 5 le nom de module est php5_module pour PHP6 le nom de module est php6_module
{APACHE_PORT}
Numéro de port utilisé dans l'interface UwAmp
{MYSQLPATH}
Chemin absolue vers le dossier MySQL : UwAmp\database\mysql-[CURRENT VERSION]
{MYSQLBINPATH}
Chemin absolue vers le dossier bin de MySQL : UwAmp\database\mysql-[CURRENT VERSION]\bin
{MYSQLDATAPATH}
Chemin absolue vers le dossier data de MySQL UwAmp\database\mysql-[CURRENT VERSION]\data
{ONLINE_MODE}
En fonction du mode sélectionné dans l'interface dans l'interface principal de UwAmp.
- Si UwAmp est sélectionné en mode Online le dossier sur lequel est utilisé la macro sera accesible pour toutes les machines du réseaux.
{ONLINE_MODE} sera remplacé par :
Order allow,deny
Allow from all
- Si UwAmp est sélectionné en mode Offline le dossier sur lequel est utilisé la macro sera accesible uniquement depuis ça propre machine et aucun autre machine du réseaux pourra y accéder.
{ONLINE_MODE} sera remplacé par :
Order deny,allow
Allow from 127.0.0.1 localhost
Mode Online et Mode Offline
Présentation
Le mode permet de gèrer la sécurité de manière simplifié sur les répertoires.
En fonction du mode sélectionné dans l'interface principal de UwAmp. Si UwAmp est sélectionné en mode Online le dossier sur lequel est utilisé la macro sera accesible pour toutes les machines du réseaux.
- Si UwAmp est sélectionné en mode Online le dossier sur lequel est utilisé la macro sera accesible pour toutes les machines du réseaux.
{ONLINE_MODE} sera remplacé par :
Order allow,deny
Allow from all
- Si UwAmp est sélectionné en mode Offline le dossier sur lequel est utilisé la macro sera accesible uniquement depuis ça propre machine et aucun autre machine du réseaux pourra y accéder.
{ONLINE_MODE} sera remplacé par :
Order deny,allow
Allow from 127.0.0.1 localhost
Exemple d'utilisation de la macro {ONLINE_MODE} dans le fichier config de apache
<Directory "{DOCUMENTPATH}/">
Options Indexes FollowSymLinks
AllowOverride All
{ONLINE_MODE}
</Directory>
Exemple d'utilisation de la macro {ONLINE_MODE} directement dans l'interface UwAmp
Virtual Host
Présentation
Les virtuals hosts permettent d'héberger plusieurs site internet sur le même serveur avec la même adresse IP et sans avoir à taper le nom d'un alias ou d'un sous répertoire dans l'URL. Le serveur va regarder le DNS utilisé et rechercher un virtual host associé.
Configuration
Pour créer un virtual host sur UwAmp il suffit de cliquer sur le bouton "Apache Config" de la fenêtre principale et d'aller dans l'onglet "Virtual Server".
Liste des paramètres
Host IP : Permet de définir une adresse IP et un port spécifique. L'ip et le port sont séparé par ":". Pour l'IP on peut mettre la valeur * pour spécifier toutes les adresses. Dans la majorité des cas ce champs s'utilise simplement en mettant *:80
Server Name : Nom du DNS associé au virtual host. Si le champs est vide votre virtual host sera considéré comme la configuration par défaut. Dans ce cas UwAmp l'appellera "Apache Main" dans la liste des virtuals hosts.
Server Alias : Autres nom DNS associé au virtual host.
Si vous souhaitez que le virtual host soit associé à plusieurs DNS entrez les DNS séparé par un espace.
Document Root : Chemin ou sont stocké les fichiers de votre site sur le disque dur. Exemple : C:\monsite\ Il est conseillé de mettre un chemin en utilisant les Macros. Exemple : {DOCUMENTPATH}/monsiteinternet où {DOCUMENTPATH} represente le chemin sur votre disque du répertoire www de UwAmp.
Tester un virtual en local sans serveur DNS
Si vous souhaitez tester un virtual host en local et que vous n'avez pas de serveur DNS voici une petite astuce.
Ouvrez le fichier "hosts" situé dans le répertoire "C:\WINDOWS\system32\drivers\etc\"
Ajoutez à la fin du fichier :
127.0.0.1 NOM_DE_VOTRE_DNS
Par exemple si vous avez créer un virtual host www.toto.com dans UwAmp, ajoutez simplement dans le fichier host :
127.0.0.1 www.toto.com
Mot de passe MySQL
Compte root MySQL
Compte MySQL par défaut :
utilisateur "root"
mot de passe "root"
Changer le mot de passe dans PHPMyAdmin
Pour changer le mot de passe il faut passer par PHPMyadmin. Sur la page d'accueil cliquez sur "Privilèges". Dans "Privilèges" cliquez sur l'icône à droite sur la ligne du compte à modifier.
Vous trouverez ensuite une section "Modifier le mot de passe" ou vous pouvez mettre un nouveau mot de passe.
Attention : le changement de mot de passe vous déconnectera de PHPMyAdmin suivez les instructions en dessous pour reconfigurer PHPMyAdmin.
Reconfigurer l'authentification PHPMyAdmin
Si vous avez changé votre mot de passe MySQL, PHPMyAdmin ne pourra plus se connecter. Il faut donc changer le mot de passe de la configuration PHPMyAdmin.
Ouvrez le fichier : UwAmp\bin\phpapps\phpmyadmin\config.inc.php
Modifier ensuite les lignes suivantes en mettant les bons identifiants :
$cfg['Servers'][$i]['user'] = 'root';
$cfg['Servers'][$i]['password'] = 'root';
Si vous souhaitez que PHPMyAdmin ne s'authentifie pas automatiquement vous pouvez modifier la ligne :
$cfg['Servers'][$i]['auth_type'] = 'config';
En mettant :
$cfg['Servers'][$i]['auth_type'] = 'cookie';
User MySQL UwAmp
Dans la liste des utilisateurs UwAmp vous trouverez un compte uwamp, ce compte permet à UwAmp de fermer proprement MySQL en mode standalone.
Ce compte doit avoir uniquement les droits sur la commande SHUTDOWN et rien d'autre.
