Lea Linux - Contributions [fr]

Apache PHP MySQL

2006-04-24T22:27:50Z

Anthony : /* Conclusion */

[[Category:Services Web]]
= Installation Apache, PHP, MySQL =

<div class="leatitre">Installation Apache, PHP, MySQL</div><div class="leapar">Jean-Marc LICHTLE<br /> Mise à jour par [mailto:anne@lea-linux.org Anne]</div><div class="leadesc">Installation d'un serveur Apache/PHP/MySQL en environnement Mandrake </div>
----

== 1 Objectif de ce document ==

L'objet de ce document est de guider les premiers pas d'un utilisateur débutant dans l'utilisation de la trilogie Apache, PHP, MySQL. On suppose que les bases de LINUX sont connues, en particulier que l'utilisateur est familiarisé avec l'arborescence des fichiers, la manipulation d'un logiciel de décompression des paquetages, la notion d'utilisateur, d'administrateur, etc. <br />

== 2 Introduction ==

La configuration de l'ensemble Apache, PHP, MySQL n'était pas spécialement aisée avec les distributions plus anciennes. Un article (très intéressant) de la revue Linux pratique décrit dans le numéro 12 comment s'y prendre pour réaliser cette opération, 9 pages d'instructions, de mises à jour de fichiers .conf etc.. Passionnant (et pénible).

Depuis un certain nombre de versions de Mandrake, il est possible de tout faire fonctionner sans retoucher le moindre fichier de configuration, simplement en installant les '''rpm''' ! Et Mandrake 10 ne déroge pas à ce constat.

Rappelons brièvement que:

* <nowiki>Apache est un serveur Web (le logiciel qui ``envoie'' des pages html à un navigateur). Il s'agit du serveur le plus utilisé actuellement sur le Web puisqu'il représente environ 2/3 des serveurs installés.</nowiki>
* PHP est un langage de programmation interprété. Correctement interfacé avec Apache il permet au serveur de fournir des pages dynamiques gérées en fonction des besoins du client. En clair, la page n'est plus un document statique mais peut évoluer, afficher des informations différentes selon les souhaits de l'utilisateur.
* MySQL est un gestionnaire de bases de données assez puissant et rapide. Il peut très bien fonctionner en utilisant son propre client en mode texte sans l'utilisation d'une quelconque interface graphique. L'utilisateur doit alors maîtriser le langage SQL de MySQL (proche de la norme ANSI) et se servir de la ligne de commande pour adresser des requêtes au serveur. Spartiate, on se croirait revenus à la grande époque de DBase sous DOS! (nostalgie).

== 3 Rappel: Utilisation de la commande rpm. ==

ll existe de nombreux utilitaires tels que Kpackage, GnoRPM, Midnight Commander etc. qui permettent d'installer et de gérer les packages au format Red Hat (RPM).

Pour ma part je trouve plus rapide et au moins aussi efficace de travailler en mode ligne de commande en utilisant directement la commande rpm. Voir l'[../software/rpm.php3 article rpm] sur Léa. Encore plus simple, URPMI permet aujourd'hui une gestion complète des dépendances. Je vous laisse le soin de consulter la documentation.

== 4 Installation d'Apache ==

Note prélable : la plupart des distributions proposent aujourd'hui les versions 1.3.x et 2.x de Apache. Si Apache 2.x présente plus d'option pour la configuration avancée du serveur et d'autres caractéristiques liées à sa performance, le groupe de développement PHP n'a toujours pas validé la plate-forme sous cette version. On peut raisonnablement dire que pour un serveur personnel ou ne nécessitant pas de fonctionnalités particulières, Apache 1.3.x fait parfaitement l'affaire. C'est ce que nous utiliserons.

=== 4.1 Mise en place des rpm ===

L'installation d'Apache ne pose pas de problèmes. L'objectif est de disposer en fin d'installation des packages suivants :

* <code>apache2-common</code> : fichiers d'installation pour Apache et apache-mod_perl
* <code>apache2-modules</code> : ensemble des modules pour Apache
* <code>apache-conf</code> : fichiers de configuration de Apache
* <code>apache2</code> : le démon Apache
* <code>apache-manuel </code>(pas obligatoire mais peut se révéler utile).

<div class="code">

<nowiki># urpmi apache2
Pour satisfaire les dépendances, les paquetages suivants vont être installés (1 Mo):
apache-conf-2.0.48-2mdk.i586
apache2-2.0.48-6mdk.i586
apache2-common-2.0.48-6mdk.i586
apache2-modules-2.0.48-6mdk.i586
Est-ce correct ? (O/n)
Préparation... ##################################################
1:apache-conf ##################################################
2:apache2-modules ##################################################
3:apache2-common ##################################################
4:apache2 ##################################################</nowiki>

</div>

