Primeras páginas en PHP. PHP. Bartolomé Sintes Marco. www.mclibre.org

Estructura de una página PHP

Una página PHP es un archivo de texto que contiene uno o varios fragmentos de código PHP y que también puede contener fragmentos de código HTML.

Fragmentos PHP

Los fragmentos de código PHP están delimitados por las etiquetas <?php (etiqueta inicial) y ?> (etiqueta final) y contienen las instrucciones de PHP. Más adelante se comentan otros posibles delimitadores de fragmentos de código PHP.

<?php
print "<p>Hola</p>\n";
?>

<p>Hola</p>

Si el programa termina con un fragmento PHP, ese último fragmento PHP no necesita cerrarse. Los siguientes programas son correctos:

<?php
print "<p>Hola</p>\n";

<p>Hola</p>

<?php
  print "<p>Hola</p>\n";
?>
<?php
print "<p>Adios</p>\n";

<p>Hola</p>
<p>Adios</p>

Los fragmentos de PHP no pueden anidarse, es decir, no puede haber un fragmento dentro de otro:

<?php
print "<p>Hola</p>\n";

<?php
print "<p>Adios</p>\n";
?>

Parse error: syntax error, unexpected '<' in ejemplo.php on line 4

Si en una misma página hay varios fragmentos PHP, se tratan como un único programa. Los siguientes programas son equivalentes:

<?php
$saludo = "Hola";         // Se define una variable
print "<p>$saludo</p>";   // Se escribe el valor de la variable
?>

<p>Hola</p>

<?php
$saludo = "Hola";             // Se define una variable
?>
<?php
print "<pre>$saludo<pre>";   // Se escribe el valor de la variable
?>

<p>Hola</p>

Fragmentos PHP y fragmentos HTML

En una página PHP todo lo que no son fragmentos PHP son fragmentos HTML. Los fragmentos de código HTML no están delimitados por ninguna etiqueta.

<?php
print "<p>Hola</p>\n";
?>
<p>¿Cómo estás?</p>

<p>Hola</p>
<p>¿Cómo estás?</p>

Cuando un navegador solicita una página PHP a un servidor, el servidor lee el archivo secuencialmente y va generando el resultado:

si la página contiene fragmentos HTML, el código HTML se incluye sin modificados en el resultado.
si la página contiene fragmentos PHP, se ejecutan las instrucciones que se encuentran en los fragmentos de código PHP. Si esas instrucciones generan texto, el texto se incluye en el resultado.

Cuando el servidor termina de leer el archivo, el servidor envía al navegador el resultado.

Es importante señalar que:

El navegador recibe una página web (es decir, únicamente código HTML), no recibe código PHP.
Los fragmentos PHP tiene que generar las etiquetas HTML que se necesiten para una correcta visualización de la página web en el navegador.
El navegador no puede distinguir en la página recibida, qué parte ha sido generada en un fragmento PHP y qué parte se encontraba ya en un fragmento HTML.
Como la página PHP se lee secuencialmente, el código HTML generado por los fragmentos PHP y el incluido en los fragmentos HTML se encuentran en el mismo orden en que se encontraban los fragmentos en la página PHP.

Los ejemplos siguientes muestran diferentes programas PHP que generan el mismo resultado:

Programa con un único fragmento PHP

<?php
print "<p>Hola</p>\n";
print "<p>¿Cómo estás?</p>\n";
print "<p>Adios</p>\n";
?>

<p>Hola</p>
<p>¿Cómo estás?</p>
<p>Adios</p>

Programa con un fragmento PHP y un fragmento HTML

<p>Hola</p>
<?php
print "<p>¿Cómo estás?</p>\n";
print "<p>Adios</p>\n";
?>

<p>Hola</p>
<p>¿Cómo estás?</p>
<p>Adios</p>

Programa con dos fragmentos PHP y un fragmento HTML

<?php
print "<p>Hola</p>\n";
?>
<p>¿Cómo estás?</p>
<?php
print "<p>Adios</p>\n";
?>

