0.3Sintaxis básica: etiquetas, echo, comentarios
Lo esencial en 30 segundos
- Etiquetas para insertar PHP en HTML: fuera de las etiquetas = HTML enviado tal cual, dentro = PHP ejecutado.
- echo muestra, punto y coma termina: cada instrucción acaba con ; — olvidarlo es el error n.º 1 del principiante.
- Documente y muestre corto: comentarios // y /* */, sintaxis corta en las plantillas.
Minicaso hilado — Riad escribe su primera página
Riad, desarrollador web en Constantine, tiene su entorno listo: crea bonjour.php en la carpeta raíz. Escribe HTML con una «isla» de PHP entre etiquetas para mostrar el nombre del visitante con echo, termina cada instrucción con punto y coma, añade un comentario para orientarse y prueba la sintaxis corta en su título. Abre la página vía localhost: el navegador muestra el resultado, nunca el código. Su cadena «editar, lanzar vía localhost, leer» funciona.
Caso autónomo de esta sección: reaparece en el curso, el esquema, el script y el reto 48h de la sección 0.3.
1. Etiquetas y echo
El código PHP se coloca entre <?php (apertura) y ?> (cierre). Todo lo que está FUERA de estas etiquetas es HTML (enviado tal cual al navegador); todo lo que está DENTRO es código PHP (ejecutado por el servidor). Esto hace de PHP un lenguaje de plantillas natural: <h1>Bonjour <?php echo 'le monde'; ?></h1> produce un título cuya parte es generada. echo es la construcción para MOSTRAR (producir texto/HTML) — su herramienta fundamental de salida (también existe print, similar). Cada instrucción termina con un punto y coma ; — olvidarlo es el error de principiante n.º 1. Para un archivo de PHP puro, a menudo se omite la etiqueta de cierre final (evita espacios parásitos). Riad escribe su primer echo y ve enseguida el resultado vía localhost.
2. Comentarios, sintaxis corta, mayúsculas
Los comentarios son texto ignorado por PHP, para explicar el código: // o # para una línea, /* ... */ para varias líneas — esenciales para la legibilidad (por usted más tarde, y por otros). La sintaxis corta <?= $variable ?>, equivalente a <?php echo $variable; ?>, es práctica en las plantillas HTML. Por último las mayúsculas: las palabras clave y funciones no son sensibles a mayúsculas (echo o ECHO funcionan), pero las variables sí lo son ($nom y $Nom son distintas) — de ahí la importancia de ser coherente. Riad comenta cada bloque de su página en Constantine y adopta unas únicas mayúsculas para sus variables.
3. Estructurar: separar lógica y presentación
Un archivo .php puede ser mayoritariamente HTML con «islas» de PHP (modo plantilla, natural para las vistas) o mayoritariamente PHP (archivos de lógica). El principio clave: separar la LÓGICA y la PRESENTACIÓN — tratar los datos primero, mostrar después con simples inserciones — si no se obtiene un «código espagueti» ilegible (el patrón MVC de la sección 4-1 lo formalizará). En las vistas, se limita el PHP al mínimo (mostrar, iterar, condicionar) y se escapan los datos mostrados (sección 3-4). Riad coloca sus cálculos arriba de bonjour.php y su HTML debajo: su página sigue legible.
🔎 Ejemplo concreto — 🔎 Ejemplo concreto — Primer script
Mezclar PHP y HTML.
Bonjour
Nous sommes le
Lectura: Riad abre la página vía localhost: el título muestra el nombre, la fecha del día es generada por PHP.
Lección: una página donde PHP genera las partes dinámicas — con el reflejo de escapar los datos mostrados (ver 3.4).
Vocabulario de la sección
- Etiquetas PHP
- El código PHP se coloca entre ``; fuera de las etiquetas = HTML (enviado tal cual), dentro = código PHP (ejecutado). Permite mezclar PHP y HTML.
Ejemplo sencillo: Riad inserta un nombre dinámico en medio de su título HTML.
Lo que no es: decoraciones opcionales alrededor del código.
Reflejo: entrar y salir del modo PHP tantas veces como sea necesario en una plantilla.
- echo
- Construcción para MOSTRAR (producir salida): `echo 'Bonjour';` genera texto/HTML en la página. La herramienta fundamental de salida (también `print`).
Ejemplo sencillo: Riad muestra «Hello, PHP!» y verifica el resultado en el navegador.
Lo que no es: una función que lee una entrada de usuario.
Reflejo: mostrar primero para verificar, suponer después.
- Punto y coma
- Termina cada instrucción PHP (`;`); olvidarlo provoca un error de sintaxis — el error de principiante más frecuente.
Ejemplo sencillo: Riad olvida un punto y coma: el error se señala en la línea siguiente, corrige la anterior.
Lo que no es: una simple elección de estilo sin consecuencia.
Reflejo: ante un error de sintaxis, verificar el punto y coma de la línea anterior.
- Comentarios
- Texto ignorado por PHP para explicar el código: `//` o `#` (una línea), `/* ... */` (varias líneas); esenciales para la legibilidad.
Ejemplo sencillo: Riad comenta la parte alta de bonjour.php para explicar lo que genera la página.
Lo que no es: texto mostrado al visitante.
Reflejo: comentar el «por qué», no cada línea evidente.
- Sintaxis corta
- Equivalente a ``: `` muestra una variable, práctica en las plantillas HTML. Las variables son sensibles a mayúsculas (no las palabras clave).
Ejemplo sencillo: Riad escribe en su título en lugar de un bloque echo completo.
Lo que no es: una sintaxis reservada a los archivos de lógica pura.
Reflejo: en las vistas, preferir para las presentaciones simples.
En la práctica — En la práctica — Escribir su primer código PHP
- Cree un archivo .php en la carpeta raíz e inserte PHP en HTML con las etiquetas ``.
- Muestre texto con `echo 'Hello, PHP!';` (¡no olvide el punto y coma!) y abra la página vía localhost.
- Mezcle HTML y PHP: `
Bonjour
`; pruebe también la sintaxis corta ``. - Añada comentarios (`//`, `/* ... */`) para documentar su código y verifique que el resultado se muestra correctamente.
Script listo para decir — contar su primera página (30 s)
«He creado bonjour.php en la carpeta raíz: HTML con una isla de PHP entre etiquetas que muestra el nombre con echo. Cada instrucción acaba con punto y coma, he comentado mi código y vía localhost veo el resultado — nunca el código.»
Para decir mostrando lado a lado el archivo .php y la página mostrada en el navegador.
Modelo copiar-pegar — mi primera página PHP
Bonjour
Sin variable
Empiece con un echo fijo («Hello, PHP!») abierto vía localhost, luego introduzca una variable $prenom y la sintaxis corta — un paso cada vez.
Cazador de punto y coma
Quite voluntariamente un punto y coma, lea el mensaje de error, anote que apunta a la línea siguiente y luego corrija — el error n.º 1 ya no le sorprenderá.
Binomio en Constantine
Riad dicta, su colega teclea: uno lee el archivo .php en voz alta (etiquetas, echo, comentarios), el otro describe lo que muestra el navegador.
Hacia lo limpio
Página que funciona: traslade toda la lógica arriba del archivo, conserve solo presentaciones simples en el HTML y escape cada dato mostrado.
✓ Buenas prácticas
- Termine cada instrucción con punto y coma (trampa n.º 1).
- Separe la lógica (arriba) y la presentación (el HTML después).
- Use en las plantillas; escape los datos mostrados (3.4).
✗ Errores frecuentes
- Olvidar el punto y coma o el $ delante de una variable.
- Mezclar anárquicamente lógica compleja y HTML (código espagueti).
- Equivocarse de mayúsculas en una variable ($nom ≠ $Nom) — bug silencioso.
Puntos clave
- PHP se inserta en HTML vía ETIQUETAS ``: fuera de las etiquetas = HTML (enviado tal cual), dentro = PHP (ejecutado). PHP es un lenguaje de plantillas natural.
- `echo` MUESTRA (produce texto/HTML): la herramienta de salida fundamental. Cada instrucción termina con PUNTO Y COMA `;` (olvidarlo = error, la trampa n.º 1 del principiante).
- COMENTARIOS (`//`, `#`, `/* */`) para documentar. Sintaxis corta `` (= echo) práctica en las plantillas.
- Las PALABRAS CLAVE/funciones NO son sensibles a mayúsculas, pero las VARIABLES sí lo son (`$nom` ≠ `$Nom`) — ser coherente. Un archivo .php mezcla HTML e «islas» de PHP.
Reto 48h — aplique mañana
Cree bonjour.php con el modelo de Riad, ábralo vía localhost, cambie el nombre y añada un comentario que explique la página.
- Mi página bonjour.php se muestra vía localhost con el nombre generado.
- Uso etiquetas, echo, punto y coma y sintaxis corta sin ayuda.
- Mi código está comentado y la lógica está separada de la presentación.
Preguntas frecuentes
¿Cómo se mezcla PHP con HTML y cómo estructurar bien un archivo PHP?
Todo lo que está FUERA de las etiquetas `` es HTML (enviado tal cual), todo lo que está DENTRO es PHP (ejecutado, su resultado insertado); se puede entrar y salir del modo PHP tantas veces como se quiera. Dos estructuras: mayoritariamente HTML con islas de PHP (modo «plantilla», natural para las VISTAS — ej. ``), o mayoritariamente PHP (archivos de LÓGICA: tratamiento, funciones, clases). Buenas prácticas: (1) SEPARAR la lógica y la presentación — el principio clave: lógica primero, presentación después, idealmente en archivos distintos (el MVC, sección 4-1); (2) en las VISTAS, limitar el PHP al mínimo (mostrar, iterar, condicionar); (3) usar para mostrar; (4) omitir la etiqueta de cierre final en los archivos de PHP puro; (5) ESCAPAR los datos mostrados (seguridad XSS, 3.4).
¿Cuáles son los errores de sintaxis más frecuentes entre los principiantes?
(1) El PUNTO Y COMA olvidado (n.º 1) — el error suele señalarse en la línea SIGUIENTE, así que verifique la línea anterior. (2) El $ olvidado delante de una variable. (3) Las LLAVES/PARÉNTESIS sin emparejar (a menudo «unexpected end of file») — indentar y un buen editor ayudan. (4) Las COMILLAS sin cerrar — cuidado con los apóstrofos en una cadena. (5) Las MAYÚSCULAS de las variables (`$nom` ≠ `$Nom`) — bug silencioso. (6) Confundir = (asignación) y == (comparación). (7) Las ETIQUETAS PHP mal escritas. Para prevenirse: active la VISUALIZACIÓN DE ERRORES en desarrollo, use VS Code con extensiones PHP, indente y pruebe por pequeños incrementos.
¿Cuál es el error de sintaxis n.º 1 del principiante en PHP?