Instalación y configuración de PHP para empezar a programar

Hola, ¿cómo están? Continuando con el curso de PHP, hoy vamos a preparar todo lo que necesitas para empezar a programar: el servidor local, el editor de código y las herramientas de apoyo.

¡Empecemos!

Qué necesitas instalar

Para programar en PHP hacen falta tres cosas:

1. PHP, el intérprete que ejecuta tu código.
2. Un servidor web, que atiende las peticiones del navegador.
3. Un editor de código, donde vas a escribir.

La buena noticia es que las dos primeras vienen juntas en un solo instalador.

Elegir tu entorno local

Tienes dos opciones muy usadas, y ambas te dejan PHP, servidor web y base de datos funcionando en minutos.

XAMPP es la opción clásica. Funciona en Windows, Linux y macOS, y tiene la comunidad más grande, así que encontrarás respuesta a cualquier problema. Si estás siguiendo un curso o tutorial antiguo, casi seguro usa XAMPP.

Laragon es la alternativa moderna para Windows. Su ventaja: puedes tener varias versiones de PHP instaladas y alternar entre ellas con un clic, y cada carpeta de proyecto recibe automáticamente su propia dirección local.

Para este curso cualquiera de las dos sirve. Los ejemplos funcionan igual en ambas.

Comprobar que PHP quedó instalado

Una vez instalado tu entorno, abre una terminal y escribe:

php --version

Deberías ver algo parecido a esto:

PHP 8.4.1 (cli) (built: ...)
Copyright (c) The PHP Group

Si en cambio te dice que el comando no existe, PHP está instalado pero no accesible desde la terminal. En Laragon usa la Terminal que trae el propio panel, que ya viene configurada. En XAMPP tendrás que añadir la carpeta php a la variable PATH de Windows.

Instalar Visual Studio Code

Visual Studio Code es gratuito, funciona en los tres sistemas operativos y es el editor más usado hoy para PHP. Descárgalo del sitio oficial e instálalo con las opciones por defecto.

Extensiones recomendadas

Con el editor abierto, ve al panel de extensiones (Ctrl + Shift + X) e instala estas:

• PHP Intelephense. Autocompletado, detección de errores y navegación por el código. Es la que más diferencia hace.
• PHP Debug. Para depurar paso a paso más adelante en el curso.
• Prettier o PHP CS Fixer. Formatean el código automáticamente al guardar, para que no pierdas tiempo alineando llaves.

Con Intelephense instalada, conviene desactivar el soporte de PHP que trae VS Code de fábrica para que no se dupliquen las sugerencias.

Dónde van tus archivos

Este es el punto donde más se traba quien empieza, así que conviene tenerlo claro.

Tu proyecto tiene que estar dentro de la carpeta que sirve el servidor web:

• En XAMPP: C:\xampp\htdocs\
• En Laragon: C:\laragon\www\

Si dejas los archivos en el escritorio o en Documentos, el servidor no los va a encontrar y el navegador te dará un error 404.

Crea ahí una carpeta llamada curso_php y ábrela desde Visual Studio Code con Archivo → Abrir carpeta.

Tu primera comprobación

Dentro de esa carpeta crea un archivo llamado info.php con este contenido:

<?php
phpinfo();

Guárdalo y abre el navegador en:

localhost/curso_php/info.php

Deberías ver una página larga con toda la configuración de PHP: la versión instalada, las extensiones activas y las rutas del sistema. Si la ves, tu entorno está listo.

Esa página también es tu herramienta de diagnóstico. Cada vez que algo no funcione —una extensión que falta, un límite de memoria bajo—, la respuesta suele estar ahí.

Importante. Borra el archivo info.php cuando termines de comprobar, y nunca lo subas a un servidor público: revela información detallada de tu sistema que no conviene mostrar.

Si algo falla

El servidor no arranca. Casi siempre es el puerto 80 ocupado por otro programa, típicamente IIS o Skype. Ciérralo o cambia el puerto desde el panel de tu entorno.

Sale un 404. Revisa que el archivo esté dentro de htdocs o www, y que la ruta del navegador coincida con el nombre de la carpeta.

El navegador descarga el archivo en vez de ejecutarlo. El servidor no está interpretando PHP. Comprueba que iniciaste Apache y que el archivo termina en .php.

Para cerrar

Ya tienes PHP funcionando, un editor configurado y una carpeta de trabajo. Es la parte menos entretenida del curso, pero es la que evita que te trabes después.

En la siguiente lección escribimos nuestro primer programa y vemos la sintaxis básica del lenguaje.

Saludos y éxitos.