Contenu | Recherche | Plan du site | Accessibilité | Contact

Documentation

Coding - PHP mini référence

Ce mini guide de référence est un condensé d'informations sur l'utilisation et les fonctions de base de PHP utilisées par les développeurs de Libordux.

Commenter un script

Comme tous bons langages de programmation PHP permet de commenter son code. Pour insérer un commentaire dans un script il suffit de mettre 2 slash // avant le texte du commentaire. 

<?php
// Un commentaire.
?>

echo et print - Afficher du texte

Les fonctions echo et print(), sont les commandes qui donnent l'ordre, ensuite, c'est le texte à afficher que l'on met entre guillemets, cela permet au serveur de repérer ce que l'on demande à afficher. A chaque fois que vous écrirez une instruction en PHP, vous devrez la terminer par un point-virgule ;, cela permet d'indiquer la fin de l'instruction. Pour afficher les guillemets, il faut les précéder de backslash \.

Ce "texte" est affiché avec echo.
Ce texte est affiché avec print.

<?php
echo "Ce \"texte\" est affiché avec echo.<br />";
print ("Ce texte est affiché avec print.");
?>

Utiliser des variables

Une variable a le pouvoir de $changer, c'est une petite information stockée en mémoire temporairement. Dès que la page PHP est générée, toutes les variables sont supprimées de la mémoire car elles ne servent plus à rien. Il est possible de stocker toutes sortes d'informations, tel que l'heure du serveur, le nom du visiteur, etc. Une variable est toujours constituée d'un nom afin de la reconnaître. Dans cet exemple la variable $SITE a pour valeur www.libordux.org. Le caractère $ précède toujours le nom d'une variable, le signe = veut dire que $SITE est égal à www.libordux.org, le nom se place entre guillemets, et si la valeur est un chiffre il n'y a pas besoin de guillemets. Pour finir echo est utilisé pour afficher le résultat de la variable:

La variable SITE est: www.libordux.org.

<?php
$SITE = "www.libordux.org";
echo "La variable SITE est: $SITE.";
?>

Calculer avec des variables

PHP permet de calculer facilement en utilisant des variables et les opérations mathématiques. Pour commencer on définit la valeur de la variable $NB = 10. La variable $RESULT additionne 5 à la variable $NB et multiplie le tout à nouveau par $NB. ET pour finir on affiche le résultat avec echo:

Calcul: (10 5) * 10 = 150

<?php
$NB = 10;
$RESULT = ($NB   5) * $NB;
echo "Calcul: (10   5) * 10 = $RESULT";
?>

Créer des fonctions

Les fonctions permettent de regrouper une suite de commandes et de gagner des lignes de code. Elles peuvent se mettre dans un fichier séparé contenant toutes les fonctions utilisées par le script. Les fonctions sont généralement reconnue par les éditeurs de texte ou les IDE tels que Geany, elles sont par exemple listées dans la bar de coté. Un nom de fonction commence toujours par une lettre ou un _underscore, les arguments se mettent entre parenthèses (), et se séparant par de virgules si il y en a plusieurs. Voici un simple exemple d'une fonction se nommant name et affichant du texte avec echo: 

<?php
function name() {
    echo "Exemple de fonction."
}
?>

Pour utiliser une fonction dans un script il faut que celle-ci soit déclarée avant sont appel: 

<?php
name();
?>

include - Inclure un fichier

La fonction include permet d'incure un fichier dans un autre. Cette fonction est par exemple utilisée sur le site de Libordux.Org pour inclure le haut (header) et la bas (footer) des pages, les fichiers inclus contiennent les logos, le menu de droite, etc. On peut inclure toutes sortes de fichiers différents texte, xHTML, XML, PHP, etc. Il est conseillé d'inclure des scripts PHP depuis un fichier .php au cas ou quelqu'un tenterait d'affichier la page directement, il ne verait que le code généré. Exemple d'inclusion: 

<?php
include("fichier.php");
?>

system - PHP et les commandes système

PHP permet de connaître différentes informations sur le système d'exploitation GNU/Linux sur lequel il est exécuté. Ceci grâce à la fonction system et aux commandes GNU/Linux. Vous pouvez créer un script affichant le temps depuis lequel il tourne, l'utilisation mémoire, les processus lancés, etc. Attention au données que vous diffusez sur le web. En local ou avec un script protégé par un fichier htaccess et un mot de passe crypté, vous pouvez créer une page avec toutes les infos qui vous sont utiles.

Afficher l'uptime de la machine

16:25:14 up 11 days, 5:15, load average: 0.01, 0.01, 0.00 

<?php
system("uptime");
?>

date - Heures et dates du serveur

PHP fournit plusieurs options pour connaître/afficher des informations en rapport à la date et l'heure du serveur, au du jour de l'année, etc. Il est par exemple très simple de savoir que nous sommes le 166 jours de l'année. Les valeurs de temps peuvent aussi facilement être reprise par des variables pour afficher l'heure ou créer des fichiers par date. Exemple d'affichage direct de l'heure et la date avec diverses avec echo:

Sunday 15 Jun 2008 16:25 UTC

<?php
echo date("l d M o H:i e");
?>

for - Créer une boucle

En PHP au lieu d'écrire plusieurs fois un mot ou une balise, il suffit de créer un script générant une boucle, manipulation classique en termes de programmation:

Trois fois.
Trois fois.
Trois fois.

<?php
for ($i = 0; $i<3; $i  ) {
    echo "Trois fois.<br />\n";
}
?>

srand - Nombres aléatoirs

La fonction srand permet de générer des chiffres aléatoirement, cette fonction peut être utilisée pour générer des mots de passes, créer des fichiers, etc. Ce petit script affiche 2 nombres aléatoirement à chaque fois que la page est rechargée:

161
73

    
<?php
srand(time());
for ($i = 0; $i<2; $i  ) {
    echo rand(1,1000)."<br />";
}
?>