<p>Hola</p>
<p>¿Cómo estás?</p>
<p>Adios</p>

En un fragmento PHP no pueden escribirse etiquetas HTML sueltas; el código HTML debe generarse siempre con instrucciones de PHP. El programa siguiente no puede ni siquiera ejecutarse y produce un error de sintaxis:

<?php
<p>Hola</p>
?>

Parse error: syntax error, unexpected '<' in ejemplo.php on line 2

De la misma manera, no se deben escribir instrucciones de PHP fuera de fragmentos PHP. No se producen errores, pero el resultado no es el esperado. Como el texto fuera de fragmentos PHP se envía tal cual al navegador, el navegador recibirá las instrucciones de PHP, que el navegador no sabe ejecutar y se mostrarán en la pantalla.

<?php
print "<p>Hola</p>\n";
?>
<p>¿Cómo estás?</p>

print "<p>Adios</p>\n";

<p>Hola</p>
<p>¿Cómo estás?</p>

print "<p>Adios</p>\n";

Se pueden fragmentar incluso las estructuras de PHP que ocupan varias líneas (aunque no es habitual hacerlo). Los siguientes programas son equivalentes:

<p>¿Dos y dos son cuatro?</p>
<?php
if (2 + 2 == 4) {
    print "<p>Sí</p>\n";
} else {
    print "<p>No</p>\n";
}

<p>¿Dos y dos son cuatro?</p>
<p>Sí</p>

<p>¿Dos y dos son cuatro?</p>
<?php if (2 + 2 == 4) { ?>
<p>Sí</p>
<?php } else { ?>
<p>No</p>
<?php } ?>

<p>¿Dos y dos son cuatro?</p>
<p>Sí</p>

El delimitador <? ... ?>

Nota: El delimitador <? ... ?> no se debe utilizar. Se comenta en esta lección porque todavía se puede encontrar en código escrito hace muchos años.

El delimitador <? se podía utilizar antiguamente como delimitador de bloques PHP, pero desde hace años se desaconseja completamente su uso porque provoca conflictos, entre otros, con la instrucción de procesamiento xml (<?xml) de los documentos XML. En su lugar, se debe utilizar el delimitador <?php .. ?>.

Mediante la directiva short_open_tag (etiqueta de apertura abreviada) se puede permitir el uso del delimitador <? además del delimitador <?php. Si la directiva short_open_tag tiene el valor On (lo que está desaconsejado), el siguiente programa no daría errores:

<?
print "<p>Hola</p>\n";
?>

<p>Hola</p>

Pero si la directiva short_open_tag tiene el valor Off (valor recomendado), el mismo programa produciría un resultado incorrecto y que puede resultar chocante, ya que en el navegador se puede ver el programa original:

<?
print "<p>Hola</p>\n";
?>

<?
print "<p>Hola</p>\n";
?>

Este resultado se debe a que como el programa no contiene el delimitador <?php, su contenido no se reconoce como fragmento PHP. Como no se reconoce como fragmento PHP, el servidor lo envía tal cual al navegador, que no puede mostrarlo correctamente puesto que no es html correcto. Abriendo la vista de código fuente en el navegador, se podría ver mejor el programa completo.

El delimitador <?= ... ?>

El delimitador <?= es una abreviatura de la expresión <?php echo que se utiliza en muchos frameworks de PHP en los documentos que sirven de plantilla de generación de interfaces, sobre todo cuando estas plantillas las van a editar usuarios que pueden no tener conocimientos de programación (diseñadores gráficos, etc.).

<?php
$saludo = "Hola";
$despedida = "Adios";
?>
<p><?= $saludo ?></p>
<p><?= $despedida ?></p>

<p>Hola</p>
<p>Adios</p>

