Différences

Ci-dessous, les différences entre deux révisions de la page.

--- php [2019/02/02 06:20]
127.0.0.1 modification externe
+++ php [2020/02/13 11:21]
@@ Ligne 1: / Ligne 1: @@
-====== Configuration PHP ======
-===== Qu'est ce que PHP ? =====
-PHP (venant de l'acronyme récursif PHP: Hypertext Preprocessor), est un langage de scripts libre principalement utilisé pour être exécuté par un serveur Web.
-PHP est un langage procédural disposant en version 5 de fonctionnalités de modèle objet complètes. En raison de la richesse de sa bibliothèque, on désigne parfois PHP comme une plate-forme plus qu'un simple langage. (Définition de wikipédia)
-===== Configuration de PHP =====
-"phpinfo()" est une fonction du langage PHP, elle permet de connaître les modules activés, la configuration du serveur, les éventuelles restrictions et limitations ainsi que les paramètres de compilation du langage.
-<code php>
-<?php
-// Affichage des informations sur le PHP utilisé :
-echo phpinfo();
-?>
-</code>
-Vous pouvez consulter les différents PHPInfo de la plateforme de FranceServ Hébergement à cette adresse :
-https://phpinfo.franceserv.fr/
-FranceServ Hébergement propose à ses hébergés le choix
-entre les branches PHP 5.6, 7.0, 7.1, 7.2 et 7.3 dans leurs dernières versions respectives.
-Il est possible de choisir la version de la branche du moteur de PHP pour chacun de ses sites internet à l'aide du gestionnaire de son site directement dans son interface de gestion.
-Avec le connecteur suPHP (et non pas PHP-FPM qui est utilisé par défaut), il est également possible de définir cette version directement à l'aide du fichier .htaccess pour disposer différentes versions PHP sur un même site Internet :
-^Branche du moteur PHP^ Directive .htaccess ^
-|PHP 7.3.x | SetEnv PHP_VER 7_3|
-|PHP 7.2.x | SetEnv PHP_VER 7_2|
-|PHP 7.1.x (par défaut) | SetEnv PHP_VER 7_1|
-|PHP 7.0.x | SetEnv PHP_VER 7_0|
-|PHP 5.6.x | SetEnv PHP_VER 5_6|
-===== Afficher/masquer les erreurs PHP =====
-Par défaut, les messages d'alertes et d'erreurs PHP ne sont pas affichés pour vos sites Internet afin d'éviter qu'un pirate puisse les utiliser à mauvais escient et qu'il y découvre de potentielles failles de sécurité à exploiter. C'est pour cette raison que lorsqu'il y a une erreur sur une page de votre site, celle-ci peut s'afficher totalement vide sur un fond blanc avec un code HTTP 500 par exemple.
-Afficher les erreurs sur un site web est pratique pour comprendre d'où viens un problème mais ça à aussi ses inconvénients. Il est recommandé d'afficher les erreurs que pendant la phase de test. Un site en production ne devrait pas afficher de messages d'alertes ou d'erreurs PHP pour des raisons de performances, de sérieux et de sécurité.
-Si vous avez une erreur de développement PHP ou .htaccess, vous avez 2 moyens pour les analyser. Mais avant tout, il vous faut maintenir à jour la ou les solutions Web que vous utilisez afin de suivre les mises à jours.
-==== Via le journal d'erreur en temps réel du Superviseur FSH : ====
-Documentation du superviseur : https://www.franceserv.fr/wiki/superviseur
-Le superviseur permet d'identifier les alertes et erreurs PHP ainsi que les erreurs .htaccess
-==== Manuellement : ====
-Pour qu'un fichier PHP affiche les erreurs PHP, le code suivant est à insérer tout en haut du code de votre page PHP où se trouve l'erreur :
-<code php>
-<?php
-// Afficher les erreurs à l'écran
-ini_set('display_errors', 1);
-// Nom du fichier log
-ini_set('error_log', 'errors.txt');
-// Enregistrer les erreurs dans un fichier log
-ini_set('log_errors', 1);
-// Afficher les erreurs et les avertissements
-error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT );
-?>
-</code>
-Pour aller plus loin, sachez qu'il est bon de ne pas spécifier ~E_DEPRECATED dans le error_reporting() afin de vérifier que l'on n'utilise pas de fonctions PHP qui disparaitrons dans les prochaines mises à jour PHP. Ça permet d'anticiper son développement PHP.
-===== Comment utiliser les sessions ? =====
-Les sessions sont un moyen pour conserver des informations pendant une visite.
-Les sessions sont activées chez FranceServ Hébergement par défaut.
-Vous n'avez pas à créer de répertoire pour vos sessions comme elles sont stockées au sein même du serveur. Vous pouvez y accéder à l'aide des fonctions sessions de PHP mais ne pouvez pas y accéder directement avec d'autres fonctions (fopen etc ...)
-Un exemple simple :
-Créez un fichier start.php (attention a l'extension .php) contenant :
-<code php>
-<?php
-  session_start();
-  session_register ("count");
-  $count = 42;
-  echo "On enregistre ".$count." <br>";
-?>
-  Pour aller a la page suivante, <A HREF="nextpage.php">cliquez ici</A>
-</code>
-Créez un fichier “nextpage.php” contenant :
-<code php>
-<?php
-  session_start();
-  session_register("count");
-  echo "La valeur précédente de count etait " . $count ."<br>";
-?>
-</code>
-Téléchargez les fichiers dans votre espace FTP dans le dossier de votre site et faites un test en appelant l'URL correspondante de start.php
-===== Répertoire Racine (DocumentRoot) =====
-Il est primordial de ne jamais utiliser de chemin absolu codé en ‘dur’, car le chemin est susceptible de changer et votre site serait alors inaccessible.
-Aussi, vous pouvez(devez) utiliser la variable $_SERVER['DOCUMENT_ROOT'] qui pointe a la racine du site Web dans lequel se trouve votre script, vous serez donc sur de ne jamais avoir de déconvenues.
-Exemple : Vous voulez savoir quel est le chemin correspondant a http://www.monsite.ext/unrepertoire/unautrerepertoire/
-Il s’agit de $chemin = $_SERVER['DOCUMENT_ROOT']."/unrepertoire/unautrerepertoire/";
-===== Connexion à une base de donnée =====
-Les connexions persistantes ne sont pas possibles du fait de l’architecture et sont effectuées en tant que connexion standard.
-===== Temps d’exécution maximum d'un script PHP =====
-Le temps d’exécution maximum d'un script PHP est soit de 3 minutes pour l'offre gratuite, de 6 minutes pour l'offre Standard et de 12 minutes pour l'offre Pro.
-La fonction set_time_limit() de PHP ne figure pas/plus parmi les fonctions interdites car elle était trop souvent utilisée à tort afin de définir un temps d’exécution maximum illimité.
-Lorsque le temps d’exécution maximum d'un script PHP était redéfinie à l'aide de cette fonction, une alerte apparaissait et beaucoup d'hébergés pensaient y voir soit une erreur (alors que c'était une alerte) ou une limitation (alors que 3 minutes c'est largement suffisant pour un un site web).
-Même si cette fonction n'est plus interdite, n’espérez pas non plus faire fonctionner un script PHP pendant plus de votre temps accordé, un robot vérifie et termine de force les scripts PHP excédant ce temps d’exécution maximum.
-===== Uploader des fichiers =====
-L'upload de fichiers via PHP est activé de base et la taille maximale d'un fichier pouvant être envoyé via PHP est de 32 Mo par défaut. Cette limite peut être rehaussée jusqu'à 400 Mo via le PHP personnalisé ".php.ini" à la racine de son site à l'aide des directives upload_max_filesize et post_max_size, par exemple ainsi :
-<code php .php.ini>
-upload_max_filesize = 400M
-post_max_size = 400M
-</code>
-La principale source de piratage et de destruction d'un site Internet provient d'un formulaire d'envoi de fichiers non sécurisé.
-Pour des raisons de sécurité, il faut veiller à ce qu'un script PHP ne puisse pas envoyer de fichier PHP car un internaute pourrai utiliser le formulaire d'envoi pour prendre le contrôle total de votre site.
-C'est pour cette raison qu'il faut dans un premier temps, bloquer l’exécution de PHP éventuel dans le répertoire où sont envoyés les fichiers via PHP.
-Soit en plaçant un fichier .htaccess dans le répertoire des envois :
-<code>
-<Files ^(*.php|*.phps)>
-    order deny,allow
-    deny from all
-</Files>
-</code>
-Ou directement à la racine de votre site ce qui est plus sécurisé :
-<code>
-<Directory /home/httpd/d/e/m/demo/demo.franceserv.com/upload>
-    <Files ^(*.php|*.phps)>
-        order deny,allow
-        deny from all
-    </Files>
-</Directory>
-</code>
-Il ne faut jamais permettre à votre script PHP d'envoyer des fichiers à la racine de votre site.
-Vous devez renommer le fichier envoyé avec l'aide de la fonction move_updloaded_file avant la fin de votre script. Le fichier temporaire est effacé à la fin de l'envoi.
-Voici un script PHP sécurisé pour permettre l'envoi de fichier image d'extension ".jpg", de type mime "image/jpeg" et d'un poids inférieur à 350 Ko :
-<code php upload.php>
-<html>
-<body>
-  <form enctype="multipart/form-data" action="upload.php" method="post">
-    <input type="hidden" name="MAX_FILE_SIZE" value="1000000" />
-    Le fichier image : <input name="uploaded_file" type="file" />
-    <input type="submit" value="Envoyer" />
-  </form>
-</body>
-</html>
-<?php
-// On vérifie que le formulaire est envoyé.
-if( isset($_POST['uploaded_file']) )
-  {
-  // On vérifie qu'il y a bien un fichier à envoyer et qu'il ne comporte pas d'erreur.
-  if((!empty($_FILES["uploaded_file"])) && ($_FILES['uploaded_file']['error'] == 0))
-    {
-    // On pourrai récupérer le type mime du fichier envoyé mais un pirate peut
-    // toujours modifier cette information en HTML. Dans la mesure où l'on
-    // n'accepte que des images dans cet exemple, on va utiliser une fonction
-    // PHP interne qui ne fonctionne qu'avec des images. Cette fonction est
-    // sécurisée car elle est exécutée après l'envoi du fichier dans la zone
-    // temporaire du serveur, il n'est alors plus possible de modifier les
-    // propriétés du fichier pour tromper la mémoire interne.
-    $upload_internal = getimagesize($_FILES['uploaded_file']['tmp_name']);
-    // On récupère l'extension du fichier envoyé
-    $filename = basename($_FILES['uploaded_file']['name']);
-    $ext = substr($filename, strrpos($filename, '.') + 1);
-    // On vérifie que :
-    // 1) le fichier interne est une image,
-    // 2) le type mime correspond à une image,
-    // 3) l'extension du fichier est permise,
-    // 4) le poid du fichier est inférieur à 350 Ko
-    if ( ($upload_internal) && (substr($upload_internal['mime'], 0, 6) == 'image/') && ($ext == "jpg" | $ext == "jpeg" | $ext == "png") && ($_FILES["uploaded_file"]["size"] < 350000))
-      {
-      // On détermine où sauvegarder le fichier final
-      $newname = dirname(__FILE__).'/upload/'.$filename;
-      // On vérifie que le fichier final n'a pas déjà été envoyé pour ne pas le remplacer
-      if (!file_exists($newname))
-        {
-        // On tente de déplacer le fichier temporaire dans son empalcement final
-        if ((move_uploaded_file($_FILES['uploaded_file']['tmp_name'], $newname)))
-          {
-          echo "Le fichier a bien été envoyé et se trouve à cet emplacement : ".$newname;
-          } else {
-          echo "Erreur : Il y a eu un problème lors de l'envoi du fichier !";
-          }
-        } else {
-        echo "Erreur ! Le fichier ".$_FILES["uploaded_file"]["name"]." existe déjà !";
-        }
-      } else {
-      echo "Erreur : Seules les images d'extensions .jpg/.jpeg/.png et inférieure à 350 Ko sont acceptées !";
-      }
-    } else {
-    echo "Erreur : Il n'y a pas de fichier à envoyer !";
-    }
-  }
-?>
-</code>
-Ce script PHP d'upload d'image est sécurisé car il ne fait pas confiance au navigateur.
-Le script PHP vérifie alors la taille de la soit disant image au moment où le fichier se trouve dans la zone temporaire d'upload avec la fonction PHP getimagesize(). Si la taille de l'image retournée est 0, ce n'est alors pas une image valide, mais très certainement un script PHP qui se fait passer pour une image en modifiant le type mime de son format à l'intérieur de son propre contenu.
-===== Envoyer des emails =====
-La fonction mail() de PHP est activée par défaut. Pour en savoir plus sur son utilisation, merci de consulter le lien suivant :
-https://www.franceserv.fr/wiki/mail#envoyer_un_mail_depuis_son_site_avec_php
-Pour information, la fonction mail renvoie TRUE en cas de succès et FALSE si le mail a été bloqué avant son envoi.
-Soyez conscient qu'un individu malveillant peut profiter des formulaires de contact pour vous envoyer du spam. En l'appelant plusieurs fois par seconde, il va finir par saturer l'adresse mail que vous avez indiqué. L'ajout d'une procédure de type captcha peut vous aider à éviter ce genre de piratage, et donc vous éviter la suspension ou l'annulation temporaire ou non de votre service mail ou de votre compte.
-===== Créer un formulaire de contact (form2mail) =====
-Nous supposons dans cet exemple que le nom de domaine hébergé est “domaine.ext”.
-Créer un fichier “form.html” que vous mettrez en ligne via FTP.
-<code html>
-<html>
-<body>
-<form action="form2mail.php" method="post">
-Entrez votre adresse mail: <input type="text" name="email"><br>
-Message:<br>
-<textarea name="message" rows="8" cols="50"></textarea><br>
-<input type="submit" value="Envoyer le mail">
-</form>
-</body>
-</html>
-</code>
-Créer un second fichier “form2mail.php” que vous mettrez en ligne via FTP.
-<code php>
-<?php
-/* Initialisation des variables */
-$from = "webmaster@domaine.ext"; // l'expéditeur : remplacer ici domaine.ext par votre domaine
-$to = "vous@domaine.ext"; // le destinataire : mettez ici votre adresse mail valide
-/* Préparation */
-$subject = "Test fonction mail() de PHP"; // le sujet du mail
-$email = NULL;
-$message = NULL;
-/* Récupération du champs email */
-if (!empty($_POST['email'])) {
-  $email = $_POST['email'] ;
-}
-/* Récupération du champs message */
-if ($email && !empty($_POST['message'])) {
-  $message = "Message envoyé par $email :\n" . $_POST['message'];
-}
-/* Envoi*/
-if ($email && $message)
-{
-  /* En-têtes obligatoires du message */
-  $headers = "From: Webmaster <$from>\n";
-  $headers .= "To: Contact <$to>\n";
-/*  $headers .= "MIME-Version: 1.0\n";
-  $headers .= "Content-type: text/plain; charset=iso-8859-15\n";
- /*  Appel a la fonction mail */
-  if (!mail($to, $subject, $message, $headers)){
-     echo "Erreur: Impossible d'envoyer le mail";
-  } else {
-     echo "Envoi réussi";
-  }
-}
-else {
-  echo "Erreur: vous devez spécifier une adresse email valide et un texte\n";
-}
-?>
-</code>
-Quand vous transférez votre fichier .htaccess, vérifiez que le mode de transfert FTP est "TEXTE" et non pas "BINAIRE", sinon vous aurez une erreur http 500.
-Le safe mode n'est pas activé.
-Astuce :
-Remplacez la ligne :
-  echo "Envoi réussi";
-par une ligne du style :
-  header("location: /envoi_reussi.html");
-car en affichant uniquement un echo, le visiteur peut actualiser sa page à l'aide de la touche F5 pour envoyer le mail le nombre de fois qu'il actualise et flooder votre boite mail de contact.
-===== chown =====
-La modifications du propriétaire des fichiers est prohibé, les fichiers uploadés via PHP et/ou via FTP ont déjà votre utilisateur.
-===== system / exec / popen =====
-L'exécution de programme binaires, d'exécutables ou de cgi est prohibé pour des raisons de sécurité.
-===== ASP/CGI =====
-Pas d'asp, ni de cgi (cgi-bin), ni de programmes exécutables.
-===== Liste des branches PHP =====
-| Branche | Fin de vie | Disponibilité | Stabilité |
-| 7.3 | 6 Dec 2021 | oui | oui |
-| 7.2 | 31 Dec 2020 | oui | oui |
-| 7.1 | 1 Dec 2019 | oui | oui |
-| 7.0 | 3 Dec 2018 | oui | non |
-| 5.6 | 31 Dec 2018 | oui | non |
-| 5.5 | 10 Jul 2016 | non | non |
-| 5.4 | 3 Sep 2015 | non | non |
-| 5.3 | 14 Aug 2014 | non | non |
-| 4.4 | 7 Aug 2008 | non | non |