<?xml version="1.0" encoding="utf-8"?>

<chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook" annotations="interactive">

<title>La syntaxe de base</title>

<sect1 xml:id="language.basic-syntax.phptags">

<title>Balises PHP</title>

<para>

Lorsque PHP traite un fichier, il reconnaît les balises d'ouverture et

de fermeture, <literal>&lt;?php</literal> et <literal>?&gt;</literal>, pour

définir les limites de l'exécution du code PHP. Le contenu en dehors des

balises est ignoré par l'analyseur PHP, permettant à PHP de s'intégrer

de manière transparente dans divers types de documents.

</para>

<para>

Un caractère d'espace (espace, tabulation, ou nouvelle ligne) doit suivre

<literal>&lt;?php</literal> pour assurer une séparation correcte des jetons.

Omettre cet espace blanc entraînera une erreur de syntaxe.

</para>

<para>

PHP inclut également la balise courte echo <literal>&lt;?=</literal>,

qui est un raccourci pour <code>&lt;?php echo</code>.

</para>

<para>

<example>

<title>Balises d'ouverture et de fermeture PHP</title>

<programlisting role="php">

<![CDATA[

</programlisting>

</example>

</para>

<para>

Les balises courtes (troisième exemple) sont disponibles par défaut,

mais peuvent être désactivées soit via l'option

<link linkend="ini.short-open-tag">short_open_tag</link>

du fichier de configuration &php.ini;, ou sont désactivées par défaut si PHP

est compilé avec l'option <option>--disable-short-tags</option>.

</para>

<para>

<note>

<para>

Comme les balises courtes peuvent être désactivées il est recommandé de

seulement utiliser les balises normales (<code>&lt;?php ?&gt;</code> et

<code>&lt;?= ?&gt;</code>) pour maximiser la compatibilité.

</para>

</note>

</para>

<para>

Si un fichier se termine avec du code PHP, il est préférable de ne pas placer

la balise de fermeture à la fin du fichier. Ceci permet d'éviter d'oublier

un espace ou une nouvelle ligne après la balise de fermeture de PHP, ce qui

causerait des effets non voulus car PHP commencera à afficher la sortie,

ce qui n'est souvent pas le cas désiré.

</para>

<para>

<example>

<title>Fichier contenant uniquement du code PHP</title>

<programlisting role="php">

</programlisting>

</example>

</para>

</sect1>

<sect1 xml:id="language.basic-syntax.phpmode">

<title>Échappement depuis du HTML</title>

<para>

Tout ce qui se trouve en dehors d'une paire de balises ouvrantes/fermantes

est ignoré par l'analyseur PHP, ce qui permet d'avoir des fichiers PHP

mixant les contenus. Ceci permet à PHP d'être contenu dans des documents

HTML, pour créer par exemple des templates.

</para>

<para>

<example>

<title>Intégrer du PHP dans du HTML</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<para>

Ceci fonctionne comme prévu parce que lorsque l'interpréteur PHP rencontre

la balise fermante ?&gt;, il commence simplement à afficher ce qu'il

rencontre (mis à part la nouvelle ligne qui est immédiatement suivie : voir

l'<link linkend="language.basic-syntax.instruction-separation">instruction

de séparation</link>) jusqu'à ce qu'il rencontre une autre balise ouvrante

même si PHP se trouve au milieu d'une instruction conditionnelle, auquel cas,

l'interpréteur va déterminer la condition à prendre en compte avant de prendre

une décision sur ce qui doit être affiché.

Voir le prochain exemple.

</para>

<para>

Utilisation de structures avec des conditions

<example>

<title>Échappement avancé en utilisant des conditions</title>

<programlisting role="php">

</programlisting>

</example>

Dans cet exemple, PHP va ignorer les blocs où la condition n'est pas remplie,

même s'ils sont en dehors des balises ouvrantes/fermantes de PHP. PHP

va les ignorer suivant la condition vu que l'interpréteur PHP va passer

les blocs contenant ce qui n'est pas rempli par la condition.

</para>

<para>

Pour afficher de gros blocs de texte, il est plus efficace de sortir

du mode d'analyse de PHP plutôt que d'envoyer le texte via la fonction

<function>echo</function> ou

<function>print</function>.

</para>

<para>

<note>

<para>

Si PHP est intégré dans un document XML ou XHTML, la balise PHP

standard <code>&lt;?php ?&gt;</code> doit être utilisée pour rester

conforme aux standards.

</para>

</note>

</para>

</sect1>

<sect1 xml:id="language.basic-syntax.instruction-separation">

<title>Séparation des instructions</title>

<para>

Comme en C ou en Perl, PHP requiert que les instructions soient terminées

par un point-virgule à la fin de chaque instruction. La balise

fermante d'un bloc de code PHP implique automatiquement un point-virgule ;

il n'est donc pas nécessaire d'utiliser un point-virgule

pour terminer la dernière ligne d'un bloc PHP. La balise fermante du bloc

englobera la ligne suivante, si elle existe.

</para>

<para>

<example>

<title>Exemple montrant que la balise fermante englobe la nouvelle ligne qui suit</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Exemples d'entrée et de sortie du parseur PHP</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<para>

<note>

<para>

La balise fermante d'un bloc PHP à la fin d'un fichier est optionnelle,

et parfois, il est utile de l'omettre lors de l'utilisation de la fonction

<function>include</function> ou

de la fonction <function>require</function>,

car les espaces non désirés n'apparaîtront pas à la fin des fichiers, et ainsi,

il sera toujours possible d'ajouter des en-têtes à la réponse plus tard. C'est utile

également lors de l'utilisation de l'affichage du buffer pour éviter de

voir des espaces blancs ajoutés à la fin des parties générées par les fichiers

inclus.

</para>

</note>

</para>

</sect1>

<sect1 xml:id="language.basic-syntax.comments">

<title>Commentaires</title>

<para>

PHP supporte les commentaires de type C, C++ et Shell Unix (aussi

appelé style Perl). Par exemple :

</para>

<para>

<example>

<title>Commentaires</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Les commentaires sur une seule ligne ne commentent que jusqu'à la fin

de la ligne du bloc PHP courant.

Ceci signifie que le code HTML après <literal>// ... ?&gt;</literal>

ou après <literal># ... ?&gt;</literal> SERA affiché :

?&gt; terminera le mode PHP et retournera en mode HTML, et

<literal>//</literal> ou <literal>#</literal> n'influencera pas cela.

</simpara>

<para>

<example>

<title>Les commentaires vont jusqu'à la fin de la ligne</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Les commentaires style 'C' commentent jusqu'à ce que le premier <literal>*/</literal>

soit rencontré. Il faut faire attention aux commentaires style 'C'

nichés dans de gros blocs lors de la mise en commentaire.

</simpara>

<para>

<informalexample>

<programlisting role="php">

</programlisting>

</informalexample>

</para>

</sect1>

</chapter>