Nombre para las variables en PHP

Eligiendo una convención para darle nombre

Un muy pero importantísimo detalle que nos facilitará la lectura de un código PHP, es seguir alguna regla relativa a los nombres que elegiremos a todos los lugares de almacenamiento de datos que utilicemos; entre ellos, las variables.

El objetivo es intentar que el nombre de una variable simbolice lo mejor que sea posible el contenido que vaya a almacenar.

Pensemos que un código se escribe de la misma manera que cualquier texto, para que el lector lo comprenda; por esta razón, todo lo que contribuya a facilitar la lectura y mejore su rápida comprensión, nos ahorrará mucho tiempo.

Lamentablemente, suele ser muy común que encontremos código con nombres de variables escritos con abreviaturas extrañas como, por ejemplo, $var_67_x_1. Dentro de un mes cuando debamos leer ese mismo código, nos habremos olvidado los datos que contenían cada una de las variables.

Veamos un ejemplo de código con nombres muy difíciles:

<?php
$dato_123 = “Pepe”;
$dato_46  = “Hola, señor $dato_123”;
print ($dato_46);
?>

Imaginemos esto proyectado a cientos o miles de líneas de código ¡imposible de entender a simple vista!

Además de los nombres descriptivos, otra recomendación es que no conviene mezclar nombres de variables en mayúsculas y en minúsculas. Lo mejor es seguir algún criterio, alguna convención, ya que es ésta una de las causas más frecuentes de errores que nos hacen perder tiempo al tratar de descubrir la causa.

La razón es que PHP es un lenguaje case-sensitive, o “sensible” a mayúsculas y a minúsculas; es decir, no es lo mismo $a que $A. Para PHP son dos variables distintas. No es la misma variable una que se llame $nombre que otra llamada $Nombre o que $nomBRE. Y si habíamos definido $nombre y después hacemos un echo de $nombre… ¡no funcionará! Y con justa razón, ya que no existe la variable que intentamos leer, existe otra con una letra de diferencia, y eso la vuelve totalmente distinta.

Por eso es sumamente recomendable que sigamos alguna regla para nombrar nuestras variables, y que la mantengamos a lo largo de todos nuestros proyectos.

Por ejemplo, algunas convenciones comunes relativas a los nombres de las variables, son las siguientes:

1. Todo en minúsculas:

$variable
$mivariablelarga

2. Todo en minúsculas, pero guiones entre palabras, si el nombre de una variable tiene varios términos:

$variable
$mi_variable_larga

3. En minúsculas la primera palabra –o si la variable es de una sola palabra-, pero colocando una mayúscula al comienzo de cada nueva palabra intermedia, en el caso de que el nombre de la variable tuviera más de un término. Esta notación se llama camel case –porque las subidas y bajadas de las mayúsculas intercaladas entre medio ¡parecen las jorobas de un camello!- Un nombre muy imaginativo. Esta es la sintaxis más extendida , y es la más recomendable:

$mivariable
$miVariableLarga

4. Cada palabra comienza siempre con mayúscula, aunque la variable sea de una sola palabra:

$Variable
$MiVariableLarga

No se recomienda poner a las variables nombres en mayúsculas; por ejemplo, $NOMBRE, ya que da lugar a confusión con otro tipo de depósito de datos llamado constante, cuyos nombres en PHP se escriben con todas sus letras en mayúsculas (aunque sin el signo $ delante, pero igual da lugar a confusiones, la lectura se vuelve poco clara)

Más allá de cuál de todas estas convenciones elijamos, es recomendable elegir una sola de estas notaciones  -cualquiera de las anteriores- y seguir siempre la misma, eso nos evitará muchos errores.

Cuando tengamos códigos de cientos de líneas será muy importante que podamos leer ese código con la velocidad con que leemos un texto cualquiera y que sea posible entender ese código entender ese código con una sola lectura superficial, por eso es preferible que nos acostumbremos desde un principio a utilizar nombres que sigan alguna regla de sintaxis que nos resulte cómoda.

Mencionemos, por último, que en el lenguaje PHP no podemos comenzar el nombre de una variable con un número: las variables deben comenzar por una letra o por un guión bajo, aunque luego pueden incluir números en su nombre, letras  de la “a” a la “z” y guiones bajos.

No utilizaremos eñes, ni acentos, ni espacios en blanco, ni guiones medio, ni caracteres especiales como asteriscos o cualquier otro signo en los nombres de nuestras variables.

Veamos algunos ejemplos de nombres de variables, correctos e incorrectos:

<?php
$lugar1 = “Buenos aires”; /*Correcto, puede comenzar por una letra*/

$_lugar _2 = “México”; /*Correcto, puede comenzar por un guión bajo*/

$3_lugar = “España”; /*Incorrecto, no puede comenzar por un número*/
?>