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

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

<title>La sintaxis básica</title>

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

<title>Etiquetas PHP</title>

<para>

Cuando PHP procesa un fichero, reconoce las etiquetas de apertura y

de cierre, <literal>&lt;?php</literal> y <literal>?&gt;</literal>, para

definir los límites de la ejecución del código PHP. El contenido fuera de

las etiquetas es ignorado por el analizador PHP, permitiendo a PHP integrarse

de manera transparente en diversos tipos de documentos.

</para>

<para>

Un carácter de espacio (espacio, tabulación, o nueva línea) debe seguir

<literal>&lt;?php</literal> para asegurar una separación correcta de los tokens.

Omitir este espacio en blanco resultará en un error de sintaxis.

</para>

<para>

PHP incluye también la etiqueta corta echo <literal>&lt;?=</literal>,

que es un atajo para <code>&lt;?php echo</code>.

</para>

<para>

<example>

<title>Etiquetas de apertura y cierre PHP</title>

<programlisting role="php">

<![CDATA[

</programlisting>

</example>

</para>

<para>

Las etiquetas cortas (tercer ejemplo) están disponibles por omisión,

pero pueden ser desactivadas a través de la opción

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

del fichero de configuración &php.ini;, o están desactivadas por omisión si PHP

es compilado con la opción <option>--disable-short-tags</option>.

</para>

<para>

<note>

<para>

Como las etiquetas cortas pueden ser desactivadas, se recomienda utilizar

solo las etiquetas normales (<code>&lt;?php ?&gt;</code> y

<code>&lt;?= ?&gt;</code>) para maximizar la compatibilidad.

</para>

</note>

</para>

<para>

Si un fichero termina con código PHP, es preferible no colocar

la etiqueta de cierre al final del fichero. Esto permite evitar olvidar

un espacio o una nueva línea después de la etiqueta de cierre de PHP, lo cual

causaría efectos no deseados ya que PHP comenzará a mostrar la salida,

lo cual no es a menudo el caso deseado.

</para>

<para>

<example>

<title>Fichero que contiene solo código PHP</title>

<programlisting role="php">

</programlisting>

</example>

</para>

</sect1>

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

<title>Escape desde HTML</title>

<para>

Todo lo que se encuentra fuera de un par de etiquetas de apertura/cierre

es ignorado por el analizador PHP, lo que permite tener ficheros PHP

mezclando contenidos. Esto permite a PHP estar contenido en documentos

HTML, para crear por ejemplo plantillas.

</para>

<para>

<example>

<title>Integrar PHP en HTML</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<para>

Esto funciona como se espera porque cuando el intérprete PHP encuentra

la etiqueta de cierre ?&gt;, simplemente comienza a mostrar lo que encuentra (a excepción de la nueva línea que es inmediatamente seguida: ver

la <link linkend="language.basic-syntax.instruction-separation">instrucción

de separación</link>) hasta que encuentre otra etiqueta de apertura

incluso si PHP se encuentra en medio de una instrucción condicional, en cuyo caso,

el intérprete determinará la condición a tener en cuenta antes de tomar una decisión sobre lo que debe ser mostrado.

Ver el siguiente ejemplo.

</para>

<para>

Uso de estructuras con condiciones

<example>

<title>Escape avanzado usando condiciones</title>

<programlisting role="php">

</programlisting>

</example>

En este ejemplo, PHP ignorará los bloques donde la condición no se cumpla,

incluso si están fuera de las etiquetas de apertura/cierre de PHP. PHP

los ignorará según la condición ya que el intérprete PHP pasará

los bloques que contienen lo que no se cumple por la condición.

</para>

<para>

Para mostrar grandes bloques de texto, es más eficiente salir

del modo de análisis de PHP en lugar de enviar el texto a través de la función

<function>echo</function> o

<function>print</function>.

</para>

<para>

<note>

<para>

Si PHP está integrado en un documento XML o XHTML, la etiqueta PHP

estándar <code>&lt;?php ?&gt;</code> debe ser utilizada para mantener la conformidad con los estándares.

</para>

</note>

</para>

</sect1>

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

<title>Separación de instrucciones</title>

<para>

Al igual que en C o en Perl, PHP requiere que las instrucciones sean terminadas

por un punto y coma al final de cada instrucción. La etiqueta

de cierre de un bloque de código PHP implica automáticamente un punto y coma;

por lo tanto, no es necesario utilizar un punto y coma

para terminar la última línea de un bloque PHP. La etiqueta de cierre

de un bloque incluye el carácter de nueva línea seguido inmediatamente si uno

está presente.

</para>

<para>

<example>

<title>Ejemplo que muestra que la etiqueta de cierre incluye la nueva línea que sigue</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

<para>

<example>

<title>Ejemplos de entrada y salida del analizador PHP</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<para>

<note>

<para>

La etiqueta de cierre de un bloque PHP al final de un fichero es opcional,

y a veces es útil omitirla cuando se utiliza la función

<function>include</function> o

la función <function>require</function>,

ya que los espacios no deseados no aparecerán al final de los ficheros, y así,

siempre se podrán agregar encabezados a la respuesta más tarde. Esto es útil

también si se desea utilizar la visualización del búfer y no se desea ver espacios en blanco añadidos al final de las partes generadas por los ficheros

incluidos.

</para>

</note>

</para>

</sect1>

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

<title>Comentarios</title>

<para>

PHP soporta los comentarios de tipo C, C++ y Shell Unix (también

llamado estilo Perl). Por ejemplo :

</para>

<para>

<example>

<title>Comentarios</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Los comentarios de una sola línea solo comentan hasta el final

de la línea del bloque PHP actual.

Esto significa que el código HTML después de <literal>// ... ?&gt;</literal>

o después de <literal># ... ?&gt;</literal> SERÁ mostrado:

?&gt; terminará el modo PHP y volverá al modo HTML, y

<literal>//</literal> o <literal>#</literal> no influirá en ello.

</simpara>

<para>

<example>

<title>Los comentarios van hasta el final de la línea</title>

<programlisting role="php">

</programlisting>

</example>

</para>

<simpara>

Los comentarios estilo 'C' comentan hasta que se encuentre el primer <literal>*/</literal>.

Se debe tener cuidado con los comentarios estilo 'C' anidados en grandes bloques cuando se comentan.

</simpara>

<para>

<example>

<title>Los comentarios de tipo C</title>

<programlisting role="php">

</programlisting>

</example>

</para>

</sect1>

</chapter>