Cómo instalar PHP

PHP (Hypertext Preprocessor) es un lenguaje de scripting del lado del servidor ampliamente utilizado para desarrollar aplicaciones web dinámicas. Antes de poder ejecutar cualquier código PHP, necesitas tener instalado un intérprete de PHP en tu máquina. Esta guía te explica cómo instalar PHP en Windows, macOS y Linux, cómo elegir la configuración adecuada para tu objetivo y cómo verificar que todo funciona correctamente.

Si eres completamente nuevo en el lenguaje, lee primero la Introducción a PHP para entender qué es PHP y dónde se ejecuta.

¿Qué tipo de instalación debo elegir?

No existe una única forma "correcta" de instalar PHP — la mejor opción depende de lo que quieras hacer:

• ¿Solo aprender el lenguaje? Instala el intérprete PHP CLI (línea de comandos). PHP incluye un servidor de desarrollo integrado, por lo que no necesitas Apache ni Nginx para empezar.
• ¿Construir un stack web completo? Usa un paquete todo-en-uno como XAMPP, MAMP o Laragon. Estos instalan PHP, Apache (o Nginx) y MySQL juntos con un solo clic.
• ¿Trabajar en un proyecto real? Instala PHP a través del gestor de paquetes de tu sistema (apt, brew, choco). Es el enfoque más limpio y actualizable para desarrolladores.

La siguiente tabla resume las ventajas e inconvenientes de cada opción:

Requisitos previos

Antes de comenzar, asegúrate de tener:

• Un equipo con Windows, macOS o Linux.
• Un editor de texto como Visual Studio Code, Sublime Text o Notepad++.
• Acceso a una terminal (Símbolo del sistema o PowerShell en Windows, Terminal en macOS/Linux).
• Un servidor web (Apache o Nginx) solo si no vas a usar el servidor de desarrollo integrado.

Instalación de PHP según el sistema operativo

Windows

La forma más sencilla en Windows es usar el gestor de paquetes Chocolatey. En un PowerShell elevado:

choco install php

¿Prefieres una instalación manual? Descarga el último Zip non-thread-safe desde la página oficial de descargas de PHP, extráelo en C:\php y añade C:\php a la variable de entorno Path para que el comando php esté disponible en todas partes.

macOS

Homebrew es la herramienta estándar:

brew install php

Homebrew enlaza el binario php en tu PATH automáticamente.

Linux (Debian/Ubuntu)

Usa apt:

sudo apt update
sudo apt install php php-cli

En Fedora/RHEL el equivalente es sudo dnf install php php-cli.

Verificar la instalación

Independientemente del método que hayas usado, confirma que PHP está en tu PATH comprobando la versión desde una terminal:

php -v

Deberías ver una salida similar a esta (el número de versión puede variar):

PHP 8.3.6 (cli) (built: ...) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.3.6, ...

Si en cambio obtienes un error "command not found", la carpeta de PHP no se añadió a tu PATH — revisa el paso de instalación correspondiente a tu sistema operativo.

Ejecutar PHP sin un servidor web

PHP incluye un servidor de desarrollo integrado, que es la forma más rápida de ejecutar páginas mientras aprendes. Crea un archivo llamado index.php:

<?php
echo "Hello from PHP " . PHP_VERSION;

Luego inicia el servidor desde esa carpeta y abre la URL que muestra:

php -S localhost:8000

Visita http://localhost:8000 en tu navegador. El servidor integrado es solo para desarrollo — nunca lo expongas a internet público.

Configurar PHP con Apache

1. Abre el archivo de configuración de Apache ubicado en la carpeta de instalación de Apache (normalmente conf/httpd.conf en Windows o /etc/apache2/apache2.conf en Linux/macOS).
2. Busca la directiva de carga del módulo PHP. En instalaciones manuales de Windows, suele tener este aspecto:

#LoadModule php_module "modules/php8apache2_4.dll"

3. Elimina el símbolo # para descomentar la línea, asegúrate de que la ruta coincide con el directorio de instalación de PHP, y luego guarda y cierra el archivo. (Nota: En Linux/macOS, PHP normalmente se activa a través de gestores de paquetes usando comandos como sudo a2enmod php8.2.)
4. Reinicia Apache para aplicar los cambios.

Probar la instalación de PHP

1. Crea un nuevo archivo con extensión .php (por ejemplo, index.php) en la carpeta raíz de tu servidor web (normalmente htdocs o /var/www/html en Linux/macOS).
2. Introduce el siguiente código en el archivo:

3. Guarda y cierra el archivo.
4. Abre un navegador web y ve a http://localhost/index.php.
5. Si todo está configurado correctamente, verás una página con información sobre tu instalación de PHP. También puedes verificar la instalación desde la línea de comandos ejecutando php -v.

Problemas comunes de instalación

• php no se reconoce / command not found. La carpeta de PHP no está en tu PATH. Vuelve a abrir la terminal después de editar el PATH, ya que los cambios solo se aplican a las nuevas sesiones del shell.
• phpinfo() se muestra como texto plano. El navegador descargó el archivo o el servidor web no está procesando PHP. Asegúrate de abrirlo a través de http://localhost (servido por un servidor web) y no haciendo doble clic en el archivo.
• Versión incorrecta de PHP. Si hay varias versiones instaladas, php -v muestra la que aparece primero en tu PATH. Ajusta el orden o usa la ruta completa (por ejemplo, /usr/local/opt/[email protected]/bin/php).

Próximos pasos

Ahora que PHP funciona en tu máquina, continúa con:

• Sintaxis de PHP — cómo se estructura un script PHP.
• Variables en PHP — almacenar y reutilizar datos.
• PHP Echo y Print — mostrar contenido en la página.

Conclusión

Ya tienes PHP instalado y verificado, además de la capacidad de ejecutar scripts tanto a través de Apache como del servidor de desarrollo integrado de PHP. Elige el flujo de trabajo que se adapte a tu objetivo — el servidor CLI para aprender rápido, o un stack completo de Apache/Nginx para aplicaciones reales — y estarás listo para empezar a escribir PHP.

Práctica