PHP es un lenguaje de programación ampliamente usado, especialmente diseñado para el desarrollo web. Aunque puede parecer complicado al principio, entender su sintaxis es crucial para escribir instrucciones claras que las computadoras puedan interpretar correctamente. La sintaxis se refiere a la manera correcta de escribir código para que sea entendido por el sistema. En el caso de PHP, esto implica seguir ciertas reglas y convenciones.
¿Cómo comenzamos a estructurar un archivo PHP?
Al iniciar un archivo PHP, es esencial seguir ciertos pasos:
Uso del sufijo .php: Cualquier archivo de PHP debe tener una extensión .php para que el servidor web lo reconozca como tal.
Etiqueta de apertura: Siempre se comienza con una etiqueta de apertura <?php. En archivos exclusivamente de PHP, la etiqueta de cierre ?> se puede omitir.
Ejemplo de estructura básica de un archivo PHP:
<?php// Esto es un comentario de línea únicaecho"¡Hola, PHP!";
¿Cómo se escriben los comentarios en PHP?
Los comentarios en el código son indispensables para la claridad y el mantenimiento a largo plazo. PHP ofrece varias formas de incluir comentarios:
Comentarios de una sola línea: Se usan // o # al inicio de la línea para comentar.
Comentarios de varias líneas: Se inician con /* y terminan con */.
Ejemplos de comentarios:
<?php// Comentario de una sola línea# Otro estilo de comentario de una sola línea/*
Comentario de
varias líneas
*/
¿Por qué es importante seguir estándares de comentarios?
Seguir estándares no solo asegura que otros desarrolladores entiendan nuestro código, sino que también mejora la legibilidad y facilita el mantenimiento. La documentación clara y precisa es esencial, especialmente cuando trabajamos en proyectos colaborativos.
Cuando se trata de comentarios extendidos o documentaciones más detalladas, se recomienda usar un formato particular:
/**
* Documentación clara de varias líneas
* Apoyando una estructura jerárquica y descriptiva.
*/functionejemplo(){// Código de la función}
Entender las instrucciones básicas y la estructura en PHP
Cada instrucción en PHP termina con un punto y coma (;). Este pequeño detalle es esencial para que PHP reconozca el fin de una instrucción y evite errores.
Buenas prácticas al estructurar el código:
Organizar el código en líneas separadas: Esto favorece la claridad y el orden.
Usar comentarios efectivos: Explicar qué hace cada bloque o función, no solo lo que significa.
Escribir código autodescriptivo: Utilizar nombres de variables y funciones que sean descriptivos.
Adoptar estas prácticas desde el principio te será de gran valor a medida que avances en tu aprendizaje de PHP y te adentres en técnicas más complejas en el futuro. ¡Sigue adelante y sigue explorando el mundo del desarrollo web con PHP!
Es importante aprender y tener siempre en cuenta las especificaciones PSR para PHP. Por ejemplo PSR-12 que trata sobre el estilo cómo se debe escribir el código PHP
En otros lenguajes como JavaScript, el punto y coma es opcional, en el caso de PHP es obligatorio, así qu nunca hay que olvidarlo.
Con respecto a los comentarios, si usas Visual Studio Code, el editor ya es tan inteligente que detecta que estás poniendo un comentario de múltiples lineas que el solito te da el formato.
Y una ventaja de este forma de comentarios, es que editores inteligentes o incluso extensiones de Visual Studio Code, son capaces de leerlos de tal forma que cuando estás trabajando en algún otro lugar de tu código y necesitas llamar una función X que está en otro archivo PHP, si esa función tiene un comentario con este formato, Visual Studio Code podrá leerlo y podrá ponerte un tooltip con ese comentario, ahorrandote la molestia de abrir el archivo y mirarlo.
Me gustaría recomendarle estás 2 extensiones para los que usan Visual Studio Code:
Está muy trillado el comentario de que PHP está muerto o ya no se usa, pero, es lo que da de comer papá, y si en eso hay trabajo, hay que aprender y ser el mejor!
Podemos omitir automaticamente la etiqueta cierre cuando el documento es puro php
<?php
PHP nos píde que finalicemos nuestras líneas de código con ';' para saber que una sentencia termino.
<?phpclassAnswer{/**
* Esto es un comentario ideal de varias líneas
* que nos da herarquía. Los Frameworks nos pide que los
* comentarios los hagamos así.
*/protected$clients=[];// Comentarioprotected$insurers=[];/*Comentario de
Varias líneas
*/protected$bills=[];# Otro comentario}
Tenemos que escribir código correcto para que nuestra computadora lo pueda entender, aquí dejamos un ejemplo de la sintaxis básica:
Comparto el código de la clase:
<?php/**
* Comentario de varias
* líneas para
* palabra
*/classAnswer{/**
* Comentario de varias
* líneas para
* palabra
*/protected$clients=[];// Un comentario/**
* Comentario de varias
* líneas para
* palabra
*/protected$insurers=[];# Otro comentario}
Para iniciar un bloque de código en PHP debes usar tags
<?php
classMain{ echo "hola mundo";//Primera forma de crear un comentario #Segunda manera de comentar
/*
* Aquí puedes comentar también
* también acá,
* documentar es mi pasión.
*/}?>
*Nuestro documento comience con la etiqueta de apertura
*Que tenga extensión .php
*Nuestras líneas cierren con punto y coma;
*Organizar bien nuestro código
*Tener bien comentado nuestro código.
<?php
/**
* Comentario de varias
* linea para
* palabra
*/classAnswer{/**
* Comentario de varias
* linea para
* palabra
*/protected $clients =[];// Mi comentario/**
* Comentario de varias
* linea para
* palabra
*/protected $insurers =[]; #Mi comentario
}```