Le package <code>apache-conf</code> contient en particulier les fichiers de configuration <code>/etc/httpd/conf/httpd.conf</code> et <code>/etc/httpd/conf/commonhttpd.conf</code> qui définissent les paramètres de fonctionnement du serveur[#foot94 ][#foot94 ]<sup>[#foot94 Note 1]</sup>

=== 4.2 Premier test d'Apache ===

Le fonctionnement d'Apache est matérialisé par la mise en route d'un démon nommé '''httpd'''. Pour mettre en route, arrêter, vérifier etc. ce service tapez /etc/rc.d/init/httpd option ou option peut prendre les valeurs start, stop, restart, status ou extendedstatus selon votre besoin. En clair, pour démarrer Apache tapez <code>/etc/rc.d/init.d/httpd start[#foot95 ][#foot95 ]</code><sup>[#foot95 ]<br />Note 2 Sur Mandrake, vous pouvez également utiliser la commande <code>service</code><nowiki>: </nowiki><code>service httpd start</code> par exemple.</sup>

.

En principe l'installation d'Apache a modifié les fichiers de configuration du lancement de LINUX. Le démon httpd devrait donc démarrer systématiquement et automatiquement à chaque boot. L'installation a par ailleurs démarré immédiatement ce démon, il n'est donc pas nécessaire de rebooter comme on le ferait avec un autre système d'exploitation très connu avec lequel le moindre changement de mulot passe par un reboot...

Nous pouvons par ailleurs passer immédiatement au test du serveur sans passer par la moindre phase de configuration. Pour cela chargez votre navigateur préféré (pour ma part j'utilise Konqueror). Saisir ``<code>http://localhost</code><nowiki>'' dans la barre d'URL. Vous voyez apparaître après quelques instant une page de présentation d'Apache. En fait le serveur Apache vient d'envoyer la page </nowiki><code>/var/www/html/index.shtml</code>, affirmation que vous pourrez facilement vérifier en tapant ``<code>file:/var/www/html/index.shtml</code><nowiki>'' dans la barre d'URL de votre navigateur. Attention: il n'y a qu'un slash après </nowiki><code>file:</code> alors que par habitude vous pourriez être tentés (comme moi!) d'en mettre deux.

La page affichée dans ce cas est bien la même que la première. Les différences d'affichage dans les parties graphiques s'expliquent par le fait que l'affichage a été demandé en direct au lieu de passer par le serveur Apache.

Si vous préférez utiliser Lynx (un navigateur en mode texte ultra rapide puisqu'il ne charge pas les parties graphiques) vous pouvez même vous contenter de taper ``<code>lynx localhost</code><nowiki>''. Lynx ajoutera automatiquement ce qui manque. Merveilleux de simplicité non ?</nowiki>

<br />

== 5 Installation de PHP ==

=== 5.1 Mise en place des paquetages rpm ===

L'installation de PHP doit contenir :

* <code>libphp-common432</code>
* <code>php.ini</code>
* <code>mod_php</code>

<nowiki>L'installation de ces packages ne devrait pas poser de problème particulier. Sauf erreur ils s'installent automatiquement avec l'option d'installation ``recommandée'' de Mdk. Vérifiez toutefois la présence de </nowiki><code>mod_php</code> (<code>rpm -qa | grep php</code>) !

<div class="code">

<nowiki># urpmi php
Un des paquetages suivants est nécessaire :
1- apache2-mod_php-2.0.48_4.3.4-1mdk.i586
2- mod_php-4.3.4-1mdk.i586
3- php-cli-4.3.4-4mdk.i586
4- php-cgi-4.3.4-4mdk.i586
Que choisissez-vous ? (1-4)1
Préparation... ##################################################
1:apache2-mod_php ##################################################
Shutting down httpd2: [ OK ]
Checking configuration sanity for Apache 2.0: [ OK ]
Starting httpd2: [ OK ]</nowiki>

</div>

L'installation des rpm se termine par un redémarrage de Apache afin de prendre en compte le module PHP.

=== 5.2 Premier script PHP ===

Il importe maintenant de réaliser le premier test. Créez un sous répertoire <code>/var/www/html/test/</code> puis créez dans ce sous répertoire un fichier <code>test.php</code> contenant :

<div class="code"><html><br /> <?<br /> echo 'premier test php<br><br>';<br /> phpinfo();<br /> ?> <br /> </html></div>

Sauvegardez et chargez dans un navigateur (URL <code>http://localhost/test/test.php</code>).

Voilà votre première page web dynamique ! Vous avez, en quelques lignes, créé du code html (les balises <html> et </html>), faite générer du html par PHP (<code>echo 'premier test php<br><br>';</code>), les <br> sont des retours chariots, et fait appel à l'une des nombreuses fonctions de PHP, phpinfo() qui donne les principales informations sur le configuration actuelle de PHP.

Vous pourrez réaliser d'autres tests, l'aide nécessaire est à votre disposition dans les bouquins, les revues et sur le net.

Lorsque vous aurez constitué un petit groupe de fichiers de test vous pourrez alors faire l'expérience suivante :

* tapez simplement <code>http://localhost/test/</code> dans la barre d'URL de votre navigateur, celui-ci affiche la liste des fichiers créés, en fait le contenu du sous répertoire <code>/var/www/html/test/</code>. Si vous cliquez sur l'un des fichiers vous lancez le serveur Apache qui va interpréter le code PHP contenu dans le fichier choisi.
* copiez l'un des fichiers (ou renommez le) vers index.php. La même URL que précédemment affiche alors directement les contenu de index.php! Le contenu du sous répertoire n'est plus visible! L'accès aux différents fichiers reste toutefois possible si vous tapez directement leurs noms respectifs.
* effacez le ficher <code>index.php</code>, l'affichage de la liste des fichiers est à nouveau possible. C'est pratique pour éviter qu'un visteur de passage puisse consulter le contenu d'un sous-répertoire. Bien sûr c'est un simple truc, pas un rideau de fer contre un kracker expérimenté, mal intentionné et patient !

== 6 Installation de MySQL ==

=== 6.1 Mise en place des rpm ===

L'installation de '''mysql''' est elle aussi très simple. Les packages suivants sont nécessaires (ils devraient avoir été installés par défaut, en cas de besoin les installer par la suite):

* <code>mysql-common</code>
* <code>mysql-client</code>
* <code>mysql</code>

MySQL-client n'est pas indispensable. Il s'agit en fait de la partie client de l'ensemble client-serveur. Ce client permet toutefois (attention, en mode texte c'est plutôt spartiate !) de faire quelques requêtes au serveur.

<div class="code">

<nowiki>'# urpmi mysql
Un des paquetages suivants est nécessaire :
1- MySQL-4.0.18-1.1.100mdk.i586
2- MySQL-Max-4.0.18-1.1.100mdk.i586
Que choisissez-vous ? (1-2)1
Pour satisfaire les dépendances, les paquetages suivants vont être installés (18 Mo):
MySQL-4.0.18-1.1.100mdk.i586
MySQL-client-4.0.18-1.1.100mdk.i586
MySQL-common-4.0.18-1.1.100mdk.i586
libmysql12-4.0.18-1.1.100mdk.i586
perl-Mysql-1.22_19-9mdk.i586
Est-ce correct ? (O/n)
Préparation... ##################################################
1:libmysql12 ##################################################
2:MySQL-client ##################################################
3:perl-Mysql ##################################################
4:MySQL-common ##################################################
5:MySQL ##################################################
040512 12:40:46 /usr/sbin/mysqld: Shutdown Complete
# service mysql start
Lancement du serveur MySQL [ OK ]</nowiki>

</div>

En principe après l'installation de mysql vous devriez disposer d'un serveur MySQL opérationnel (et en marche). Pour le vérifier tapez <code>ps -ax | grep mysql</code>. Vous devriez voir s'afficher quelques lignes relatives à autant de serveurs en attente de requêtes. Si tel n'est pas le cas tapez (comme root) "<code>safe_mysql &</code>" dans une fenètre texte. Cette commande devrait démarrer le serveur MySQL.

<u>Attention</u> : l'installation par défaut utilise root comme super administrateur du serveur et le mot de passe root. Faites donc un essai de fonctionnement du serveur MySQL en utilisant simplement le client MySQL en mode texte.

<div class="code"><nowiki># mysql -p</nowiki><br /> Enter password:<br /> Welcome to the MySQL monitor. Commands end with ; or \g.<br /> Your MySQL connection id is 4 to server version: 4.0.18-log<br /><br /> Type 'help;' or '\h' for help. Type '\c' to clear the buffer.<br /><br /> mysql></div>

Tapez alors quit à l'invite mysql et vous voilà sorti.

Il va falloir faire fonctionner tout ce petit monde ensemble! Apache et PHP sont déjà opérationnels. Ils communiquent ensemble, l'essai a été fait. MySQL est en route également. Pour que PHP puisse entrer en contact avec MySQL il lui faut un minimum de connaissances qui lui sont apportées par le module '''php-mysql'''.

<div class="code">

<nowiki># urpmi php-mysql
Préparation... ##################################################
1:php-mysql ##################################################</nowiki>

</div>

Pensez donc à l'installer lui aussi sinon pas de langue commune! Redémarrez Apache.

=== 6.2 Installation du script phpMyAdmin ===

Plutôt que de vous lancer dans la rédaction d'un premier script php qui va s'adresser au serveur MySQL (pour lui dire quoi ? Rien n'existe encore, ou si peu !) je vous suggère de récupérer sur le net un ensemble de scripts nommé phpMyAdmin. Il s'agit tout simplement d'un ensemble de scripts PHP qui va vous permettre, via un navigateur, d'administrer vos premières bases de données, de lire les bases de données système MySQL (celles qui définissent les droits des utilisateurs), d'en créer d'autres.

<div class="code"><nowiki># urpmi phpmyadmin</nowiki><br /> Préparation... ##################################################<br /> 1:phpMyAdmin ##################################################</div>

=== 6.3 Premier test ===

Une fois l'installation faite utilisez votre navigateur préféré et tapez <code>http://localhost/admin/phpMyAdmin/</code> dans la barre d'URL. Vous devriez voire apparaître une page html "Bienvenue à phpMyAdmin 2.5.4 - Connexion". Il vous reste à modifier le fichier /var/www/html/admin/phpMyAdmin/config.inc.php et le paramètre <code><nowiki>$cfg['blowfish_secret'] = '';</nowiki></code>.<br /> Exemple : <code>$cfg['blowfish_secret'] = 'ma phrase secrete';</code>

Rechargez la page de votre navigateur, voilà vous êtes prêts à l'utiliser !

== 7 Synthèse ==

Vous venez de créer deux ensembles de données, les répertoires contenant les pages HTML/PHP, et les répertoires contenant les bases de données MySQL.

* Les pages PHP/HTML sont rangées dans <code>/var/www/html/</code>. La page d'accueil Apache est à l'adresse <code>/var/www/html/index.shtml</code> (rappel !). Le sous-répertoire <code>/var/www/html/admin/phpMyAdmin</code> contient le script de connexion à MySQL. Vous pourrez créer d'autres sous répertoires contenant vos premiers essais, par exemple <code>/var/www/html/test/</code> qui sera accessible à l'URL <code>http://localhost/test/</code>.
* Les données MySQL sont rangées dans <code>/var/lib/mysql/</code>. Chaque base de données correspond à un sous-répertoire. Exemple : <code>/var/lib/mysql/mysql/</code> contient les tables qui définissent les droits d'accès à MySQL. Ce sous-répertoire n'est évidemment accessible que pour l'administrateur système. Si vous créez une nouvelle base de données avec phpMyAdmin ou directement en utilisant le client MySQL, le serveur créera un nouveau sous répertoire /var/lib/mysql/test par exemple si votre nouvelle base s'appelle test.

== Conclusion ==

<nowiki>La description ci-dessus avait pour but de vous conduire à disposer d'un serveur Apache qui soit opérationnel et qui puisse mettre en oeuvre des bases de données MySQL via PHP. Ce but étant atteint il convient maintenant d'être modeste. Le vrai travail commence juste. Lisez les docs, les man pages. Il existe aussi d'excellents bouquins sur la question. Pour ma part j'étudie actuellement ``Pratique de MySQL et PHP'' édition O'Reilly. Je le trouve très bien fait.</nowiki>

Enfin, lisez [[reseau-web-Apache_protec|Protection d'un serveur Apache PHP MySQL]], concernant la sécurisation de l'environnement que l'on vient de créer.

== Remerciement ==

Lors d'une installation il est courant de progresser un peu à tâtons, par essais successifs. Après quelques heures de bagarre (qui peuvent être réparties sur plusieurs jours) il faudrait être un sur-homme pour se souvenir de tout ce qu'on a fait. La mise au point d'un document comme celui-ci ne peut donc se faire qu'après plusieurs installations réussies. Idéalement la bêta-version du document doit elle-même être testée par un autre personne qui suit scrupuleusement la description et commente les erreurs, inversions, oublis etc. Je remercie donc M. Guy ASSFELD d'avoir bien voulu apporter sa contribution à ce travail en déboguant la première version.

== L'auteur ==

JML dit Jean-Marc LICHTLE, email jean-marc.lichtle@gadz.org, ingénieur Arts et Métiers promo CH173 (rigolez pas, à l'époque le hi-tech c'était les cartes perforées sur IBM 1130) !

<br />

----

==== Notes ====

; ... serveur<sup>[#tex2html1 1]</sup>
: <nowiki>De nombreuses distributions ne se contente plus du seul fichier httpd.conf. La version contenue dans LINUX Mandrake 10.0 utilise un fichier supplémentaire, commonhttpd.conf qui est appelé par httpd.conf par un ``include''.</nowiki>
; ... start<sup>[#tex2html2 2]</sup>
: Je ne précise pas, il va sans dire que certaines commandes ne peuvent être lancées que par l'administrateur système (root). L'appel à httpd fait partie de ces commandes réservées. Donc si LINUX vous fait un bras d'honneur commencez par vous poser la question de votre habilitation à lancer une commande.

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa a été convertie avec HTML::WikiConverter. Elle fut créée par Jean-Marc LICHTLE le 01/10/2001.</div>

= Copyright =
Copyright © 01/10/2001, Jean-Marc LICHTLE
{{CC-BY-NC-SA}}

Apache PHP MySQL

2006-04-24T22:17:17Z

Anthony : /* Conclusion */

[[Category:Services Web]]
= Installation Apache, PHP, MySQL =

<div class="leatitre">Installation Apache, PHP, MySQL</div><div class="leapar">Jean-Marc LICHTLE<br /> Mise à jour par [mailto:anne@lea-linux.org Anne]</div><div class="leadesc">Installation d'un serveur Apache/PHP/MySQL en environnement Mandrake </div>
----

== 1 Objectif de ce document ==

L'objet de ce document est de guider les premiers pas d'un utilisateur débutant dans l'utilisation de la trilogie Apache, PHP, MySQL. On suppose que les bases de LINUX sont connues, en particulier que l'utilisateur est familiarisé avec l'arborescence des fichiers, la manipulation d'un logiciel de décompression des paquetages, la notion d'utilisateur, d'administrateur, etc. <br />

== 2 Introduction ==

La configuration de l'ensemble Apache, PHP, MySQL n'était pas spécialement aisée avec les distributions plus anciennes. Un article (très intéressant) de la revue Linux pratique décrit dans le numéro 12 comment s'y prendre pour réaliser cette opération, 9 pages d'instructions, de mises à jour de fichiers .conf etc.. Passionnant (et pénible).

Depuis un certain nombre de versions de Mandrake, il est possible de tout faire fonctionner sans retoucher le moindre fichier de configuration, simplement en installant les '''rpm''' ! Et Mandrake 10 ne déroge pas à ce constat.

Rappelons brièvement que:

* <nowiki>Apache est un serveur Web (le logiciel qui ``envoie'' des pages html à un navigateur). Il s'agit du serveur le plus utilisé actuellement sur le Web puisqu'il représente environ 2/3 des serveurs installés.</nowiki>
* PHP est un langage de programmation interprété. Correctement interfacé avec Apache il permet au serveur de fournir des pages dynamiques gérées en fonction des besoins du client. En clair, la page n'est plus un document statique mais peut évoluer, afficher des informations différentes selon les souhaits de l'utilisateur.
* MySQL est un gestionnaire de bases de données assez puissant et rapide. Il peut très bien fonctionner en utilisant son propre client en mode texte sans l'utilisation d'une quelconque interface graphique. L'utilisateur doit alors maîtriser le langage SQL de MySQL (proche de la norme ANSI) et se servir de la ligne de commande pour adresser des requêtes au serveur. Spartiate, on se croirait revenus à la grande époque de DBase sous DOS! (nostalgie).

== 3 Rappel: Utilisation de la commande rpm. ==

ll existe de nombreux utilitaires tels que Kpackage, GnoRPM, Midnight Commander etc. qui permettent d'installer et de gérer les packages au format Red Hat (RPM).

Pour ma part je trouve plus rapide et au moins aussi efficace de travailler en mode ligne de commande en utilisant directement la commande rpm. Voir l'[../software/rpm.php3 article rpm] sur Léa. Encore plus simple, URPMI permet aujourd'hui une gestion complète des dépendances. Je vous laisse le soin de consulter la documentation.

== 4 Installation d'Apache ==

Note prélable : la plupart des distributions proposent aujourd'hui les versions 1.3.x et 2.x de Apache. Si Apache 2.x présente plus d'option pour la configuration avancée du serveur et d'autres caractéristiques liées à sa performance, le groupe de développement PHP n'a toujours pas validé la plate-forme sous cette version. On peut raisonnablement dire que pour un serveur personnel ou ne nécessitant pas de fonctionnalités particulières, Apache 1.3.x fait parfaitement l'affaire. C'est ce que nous utiliserons.

=== 4.1 Mise en place des rpm ===

L'installation d'Apache ne pose pas de problèmes. L'objectif est de disposer en fin d'installation des packages suivants :

* <code>apache2-common</code> : fichiers d'installation pour Apache et apache-mod_perl
* <code>apache2-modules</code> : ensemble des modules pour Apache
* <code>apache-conf</code> : fichiers de configuration de Apache
* <code>apache2</code> : le démon Apache
* <code>apache-manuel </code>(pas obligatoire mais peut se révéler utile).

<div class="code">

<nowiki># urpmi apache2
Pour satisfaire les dépendances, les paquetages suivants vont être installés (1 Mo):
apache-conf-2.0.48-2mdk.i586
apache2-2.0.48-6mdk.i586
apache2-common-2.0.48-6mdk.i586
apache2-modules-2.0.48-6mdk.i586
Est-ce correct ? (O/n)
Préparation... ##################################################
1:apache-conf ##################################################
2:apache2-modules ##################################################
3:apache2-common ##################################################
4:apache2 ##################################################</nowiki>

</div>

Le package <code>apache-conf</code> contient en particulier les fichiers de configuration <code>/etc/httpd/conf/httpd.conf</code> et <code>/etc/httpd/conf/commonhttpd.conf</code> qui définissent les paramètres de fonctionnement du serveur[#foot94 ][#foot94 ]<sup>[#foot94 Note 1]</sup>

=== 4.2 Premier test d'Apache ===

Le fonctionnement d'Apache est matérialisé par la mise en route d'un démon nommé '''httpd'''. Pour mettre en route, arrêter, vérifier etc. ce service tapez /etc/rc.d/init/httpd option ou option peut prendre les valeurs start, stop, restart, status ou extendedstatus selon votre besoin. En clair, pour démarrer Apache tapez <code>/etc/rc.d/init.d/httpd start[#foot95 ][#foot95 ]</code><sup>[#foot95 ]<br />Note 2 Sur Mandrake, vous pouvez également utiliser la commande <code>service</code><nowiki>: </nowiki><code>service httpd start</code> par exemple.</sup>

.

En principe l'installation d'Apache a modifié les fichiers de configuration du lancement de LINUX. Le démon httpd devrait donc démarrer systématiquement et automatiquement à chaque boot. L'installation a par ailleurs démarré immédiatement ce démon, il n'est donc pas nécessaire de rebooter comme on le ferait avec un autre système d'exploitation très connu avec lequel le moindre changement de mulot passe par un reboot...

Nous pouvons par ailleurs passer immédiatement au test du serveur sans passer par la moindre phase de configuration. Pour cela chargez votre navigateur préféré (pour ma part j'utilise Konqueror). Saisir ``<code>http://localhost</code><nowiki>'' dans la barre d'URL. Vous voyez apparaître après quelques instant une page de présentation d'Apache. En fait le serveur Apache vient d'envoyer la page </nowiki><code>/var/www/html/index.shtml</code>, affirmation que vous pourrez facilement vérifier en tapant ``<code>file:/var/www/html/index.shtml</code><nowiki>'' dans la barre d'URL de votre navigateur. Attention: il n'y a qu'un slash après </nowiki><code>file:</code> alors que par habitude vous pourriez être tentés (comme moi!) d'en mettre deux.

La page affichée dans ce cas est bien la même que la première. Les différences d'affichage dans les parties graphiques s'expliquent par le fait que l'affichage a été demandé en direct au lieu de passer par le serveur Apache.

Si vous préférez utiliser Lynx (un navigateur en mode texte ultra rapide puisqu'il ne charge pas les parties graphiques) vous pouvez même vous contenter de taper ``<code>lynx localhost</code><nowiki>''. Lynx ajoutera automatiquement ce qui manque. Merveilleux de simplicité non ?</nowiki>

<br />

== 5 Installation de PHP ==

=== 5.1 Mise en place des paquetages rpm ===

L'installation de PHP doit contenir :

* <code>libphp-common432</code>
* <code>php.ini</code>
* <code>mod_php</code>

<nowiki>L'installation de ces packages ne devrait pas poser de problème particulier. Sauf erreur ils s'installent automatiquement avec l'option d'installation ``recommandée'' de Mdk. Vérifiez toutefois la présence de </nowiki><code>mod_php</code> (<code>rpm -qa | grep php</code>) !

<div class="code">

<nowiki># urpmi php
Un des paquetages suivants est nécessaire :
1- apache2-mod_php-2.0.48_4.3.4-1mdk.i586
2- mod_php-4.3.4-1mdk.i586
3- php-cli-4.3.4-4mdk.i586
4- php-cgi-4.3.4-4mdk.i586
Que choisissez-vous ? (1-4)1
Préparation... ##################################################
1:apache2-mod_php ##################################################
Shutting down httpd2: [ OK ]
Checking configuration sanity for Apache 2.0: [ OK ]
Starting httpd2: [ OK ]</nowiki>

</div>

L'installation des rpm se termine par un redémarrage de Apache afin de prendre en compte le module PHP.

=== 5.2 Premier script PHP ===

Il importe maintenant de réaliser le premier test. Créez un sous répertoire <code>/var/www/html/test/</code> puis créez dans ce sous répertoire un fichier <code>test.php</code> contenant :

<div class="code"><html><br /> <?<br /> echo 'premier test php<br><br>';<br /> phpinfo();<br /> ?> <br /> </html></div>

Sauvegardez et chargez dans un navigateur (URL <code>http://localhost/test/test.php</code>).

Voilà votre première page web dynamique ! Vous avez, en quelques lignes, créé du code html (les balises <html> et </html>), faite générer du html par PHP (<code>echo 'premier test php<br><br>';</code>), les <br> sont des retours chariots, et fait appel à l'une des nombreuses fonctions de PHP, phpinfo() qui donne les principales informations sur le configuration actuelle de PHP.

Vous pourrez réaliser d'autres tests, l'aide nécessaire est à votre disposition dans les bouquins, les revues et sur le net.

Lorsque vous aurez constitué un petit groupe de fichiers de test vous pourrez alors faire l'expérience suivante :

* tapez simplement <code>http://localhost/test/</code> dans la barre d'URL de votre navigateur, celui-ci affiche la liste des fichiers créés, en fait le contenu du sous répertoire <code>/var/www/html/test/</code>. Si vous cliquez sur l'un des fichiers vous lancez le serveur Apache qui va interpréter le code PHP contenu dans le fichier choisi.
* copiez l'un des fichiers (ou renommez le) vers index.php. La même URL que précédemment affiche alors directement les contenu de index.php! Le contenu du sous répertoire n'est plus visible! L'accès aux différents fichiers reste toutefois possible si vous tapez directement leurs noms respectifs.
* effacez le ficher <code>index.php</code>, l'affichage de la liste des fichiers est à nouveau possible. C'est pratique pour éviter qu'un visteur de passage puisse consulter le contenu d'un sous-répertoire. Bien sûr c'est un simple truc, pas un rideau de fer contre un kracker expérimenté, mal intentionné et patient !

== 6 Installation de MySQL ==

=== 6.1 Mise en place des rpm ===

L'installation de '''mysql''' est elle aussi très simple. Les packages suivants sont nécessaires (ils devraient avoir été installés par défaut, en cas de besoin les installer par la suite):

* <code>mysql-common</code>
* <code>mysql-client</code>
* <code>mysql</code>

MySQL-client n'est pas indispensable. Il s'agit en fait de la partie client de l'ensemble client-serveur. Ce client permet toutefois (attention, en mode texte c'est plutôt spartiate !) de faire quelques requêtes au serveur.

<div class="code">

<nowiki>'# urpmi mysql
Un des paquetages suivants est nécessaire :
1- MySQL-4.0.18-1.1.100mdk.i586
2- MySQL-Max-4.0.18-1.1.100mdk.i586
Que choisissez-vous ? (1-2)1
Pour satisfaire les dépendances, les paquetages suivants vont être installés (18 Mo):
MySQL-4.0.18-1.1.100mdk.i586
MySQL-client-4.0.18-1.1.100mdk.i586
MySQL-common-4.0.18-1.1.100mdk.i586
libmysql12-4.0.18-1.1.100mdk.i586
perl-Mysql-1.22_19-9mdk.i586
Est-ce correct ? (O/n)
Préparation... ##################################################
1:libmysql12 ##################################################
2:MySQL-client ##################################################
3:perl-Mysql ##################################################
4:MySQL-common ##################################################
5:MySQL ##################################################
040512 12:40:46 /usr/sbin/mysqld: Shutdown Complete
# service mysql start
Lancement du serveur MySQL [ OK ]</nowiki>

</div>

En principe après l'installation de mysql vous devriez disposer d'un serveur MySQL opérationnel (et en marche). Pour le vérifier tapez <code>ps -ax | grep mysql</code>. Vous devriez voir s'afficher quelques lignes relatives à autant de serveurs en attente de requêtes. Si tel n'est pas le cas tapez (comme root) "<code>safe_mysql &</code>" dans une fenètre texte. Cette commande devrait démarrer le serveur MySQL.

<u>Attention</u> : l'installation par défaut utilise root comme super administrateur du serveur et le mot de passe root. Faites donc un essai de fonctionnement du serveur MySQL en utilisant simplement le client MySQL en mode texte.

<div class="code"><nowiki># mysql -p</nowiki><br /> Enter password:<br /> Welcome to the MySQL monitor. Commands end with ; or \g.<br /> Your MySQL connection id is 4 to server version: 4.0.18-log<br /><br /> Type 'help;' or '\h' for help. Type '\c' to clear the buffer.<br /><br /> mysql></div>

Tapez alors quit à l'invite mysql et vous voilà sorti.

Il va falloir faire fonctionner tout ce petit monde ensemble! Apache et PHP sont déjà opérationnels. Ils communiquent ensemble, l'essai a été fait. MySQL est en route également. Pour que PHP puisse entrer en contact avec MySQL il lui faut un minimum de connaissances qui lui sont apportées par le module '''php-mysql'''.

<div class="code">

<nowiki># urpmi php-mysql
Préparation... ##################################################
1:php-mysql ##################################################</nowiki>

</div>

Pensez donc à l'installer lui aussi sinon pas de langue commune! Redémarrez Apache.

=== 6.2 Installation du script phpMyAdmin ===

Plutôt que de vous lancer dans la rédaction d'un premier script php qui va s'adresser au serveur MySQL (pour lui dire quoi ? Rien n'existe encore, ou si peu !) je vous suggère de récupérer sur le net un ensemble de scripts nommé phpMyAdmin. Il s'agit tout simplement d'un ensemble de scripts PHP qui va vous permettre, via un navigateur, d'administrer vos premières bases de données, de lire les bases de données système MySQL (celles qui définissent les droits des utilisateurs), d'en créer d'autres.

<div class="code"><nowiki># urpmi phpmyadmin</nowiki><br /> Préparation... ##################################################<br /> 1:phpMyAdmin ##################################################</div>

=== 6.3 Premier test ===

Une fois l'installation faite utilisez votre navigateur préféré et tapez <code>http://localhost/admin/phpMyAdmin/</code> dans la barre d'URL. Vous devriez voire apparaître une page html "Bienvenue à phpMyAdmin 2.5.4 - Connexion". Il vous reste à modifier le fichier /var/www/html/admin/phpMyAdmin/config.inc.php et le paramètre <code><nowiki>$cfg['blowfish_secret'] = '';</nowiki></code>.<br /> Exemple : <code>$cfg['blowfish_secret'] = 'ma phrase secrete';</code>

Rechargez la page de votre navigateur, voilà vous êtes prêts à l'utiliser !

== 7 Synthèse ==

Vous venez de créer deux ensembles de données, les répertoires contenant les pages HTML/PHP, et les répertoires contenant les bases de données MySQL.

* Les pages PHP/HTML sont rangées dans <code>/var/www/html/</code>. La page d'accueil Apache est à l'adresse <code>/var/www/html/index.shtml</code> (rappel !). Le sous-répertoire <code>/var/www/html/admin/phpMyAdmin</code> contient le script de connexion à MySQL. Vous pourrez créer d'autres sous répertoires contenant vos premiers essais, par exemple <code>/var/www/html/test/</code> qui sera accessible à l'URL <code>http://localhost/test/</code>.
* Les données MySQL sont rangées dans <code>/var/lib/mysql/</code>. Chaque base de données correspond à un sous-répertoire. Exemple : <code>/var/lib/mysql/mysql/</code> contient les tables qui définissent les droits d'accès à MySQL. Ce sous-répertoire n'est évidemment accessible que pour l'administrateur système. Si vous créez une nouvelle base de données avec phpMyAdmin ou directement en utilisant le client MySQL, le serveur créera un nouveau sous répertoire /var/lib/mysql/test par exemple si votre nouvelle base s'appelle test.

== Conclusion ==

<nowiki>La description ci-dessus avait pour but de vous conduire à disposer d'un serveur Apache qui soit opérationnel et qui puisse mettre en oeuvre des bases de données MySQL via PHP. Ce but étant atteint il convient maintenant d'être modeste. Le vrai travail commence juste. Lisez les docs, les man pages. Il existe aussi d'excellents bouquins sur la question. Pour ma part j'étudie actuellement ``Pratique de MySQL et PHP'' édition O'Reilly. Je le trouve très bien fait.</nowiki>

Enfin, lisez [[Reseau-web-Apache_protec|Protection d'un serveur Apache PHP MySQL]], concernant la sécurisation de l'environnement que l'on vient de créer.

== Remerciement ==

Lors d'une installation il est courant de progresser un peu à tâtons, par essais successifs. Après quelques heures de bagarre (qui peuvent être réparties sur plusieurs jours) il faudrait être un sur-homme pour se souvenir de tout ce qu'on a fait. La mise au point d'un document comme celui-ci ne peut donc se faire qu'après plusieurs installations réussies. Idéalement la bêta-version du document doit elle-même être testée par un autre personne qui suit scrupuleusement la description et commente les erreurs, inversions, oublis etc. Je remercie donc M. Guy ASSFELD d'avoir bien voulu apporter sa contribution à ce travail en déboguant la première version.

== L'auteur ==

JML dit Jean-Marc LICHTLE, email jean-marc.lichtle@gadz.org, ingénieur Arts et Métiers promo CH173 (rigolez pas, à l'époque le hi-tech c'était les cartes perforées sur IBM 1130) !

<br />

----

==== Notes ====

; ... serveur<sup>[#tex2html1 1]</sup>
: <nowiki>De nombreuses distributions ne se contente plus du seul fichier httpd.conf. La version contenue dans LINUX Mandrake 10.0 utilise un fichier supplémentaire, commonhttpd.conf qui est appelé par httpd.conf par un ``include''.</nowiki>
; ... start<sup>[#tex2html2 2]</sup>
: Je ne précise pas, il va sans dire que certaines commandes ne peuvent être lancées que par l'administrateur système (root). L'appel à httpd fait partie de ces commandes réservées. Donc si LINUX vous fait un bras d'honneur commencez par vous poser la question de votre habilitation à lancer une commande.

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa a été convertie avec HTML::WikiConverter. Elle fut créée par Jean-Marc LICHTLE le 01/10/2001.</div>

= Copyright =
Copyright © 01/10/2001, Jean-Marc LICHTLE
{{CC-BY-NC-SA}}

Apache PHP MySQL

2006-04-24T22:13:57Z

Anthony : /* Conclusion */

[[Category:Services Web]]
= Installation Apache, PHP, MySQL =

<div class="leatitre">Installation Apache, PHP, MySQL</div><div class="leapar">Jean-Marc LICHTLE<br /> Mise à jour par [mailto:anne@lea-linux.org Anne]</div><div class="leadesc">Installation d'un serveur Apache/PHP/MySQL en environnement Mandrake </div>
----

== 1 Objectif de ce document ==

L'objet de ce document est de guider les premiers pas d'un utilisateur débutant dans l'utilisation de la trilogie Apache, PHP, MySQL. On suppose que les bases de LINUX sont connues, en particulier que l'utilisateur est familiarisé avec l'arborescence des fichiers, la manipulation d'un logiciel de décompression des paquetages, la notion d'utilisateur, d'administrateur, etc. <br />

== 2 Introduction ==

La configuration de l'ensemble Apache, PHP, MySQL n'était pas spécialement aisée avec les distributions plus anciennes. Un article (très intéressant) de la revue Linux pratique décrit dans le numéro 12 comment s'y prendre pour réaliser cette opération, 9 pages d'instructions, de mises à jour de fichiers .conf etc.. Passionnant (et pénible).

Depuis un certain nombre de versions de Mandrake, il est possible de tout faire fonctionner sans retoucher le moindre fichier de configuration, simplement en installant les '''rpm''' ! Et Mandrake 10 ne déroge pas à ce constat.

Rappelons brièvement que:

* <nowiki>Apache est un serveur Web (le logiciel qui ``envoie'' des pages html à un navigateur). Il s'agit du serveur le plus utilisé actuellement sur le Web puisqu'il représente environ 2/3 des serveurs installés.</nowiki>
* PHP est un langage de programmation interprété. Correctement interfacé avec Apache il permet au serveur de fournir des pages dynamiques gérées en fonction des besoins du client. En clair, la page n'est plus un document statique mais peut évoluer, afficher des informations différentes selon les souhaits de l'utilisateur.
* MySQL est un gestionnaire de bases de données assez puissant et rapide. Il peut très bien fonctionner en utilisant son propre client en mode texte sans l'utilisation d'une quelconque interface graphique. L'utilisateur doit alors maîtriser le langage SQL de MySQL (proche de la norme ANSI) et se servir de la ligne de commande pour adresser des requêtes au serveur. Spartiate, on se croirait revenus à la grande époque de DBase sous DOS! (nostalgie).

== 3 Rappel: Utilisation de la commande rpm. ==

ll existe de nombreux utilitaires tels que Kpackage, GnoRPM, Midnight Commander etc. qui permettent d'installer et de gérer les packages au format Red Hat (RPM).

Pour ma part je trouve plus rapide et au moins aussi efficace de travailler en mode ligne de commande en utilisant directement la commande rpm. Voir l'[../software/rpm.php3 article rpm] sur Léa. Encore plus simple, URPMI permet aujourd'hui une gestion complète des dépendances. Je vous laisse le soin de consulter la documentation.

== 4 Installation d'Apache ==

Note prélable : la plupart des distributions proposent aujourd'hui les versions 1.3.x et 2.x de Apache. Si Apache 2.x présente plus d'option pour la configuration avancée du serveur et d'autres caractéristiques liées à sa performance, le groupe de développement PHP n'a toujours pas validé la plate-forme sous cette version. On peut raisonnablement dire que pour un serveur personnel ou ne nécessitant pas de fonctionnalités particulières, Apache 1.3.x fait parfaitement l'affaire. C'est ce que nous utiliserons.

=== 4.1 Mise en place des rpm ===

L'installation d'Apache ne pose pas de problèmes. L'objectif est de disposer en fin d'installation des packages suivants :

* <code>apache2-common</code> : fichiers d'installation pour Apache et apache-mod_perl
* <code>apache2-modules</code> : ensemble des modules pour Apache
* <code>apache-conf</code> : fichiers de configuration de Apache
* <code>apache2</code> : le démon Apache
* <code>apache-manuel </code>(pas obligatoire mais peut se révéler utile).

<div class="code">

<nowiki># urpmi apache2
Pour satisfaire les dépendances, les paquetages suivants vont être installés (1 Mo):
apache-conf-2.0.48-2mdk.i586
apache2-2.0.48-6mdk.i586
apache2-common-2.0.48-6mdk.i586
apache2-modules-2.0.48-6mdk.i586
Est-ce correct ? (O/n)
Préparation... ##################################################
1:apache-conf ##################################################
2:apache2-modules ##################################################
3:apache2-common ##################################################
4:apache2 ##################################################</nowiki>

</div>

Le package <code>apache-conf</code> contient en particulier les fichiers de configuration <code>/etc/httpd/conf/httpd.conf</code> et <code>/etc/httpd/conf/commonhttpd.conf</code> qui définissent les paramètres de fonctionnement du serveur[#foot94 ][#foot94 ]<sup>[#foot94 Note 1]</sup>

=== 4.2 Premier test d'Apache ===

Le fonctionnement d'Apache est matérialisé par la mise en route d'un démon nommé '''httpd'''. Pour mettre en route, arrêter, vérifier etc. ce service tapez /etc/rc.d/init/httpd option ou option peut prendre les valeurs start, stop, restart, status ou extendedstatus selon votre besoin. En clair, pour démarrer Apache tapez <code>/etc/rc.d/init.d/httpd start[#foot95 ][#foot95 ]</code><sup>[#foot95 ]<br />Note 2 Sur Mandrake, vous pouvez également utiliser la commande <code>service</code><nowiki>: </nowiki><code>service httpd start</code> par exemple.</sup>

.

En principe l'installation d'Apache a modifié les fichiers de configuration du lancement de LINUX. Le démon httpd devrait donc démarrer systématiquement et automatiquement à chaque boot. L'installation a par ailleurs démarré immédiatement ce démon, il n'est donc pas nécessaire de rebooter comme on le ferait avec un autre système d'exploitation très connu avec lequel le moindre changement de mulot passe par un reboot...

Nous pouvons par ailleurs passer immédiatement au test du serveur sans passer par la moindre phase de configuration. Pour cela chargez votre navigateur préféré (pour ma part j'utilise Konqueror). Saisir ``<code>http://localhost</code><nowiki>'' dans la barre d'URL. Vous voyez apparaître après quelques instant une page de présentation d'Apache. En fait le serveur Apache vient d'envoyer la page </nowiki><code>/var/www/html/index.shtml</code>, affirmation que vous pourrez facilement vérifier en tapant ``<code>file:/var/www/html/index.shtml</code><nowiki>'' dans la barre d'URL de votre navigateur. Attention: il n'y a qu'un slash après </nowiki><code>file:</code> alors que par habitude vous pourriez être tentés (comme moi!) d'en mettre deux.

La page affichée dans ce cas est bien la même que la première. Les différences d'affichage dans les parties graphiques s'expliquent par le fait que l'affichage a été demandé en direct au lieu de passer par le serveur Apache.

Si vous préférez utiliser Lynx (un navigateur en mode texte ultra rapide puisqu'il ne charge pas les parties graphiques) vous pouvez même vous contenter de taper ``<code>lynx localhost</code><nowiki>''. Lynx ajoutera automatiquement ce qui manque. Merveilleux de simplicité non ?</nowiki>

<br />

== 5 Installation de PHP ==

=== 5.1 Mise en place des paquetages rpm ===

L'installation de PHP doit contenir :

* <code>libphp-common432</code>
* <code>php.ini</code>
* <code>mod_php</code>

<nowiki>L'installation de ces packages ne devrait pas poser de problème particulier. Sauf erreur ils s'installent automatiquement avec l'option d'installation ``recommandée'' de Mdk. Vérifiez toutefois la présence de </nowiki><code>mod_php</code> (<code>rpm -qa | grep php</code>) !

<div class="code">

<nowiki># urpmi php
Un des paquetages suivants est nécessaire :
1- apache2-mod_php-2.0.48_4.3.4-1mdk.i586
2- mod_php-4.3.4-1mdk.i586
3- php-cli-4.3.4-4mdk.i586
4- php-cgi-4.3.4-4mdk.i586
Que choisissez-vous ? (1-4)1
Préparation... ##################################################
1:apache2-mod_php ##################################################
Shutting down httpd2: [ OK ]
Checking configuration sanity for Apache 2.0: [ OK ]
Starting httpd2: [ OK ]</nowiki>

</div>

L'installation des rpm se termine par un redémarrage de Apache afin de prendre en compte le module PHP.

=== 5.2 Premier script PHP ===

Il importe maintenant de réaliser le premier test. Créez un sous répertoire <code>/var/www/html/test/</code> puis créez dans ce sous répertoire un fichier <code>test.php</code> contenant :

<div class="code"><html><br /> <?<br /> echo 'premier test php<br><br>';<br /> phpinfo();<br /> ?> <br /> </html></div>

Sauvegardez et chargez dans un navigateur (URL <code>http://localhost/test/test.php</code>).

Voilà votre première page web dynamique ! Vous avez, en quelques lignes, créé du code html (les balises <html> et </html>), faite générer du html par PHP (<code>echo 'premier test php<br><br>';</code>), les <br> sont des retours chariots, et fait appel à l'une des nombreuses fonctions de PHP, phpinfo() qui donne les principales informations sur le configuration actuelle de PHP.

Vous pourrez réaliser d'autres tests, l'aide nécessaire est à votre disposition dans les bouquins, les revues et sur le net.

Lorsque vous aurez constitué un petit groupe de fichiers de test vous pourrez alors faire l'expérience suivante :

* tapez simplement <code>http://localhost/test/</code> dans la barre d'URL de votre navigateur, celui-ci affiche la liste des fichiers créés, en fait le contenu du sous répertoire <code>/var/www/html/test/</code>. Si vous cliquez sur l'un des fichiers vous lancez le serveur Apache qui va interpréter le code PHP contenu dans le fichier choisi.
* copiez l'un des fichiers (ou renommez le) vers index.php. La même URL que précédemment affiche alors directement les contenu de index.php! Le contenu du sous répertoire n'est plus visible! L'accès aux différents fichiers reste toutefois possible si vous tapez directement leurs noms respectifs.
* effacez le ficher <code>index.php</code>, l'affichage de la liste des fichiers est à nouveau possible. C'est pratique pour éviter qu'un visteur de passage puisse consulter le contenu d'un sous-répertoire. Bien sûr c'est un simple truc, pas un rideau de fer contre un kracker expérimenté, mal intentionné et patient !

== 6 Installation de MySQL ==

=== 6.1 Mise en place des rpm ===

L'installation de '''mysql''' est elle aussi très simple. Les packages suivants sont nécessaires (ils devraient avoir été installés par défaut, en cas de besoin les installer par la suite):

* <code>mysql-common</code>
* <code>mysql-client</code>
* <code>mysql</code>

MySQL-client n'est pas indispensable. Il s'agit en fait de la partie client de l'ensemble client-serveur. Ce client permet toutefois (attention, en mode texte c'est plutôt spartiate !) de faire quelques requêtes au serveur.

<div class="code">

<nowiki>'# urpmi mysql
Un des paquetages suivants est nécessaire :
1- MySQL-4.0.18-1.1.100mdk.i586
2- MySQL-Max-4.0.18-1.1.100mdk.i586
Que choisissez-vous ? (1-2)1
Pour satisfaire les dépendances, les paquetages suivants vont être installés (18 Mo):
MySQL-4.0.18-1.1.100mdk.i586
MySQL-client-4.0.18-1.1.100mdk.i586
MySQL-common-4.0.18-1.1.100mdk.i586
libmysql12-4.0.18-1.1.100mdk.i586
perl-Mysql-1.22_19-9mdk.i586
Est-ce correct ? (O/n)
Préparation... ##################################################
1:libmysql12 ##################################################
2:MySQL-client ##################################################
3:perl-Mysql ##################################################
4:MySQL-common ##################################################
5:MySQL ##################################################
040512 12:40:46 /usr/sbin/mysqld: Shutdown Complete
# service mysql start
Lancement du serveur MySQL [ OK ]</nowiki>

</div>

En principe après l'installation de mysql vous devriez disposer d'un serveur MySQL opérationnel (et en marche). Pour le vérifier tapez <code>ps -ax | grep mysql</code>. Vous devriez voir s'afficher quelques lignes relatives à autant de serveurs en attente de requêtes. Si tel n'est pas le cas tapez (comme root) "<code>safe_mysql &</code>" dans une fenètre texte. Cette commande devrait démarrer le serveur MySQL.

<u>Attention</u> : l'installation par défaut utilise root comme super administrateur du serveur et le mot de passe root. Faites donc un essai de fonctionnement du serveur MySQL en utilisant simplement le client MySQL en mode texte.

<div class="code"><nowiki># mysql -p</nowiki><br /> Enter password:<br /> Welcome to the MySQL monitor. Commands end with ; or \g.<br /> Your MySQL connection id is 4 to server version: 4.0.18-log<br /><br /> Type 'help;' or '\h' for help. Type '\c' to clear the buffer.<br /><br /> mysql></div>

Tapez alors quit à l'invite mysql et vous voilà sorti.

Il va falloir faire fonctionner tout ce petit monde ensemble! Apache et PHP sont déjà opérationnels. Ils communiquent ensemble, l'essai a été fait. MySQL est en route également. Pour que PHP puisse entrer en contact avec MySQL il lui faut un minimum de connaissances qui lui sont apportées par le module '''php-mysql'''.

<div class="code">

<nowiki># urpmi php-mysql
Préparation... ##################################################
1:php-mysql ##################################################</nowiki>

</div>

Pensez donc à l'installer lui aussi sinon pas de langue commune! Redémarrez Apache.

=== 6.2 Installation du script phpMyAdmin ===

Plutôt que de vous lancer dans la rédaction d'un premier script php qui va s'adresser au serveur MySQL (pour lui dire quoi ? Rien n'existe encore, ou si peu !) je vous suggère de récupérer sur le net un ensemble de scripts nommé phpMyAdmin. Il s'agit tout simplement d'un ensemble de scripts PHP qui va vous permettre, via un navigateur, d'administrer vos premières bases de données, de lire les bases de données système MySQL (celles qui définissent les droits des utilisateurs), d'en créer d'autres.

<div class="code"><nowiki># urpmi phpmyadmin</nowiki><br /> Préparation... ##################################################<br /> 1:phpMyAdmin ##################################################</div>

=== 6.3 Premier test ===

Une fois l'installation faite utilisez votre navigateur préféré et tapez <code>http://localhost/admin/phpMyAdmin/</code> dans la barre d'URL. Vous devriez voire apparaître une page html "Bienvenue à phpMyAdmin 2.5.4 - Connexion". Il vous reste à modifier le fichier /var/www/html/admin/phpMyAdmin/config.inc.php et le paramètre <code><nowiki>$cfg['blowfish_secret'] = '';</nowiki></code>.<br /> Exemple : <code>$cfg['blowfish_secret'] = 'ma phrase secrete';</code>

Rechargez la page de votre navigateur, voilà vous êtes prêts à l'utiliser !

== 7 Synthèse ==

Vous venez de créer deux ensembles de données, les répertoires contenant les pages HTML/PHP, et les répertoires contenant les bases de données MySQL.

* Les pages PHP/HTML sont rangées dans <code>/var/www/html/</code>. La page d'accueil Apache est à l'adresse <code>/var/www/html/index.shtml</code> (rappel !). Le sous-répertoire <code>/var/www/html/admin/phpMyAdmin</code> contient le script de connexion à MySQL. Vous pourrez créer d'autres sous répertoires contenant vos premiers essais, par exemple <code>/var/www/html/test/</code> qui sera accessible à l'URL <code>http://localhost/test/</code>.
* Les données MySQL sont rangées dans <code>/var/lib/mysql/</code>. Chaque base de données correspond à un sous-répertoire. Exemple : <code>/var/lib/mysql/mysql/</code> contient les tables qui définissent les droits d'accès à MySQL. Ce sous-répertoire n'est évidemment accessible que pour l'administrateur système. Si vous créez une nouvelle base de données avec phpMyAdmin ou directement en utilisant le client MySQL, le serveur créera un nouveau sous répertoire /var/lib/mysql/test par exemple si votre nouvelle base s'appelle test.

== Conclusion ==

<nowiki>La description ci-dessus avait pour but de vous conduire à disposer d'un serveur Apache qui soit opérationnel et qui puisse mettre en oeuvre des bases de données MySQL via PHP. Ce but étant atteint il convient maintenant d'être modeste. Le vrai travail commence juste. Lisez les docs, les man pages. Il existe aussi d'excellents bouquins sur la question. Pour ma part j'étudie actuellement ``Pratique de MySQL et PHP'' édition O'Reilly. Je le trouve très bien fait.</nowiki>

Enfin, lisez [[reseau-web-Apache_protec|Protection d'un serveur Apache PHP MySQL]], concernant la sécurisation] de l'environnement que l'on vient de créer.

== Remerciement ==

Lors d'une installation il est courant de progresser un peu à tâtons, par essais successifs. Après quelques heures de bagarre (qui peuvent être réparties sur plusieurs jours) il faudrait être un sur-homme pour se souvenir de tout ce qu'on a fait. La mise au point d'un document comme celui-ci ne peut donc se faire qu'après plusieurs installations réussies. Idéalement la bêta-version du document doit elle-même être testée par un autre personne qui suit scrupuleusement la description et commente les erreurs, inversions, oublis etc. Je remercie donc M. Guy ASSFELD d'avoir bien voulu apporter sa contribution à ce travail en déboguant la première version.

== L'auteur ==

JML dit Jean-Marc LICHTLE, email jean-marc.lichtle@gadz.org, ingénieur Arts et Métiers promo CH173 (rigolez pas, à l'époque le hi-tech c'était les cartes perforées sur IBM 1130) !

<br />

----

==== Notes ====

; ... serveur<sup>[#tex2html1 1]</sup>
: <nowiki>De nombreuses distributions ne se contente plus du seul fichier httpd.conf. La version contenue dans LINUX Mandrake 10.0 utilise un fichier supplémentaire, commonhttpd.conf qui est appelé par httpd.conf par un ``include''.</nowiki>
; ... start<sup>[#tex2html2 2]</sup>
: Je ne précise pas, il va sans dire que certaines commandes ne peuvent être lancées que par l'administrateur système (root). L'appel à httpd fait partie de ces commandes réservées. Donc si LINUX vous fait un bras d'honneur commencez par vous poser la question de votre habilitation à lancer une commande.

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa a été convertie avec HTML::WikiConverter. Elle fut créée par Jean-Marc LICHTLE le 01/10/2001.</div>

= Copyright =
Copyright © 01/10/2001, Jean-Marc LICHTLE
{{CC-BY-NC-SA}}

EGroupware

2005-12-14T09:43:46Z

Anthony : /* Configuration d'eGroupWare */

[[Category:Applications]]
= Une solution de groupware OpenSource =

<div class="leatitre">Une solution de groupware OpenSource</div><div class="leapar">Par [mailto:anne@lea-linux.org Anne]</div>

== Quand l'évolution des technologies impacte sur l'organisation d'entreprise ==

Le schéma organisationnel des entreprises qui était plutôt de type hiérarchique et rigide il y a quelques années tend à s'aplatir et se doter de nombreuses fonctionnalités transversales.

Cette évolution implique donc un remaniement des modes de communication et d'organisation, ainsi que du système d'information. Un des outils clé de ce changement est le groupware qui dote l'entreprise de moyens simples et efficaces pour permettre à l'ensemble de ses collaborateurs d'y parvenir : partage de l'information à travers de multiples calendriers privés ou non, de forums, d' outils collaboratifs (de type wiki), de gestionnaire de contacts...

Les quatre membres fondateurs d'eGroupWare sont issus du projet phpGroupWare. Celui-ci n'évoluant pas selon eux dans la bonne direction et ne collant pas assez aux besoins exprimés par les utilisateurs d'un groupware, ils décidèrent de forker(partir et refaire) le projet et d'initier ainsi eGroupWare.

L'objectif clairement annoncé est de concurrencer des solutions commerciales comme Notes et Exchange tout en respectant les principes de l'Open Source. à cet effet l'équipe d'eGroupWare a donc orienté son outil en fonction de ce que doit apporter un logiciel de groupware dans une entreprise, une association,...

Selon Reiner Jung, chef de projet eGroupWare : "Souvent les gens définissent le groupware comme un regroupement de fonctions comme le mail, une todo liste, des notes et un calendrier. àa n'est pas notre définition. Un groupware devrait offrir un espace de travail partagé. Cet espace doit mettre à disposition un ensemble de modules pour le travail de tous les jours. Dans mon activité quotidienne, je partage aussi des fichiers, gère mes projets, les développeurs ont besoin d'un wiki, d'un forum pour les discussions... Quand je peux exécuter la plupart de mes tâches quotidiennes à travers un groupware, alors c'en est un véritablement. Nous sommes sur la voie de ce genre de réalisation."

Dans de nombreux projets, les développeurs et/ou les entreprises créent un road map et décident des besoins des utilisateurs à la version suivante. àa n'est pas la bonne façon de procéder. Nous voulons obtenir un groupware qui remplisse les besoins d'utilisateurs dans le monde professionnel. Selon moi, ce sont les utilisateurs qui développent eGroupWare. Ils ont souvent des connaissances plus importantes que nous sur le fonctionnement d'un groupware et savent pertinemment ce dont ils ont besoin. Le projet doit réaliser, coordonner les demandes, s'assurer de sa viabilité, sa stabilité et sa sécurité."

Particularité de fonctionnement : le groupe propose à des entreprises qui souhaitent voir une ou plusieurs fonctionnalités aboutir plus rapidement de financer des heures de développement.. La méthode est de plus en plus courante et gage d'adéquation du développement aux besoins réels.

Un des avantages d'eGroupWare est sa simplicité de mise en place. Elle ne doit toutefois pas occulter la complexité que représente la mise à plat du circuit de l'information dans une organisation. En effet, le groupware ne sera finalement que le reflet de ce schéma organisationnel. L'objet de cet article est de montrer pas à pas la solution technique. Nous n'aborderons pas l'étape préalable indispensable qui consiste à partir de l'organigramme de l'entreprise pour mettre en place des groupes d'utilisateurs et organiser les différents niveaux d'accès à l'information.

eGroupWare est constitué d'un ensemble de modules présentant les fonctionnalités suivantes :

* webmail
* carnet de contacts
* calendrier partagé
* forum
* wiki
* CMS
* gestion de tickets d'incident
* éditeur de site wysiwyg
* lient FTP et gestionnaire de fichiers
* messagerie instantanée
* gestionnaire de projets
* outil de sondage
* gestion graphique des utilisateurs et groupes, ainsi que de leur compte mail et LDAP
Chacun de ces modules, on le verra, peut être partagé avec tout ou partie des utilisateurs accédant à eGroupWare. Passons aux choses concrètes : les prérequis
Passons maintenant à l'installation de la plate-forme qui va supporter eGroupWare. Nous avons fait le choix d'une Mandrake 10.0 pour supporter cette plate-forme.
== Installer une plate-forme LAMP ==
L'application nécessite au moins un serveur web, PHP et une base de données. Il est possible de l'installer sur IIS, mais pour une raison on ne peut plus partisane, nous choisirons Apache sur Linux. L'ensemble des informations du groupware et notamment le système d'ACL (Access control List) est stocké dans une base de donnée, qui peut être MySQL ou PostgreSQL.
Nous allons décrire ci-dessous les modalités d'installation de cette plate-forme LAMP (Linux, Apache, MySQL, PHP).
'''La première étape consiste à installer Apache :'''
<div class="code">
<nowiki># urpmi apache2
Pour satisfaire les dépendances, les paquetages suivants vont être installés (1 Mo):
apache-conf-2.0.48-2mdk.i586
apache2-2.0.48-6mdk.i586
apache2-common-2.0.48-6mdk.i586
apache2-modules-2.0.48-6mdk.i586
Est-ce correct ? (O/n)
Préparation... ##################################################
1:apache-conf ##################################################
2:apache2-modules ##################################################
3:apache2-common ##################################################
4:apache2 ##################################################</nowiki>
</div>
Le fichier de configuration est /etc/httpd/conf/httpd.conf. (Mandrake a délocalisé une partie de ce fichier dans /etc/httpd/conf/commonhttpd.conf). La configuration par défaut permet de lancer dès maintenant le service Apache :
<div class="code">
<nowiki># service httpd start
Starting httpd: [ OK ]</nowiki>
</div>
La plate-forme nécessite également l'installation de PHP :
<div class="code">
<nowiki># urpmi php
Un des paquetages suivants est nécessaire :
1- apache2-mod_php-2.0.48_4.3.4-1mdk.i586
2- mod_php-4.3.4-1mdk.i586
3- php-cli-4.3.4-4mdk.i586
4- php-cgi-4.3.4-4mdk.i586
Que choisissez-vous ? (1-4)1
Préparation... ##################################################
1:apache2-mod_php ##################################################
Shutting down httpd2: [ OK ]
Checking configuration sanity for Apache 2.0: [ OK ]
Starting httpd2: [ OK ]</nowiki>
</div>
Là encore la configuration proposée permet un fonctionnement immédiat de PHP. Il nous reste enfin à installer le serveur MySQL :
<div class="code">
<nowiki># urpmi mysql
Un des paquetages suivants est nécessaire :
1- MySQL-4.0.18-1.1.100mdk.i586
2- MySQL-Max-4.0.18-1.1.100mdk.i586
Que choisissez-vous ? (1-2)1
Pour satisfaire les dépendances, les paquetages suivants vont être installés (18 Mo):
MySQL-4.0.18-1.1.100mdk.i586
MySQL-client-4.0.18-1.1.100mdk.i586
MySQL-common-4.0.18-1.1.100mdk.i586
libmysql12-4.0.18-1.1.100mdk.i586
perl-Mysql-1.22_19-9mdk.i586
Est-ce correct ? (O/n)
Préparation... ##################################################
1:libmysql12 ##################################################
2:MySQL-client ##################################################
3:perl-Mysql ##################################################
4:MySQL-common ##################################################
5:MySQL ##################################################
040512 12:40:46 /usr/sbin/mysqld: Shutdown Complete</nowiki>
</div>
On procède ensuite au démarrage du service :
<div class="code">
<nowiki># service mysql start
Starting mysql: [ OK ]</nowiki>
</div>
L'installation nécessite enfin un certain nombre de modules pour Apache, nécessaires au bon fonctionnement d'eGroupWare.
<div class="code">
<nowiki># urpmi php-mysql php-xml php-imap php-ldap
Préparation... ##################################################
1:php-imap ##################################################
2:php-xml ##################################################
3:php-mysql ##################################################
4:php-ldap ##################################################</nowiki>
</div>
Voilà votre plate-forme prête à fonctionner !
== L'annuaire LDAP ==
Il est également possible d'adosser le groupware à un annuaire LDAP (site officiel : http://openldap.org). Avantage de la méthode : il va permettre de centraliser . C'est l'option qui sera présentée ici car elle permet d'utiliser de manière optimale les fonctionnalités d'eGroupWare. L'installation du serveur LDAP est simple :
<div class="code">
<nowiki># urpmi openldap-servers openldap-client
Préparation... ##################################################
1:openldap-servers ##################################################
2:openldap-client ##################################################</nowiki>
</div>
Le recours à un annuaire LDAP présuppose deux choses : l'installation du module php-ldap pour Apache (ce que nous avons fait dans le paragraphe précédent) et l'intégration d'une classe nécessaire pour inclure des paramètres eGroupWare dans la définition des comptes de groupes et d'utilisateurs. Pour ce faire, copiez les schémas fournis dans les sources (les schémas seront ajoutés dès la prochaine version du RPM Mandrake), phpgwaccount.schema et phpgwcontact.schema dans l'arborescence LDAP. Comme leurs noms l'indiquent, l'un permet de définir les comptes de groupes et d'utilisateurs, l'autre permet de définir le stockage des contacts dans l'annuaire. Pour finir, déclarez l'utilisation de ces schémas dans slapd.conf et redémarrez le serveur.
<div class="code"><nowiki># ls /etc/openldap/schema</nowiki><br /> local.schema phpgwaccount.schema phpgwcontact.schema<br /> # cat /etc/openldap/slapd.conf<br /> ...<br /> include /etc/openldap/schema/phpgwaccount.schema<br /> include /etc/openldap/schema/phpgwcontact.schema<br /> ...<br /> # service ldap restart</div>
== Le support de la messagerie ==
Nous allons utiliser également un serveur SMTP et un serveur POP/IMAP. Les choix réalisés par l'équipe d'eGroupWare privilégient Postfix d'un côté et Cyrus-IMAP de l'autre. Il est tout à fait envisageable d'utiliser d'autres produits mais ceux-ci ont l'avantage de permettre ensuite la gestion du compte de messagerie à travers l'interface du groupware (gestion des boites mail, alias de mail, forwards, et bientôt les absences).
Attention : les requêtes sur les utilisateurs eGroupWare concernant la messagerie se basent sur la classe qmailUser et l'attribut mailAlternateAddress. Ci-dessous un extrait du fichier de configuration de Postfix main.cf concernant la construction de la requête LDAP à effectuer :
<div class="code"><nowiki># cat /etc/postfix/main.cf</nowiki><br /><br /> virtual_alias_maps = ldap:ldapuser, ldap:ldapgroup<br /><br /> ldapuser_server_host = 127.0.0.1<br /> ldapuser_server_port = 389<br /> ldapuser_bind = yes<br /> ldapuser_bind_dn = cn=adminmail,dc=domain,dc=com<br /> ldapuser_bind_pw = Xd25./T<br /> ldapuser_search_base = ou=Personnes,dc=domain,dc=com<br /> ldapuser_timeout = 60<br /> ldapuser_query_filter = (&(objectclass=qmailUser)(mailAlternateAddress=%s))<br /> ldapuser_result_attribute = mail<br /> ldapuser_lookup_timeout = 60<br /><br /> ldapgroup_server_host = 127.0.0.1<br /> ldapgroup_server_port = 389<br /> ldapgroup_bind = yes<br /> ldapgroup_bind_dn = cn=adminmail,dc=domain,dc=com<br /> ldapgroup_bind_pw = Xd25./T<br /> ldapgroup_search_base = ou=Groupes,dc=domain,dc=com<br /> ldapgroup_timeout = 60<br /> ldapgroup_query_filter = (&(objectclass=mailRecipient)(mailAlternateAddress=%s))<br /> ldapgroup_result_attribute = rfc822MailMember<br /> ldapgroup_lookup_timeout = 60<br /> ....</div>
On pourra bien sur affiner cette configuration mais ce n'est pas l'objet de l'article. Consulter Postfix-Cyrus-Web-cyradm-HOWTO, un bon point de départ.
== L'installation de eGroupWare ==
=== Les étapes de l'installation ===
L'installation peut se faire à partir des sources :
<div class="code"><nowiki># cd /var/www/html</nowiki><br /> # tar xjf eGroupWare-0.9.99.015-1.tar.bz2</div>
Comme nous travaillons sur une Mandrake, nous utiliserons les packages prévu à cet effet. Il est possible de télécharger le package édité par l'équipe d'eGoupWare (eGroupWare-all-apps-0.9.99.015-1.noarch.rpm). Toutefois dans un soucis de cohérence, nous utiliserons les packages fournis par la source contrib de Mandrake. Pour installer eGroupWare et tous ses modules :
<div class="code"><nowiki># urpmi -a egroupware egroupware-</nowiki></div>
Par défaut les fichiers s'installent dans /var/www/html/egroupware.
Le processus d'installation d'eGroupWare prévoit la création de la base de donnée pour MySQL et PostgreSQL. Nous reprenons ci-dessous les étapes qui permettent la création en ligne de commande de la base et d'un utilisateur qui aura les droits sur cette base pour MySQL.
<div class="code"><nowiki># mysqladmin --user=root create egroupware</nowiki><br /> # mysql --user=root mysql<br /> mysql> GRANT ALL ON egroupware.* TO egroupware@localhost IDENTIFIED BY 'passwd';<br /> mysql> flush privileges;</div>
Voilà , nous laissons de côté maintenant la ligne de commande pour passer à l'installeur web d'eGroupWare. L'installation va alors se faire en 3 étapes à partir de l'URL suivante dans notre cas : http://localhost/egroupware/setup.
=== Vérification de l'installation ===
[[Image:egroupware-egw1.png]]
=== Génération du fichier header.inc.php ===
[[Image:egroupware-egw2.png]]
Ce fichier contient les paramètres de base d'eGroupWare comme les paramètres de connexion à la base de données mais aussi la possibilité d'en générer plusieurs instances en définissant des domaines. Cette notion peut être utile si l'on souhaite par exemple définir deux interfaces distinctes d'eGroupWare, par exemple, l'Intranet et les clients.
Vous allez également créer deux utilisateurs clés : l'un vous servira à rééditer cette page, l'autre à poursuivre la procédure d'installation.
Il est recommandé de conserver une sauvegarde de ce fichier.
=== Installation des applications ===
[[Image:egroupware-egw3.png]]
Connectez-vous comme demandé.
L'étape suivante consiste à valider l'installation des différents applications du groupware et créer les tables correspondantes dans votre base de données.
=== Configuration d'eGroupWare ===
[[Image:egroupware-egw4.png]]
La configuration se présente ensuite comme une série de champs à renseigner. L'installation d'eGroupWare nécessite la création d'un répertoire, de préférence hors de l'arborescence Apache qui contiendra notamment les fichiers uploadés par l'intermédiaire du gestionnaire de fichiers. Ce répertoire devra être accessible à l'utilisateur exécutant l'instance Apache (le répertoire est créé par défault, vérifiez qu'il existe, sinon tapez le code ci desous).
<div class="code"><nowiki># mkdir /var/lib/egroupware</nowiki><br /> # chown -R apache:apache /var/lib/egroupware</div>
Vous devrez également spécifier l'IP ou le nom de votre serveur FTP si vous souhaitez utiliser le module FTP du groupware.
[[Image:egroupware-egw5.png]]
Nous voilà maintenant arrivés à la configuration de l'authentification et des comptes utilisateurs. Plusieurs options s'offrent à vous. Si vous ne disposez pas d'annuaire LDAP, choisissez de stocker les comptes dans la base de données. Dans notre cas, ayant recours à LDAP, nous allons donc compléter les éléments nécessaires. Ils sont classiques pour ceux qui ont l'habitude de manipuler ce service : home directory à utiliser, shell, contexte des OU (Organizational Units) d'utilisateurs et de groupes, manager de LDAP et mot de passe.
Il est indispensable également d'autoriser l'utilisation de LDAP v.3, que l'on retrouve par défaut dans la majorité des distributions. Enregistrer la configuration obtenue.
Nous compléterons cette phase par la création d'un compte administrateur qui sera utilisé ensuite pour l'administration du groupware (gestion des ACL, gestion des utilisateurs et des applications). Il vous est d'ailleurs proposé de créer des comptes de démonstration pour tester le bon fonctionnement de l'application. Vous pouvez en vérifier la création dans l'annuaire :
<div class="code"><nowiki># ldapsearch -x "uid=adminegw"</nowiki><br /> # adminegw, Users, domain, com<br /> dn: uid=adminegw,ou=Users,dc=domain,dc=com<br /> phpgwAccountType: u<br /> uidNumber: 2008<br /> objectClass: top<br /> objectClass: person<br /> objectClass: organizationalPerson<br /> objectClass: inetOrgPerson<br /> objectClass: posixAccount<br /> objectClass: shadowAccount<br /> objectClass: phpgwAccount<br /> cn: adminegw adminegw<br /> uid: adminegw<br /> sn: adminegw<br /> givenName: adminegw<br /> homeDirectory: /home/adminegw<br /> loginShell: /bin/false<br /> gidNumber: 2<br /> phpgwAccountStatus: A<br /> phpgwAccountExpires: -1</div>
L'utilisateur est bien créé et on retrouve la classe phpgwAccount ainsi que les attributs élémentaires : phpgwAccountType (u : user ou g : groupe), phpgwAccountStatus (A : compte actif), phpgwAccountExpires (-1 : jamais).
La configuration est maintenant terminée. Vous pouvez toutefois à ce stade gérer les langues (ajouter / supprimer). 22 langues sont aujourd'hui disponibles, par défaut sont sélectionnés l'anglais et le français. Vous pouvez également gérer les applications. Le mode d'installation que nous avons utilisé fournit toutes les applications disponibles, vous pouvez restreindre cette liste.
L'installation et la configuration de base sont maintenant terminées, nous passons à la configuration de l'utilisation du groupware.

== Configuration du groupware ==
Une fois connecté en tant qu'administrateur du groupware, allez sur le paneau d'administration . [[Image:egroupware-egw6.png]]
Il vous offre les fonctionnalités suivantes :
* gestion des applications
* gestion des utilisateurs
* configuration du site et paramétrage mail
* gestion des catégories et ACL
Avant de poursuivre il est indispensable de définir ces 2 dernières notions qui sous-tendent toute la configuration qui va suivre.
=== ACL et catégories globales ===
[[Image:egroupware-egw7.png]]
Les ACL sont un terme générique (Acces Control List) que l'on retrouvera dans de nombreuses applications. Elles vont définir les droits d'accès d'un utilisateur et/ou d'un groupe aux données d'une application. Elles sont au nombre de quatre : lecture, ajout, modification, suppression.
Dans notre exemple, les membres du groupe commerciaux auront tous les droits sur les données du gestionnaire de fichiers relatives à leur groupe. Seuls les membres du groupe techniciens auront un accès en lecture.
[[Image:egroupware-egw8.png]]<br />
Les catégories globales permettent d'organiser les données et sont communes à toutes les applications. Il est possible également de créer des catégories spécifiques à une application ainsi que des catégories personnelles. Elles sont importantes car elles permettent de rationaliser l'affichage des données et de d'organiser celles-ci plus clairement.
=== Une administration centralisée des utilisateurs ===
La gestion des utilisateurs et des groupes peut se faire à plusieurs niveaux :
[[Image:egroupware-egw9.png]]
* le module de gestion de comptes utilisateurs : il permet de créer, modifier, supprimer un utilisateur. Les modifications portent sur les données de base du compte, la configuration mail, les applications attribuées spécifiquement à un utilisateur.[[Image:egroupware-egw10.png]]
* le module de gestion de comptes de groupes : il permet de positionner les utilisateurs dans le groupe choisi. Pour pouvoir positionner les ACL, cliquer sur l'application et sauvegarder puis cliquer à nouveau sur la puce situé à droite de la dite application.<br /> On conseille souvent d'utiliser un groupe "Default" dans lequel on positionnera tous les utilisateurs. Celui-ci permettra de fixer les applications de base communes à tous ainsi que des ACL. On affinera ensuite groupe par groupe ces ACL en fonction des besoins.
* On trouve enfin la gestion des préférences utilisateurs. Ces préférences agissent sur l'ergonomie des applications, leur mode de visualisation, la possibilité ou non de personnaliser la configuration. Ces préférences peuvent être définies par les utilisateurs eux-mêmes mais restreintes par l'administrateur qui positionnera des préférences forcées pour une ou plusieurs applications. Enfin on dispose également de la possibilité de fixer des préférences par défaut.
== Revue de détail des principales applications ==
Nous allons ici passer en revue les applications les plus courantes ainsi que leurs fonctionnalités dans le cadre du groupware.
* Messagerie<br />[[Image:egroupware-egw11.png]]<br /> eGroupWare propose deux types de webmails qui offrent les fonctionnalités classiques de ce type de client. On trouve entre autres un lien avec le carnet de carnet d'adresses.
* Carnet d'adresses<br /> Il s'agit la d'une fonctionnalité classique. Il permet des importations et des exportations à partir de différents formats standards. L'ensemble des contacts est stockable dans une base LDAP.
* Calendrier<br />[[Image:egroupware-egw12.png]]<br /> Le calendrier dispose de vues quotidienne, par semaine, mensuelle ou annuelle. On peut ajouter des événements pour soi-même, d'autres utilisateurs ou des groupes. Il est possible alors de générer des alarmes par mail pour prévenir les différents participants. Ce calendrier est également doté d'un système de confirmation pour chaque événement qui permet ainsi au mieux leur planification.
Egalement à disposition, un planificateur de tâches, qui permet de visualiser rapidement les plages horaires disponibles pour fixer un rendez-vous pour une ou plusieurs personnes.
* Infolog <br /> C'est un outil à mi chemin entre le post-itÂ© et la mini gestion de projet. Il permet de programmer des tâches, en associant ou non d'autres participants, des contacts, des événements du calendrier, des fichiers. Des indicateurs permettent ensuite de visualiser la progression du dit projet.
L'application propose en tout une quinzaine de modules.
== Sécurisation et optimisation de l'installation ==
La sécurisation de la plate-forme supportant eGroupWare relève des conseils habituels liés à l'administration d'une plate-forme LAMP (Linux-Apache-MySQL-PHP).
Concernant le serveur MySQL, vérifiez que l'utilisateur root dispose bien d'un mot de passe. En effet, à l'installation du serveur, l'utilisateur root est initialisé dans la base " mysql" sans aucun mot de passe :
De plus nous allons restreindre l'accès au serveur MySQL aux seules requêtes lancées en local :
<div class="code"><nowiki># cat /etc/my.cnf</nowiki><br /> [mysqld]<br /> ...<br /> bind_address = 127.0.0.1<br /> ...</div>
Concernant la configuration de PHP, les développeurs apportent quelques conseils pour en optimiser les performances :
<div class="code">max_execution_time ? 30<br /> memory_limit ? 16 Mo<br /> register_globals = Off<br /> safe_mode = On</div>
Vous devrez également personnaliser le paramètre "upload_max_filesize" en fonction des besoins pour le gestionnaire de fichiers. C'est à ce niveau que la taille des uploads de fichiers de cette application sera limité et non par un paramètre propre au groupware.
Enfin eGroupWare peut gagner considérablement en rapidité d'exécution grâce à Turck MMCache. Il accélère l'interprétation du code PHP et réduit la charge du serveur.
<div class="code">
<nowiki># urpmi php-mmcache php-mmcache-admin
installation de php-mmcache php-mmcache-admin
1:php-mmcache ##################################################
2:php-mmcache-admin ##################################################</nowiki>
</div>
Attribuer un mot de passe à l'administrateur de l'interface de gestion du cache :
<div class="code"><nowiki># php -q /var/www/html/admin/php-mmcache/mmcache_password.php</nowiki><br /> Changing password for Turck MMCache Web Interface (mmcache.php)<br /><br /> Enter admin name: admincache<br /> New admin password: R3./po<br /> Retype new admin password: R3./po<br /><br /> Add the following lines into your php.ini and restart HTTPD<br /><br /> mmcache.admin.name="admincache"<br /> mmcache.admin.password="$1$BGhHjZ5A$wNPAxc3BfU12POJoxopBO/"</div>
On accède ensuite à l'interface de gestion du cache : http://localhost/admin/php-mmcache
== eGroupWare, les projets ==
Le projet est aujourd'hui disponible dans sa première version stable. Mais le groupe de développement travaille déjà sur ce que sera la prochaine version stable, la 1.2. Dans cette optique, de nombreux d'objectifs ont étés fixés et mis en avant.
Il est projeté de mettre à disposition un moteur de workflow1
Dans les développements très attendus, on note aussi un certain nombre de connecteurs vers l'extérieur qui permettront d'inclure encore plus le groupware dans son environnement : une synchronisation avec les PDA (ou organiseurs personnels en bon français) disponible très prochainement, un connecteur pour Evolution, et un connecteur pour Outlook.
Il est prévu également de travailler sur l'ergonomie de l'interface utilisateur et notamment un assistant pour la configuration de celle ci. De nouveaux modèles de documents, ainsi que de nouvelles fonctionnalités comme le glisser-déposer sont également au programme.
Des applications vont être ré-écrites, soit totalement (carnet d'adresses, gestion des accidents), soit partiellement(webmail, gestionnaire de fichiers, gestion de projets).
Enfin pour vérifier l'identité de l'utilisateur du groupware, celui-ci devrait inclure également une fonction d'autorité de certification, tout ceci dans un souci de mieux répondre aux exigences de sécurisation du système.
== Liens ==
* [http://egroupware.org le site du projet]
* [http://sourceforge.net/mail/?group_id=78745 les listes de diffusion (utilisateurs, développeurs)]
* [http://linuxfrench.net/article.php?id_article=1403 Interview de Reiner JUNG, chef de projet ]
* [http://httpd.apache.org le site d'Apache ]
* [http://www.mysql.com le site de MySQL ]
* [http://openldap.org le site de OpenLDAP ]
* [http://lea-linux.org/reseau/Apache_PHP_MySQL.html HOWTO plate-forme LAMP]
* [http://www.linux.com/howtos/Postfix-Cyrus-Web-cyradm-HOWTO/index.shtml HOWTO Postfix/Cyrus-IMAP]

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa a été convertie avec HTML::WikiConverter. Elle fut créée par Anne le 05/09/2004.</div>

= Copyright =
Copyright © 05/09/2004, Anne
{{CC-BY-NC-SA}}

Les permissions sur les fichiers

2005-12-12T13:37:51Z

Anthony : /* La propriété : <code>chown</code> */

[[Category:Environnement système]]
= Les permissions sur les fichiers =

<div class="leatitre">Les permissions sur les fichiers</div><div class="leapar">par Jean-Christophe</div><div class="leadesc">Dis Papa, c'est quoi <code>rwxr-xr-x</code> ? Tais-toi et nage !</div>
----

== Un peu de théorie ==

Dans ce chapitre, nous allons étudier les '''permissions sur les fichiers'''. Nous allons voir rapidement sur quoi la gestion des permissions se base.

=== Les utilisateurs et les groupes ===

Les fichiers appartiennent à un '''''utilisateur''''' à l'intérieur d'un '''''groupe d'utilisateurs'''''.

* L'''utilisateur'', c'est vous ! C'est un identifiant avec un mot de passe, qui sont définis dans le fichier <code>/etc/passwd</code>. On peut ajouter des utilisateurs à l'aide de la commande <code>useradd</code> ou <code>adduser</code> (voir <code>man adduser</code>). Certaines distributions fournissent des outils graphiques pour ce faire, comme <code>drakuser</code> de Mandrake.
* Le ''groupe d'utilisateurs'', défini dans le fichier <code>/etc/group</code>, permet de regrouper des utilisateurs dans des groupes (un même utilisateur peut faire partie de plusieurs groupes) afin par exemple de partager des permissions entre plusieurs utilisateurs. Par exemple, le groupe <code>quakeusers</code> peut être défini afin d'y placer les utilisateurs qui auront le droit d'utiliser le jeu Quake : on donnera par exemple la permission aux membres de ce groupe de lancer l'exécutable de ce jeu. De même, le groupe <code>cdrecording</code> aura les droits d'utiliser le graveur de CD.

=== Les droits possibles : R, W et X ===

Les droits que l'on peut attribuer à un fichier concernent :

* la lecture ('''<code>r</code>''' comme read),
* l'écriture ('''<code>w</code>''' comme write),
* l'exécution ('''<code>x</code>''' comme execute).

On peut attribuer ces droits pour :

* un utilisateur,
* les membres d'un groupe,
* le monde entier (i.e. les autres utilisateurs).

----

== Visualiser/modifier les permissions ==

=== Ligne de commande ===

En ligne de commande (voir la rubrique [shell.php3 Shell]), tapez :

<div class="code">[username@taz username]$ '''ls -la'''<br /><font size="-1">total 144 <br /> drwxr-xr-x   18 username     users        2048 jan  7 19:22 . <br /> drwxr-xr-x    7 root     root         1024 fév  6  1996 .. <br /> -rw-------    1 username     users         147 jan  7 19:22 .Xauthority <br /> -rw-r--r--    1 username     users        1899 jui 28 21:01 .Xdefaults <br /> -rw-------    1 username     users        5860 jan  7 19:22 .bash_history <br /> -rw-r--r--    1 username     users          24 jui 28 21:01 .bash_logout <br /> -rw-r--r--    1 username     users         262 jui 29 18:15 .bash_profile <br /> -rw-r--r--    1 username     users         434 jui 28 21:01 .bashrc <br /> -rw-r--r--    1 username     users        2626 jui 28 21:01 .emacs <br /> -rw-r--r--    1 username     users         532 jui 28 21:01 .inputrc <br /> drwxr-xr-x    3 username     users        1024 jui 28 21:01 .kde <br /> -rw-r--r--    1 username     users        1546 jan  7 19:04 .kderc <br /> -rwxr-xr-x    1 username     users        1166 jui 28 21:01 .kderc.rpmorig</font></div>

Pour une explication détaillée des différentes colonnes, voir la rubrique [shell.php3#ls Shell]. Nous n'allons ici nous intéresser qu'aux éléments relatifs aux permissions.

1. La première colonne -rw-r--r-- représente les permissions associées au fichier. <br />''(le premier caractère est le type du fichier fichier : un d pour un répertoire, un l pour un lien, etc.)''<br /> Ensuite, on a trois groupes de trois caractères : '''<code><font size="+1">rwx</font></code>'''. La présence de la lettre r w ou x accorde la permission, un tiret '-' la dénie.

'''<code>r</code>''' signifie : possibilité de lire ce fichier / dans ce répertoire, <br />'''<code>w</code>''' signifie : possibilité d'écrire dans ce fichier / répertoire, <br />'''<code>x</code>''' signifie : possibilité d'exécuter ce fichier / d'aller dans ce répertoire.

Les trois groupes de caractère s'appliquent, dans l'ordre, à :

# l'utilisateur auquel appartient le fichier,
# le groupe d'utilisateurs auquel est rattaché le fichier,
# les autres utilisateurs.

{|
| <code>-</code>
| <code>r w x</code>
| <code>r - x</code>
| <code>r - x</code>
|-
|
| utili-<br />sateur
| groupe
| autres
|}

2. La 3<sup>ème</sup> colonne est l'utilisateur à qui appartient le fichier. À cet utilisateur s'appliquent les permissions représentées par les trois premiers caractères de permissions de la première colonne (<code>-'''<font size="+1">rwx</font>'''r-xr-x</code>).

3. La 4<sup>ème</sup> colonne est le groupe d'utilisateurs auquel appartient le fichier. A ce groupe s'appliquent les permissions représentées par le deuxième groupe de trois caractères de permissions de la première colonne (<code>-rwx'''<font size="+1">r-x</font>'''r-x</code>).

'''<font size="+1">Exemples :</font>'''<br /> 1. La ligne suivante : <br /><code><font size="-1">drwxr-xr-x 18 username users   2048 jan 7 19:22 .</font></code><br /> signifie pour le répertoire '.' (le répertoire HOME de l'utilisateur username) que tout le monde a le droit de lire le contenu du répertoire (le dernier 'r'), et que tout le monde peut y accéder (le dernier 'x'). Par contre, seul l'utilisateur username peut y écrire (caractère 'w'), c'est à dire y créer des fichiers, les modifier ou les supprimer.

2. La ligne : <br /><code><font size="-1">-rw-r-----   1 username wwwadm 1728 jan 7 19:22 projet-www</font></code><br /> signifie que seul 'username' et les utilisateurs du groupe 'wwwadm' peuvent lire ce fichier, que seule username peut le modifier, et que les autres utilisateurs n'ont aucun droit dessus (le dernier groupe de caractères '---').

== Modification ==

=== Les droits : <code>chmod</code> ===

Il existe deux façon de changer les droits d'un fichier ou répertoire.

* '''Soit en précisant les droits en octal (base 8)'''. La correspondance est la suivante :
** 1 : droit d'exécution ;
** 2 : droit d'écriture ;
** 4 : droit de lecture.
Donc, pour préciser les droits en exécution et lecture, le chiffre octal est : 1 + 4 = 5. Pour préciser les droits en éxécution, écriture et lecture, le chiffre octal est : 1 + 2 + 4 = 7.
Ensuite, il faut savoir que le chiffre des unités (en octal) correspond 'au reste du monde' que le chiffre des 'huitaines' (deuxième chiffre en octal) correspond 'au groupe' et que le chiffre des 'soixante-quatraines' (troisième chiffre en octal) correspond 'à l'utilisateur'. Ainsi, si on veut que l'utilisateur ait les 3 droits (rwx), que le groupe ait les 2 droits (r-x) et que le reste du monde n'ai aucun droit (---), le nombre octal est : 750 (7 = 1 + 2 + 4 ; 5 = 1 + 4 ; 0 = 0). Pour donner ces droits à un fichier on tape alors :
<div class="code"> [username@localhost ~] $ chmod 0750 /chemin/vers/fichier </div>
Le premier 0 dans 0750 signifie qu'on donne le nombre en octal (son absence ne modifie pas le comportement de chmod).

* '''Soit en précisant les droits qu'on ajoute (+) ou soustrait (-) au fichier (ou répertoire).''' Pour ajouter des droits à l'utilisateur, on ajoute un droit (r,w, x ou toute combinaison des 3) à 'u'. Par exemple : <code>u+rw</code> signifie qu'on ajoute les droit de lecteur et d'écriture à l'utilisateur. Pour le groupe, on ajoute ou soustrait à 'g' et pour le reste du monde on ajoute ou soustrait à 'o' (other). Par exemple pour ajouter les droits de lecture et d'écriture à l'utilisateur on tapera :
<div class="code"> [username@localhost ~] $ chmod u+rw /chemin/vers/fichier </div>
Et :
<div class="code"> [username@localhost ~] $ chmod go-rwx /chemin/vers/fichier </div>
Pour retirer tous les droits (rwx) au groupe (g) et aux autres (a).
<div class="note">Remarque : à la place de u, g et o on peut utiliser 'a' (all) qui veut dire qu'on change les droits de tout le monde (utilisateur, groupe et reste du monde).</div>
Il faut savoir que la commande peut s'appliquer de manière récursive (c'est bien pratique pour les répertoires), en lui passant l'argument '-R' et qu'à la place du droit 'x', on peut présiser 'X' (majuscule) ce qui signifie que parmi les fichiers et répertoires dont on modifiera les droits d'exécution, seuls les répertoires sont concernés. Ainsi :
<div class="code"> [username@localhost ~] $ chmod -R u+rwX /chemin/vers/repertoire </div>
rendra tous les fichiers contenus dans ce répertoire (ainsi que dans tous les sous-répertoires de celui-ci) lisibles et écrivables et que tous les sous-répertoires (et leurs sous-répertoires) seront 'navigables' (le droit d'exécution pour un répertoire autorise à se rendre dans le dit répertoire).

=== La propriété : <code>chown</code> ===

Les droits de propriétés sont très simples à modifier. Il suffit de donner le nom du nouveau possesseur (et éventuellement le nom du nouveau groupe) et le nom du fichier. Ainsi :

<div class="code"> [username@localhost ~] $ chown username /chemin/vers/fichier </div>

donne le fichier <code>/chemin/vers/fichier</code> à l'utilisateur 'username'. Et :

<div class="code"> [username@localhost ~] $ chown username.groupe /chemin/vers/fichier </div>

donne le fichier <code>/chemin/vers/fichier</code> à l'utilisateur 'username' et au groupe 'groupe'. Comme pour <code>chmod</code> '''le paramétre '-R' permet de rendre récursive''' l'application de la nouvelle propriété '''(i.e. répertoires et sous-répertoires)'''.

=== Le groupe : <code>chgrp</code> ===

Le changement de groupe uniquement peut être obtenu par :

<div class="code"> [username@localhost ~] $ chgrp groupe /chemin/vers/fichier </div>

qui donne <code>/chemin/vers/fichier</code> au groupe 'groupe'. L'argument '-R' rend cette application récursive.

=== Interface graphique ===

Dans votre gestionnaire de fichiers préféré, sous KDE ou Gnome par exemple, vous pouvez consulter et modifier les permissions sur un fichier en affichant la boîte de dialogue "Propriétés" du fichier/répertoire (en général par un clic droit).

== Pour aller plus loin... ==
===SUID et GUID===
Il existe encore deux types de droits (en fait 3 mais le troisième est devenu obsolète) : 's' (SUID bit) et 'g' (SGID bit). Si l'on active le SUID bit d'un programme, il s'exécute sur le compte du possesseur du fichier (si c'est root, sur le compte de root, d'où un danger potentiel de sécurité). Si l'on active le SGID bit, c'est sur le compte de l'utilisateur normal, mais en tant que membre du groupe du fichier. Cela rend un fichier exécutable. <br />À ce propos consultez l'article [../dev/suid_scripts.php3 SUID Scripts] par Xavier GARREAU sur Léa.

Ces droits s'octroient de la même manière que les autres. Par exemple :

<div class="code"><nowiki># chmod +s /usr/bin/xmms</nowiki></div>

fera en sorte que xmms puisse obtenir les privilèges de root (le fichier <code>/usr/bin/xmms</code> appartenant à root. Un <code>ls -l</code> sur le fichier donnera ensuite :

<div class="code">-rw'''s'''r-xr-- 1 root root 172812 dec 12 12:12 xmms</div>

Dans ce cas particulier, cela permet à xmms d'obtenir une priorité temps réel qui peut être nécessaire pour un son parfait.

===ACL===
Les permissions peuvent se montrer limitées et ne permettent pas une gestion fine de certaines situations dans lesquelles un même fichier doit présenter des permissions différentes pour plusieurs utilisateurs. En effet, on ne peut définir normalement qu'un seul propriétaire et un seul groupe, opposés à un unique « tout le monde ».

Les [[ACL]] permettent de dépasser cette limitation en attribuant à un fichier des permissions différentes selon l'utilisateur (rw pour ''utilisateur1'', rwx pour ''utilisateur2'', ''r'' pour ''utilisateur3'', etc.).

Consulter l'article requis pour plus de détails.

===Attributs étendus===
Les [[systèmes de fichiers]] ''ext2'' et ''ext3'' permettent l'ajout d'[[attributs étendus]] s'apparentant aux permissions.

Consulter l'article requis pour plus de détails.

= Copyright =
Copyright © 10/01/2000, Jean-Christophe Cardot
{{CC-BY-NC-SA}}