Leçon de PHP n°1 : Les bases - niveau débutant

Salut à tous,

Profitant d'un peu de temps libre et voyant que certains et certaines flirtent avec le développement web, l'idée m'est venu de vous apporter ma petite contribution via ce forum. Il ne sera pas forcément question de tout expliquer, des tonnes de sites et de livres savent très bien faire cela, mais plutôt de donner quelques notions, quelques astuces et quelques méthodes à connaître afin de partir du bon pied, ou même de s'améliorer en chemin.

Je commence donc cette série de leçon, qui j'espère vous intéressera autant que ce monde me passionne et nourrit mon quotidien, par le B.A.BA, les bases du PHP, et un peu de HTML bien entendu même si ce ne sera pas le sujet privilégié.


Chapitre 1 : PHP, c'est quoi donc ?
Dans n'importe quel langage informatique, on apprend toujours à faire un "Hello World" donc on ne va pas y échapper, mais tout d'abord une introduction.

Tout d'abord il faut savoir comment ça fonctionne le PHP et qu'est-ce que ça veut dire. PHP pour Hypertext PreProcessor, je vous invite à aller lire Wikipédia pour en savoir plus sur son histoire, ses origines et tout ça... Tout ce qui nous intéresse ici est de savoir rapidement comment ça marche. Pour savoir ça, il faut d'abord savoir comment fonctionne un site web statique déjà, afin de différencier un site web dynamique, car PHP c'est fait pour ça : faire des sites webs dynamiques. Dynamique mais pas animé hein... c'est pas du flash.

