Curso de PHP.2 – Sintaxis básica

Cuando PHP analiza un fichero (por regla general los ficheros php deben tener la extensión .php) busca las etiquetas de aperturas que indican al interprete dónde empezar y finalizar la interpretación del código. Este mecanismo permite incrustar código de PHP en todo tipo de documentos, ya que todo lo que esté fuera de las etiquetas de apertura y cierre será ignorado por el analizador sintáctico de PHP, excepto si los bloques html se encuentran entre condicionales o sentencias de bloques: foreach, for, while, switch. Veamos el siguiente ejemplo:

<p>Hola mundo está sentencia es ignorada por PHP y mostrada por el navegador</p>
<p><?php echo 'Mientras que esto va a ser interpretada por PHP'; ?></p>
<p>Esto también será ignorado por PHP y mostrado por el navegador.</p>
<?php if ($expression == true): ?>
    <p>Esto se mostrará si $expression se cumple</p>
<?php else: ?>
    <p>Esto se mostrará si $expression no se cumple</p>
<?php endif ?>
<?php foreach (range(1, 5) as $i): ?>
    <p>Esta es la iteración <?php echo $i ?></p>
<?php endforeach ?>

Es un estándar entre los desarrolladores PHP no utilizar la etiqueta de cierre en aquellos ficheros que solo contengan código PHP, por ejemplo clases o scripts cli.

<?php
 class Persona
 {
      private $name;
      private $age;
      public function __construct($name, $age)
      {
           $this->name = $name;
           $this->age = $age; 
      }
 }

Como en C o en Perl, PHP requiere que las instrucciones terminen en punto y coma al final de cada sentencia excepto en la última línea la cual no requiere el ; tampoco se requiere en bloques de código en el ejemplo anterior nótese q no hay ; después de las }.

PHP soporta comentarios de una sola línea // y comentarios multilíneas /* */ también soporta comentarios tipo shell # aunque no se recomienda su uso.

 <?php
echo 'Esto es una prueba'; // Esto es un comentario al estilo de c++ de una sola línea
 /* Esto es un comentario multilínea
        y otra lína de comentarios */
echo 'Esto es otra prueba';
echo 'Una prueba final'; # Esto es un comentario al estilo de consola de una sola línea

PHP además soporta PHPDoc. PHPDoc es una adaptación de Javadoc que permite a los generadores de documentos externos como phpDocumentor, generar la documentación de su proyecto y ayuda a algunos IDE a interpretar los tipos de variables, a resolver ambigüedades del lenguaje, debido a su característica de debilmente tipeado, a mejorar el autocompletamiento de código y a realizar sugerencias de tipo y depuración en línea facilitando una mejor experiencia de desarrollo.

<?php

/**
 * Class Persona. Esta clase representa la información de un
 * trabajador en el departamento de Recursos Humanos.
 * @package RecursosHumanos
 * @version 1.0
 * @author LibreByte <librebyte@micorreo.com>
 */
class Persona
{
    /** @var string */
    private $name;
    /** @var int */
    private $age;

   /**
    * Persona constructor.
    * @param string $name
    * @param int $age
    */
    public function __construct($name, $age)
    {
        $this->name = $name;
        $this->age = $age;
    }
}