<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/tutorial.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'tutorial.firstpage.php',
    1 => 'La premi&egrave;re page PHP',
    2 => 'La premi&egrave;re page PHP',
  ),
  'up' => 
  array (
    0 => 'tutorial.php',
    1 => 'Une introduction &agrave; PHP',
  ),
  'prev' => 
  array (
    0 => 'tutorial.php',
    1 => 'Une introduction &agrave; PHP',
  ),
  'next' => 
  array (
    0 => 'tutorial.useful.php',
    1 => 'Trucs pratiques',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'chapters/tutorial.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="tutorial.firstpage" class="section">
   <div class="info"><h1 class="title">La première page PHP</h1></div>
   <p class="simpara">
    Ce tutoriel suppose que PHP est déjà installé.
    Les instructions d&#039;installation sont disponibles sur la
    <a href="https://www.php.net/downloads.php" class="link external">&raquo;&nbsp;page de téléchargement</a>.
   </p>
   <p class="para">
    Créer un fichier appelé <var class="filename">hello.php</var>
    avec le contenu suivant :
   </p>
   <p class="para">
    <div class="example" id="example-1">
     <div class="info"><p><strong>Exemple #1 Notre premier script PHP : <var class="filename">hello.php</var></strong></p></div>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"Hello World!"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

     <div class="example-contents"><p>
      Depuis le terminal, il faut se rendre dans le répertoire contenant ce fichier et
      démarrer un serveur de développement avec la commande suivante :
     </p></div>
     <div class="example-contents">
<div class="shellcode"><pre class="shellcode">php -S localhost:8000</pre>
</div>
     </div>

     <div class="example-contents"><p>
      Il faut utiliser un navigateur pour accéder au fichier en utilisant l&#039;URL du serveur web, se terminant
      avec la référence au fichier <code class="literal">/hello.php</code>.
      Selon la commande précédente exécutée, l&#039;URL sera
      <code class="literal">http://localhost:8000/hello.php</code>.
      Si tout est configuré correctement, ce fichier sera analysé par PHP
      et la sortie &quot;Hello World!&quot; sera affichée dans le navigateur.
     </p></div>
     <div class="example-contents"><p>
      PHP peut être intégré dans une page web HTML normale. Cela signifie que, dans le document HTML,
      il est possible d&#039;écrire des instructions PHP, comme démontré dans l&#039;exemple suivant :
     </p></div>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">&lt;!DOCTYPE html&gt;<br />&lt;html&gt;<br />    &lt;head&gt;<br />        &lt;title&gt;Test PHP&lt;/title&gt;<br />    &lt;/head&gt;<br />    &lt;body&gt;<br />        <span style="color: #0000BB">&lt;?php </span><span style="color: #007700">echo </span><span style="color: #DD0000">'&lt;p&gt;Bonjour le monde&lt;/p&gt;'</span><span style="color: #007700">; </span><span style="color: #0000BB">?&gt;<br /></span>    &lt;/body&gt;<br />&lt;/html&gt;</span></code></div>
     </div>

     <div class="example-contents"><p>
      Cela produira le résultat suivant :
     </p></div>
     <div class="example-contents screen">
<div class="cdata"><pre>
&lt;!DOCTYPE html&gt;
&lt;html&gt;
    &lt;head&gt;
        &lt;title&gt;Test PHP&lt;/title&gt;
    &lt;/head&gt;
    &lt;body&gt;
        &lt;p&gt;Bonjour le monde&lt;/p&gt;
    &lt;/body&gt;
&lt;/html&gt;
</pre></div>
     </div>
    </div>
   </p>
   <p class="para">
    Ce programme est extrêmement simple et PHP n&#039;est pas nécessaire
    pour créer une page web comme ceci. Elle ne fait qu&#039;afficher
    <code class="literal">Bonjour le monde</code>, grâce à la fonction
    <span class="function"><a href="function.echo.php" class="function">echo</a></span>
    de PHP. Il est à noter que ce fichier <em>n&#039;a pas besoin d&#039;être exécutable</em>
    ou autre, dans aucun cas. Le serveur sait que ce fichier a besoin d&#039;être interprété
    par PHP, car l&#039;extension &quot;.php&quot; est utilisée, et le serveur est configuré pour
    les passer à PHP. Il s&#039;agit d&#039;une page HTML normale qui contient une série
    de balises spéciales qui permettent de réaliser beaucoup de choses intéressantes.
   </p>

   <p class="para">
    Le point important de cet exemple était de montrer le format des
    balises spéciales PHP. Nous avons utilisé ici
    <code class="literal">&lt;?php</code> pour indiquer le début de la balise PHP.
    Puis, nous avons introduit les commandes PHP et refermé les balises
    PHP avec <code class="literal">?&gt;</code>. Il est possible de passer du mode PHP
    au mode HTML et vice-versa, de cette manière, à volonté. Pour plus
    d&#039;informations, consulter la section du manuel sur la
    <a href="language.basic-syntax.php" class="link">syntaxe basique de PHP</a>.
   </p>

   <blockquote class="note"><p><strong class="note">Note</strong>: 
    <span class="info"><strong>Une note sur les retours à la ligne</strong><br /></span>
    <p class="para">
     Les retours à la ligne ont une signification minime en HTML, cependant,
     c&#039;est toujours une bonne idée de rendre le HTML aussi joli et proche
     que possible en y ajoutant des retours à la ligne. Un retour à la ligne
     suivant immédiatement une balise de fermeture PHP (<code class="literal">?&gt;</code>)
     sera supprimé par PHP. Ceci peut être vraiment très utile lors de
     l&#039;insertion de plusieurs blocs PHP ou fichiers inclus contenant du PHP qui
     n&#039;est pas supposé afficher quoi que ce soit. En même temps, ce peut
     être confus. Il est possible d&#039;ajouter un espace après la balise fermante
     PHP (<code class="literal">?&gt;</code>) pour forcer l&#039;espace et un retour à
     la ligne à afficher, ou d&#039;ajouter explicitement un retour à la ligne
     dans le dernier echo/print du bloc PHP.
    </p>
   </p></blockquote>

   <blockquote class="note"><p><strong class="note">Note</strong>: 
    <span class="info"><strong>Une note sur les éditeurs de texte</strong><br /></span>
    <p class="para">
     Il existe de nombreux éditeurs de texte et environnements de
     développement (IDE) utilisables pour créer, éditer
     et gérer des applications PHP. Une liste partielle de ces outils
     est entretenue à l&#039;adresse
     <a href="http://en.wikipedia.org/wiki/List_of_PHP_editors" class="link external">&raquo;&nbsp;PHP Editor&#039;s List</a>.
     Pour recommander un éditeur particulier, il suffit de visiter
     cette page et de demander au webmestre de l&#039;ajouter. Avoir au minimum
     un éditeur de texte avec la coloration syntaxique peut être utile.
    </p>
   </p></blockquote>

   <blockquote class="note"><p><strong class="note">Note</strong>: 
    <span class="info"><strong>Une note sur les traitements de texte</strong><br /></span>
    <p class="para">
     Les traitements de texte tels que StarOffice Writer, Microsoft Word et
     Abiword sont de très mauvais choix pour éditer des scripts PHP.
     Pour utiliser l&#039;un d&#039;entre eux malgré tout pour tester des
     scripts, il faut s&#039;assurer de sauver les fichiers au format
     texte seul (<em>plain text</em>) : sinon, PHP ne sera pas capable de lire
     et d&#039;exécuter ces scripts.
    </p>
   </p></blockquote>

   <p class="para">
    Maintenant que le script PHP précédent fonctionne, c&#039;est le moment
    de créer le meilleur script PHP ! Un appel à la fonction
    <span class="function"><a href="function.phpinfo.php" class="function">phpinfo()</a></span> affichera beaucoup d&#039;informations
    intéressantes sur le système et sa configuration comme les
    <a href="language.variables.predefined.php" class="link">variables pré-définies disponibles</a>,
    les modules PHP chargés ainsi que la <a href="configuration.php" class="link">configuration</a>.
    Prendre le temps de revoir ces informations importantes.
   </p>
   <p class="para">
    <div class="example" id="example-2">
     <div class="info"><p><strong>Exemple #2 Récupération des informations du système depuis PHP</strong></p></div>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />phpinfo</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
   </p>
  </div><?php manual_footer($setup); ?>