Alors donc, en premier lieu il y a vous et votre ordinateur, vous utilisez tous un navigateur pour surfer sur le web, c'est un logiciel permettant de vous restituer de manière plus sympa à l'oeil l'hypertexte. L'HTML est le meilleur exemple d'hypertexte, il en existe d'autres, des variantes, etc... Je ne m'étend pas là-dessus. Mais ce qu'il faut savoir c'est que le HTML est un langage de balisage (qui commence par < et se finit par >) qui permet structurer et de mettre en forme du contenu textuel, qui permet également de faire des liens entres les contenus, d'où l'hypertexte, qui va au delà du texte. Bref, cet hypertexte, votre navigateur vous le traduit et vous l'affiche comme il se doit (enfin pas toujours... mais ça, c'est une autre histoire...), mais avant cela il faut une machine pour le délivrer à votre navigateur. Cette machine c'est le serveur web. Alors attention on peut confondre il y a le serveur web / machine, et le serveur web / logiciel, c'est ce dernier qui nous intéresse plus particulièrement parce que la machine on s'en fout un peu au final...

On peut donc distinguer deux interlocuteurs : le client web, votre navigateur, et le serveur web, Apache par exemple. Lorsque vous surfez sur un site que se passe-t-il ?
1° Le client demande au serveur "salut serveur, j'aimerais consulter cette page (index.html par exemple)"
2° Le serveur peut lui répondre plusieurs choses : "biensûr, tiens là voici" ou bien "ah non désolé, je ne connais pas cette page" ou bien encore "T'as une autorisation d'abord?"
3° dans le cas où le serveur est aimable et fait bien son boulot il renverra au client ce qu'il lui a demandé : de l'hypertexte. Je vous fais l'impasse sur le protocole HTTP qui est le support de ce dialogue, peut-être plus tard au fil des leçons j'y reviendrais pour quelques subtilités.

Voilà, c'est très simple : le client demande, le serveur répond. Dans d'autres cas de figures il se peut que lors de sa demande le client envoie en même temps certaines informations, c'est le cas lorsque vous remplissez et envoyer un formulaire ou lorsque vous cliquez sur certains éléments d'une page lorsqu'ils utilisent du JavaScript.
Lorsque le client fait sa demande, avec ou sans données, on parle de requête. Il y a deux sortes de requêtes : GET ou POST, selon que les informations passent dans l'URL. Vous savez tous ce qu'est une URL tout de même hein... ce petit bout de truc qui commence par http:// blablabla...
Lors que le serveur reçoit la requête, il doit délivrer une réponse, la plupart du temps il s'agira d'aller chercher un fichier. Cela peut-être un fichier HTML mais également une image qui composera une page, ou une animation Flash ou n'importe quoi d 'autre.

Que vient donc faire le PHP dans cette équation ?
Souvenez-vous de ce que veut dire PHP, c'est un préprocesseur d'hypertexte, ce qui veut dire qu'il va se positionner juste avant que le serveur ne renvoie l'hypertexte. PHP est un langage serveur, cela veut dire qu'il est exécuté par le serveur et jamais au grand jamais le client n'aura connaissance de ce PHP. Si jamais le client recevait du code PHP il ne saurait qu'en faire, il est fait pour interpréter de l'hypertexte et du langage client, comme le JavaScript, et pour lire des médias comme les images, les vidéos, l'audio, le flash, etc... Par contre il faut savoir que c'est très mauvais signe si le client a l'occasion de voir du PHP, c'est un risque pour la sécurité de vos scripts...

Revoyons donc le dialogue client-serveur en ajoutant l'ingrédient PHP :
1° Le client demande au serveur "salut serveur, j'aimerais consulter cette page (index.php par exemple)" à noter le .php, pas obligatoire pour du PHP, tout dépend de la configuration du serveur.
2° Le serveur (Apache) va confier le fichier demandé (index.php) à PHP (un exécutable dont le serveur/machine dispose).
3° PHP va lire le document en question et si il y trouve quelque chose qui le concerne (les scripts PHP à proprement parler) il fera son travail, à la fin il renverra le code hypertexte généré au serveur.
4° Le serveur récupère l'hypertexte de la part de PHP et le renvoie au client.

PHP est une sorte d'intermédiaire dans ce dialogue, ou plutôt un traducteur. Le serveur regarde le fichier demandé et selon sa configuration va se dire :
- "oulah, mais moi je ne sais pas lire ça, tiens toi là, PHP, lis-le pour moi s'il te plaît).
Et PHP de lui répondre :
- "Oh mais c'est facile, regarde... là y'a du HTML, là du code, attend.… je déchiffre... voilà le résultat".
- "Ah super, je crois que le client y verra plus clair ainsi, merci".

Maintenant la question c'est de savoir comment PHP fait-il pour déterminer quand il doit intervenir ou non...

Ouais, bravo, j'ai tout compris !!!!!!!

C'est quand la belle histoire n°2, Onc' Juju ?

Chapitre 2 : PHP, ça marche comment ?

Reprenons notre exemple, index.php, que contient-il en vérité ? La même chose qu'un fichier HTML sauf qu'on pourra y trouver des balises un peu particulières : <?php … ?>
Ce sont ses balises qui indiqueront à partir de quand PHP doit-il rentrer en scène. En dehors de ces balises, PHP renverra le HTML tel quel, sans le traiter. Il est donc important que ces balises se ferment bien pour que PHP s'arrête de "parser" (analyser et exécuter le code), si ce n'est pas le cas une erreur sera générée.

PHP renferme de nombreuses fonctions, mais la plus importante de toutes c'est celle qui signifie "renvoie ça au serveur". En fait il existe deux fonctions pour cela echo et print. Et en fait... pour vous dire la vérité ce ne sont pas vraiment des fonctions mais des structures de langages, on ne va pas rentrer dans le détail mais la différence c'est qu'avec les fonctions vous êtes obligés d'utiliser des parenthèses tandis qu'avec echo ou print, ce n'est pas la peine. Autre question que l'on est en droit de se poser : pourquoi deux fonctions plutôt qu'une? En fait, c'est très simple : les mecs qui ont créé le PHP étaient deux donc ils ont tout fait en double les cons... Non, je plaisante, enfin … je dis ça... on est pas loin de la vérité dans certains cas : certaines fonctions utilisent des conventions de nommages différentes car le PHP a été écrit par plusieurs personnes. Concernant print et echo, la différence est très subtile, pour ceux que ça intéresse, Google est votre ami. Pour la suite, perso j'utilise tout le temps echo, donc je ne ferais jamais référence à print, echo est paraît-il plus rapide, et on utilise jamais la spécificité de print...

Bon, il va pas se faire tout seul ce "Hello World" …

Code:

<?php
echo 'Hello World';
?>

- On commence donc par <?php qui indique que PHP doit faire son job, à noter qu'il existe également des balises comment <? … ?> ou <% … %> mais elles sont dépréciées.
- On appelle echo, on lui passe la chaîne de caractères "Hello World" en argument et on termine par un point-virgule. Très important le point-virgule, il indique la fin d'une instruction.
- On termine par ?> PHP a fini son boulot.

Bon ok c'est gentil, me direz-vous, mais il est où l'hypertexte là-dedans?
Reprenons donc notre exemple avec un peu de HTML.

Code:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
   <head>
      <title>Mon Super Site !</title>
   </head>
   <body>
      <b>
      <?php
      echo 'Hello World';
      ?>
      </b>
   </body>
</html>

Voilà qui est sans doute plus parlant : j'ai mon HTML comme n'importe quel fichier HTML de base, et en plein milieu, PAF! du PHP...
Maintenant, bon c'est pas moi qui ai inventé la tradition du "Hello World" mais il faut dire que pour ce qui est de l'utilité du PHP, on a fait mieux...
En effet, pourquoi utiliser un langage dynamique pour simplement afficher un texte statique?
Patience, patience...

Chapitre 3 : Dis moi PHP, quelle heure est-il ?

Nous allons donc commencer à attaquer le vif du sujet, mais il faut savoir que pour le début, je ne vais pas expliquer toutes les fonctions utilisées, pour cela je vous invite à lire les documentations de PHP qui sont facilement trouvables sur le net.

Nous avons vu à l'instant comment afficher un texte statique, cela n'a aucun intérêt, je crois que nous sommes d'accord. Alors pour rendre la chose un peu plus sympathique, commençons par afficher à notre cher visiteur l'heure et la date du jour, pour peu qu'il ne sache pas la trouver sur son PC...ou son Mac

Pour la date il existe une fonction bien utile, je vous laisse deviner comment elle s'appelle... allez-y, cherchez... oui, vous y êtes : date() incroyable !?
Son fonctionnement est plutôt simple, il existe plein de façons d'afficher une heure ou une date, exemples : 2008-03-25 ou 25/03/2008 ou bien encore 25-3-08, 20h18 ou 20:18:34 ou bien encore 8:18 PM. Pour indiquer à date() ce que l'on veut on utilise des lettres, chaque lettre indique une information (le jour, le jour de la semaine, la semaine, le mois, l'année, l'heure,la minute,la seconde, etc...).
Pour avoir un détail de chaque possibilité de la fonction date, zieutez par ici : date()

Voici le code pour afficher la date :

Code:

<?php
echo date('d/m/Y H:i');
?>

Nous avons optez pour une écriture plutôt française de la date, à savoir 25/03/2008, 20h18.

Voilà, nous avons utiliser PHP pour quelque chose de plus utile, même si on pourrait mieux faire. Mais avant d'aller plus loin, nous allons nous arrêter quelques temps sur la syntaxe de PHP.

Chapitre 4 : "Cot, cot", faisait la poule

Les plus observateurs auront peut-être remarqué que depuis le début, lorsqu'il s'agit de faire des chaînes de caractères, comme pour le "Hello World" de tout à l'heure, j'ai utilisé des ' et non des ", autrement dit des simple quotes et non des double quotes. PHP accepte les deux, mais il y a une grande différence entre les deux, que je vais expliquer car c'est important à mes yeux.

Pourquoi utiliser l'un plutôt que l'autre, tout d'abord il faut savoir que le PHP est très souvent destiné à retourner du HTML, et que dans le HTML nous utilisons très souvent des doubles quotes pour les attributs. Exemple :

Code:

<div class="principal">Mon calque principal</div>.

Que se passerait-il si je décidais d'utiliser des double quotes pour PHP et pour mon HTML ?

Code:

<?php
echo "<div class="principal">Mon calque principal</div>.";
?>

Il y a un soucis car avec le premier double quote, j'indique le début d'une chaîne de caractère, mais au moment d'écrire le double quote de mon HTML j'indique en même temps à PHP la fermeture de cette même chaîne. PHP génèrera une erreur car à la suite de cette chaîne se trouve des caractères qui se baladent sans raison.
Pour corriger ce problème nous devons faire appel à un caractère d'échappement le \ (antislash ou backslash à ne pas confondre avec le slash / ). Ce caractère indique à PHP de ne pas traiter le caractère qui suit.
Ainsi notre code ressemblerait à ceci :

Code:

<?php
echo "<div class=\"principal\">Mon calque principal</div>.";
?>

Là c'est bon, PHP est content, et le HTML est correct, notez bien que à l'arrivée nos antislashs auront disparu bien sûr. C'est juste pour PHP que nous les mettons, il les enlèvera de lui-même.
Par contre il y a un soucis... Je rencontre beaucoup, mais beaucoup, de double quotes dans mon HTML. Alors que faire? Certes on a le droit de faire du HTML avec des simples quotes, mais il est tout de même plus fréquent de le faire avec des doubles, et une règle de base du HTML (ou plutôt du XHTML...) c'est de décider une bonne fois pour toute ce qu'on utilise au sein d'un même document. Il faut éviter d'utiliser tantôt les doubles, tantôt les simples.
Personnellement j'utilise TOUJOURS des doubles quotes pour mon HTML. Et pour éviter de m'embêter à backslasher à tout bout de champ, c'est "simple", j'utilise les simple quotes dans mon PHP.
Ainsi mon code ressemble à ceci :

Code:

<?php
echo '<div class="principal">Mon calque principal</div>.';
?>

Nul besoin de le préciser mais lorsqu'on commence une chaîne de caractère avec un type de quote, on le termine avec le même type. Et si PHP trouve un quote de l'autre type dans la chaîne il considèrera qu'il s'agit de texte, et non d'une fin de chaîne. Donc en commençant par des simples quotes, nul besoin de backslasher. Ouf! Ah non... ce n'est pas si simple, mais moins compliqué tout de même : il faudra faire attention à ce que le texte, lui, ne contienne pas de simple quote. Comme il s'agit du caractère d'apostrophe (ou une de ses versions), cela arrive souvent. Mais comme on rencontre plus souvent des doubles quotes dans le HTML que de simple quotes dans le texte, il est préférable de backslasher les moins nombreux, d'où le choix d'utiliser les simples quotes dans le PHP pour indiquer le début et la fin d'une chaîne de caractère.

Mais il y a une autre raison à ce choix. PHP, comme tout langage digne de ce nom, utilise des variables, et il est possible de faire intervenir ces variables dans nos chaînes de caractères.
Exemple :

Code:

<?php
echo '<div>Vous êtes le '.$nombre.' ème visiteur</div>.';
?>

A noter : les variables en PHP commencent toutes par le caractère $, c'est comme çà.
A noter également : pour concaténer on utilise le point ".", on peut concaténer des chaînes de caractères avec d'autres ou avec des variables autant de fois qu'on le désire.

En utilisant les simples quotes, pas de soucis, je clos ma chaîne, je concatène avec ma variable, je concatène avec une nouvelle chaîne.
Mais si j'avais voulu, j'aurais pu le faire également de cette manière :

Code:

<?php
echo "<div>Vous êtes le $nombre ème visiteur</div>.";
?>

Remarquez que je n'ai pas fermé ma chaîne de caractère lorsque j'ai mis ma variable, PHP saura que dès qu'il y a le caractère $ c'est qu'il doit utiliser la variable. Ce n'est le cas qu'avec les chaînes utilisant les doubles quotes, avec des simples il affichera "vous êtes le $nombre visiteur".

Mais si ces deux exemples affichent exactement la même chose alors où est le problème?

Le problème, c'est que PHP "analyse" ce qui se trouve dans une chaîne double-quotée, il va regarder avant de l'afficher, si il n'y trouve pas des variables. Si on lui passe des chaînes simple-quotées, il ne les traitera pas, il les renverra telles quelles. Ce petit détail peut faire une différence en terme de ressources. En effet, les chaînes de caractères s'utilisent très souvent, et pas toujours pour afficher du texte, mais ne serait-ce que pour le texte, et son HTML, cela peut déjà représenter beaucoup de caractères. Si PHP peut économiser un peu de ressources processeurs pour ne pas avoir à analyser toutes les chaînes de caractères qu'il trouve, c'est déjà ça. Ainsi, en utilisant des chaînes simple-quotées et des concaténations, nous pouvons obtenir un gain de performance. Cela ne se verra pas à petite échelle, mais pour de gros applicatifs, ou des sites à fortes audiences, ça n'est pas négligeable.
Mais pour le développeur, le gain est aussi à la lecture. C'est un gain réel : il est plus facile de lire du code lorsque les variables ne sont pas au sein de chaînes de caractères, l'oeil est comme l'analyseur de PHP, si il sait qu'il n'a rien de particulier à chercher à tel ou tel endroit, il ira plus vite. C'est également une bonne habitude à prendre que de concaténer, à vrai dire, je n'aime pas cette possibilité que le PHP offre, ce n'est pas très "propre".

En résumé : utilisez au maximum les simples quotes pour vos chaînes de caractères en PHP, gardez les doubles quotes pour le HTML. Il n'existe que quelques cas où les doubles quotes sont utiles.

- L'emploi de caractères spéciaux comme les retours charriots et les tabulations qui peuvent s'écrire sous la forme suivante \r \n et \t. On ne l'utilise pas tous les jours.
En effet ces caractères ne sont pas pris en comptes avec les simples quotes. A l'inverse, cela veut dire qu'avec les double quotes, PHP cherchera également si il n'y a pas des caractères de ce genre...

- Les requêtes SQL qui utilisent des simples quotes pour délimiter les chaînes de caractères de préférence, dans ce cas on a le choix, on peut backslasher les simples quotes ou utiliser les doubles.

Dans tous les cas, on peut utiliser les simples la plupart du temps et utiliser les doubles les rares fois où elles s'avèrent utiles et/ou nécessaires.

Chapitre 5 : Chari varie

Nous venons de voir un détail de la syntaxe de PHP, mais c'est un détail important car si jamais il vous arrive de vous familiariser plus avec le PHP vous verrez qu'on arrive rapidement à des écritures à rallonges et plus vite on opte pour une écriture claire, plus on y gagne.

Il est désormais temps de s'attarder un peu sur les variables. Cette chose si simple en apparence est la clé de toute programmation, elle permet le stockage de valeurs et a beaucoup d'utilisations.
Nous allons commencer par expliquer rapidement le fonctionnement de PHP sur les variables. Dans beaucoup de langages, les variables sont "typées", cela veut dire qu'on indique si il s'agit d'un nombre entier, décimal, d'une chaîne de caractère, d'un tableau, d'un objet, d'un booléen, etc...
En PHP, les variables n'ont pas besoin d'être typées, enfin pas tout le temps. Ce qui simplifie beaucoup les choses.
Comme un exemple vaut mieux qu'un long discours voici comment nous pouvons déclarer nos variables en PHP :

Code:

<?php
$entier = 15;
$decimal = 14.78;
$chaine = 'quinze';
$tableau = array(15,16,17);
// $objet = 'chaque chose en son temps';
$boolean = true;
?>

Bon pour les premiers, pas de soucis, je pense que vous comprendrez aisément.
Le symbole = permet de déclarer ou de redéclarer une variable en lui donnant d'emblée une valeur. Attention à bien écrire = et pas == qui a un tout autre sens que nous verrons plus tard.
La déclaration d'un tableau nécessite l'utilisation de la fonction array(), cette fonction retournera le tableau contenant les arguments que nous lui avons passer. Pour l'utilisation des fonctions, voir plus loin.
Je dis "nécessite" mais en fait ce n'est pas totalement vrai, on peut déclarer un tableau d'une autre manière :

Code:

<?php
$tableau[0] = 16;
$tableau[1] = 17;
$tableau[2] = 18;

Mais c'est moins intéressant... On reviendra sur les tableaux plus loin.
Les objets attendront également de plus amples explications plus tard.
Quant aux booléens ils peuvent avoir deux valeurs : true ou false, soit vrai ou faux, 1 ou 0. Attention toutefois à bien écrire true et non "true" sinon la variable sera considérée comme une chaîne de caractère.

Comme son nom l'indique, une variable c'est fait pour varier ! Ainsi je peux faire évoluer mes variables de cette manière :

Code:

<?php
$entier += 2;
$decimal -= 4;
$chaine .= ' plus deux';
array_push($tableau,18);
$boolean = false;

Ainsi $entier vaudra 17, $decimal vaudra 10.78, $chaine vaudra "quinze plus deux", et mon tableau comportera un élément de plus : 18, la fonction array_push va "rajouter" une valeur au dessus de la pile du tableau.
J'ai ici utilisé des écritures simplifiées à savoir +=, -=, .= au lieu d'écrire $entier = $entier+2 qui fonctionne aussi. A ce propos, si on veut incrémenter il suffira
Un petit mot sur les tableaux :
Il existe pleins de fonctions destinées aux tableaux, je ne les listerais pas ici, heureusement pour moi, et pour vous...
Mais il est important de savoir comment ils fonctionnent. Par défaut un tableau comporte des clés, et des valeurs. Les clés permettent de trouver les valeurs. Les clés, si elles ne sont pas spécifiées lors de la déclaration, sont créées par PHP et commencent toujours par 0. Ainsi dans mon exemple, la valeur de $tableau pour la clé 0 vaudra 16, pour la clé 1, 17, etc...
Il s'agit ici d'un exemple simple, un tableau peut contenir tout type de variable comme valeur. Ainsi on pourra mettre un entier, un décimal, une chaîne... ou un autre tableau ! Parfois même on y mettra des objets.
Autant les valeurs peuvent être de tout types, les clés, elles, sont forcément des entiers, même si on peut utiliser des textes. Un petit exemple pour ne pas trop vous embrouiller :

Code:

<?php
$tableau1 = array(0=>'Voici un élément de mon tableau',
                              1=>'Un autre élément',
                              2=>'Et un dernier');
$tableau2 = array('premier'=>'Voici un élément de mon tableau',
                              'second'=>'Un autre élément',
                              'troisieme'=>'Et un dernier');

echo $tableau1[0].'<br/>';
echo $tableau2['premier'].'<br/>';
echo $tableau2[0].'<br/>';
?>

Affichera :
Voici un élément de mon tableau
Voici un élément de mon tableau
Voici un élément de mon tableau

$tableau1 est un "témoin", $tableau2 l'exemple même. Si j'utilise la clé "premier" ou 0, j'ai le même résultat. Donc la clé "réelle" est bien un entier, mais on peut utiliser une chaîne pour mieux s'y retrouver.
Un autre exemple pour voir le cas des tableaux à plusieurs dimensions, ou les tableaux dans les tableaux.

Code:

<?php
$tableau = array(
                            array('a','b','c','d','e'),
                            array(1,2,3,4,5),
                            array(true,false));

echo $tableau[1][2];
?>
Affichera :
3

J'ai ici créé un tableau à deux dimensions, j'utilise les crochets pour indiquer les clés que je désire utiliser. $tableau[1] sera égal à array(1,2,3,4,5) et $tableau[1][2] sera égal à 3, n'oubliez pas que les clés commencent à 0 et non à 1.

Voici pour les tableaux, pour en savoir plus, une fois encore, la documentation officielle est à votre disposition.

Chapitre 6 : Ne pas manquer de constance

A l'inverse des variables qui varient il y a les constantes qui... bin, qui ne font rien en fait à part garder la valeur qu'on leur a donné.
Ces constantes peuvent être très utiles dans certains cas, par exemple pour la configuration d'un site, ou même pour les traductions.
La syntaxe de ces constantes est très simple, pas de $ ici. Par contre il faut obligatoirement utiliser la fonction define().

Code:

<?php
define('URL_ABSOLUE_DE_MON_SITE','http://www.monsite.fr/');
echo URL_ABSOLUE_DE_MON_SITE;
?>

Quel intérêt d'utiliser une constante plutôt qu'une variable?
C'est simple, si ça a vocation à varier, c'est une variable, si ça a vocation à ne pas varier, c'est une constante...
L'intérêt, en fait, il n'est pas seulement là. Une variable n'est pas accessible de partout, en effet si je définis une variable en début de script et que je veux y faire appel dans une fonction, je ne pourrais pas à moins de préciser que je veux appeler une variable "globale" (une spécificité de PHP où nous reviendrons lors du chapitre sur les fonctions).
Une constante à l'inverse est accessible de partout sans soucis.
Mais finalement c'est plutôt un choix d'utilisation que l'on fait. J'ai moi-même pour habitude d'utiliser les constantes pour tous les textes. De la même manière qu'en HTML en sépare la structure de la mise en forme avec le CSS, en PHP on peut séparer le contenu "statique" afin de le retrouver dans un dictionnaire (un script à part), qui ne contient que des constantes. C'est ensuite plus pratique si on veut traduire le site en plusieurs langues. J'utilise également ces constantes pour les textes d'erreurs, par exemple : ERR_1, ERR_2, ERR_3 pour les noms. Je mets des textes de debug pendant le développement et ensuite on peut les changer pour des textes plus "présentables" sans avoir à relire des lignes et des lignes de codes puisque ces constantes seront toutes définies au même endroit.

Je vous conseille vivement d'utiliser dès le départ les constantes dans tous les cas, si jamais vous en aviez l'utilité par la suite il serait plus long et compliqué de le faire une fois le code écrit et fonctionnel. Le cas de la traduction en est le meilleur exemple.

Pomme-I a écrit:

Ouais, bravo, j'ai tout compris !!!!!!!

Super, c'est pas du temps de perdu alors

Pomme-I a écrit:

C'est quand la belle histoire n°2, Onc' Juju ?

C'est dès maintenant, il fallait juste que je découpe en plusieurs morceaux... ça faisait beaucoup de texte pour un seul post

Si après ça TG est pas content je sais plus quoi faire

Tu écris un bouquin en ligne, si j'ai bien compris ?

Bernardo a écrit:

Tu écris un bouquin en ligne, si j'ai bien compris ?

Un bouquin peut-être pas Mais un guide de prise en main rapide peut-être oui

jusqu'à présent on était peinard sur ce forum … v'là-ti pas que le Ju' de service s'en est accaparé ! omagad !

Chapitre 7 : Ca fonctionne !

Maintenant que nous nous sommes un peu familiarisés avec certaines notions de bases de PHP, nous allons pouvoir passer aux choses sérieuses : les fonctions.

Nous allons tout d'abord étudier quelques cas de fonctions intégrées à PHP.

explode()
Cette fonction explosive est utile lorsqu'on veut séparer un texte en plusieurs morceaux à partir d'un séparateur, tel que le CSV.
Cas concret : J'ai une liste de courses que m'a donné ma femme d'un côté et une liste de produits avec leur prix d'un autre côté. Je veux déterminer le prix du caddie final.

Tout d'abord la petite base de prix, pas de base MySQL pour l'instant, juste un tableau PHP.
On considère le prix au kilo pour les fruits et légumes

Code:

<?php
$produits = array(          'pommes'=>2.99,
                            'fraises'=>3.99,
                            'tomates'=>2.49,
                            'carottes'=>0.99,
                            'couches'=>13.99,
                            'lait'=>11.99,
                            'coton'=>1.99,
                            'yahourt'=>3.99);

J'utilise simplement le nom du produit comme clé, et le prix comme valeur. Pas très propre mais c'est un exemple
Ensuite ma liste de course, comme prévu un texte avec des virgules :

Code:

$liste = 'pommes, tomates, couches, carottes, lait, yahourt';

Et maintenant le code qui me permet de faire le calcul proprement dit :

Code:

$arr_liste = explode(',',$liste);
$total_panier = 0;
foreach($arr_liste as $produit)
{
   if(isset($produits[trim($produit)]))
   {
      $total_panier += $produits[trim($produit)];
   }
   else
   {
      echo 'le produit '.$produit.' est introuvable<br/>';
   }
}
echo 'montant total du panier : '.$total_panier.'€';
?>

Décortiquons tout cela :

Code:

$arr_liste = explode(',',$liste);

La fonction explode transforme ma chaîne de caractère en tableau, chaque valeur étant le nom du produit débarrassé des virgules.

Code:

$total_panier = 0;

J'initialise le total de mon panier à 0.

Code:

foreach($arr_liste as $produit)
{

Foreach signifie "pour chaque". Ainsi PHP va parcourir mon tableau et stocker à chaque fois la valeur courante dans la variable $produit.

Code:

   if(isset($produits[trim($produit)]))
   {

Là c'est plus compliqué, nous allons prendre la ligne dans le sens inverse.
La fonction trim() sert à débarrasser un texte des espaces qu'il pourrait avoir au début ou à la fin, pratique dans mon cas vu que j'en ai effectivement laissé dans ma liste de produits après chaque virgule...
Ensuite on peut voir que j'utilise donc le nom de mon produit comme clé du tableau $produits. C'est ainsi que je trouve le prix de mon produit.
La fonction isset() permet de d'abord tester si le prix que je cherche existe effectivement. Si j'avais cherché des kiwis dans ma liste, ils auraient été introuvables et PHP aurait généré une erreur. isset() renvoie TRUE ou FALSE selon que la variable passée en argument existe bel et bien.
Et pour finir plus simplement la condition if() qui teste la fonction isset().
Donc pour résumer, et en français cette ligne signifie : Si tu trouves le prix de ce produit dans mon tableau $produits alors fais ce qui est entre les accolades :

Code:

      $total_panier += $produits[trim($produit)];
   }

C'est à dire ajouter le prix en question au total de mon panier.

Code:

   else
   {

Suite de la condition if(), le else qui signifie "sinon fais ceci".

Code:

      echo 'le produit '.$produit.' est introuvable<br/>';
   }

Affiche cette phrase "le produit untel est introuvable" suivi d'un saut de ligne HTML (<br/> pour breakline).

Code:

}

Ne pas oublier cette accolade de fermeture qui appartient au foreach, c'est ici que se termine la boucle.

Code:

echo 'montant total du panier : '.$total_panier.'€';

Quand la boucle est finie, nous avons parcouru tous les articles et nous pouvons finalement afficher le montant de mon panier : 36.44€
A noter que j'ai utilisé le code HTML pour le sigle Euro, c'est toujours plus sûr. Nous n'avons pas encore parlé de charset, pardon, d'encodage.

Voilà cet exemple est terminé, enfin pas tout à fait car nous l'améliorerons au fur et à mesure des leçons.
Première conclusion : ça coûte cher quelques fruits et légumes et de quoi changer un bébé de nos jours on en est déjà à plus de deux cent balles, même si mes prix ne sont pas réels ils n'en sont pas loin.
Deuxième conclusion : les fonctions ont deux particularités.
- elles nécessitent la plupart du temps des arguments : ce que l'on met entre les parenthèse, il peut y en avoir un, plusieurs ou aucun.
- elles retournent la plupart du temps également un résultat : ce que l'on utilise.
Je dis la plupart du temps car certaines fonctions, allez savoir pourquoi, vont immédiatement transformer la variable en argument. La fonction array_push() par exemple ne s'utilise pas comme les autres, elle va transformer le premier argument.
Mais d'une manière générale il y a toujours un "retour", même si on ne l'utilise pas, il y a au moins un retour booléen pour indiquer si tout s'est bien passé.

Passons maintenant à quelque chose de plus intéressant, fabriquer soi-même une fonction.

Chapitre 8 : Je fonctionne !

Faire ses propres fonctions, c'est très utile voire même obligatoire si on ne veut pas copier-coller du code à tout-va. Cela simplifie énormément les choses comme nous pourrons le voir dans le prochain exemple.

Cas concret : ma femme me file toujours une liste de course, mais cette fois-ci j'ai amélioré ma base, j'y ai intégré plus d'informations.

Code:

<?php
$produits = array(
            array('code'=>'pom',
                  'nom'=>'Pommes Grany',
                  'description'=>'De bonne pommes à croquer',
                  'image'=>'grany.png',
                  'prix'=>'2.99'),

            array('code'=>'tom',
                  'nom'=>'Tomates en grappes',
                  'description'=>'Tomates d\'origine française',
                  'image'=>'tomate_grappe.png',
                  'prix'=>2.49),

            array('code'=>'carot',
                  'nom'=>'Carottes en sachet',
                  'description'=>'Carottes d\'origine française',
                  'image'=>'carottes.png',
                  'prix'=>0.99),

            array('code'=>'couch',
                  'nom'=>'Couches 9/11Kg',
                  'description'=>'Couches de 9 à 11kg x 72',
                  'image'=>'couches.png',
                  'prix'=>13.99),

            array('code'=>'lait',
                  'nom'=>'Lait 2ème âge',
                  'description'=>'Lait maternel 2ème âge 900g',
                  'image'=>'couches.png',
                  'prix'=>11.99),

            array('code'=>'coton',
                  'nom'=>'Coton pour bébé',
                  'description'=>'Coton pour bébé hypoallergénique',
                  'image'=>'cotonbebe.png',
                  'prix'=>1.99),

            array('code'=>'yaho',
                  'nom'=>'Yahourt Nature',
                  'description'=>'Yahourt Nature 12x25cl',
                  'image'=>'yahourt.png',
                  'prix'=>3.99));

Voilà ça fait un sacrée liste mais nous avons plus de détails sur les produits en questions. On commence à se rendre compte de l'intérêt d'une base, une vraie, mais ça attendra.
Cette fois-ci je ne m'intéresse pas au calcul de mon panier, j'aimerais juste pouvoir générer des fiches produits en utilisant le code. Comme je risque de vouloir l'utiliser à plusieurs endroits, j'ai tout intérêt à fabriquer une fonction pour cela.
La voici :
NB: je ne découperai pas le code cette fois-ci, mais j'y mettrais des commentaires pour expliquer chaque ligne. Prenez également cette habitude, c'est très utile.

Code:

// la syntaxe pour créer une fonction la voici, je définis moi-même le nom, et l'argument attendu
function fiche_produit($code)
{
   // ici je précise "global" pour indiquer que je veux utiliser la variable $produits qui se trouve en dehors de ma fonction
   global $produits;
   // je créé un tableau vide pour mon produit
   $le_produit = array();
   // Je liste les produits que j'ai dans ma base pour trouver celui qui possède le bon code
   foreach($produits as $produit)
   {
      // je cherche la concordance du code passé en argument avec le code du produit dans la base
      if($produit['code'] == $code)
      {
         // Si je le trouve, je le stocke dans ma variable $le_produit
         $le_produit = $produit;
      }
      // on continue la boucle.
   }
   // Une fois la boucle terminée, il se peut que le produit n'ait pas été trouvé, donc on vérifie que $le_produit n'est pas vide.
   // Pour cela je compte le nombre d'éléments à l'intérieur du tableau.
   // Notez qu'on utilise pas le symbole ≠ pour signifier "est différent de" mais !=
   if(count($le_produit) != 0)
   {
      // Là je vais déclarer la variable de retour, du code HTML avec l'utilisation des informations du produit.
      // Bon c'est du HTML ultra simple on est pas là pour faire du webdesign non plus ;-)
      $retour = '
         <table cellpadding="4" cellspacing="0" border="1">
            <tr>
               <td><img src="img/produits/'.$le_produit['image'].'" alt="'.$le_produit['nom'].'" title="'.$le_produit['nom'].'"/></td>
               <td><b>'.$le_produit['nom'].'</b><br/>'.$le_produit['description'].'</td>
               <td>Prix : <b>'.$le_produit['prix'].'</b> &euro;</td>
            </tr>
         </table>';
   }
   else
   {
      // si on ne trouve pas le produit, il faut un retour tout de même
      $retour = 'Ce produit est introuvable';
   }
   // La syntaxe la plus importante mais la plus simple à retenir, le retour
   return $retour;
}

Ca y est, nous avons une fonction. Oh mais.. nous ne l'avons pas utilisée, c'est balot

Code:

echo fiche_produit('carot');

Si on revient quelques secondes sur cet exemple, on notera quelques détails :

- Plutôt que de faire un echo au sein même de ma fonction, j'ai préféré retourner le code HTML à la sortie de ma fonction. Et c'est à l'utilisation de ma fonction que je fais un echo.
C'est plus souple car on peut toujours vouloir utiliser sa fonction dans divers contexte.
C'est plus propre car dans tous les cas une fonction doit retourner quelque chose, que ce soit au moins un true ou un false, c'est une pratique à avoir.
Rien ne vous y oblige mais si votre fonction n'a pas de retour, posez-vous la question de savoir si vous avez bien pensé l'utilité de votre fonction.

- Ma fonction n'est pas optimale sur un point, elle a besoin de lister la base de produits pour y trouver celui que l'on cherche. Pas top.
Cela s'arrangera lorsque nous attaquerons une vraie base de donnée et que nous utiliserons des objets.

Nous voici enfin avec un exemple qui montre bien l'intérêt d'un langage comme le PHP : automatiser l'affichage de tout ou partie d'un site web. Autant le calcul du panier peut se faire facilement sur Excel, et ce n'est pas le but de PHP que de concurrencer Excel, autant ce dernier exemple montre plus clairement en quoi il peut génèrer des petits bouts de code hypertexte, petits bouts qui au fil du compte construiront une page HTML toute entière.

Super Julien ! Bravo pour l'initiative !
Dis, tu devrais en faire un pdf qu'on pourrait télécharger et postasser tranquillement off line (dans le train ou dans son lit).

Juste un truc, il y a deux chapitres 6…

Peacemaker a écrit:

Super Julien ! Bravo pour l'initiative !
Dis, tu devrais en faire un pdf qu'on pourrait télécharger et postasser tranquillement off line (dans le train ou dans son lit).

Voilà qui est fait :

Bon c'est du copier-coller de Safari vers Textedit donc pas de sommaire ou d'index hein...

hr a écrit:

Juste un truc, il y a deux chapitres 6…

Corrigé

Merci !
Bon, c'est vrai j'aurai pu le faire moi-même le copier/coller. J'y ai pas pensé.

hr a écrit:

Juste un truc, il y a deux chapitres 6…

Ah ben, il y en a au moins un qui suit !

Bon il est temps que je m'y mette sérieusement... encore merci neiluj