Antes de PHP 5.4, publicado en marzo de 2012, para poder usar este delimitador se necesitaba activar la directiva short_open_tag. El problema era que, como se comenta en el apartado anterior, desde hace años se aconseja no activar esa directiva para impedir el uso del delimitador <?. A partir de PHP 5.4 se resolvió este problema desvinculado el delimitador <?= de la directiva short_open_tag. por tanto, desde PHP 5.4, el delimitador <?= se puede utilizar sin limitaciones.

Instrucciones PHP

Los fragmentos PHP contienen instrucciones de PHP. Las instrucciones individuales deben terminarse por un punto y coma (;).

<?php
print "<p>Hola</p>\n";
print "<p>Adios</p>\n";
?>

<p>Hola</p>
<p>Adios</p>

La última instrucción antes del cierre de un fragmento puede no llevar punto y coma, aunque se aconseja terminar todas las instrucciones con punto y coma, para evitar errores si posteriormente se añaden instrucciones al final del fragmento o si se mueve esa última instrucción a un punto anterior del programa.

<?php
print "<p>Hola</p>\n";
print "<p>Adios</p>\n" 
?>

<p>Hola</p>
<p>Adios</p>

Una línea puede contener varias instrucciones, aunque por legibilidad se recomienda escribir una sola instrucción por línea de programa.

<?php
print "<p>Hola</p>\n"; print "<p>Adios</p>\n";
?>

<p>Hola</p>
<p>Adios</p>

Los grupos de instrucciones se escriben entre llaves. Tras las llaves no es necesario escribir puntos y comas y se recomienda no hacerlo, pues en algunos casos puede ser incluso un error de sintaxis, aunque la última instrucción dentro de las llaves requiere el punto y coma.

<?php
$a = 5;
if ($a == 5) {
    print "<p>$a es cinco</p>\n";
    print "<p>¡Hasta otra!</p>\n";
}
?>

<p>Hola</p>
<p>Adios</p>

<?php
$a = 5;
if ($a == 5) {
    print "<p>$a es cinco</p>\n";
    print "<p>¡Hasta otra!</p>\n";
};
?>

<p>Hola</p>
<p>Adios</p>

<?php
$a = 5;
if ($a == 5) {
    print "<p>$a es cinco</p>\n";
    print "<p>¡Hasta otra!</p>\n";
}; else {
    print "<p>$a no es cinco</p>\n";
    print "<p>¡Hasta otra!</p>\n";
}
?>

Parse error: syntax error, unexpected 'else' (T_ELSE), expecting end of file in ejemplo.php on line 6

Comentarios en páginas PHP

En un fragmento PHP se pueden comentar líneas o fragmentos de línea utilizando:

// para comentar el resto de la línea (como en C++)
# para comentar el resto de la línea (como en la shell de Unix o en Perl)
/* */ para delimitar varias líneas o una parte de una línea (como en C)

Las líneas o fragmentos comentados no se ejecutan ni se añaden al código HTML generado por la página, por lo que no se ven en el navegador. Los comentarios se pueden utilizar para añadir aclaraciones o información adicional en forma de texto libre o para evitar que se ejecuten determinadas instrucciones.

<?php
// La instrucción print escribe texto en la página web
print "<p>Hola</p>"; // El comentario se puede escribir al final de la línea

// print "<p>Adios</p>";
// Las instrucciones en líneas comentadas no se ejecutan
?>

<p>Hola</p>

<?php
# La instrucción print escribe texto en la página web
print "<p>Hola</p>"; # El comentario se puede escribir al final de la línea

# print "<p>Adios</p>";
# Las instrucciones en líneas comentadas no se ejecutan
?>

<p>Hola</p>

<?php
/* En un fragmento PHP no se pueden escribir
   etiquetas html sueltas, tienen que estar
   siempre incluidas en instrucciones print
*/
print "<p>Hola</p>"; /* El comentario se puede escribir al final de la línea */

/* print "<p>Adios</p>";
   Las instrucciones en líneas comentadas no se ejecutan
*/
?>

<p>Hola</p>

Los comentarios /* */ pueden abarcar varias líneas o una parte de la línea:

<?php
print "<p>Hola</p>"; /* print "<p>¿Qué tal?</p>"; */ print "<p>Adiós</p>";
?>

<p>Hola</p><p>Adiós</p>

Si se quiere generar un comentario HTML, hay que incluir la etiqueta de comentarios de HTML .

En principio, el navegador no muestra los comentarios HTML, salvo que elijamos ver el código fuente de la página web en el navegador (atajo Ctrl+u).

<?php
print "<p>Hola</p>\n";
print "<!-- El texto anterior ha sido generado por PHP -->\n"
?>

<p>Hola</p>
<!-- El texto anterior ha sido generado por PHP -->

Si se quieren escribir comentarios en las hojas de estilo CSS, hay que utilizar la etiqueta de comentarios de C /* .... */.

Estos comentarios, como todo el código CSS situado en las hojas de estilo, se incluyen sin modificaciones en el resultado, por lo que pueden verse en el navegador.

html {
    background-color: #FF0000; /* #FF0000 es rojo */
}

html {
    background-color: #FF0000; /* #FF0000 es rojo */
}

Código HTML de páginas HTML válidas

Si queremos crear páginas HTML válidas debemos generar código HTML válido, es decir, generar todas las etiquetas HTML necesarias respetando las reglas sintácticas. En este curso se generarán páginas HTML y se utilizará el juego de caracteres UTF-8.

El ejemplo siguiente muestra el código html de una página web HTML válida con las líneas numeradas.

<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <title>Página HTML válida</title>
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <link rel="stylesheet" href="estilo.css" title="Color">
</head>

<body>
  <p>Esta página es una página HTML válida.</p>
</body>
</html>

La etiqueta <!DOCTYPE ... > (línea 1) es obligatoria. Esta etiqueta indica el tipo de documento (DOCTYPE) de la página. El tipo html sin información adicional corresponde a HTML. En versiones anteriores a HTML 5 esta etiqueta contenía la dirección web de la DTD (definición de tipo de documento) que especifica la versión del lenguaje de marcas utilizado en el documento (cuál es la estructura, qué etiquetas existen y qué atributos pueden tener).
La etiqueta <html> ... </html> (líneas 2 a 13) engloba todo el documento html. El atributo lang no es obligatorio e indica el idioma en que está escrito el documento.
El documento html se divide a su vez en dos partes, el encabezado (<head> ... </head>, líneas 3 a 8) y el cuerpo (<body> ... </body>, líneas 10 a 12).
- El encabezado <head> ... </head> (líneas 3 a 8) contiene información de identificación y control que en general no se muestra en la ventana del navegador, aunque puede afectar a la presentación (por ejemplo, los enlaces a hojas de estilo).
  - Las etiquetas <meta> están pensadas para proporcionar información sobre el documento a los programas que analicen la página y por ello existen muchas etiquetas <meta> diferentes. Por ejemplo, la etiqueta <meta name="keywords" content="..."> está pensada para informar a los buscadores de los temas tratados en la página pero, por desgracia, se ha abusado mucho de esta etiqueta así que los buscadores no la toman prácticamente en cuenta).
    - La línea 4 del ejemplo informa del juego de caracteres empleado en la página, en este caso UTF-8, que es el juego de caracteres recomendado para HTML.
    - La línea 6 del ejemplo se utiliza para mejorar la presentación de las páginas webs en las pantallas de los teléfonos móviles y, en general, en las pantallas de alta densidad.
  - La etiqueta de título <title> ... </title> (línea 5) contiene el texto que se muestra en la barra de título de la ventana del navegador.
    La etiqueta title es obligatoria y debe incluirse en todas las páginas web.
  - La línea 7 contiene el enlace a una hoja de estilo. Esta etiqueta no es obligatoria.
- El cuerpo (<body> .... </body>, líneas 10 a 12) contiene lo que se verá en la ventana del navegador. En el ejemplo, contiene un único párrafo
  - La etiqueta de párrafo <p> ... </p> contiene el texto que se muestra en la ventana del navegador

Primeras páginas en PHP