Instalación y primer programa de PHP

Básico
PHP
PHP
Actualizado: 18/04/2026

Instalar PHP en su última versión

Para comenzar a desarrollar en PHP es esencial instalar la última versión del intérprete en el sistema operativo que se esté utilizando. A continuación, se detallan los pasos para realizar una instalación correcta en Windows, macOS y Linux.

Instalación en Windows:

Descargar PHP:

  • Acceder al sitio oficial de descargas de PHP: www.php.net/downloads.
  • Seleccionar la versión estable más reciente, por ejemplo, PHP 8.3.
  • Descargar el paquete Thread Safe Zip para Windows.

Extraer y configurar:

  • Descomprimir el archivo descargado en una carpeta, por ejemplo, C:\php.
  • Copiar el archivo php.ini-development y renombrarlo a php.ini.
  • Abrir php.ini con un editor de texto y configurar las directivas necesarias según las necesidades del desarrollo.

Agregar PHP al PATH:

  • Acceder a las Variables de entorno del sistema:
  • Ir a Configuración del sistema > Configuración avanzada del sistema > Variables de entorno.
  • En las Variables del sistema, seleccionar Path y hacer clic en Editar.
  • Añadir la ruta C:\php y guardar los cambios.

Verificar la instalación:

  • Abrir la línea de comandos y ejecutar: php -v
  • Debería mostrarse la versión de PHP instalada, confirmando que la instalación ha sido exitosa.

Instalación en macOS:

Instalar Homebrew (si no está instalado):

  • Ejecutar en la terminal:

Instalar PHP usando Homebrew:

  • Actualizar Homebrew:
  • Instalar PHP:
  • Esto instalará la versión más reciente disponible de PHP.

Configurar el PATH (si es necesario):

  • Añadir PHP al PATH editando el archivo ~/.bash_profile o ~/.zshrc y agregando:

Verificar la instalación:

  • Reiniciar la terminal y ejecutar:
  • Debería aparecer la versión instalada de PHP.

Instalación en Linux (Ubuntu/Debian):

Actualizar los repositorios:

  • Ejecutar en la terminal:

Instalar PHP:

  • Instalar la última versión de PHP disponible:
  • Si se requiere una versión específica, como PHP 8.3:

Instalar extensiones comunes (opcional):

  • Para añadir funcionalidades adicionales:

Verificar la instalación:

  • Ejecutar:
  • Confirmar que la versión instalada es la esperada.

Consideraciones generales:

  • Siempre es recomendable instalar PHP desde fuentes oficiales o repositorios confiables para garantizar la seguridad y estabilidad del entorno de desarrollo.
  • Después de la instalación, es posible personalizar la configuración de PHP editando el archivo php.ini, ajustando parámetros como el límite de memoria o las zonas horarias.
  • Para mantener el entorno actualizado, es aconsejable verificar periódicamente la disponibilidad de nuevas versiones y aplicar las actualizaciones correspondientes.

Una vez instalado PHP, el siguiente paso es configurar un entorno de desarrollo adecuado y empezar a crear aplicaciones aprovechando las características más recientes del lenguaje.

Instalar y configurar PhpStorm para desarrollo en PHP

Para desarrollar eficazmente en PHP de forma profesional, el IDE recomendado es PhpStorm de JetBrains. Se trata de un entorno específicamente diseñado para PHP que integra de forma nativa autocompletado por tipos, refactorización segura, soporte de Composer, PHPUnit, PHPStan, Psalm y un depurador con Xdebug sin necesidad de instalar extensiones adicionales.

Para comenzar, descargue PhpStorm desde el sitio oficial jetbrains.com/phpstorm y elija la versión adecuada para su sistema operativo (Windows, macOS o Linux). JetBrains ofrece licencias gratuitas de estudiante y de uso no comercial para Early Access y proyectos open source. Una vez descargado, ejecute el instalador y siga las instrucciones del asistente aceptando los términos y condiciones y seleccionando las opciones por defecto.

Al abrir PhpStorm por primera vez, el IDE le ofrece configurar el intérprete de PHP del sistema. Vaya a File > Settings > PHP (en macOS: PhpStorm > Preferences > PHP) y seleccione el ejecutable php instalado previamente; el IDE detectará la versión y habilitará el soporte de PHP 8.4 con funcionalidades como readonly properties, enums, property hooks y visibilidad asimétrica.

PhpStorm incorpora todo lo necesario para PHP sin plugins externos. La configuración de Composer se habilita en Settings > PHP > Composer indicando la ruta al archivo composer.phar o al binario global. Para PHPUnit vaya a Settings > PHP > Test Frameworks y añada una configuración apuntando a vendor/autoload.php. Para análisis estático con PHPStan o Psalm, el IDE los detecta automáticamente si están declarados como dependencias de desarrollo en composer.json.

Para habilitar la depuración de código PHP con Xdebug, instale la extensión en el php.ini y configure el puerto por defecto 9003. En PhpStorm active Settings > PHP > Debug > Start Listening for PHP Debug Connections y el IDE interceptará las sesiones automáticamente al colocar breakpoints en el margen del editor.

Para verificar que el entorno de desarrollo está correctamente configurado, cree un nuevo proyecto con File > New Project > PHP Empty Project, seleccione una carpeta y cree un archivo llamado index.php. Escriba un código sencillo, como:

<?php
declare(strict_types=1);

echo "Hola, mundo desde PhpStorm!";

A continuación, abra el terminal integrado de PhpStorm con Alt + F12 y ejecute el comando:

php -S localhost:8000

Este comando inicia el servidor web integrado de PHP en el puerto 8000. Abra un navegador web y diríjase a http://localhost:8000; debería ver el mensaje Hola, mundo desde PhpStorm!, lo que confirma que la configuración es correcta.

Otra alternativa es ejecutar el comando:

php index.php

Para probar la depuración, añada un breakpoint haciendo clic en el margen izquierdo junto al número de línea y ejecute el script con Run > Debug. PhpStorm detiene la ejecución, muestra el stack de llamadas, las variables locales y permite evaluar expresiones en caliente con Evaluate Expression.

Es posible personalizar aún más el entorno ajustando las preferencias y atajos de teclado desde Keymap. PhpStorm ofrece mapas de teclas predefinidos como IntelliJ IDEA, Eclipse o Visual Studio para migrar cómodamente. Mantener PhpStorm actualizado desde Help > Check for Updates garantiza el acceso a las últimas mejoras, soporte de versiones nuevas de PHP y correcciones de seguridad.

Con esta configuración, ya está listo para desarrollar en PHP de manera eficiente, aprovechando las herramientas de autocompletado por tipos, refactorización, depuración y análisis estático que integra PhpStorm de forma nativa.

Hola mundo en PHP ejecutando servidor PHP integrado

Después de configurar el entorno de desarrollo, es momento de escribir el primer programa en PHP y ejecutarlo utilizando el servidor web integrado. Este ejercicio permite familiarizarse con la estructura básica de un script PHP y cómo se interactúa con el servidor.

Crear el archivo index.php:

  1. Crear una carpeta para el proyecto:
  • En su sistema de archivos, cree una nueva carpeta llamada hola_mundo.
  • Es recomendable organizar los proyectos en una ubicación específica, por ejemplo, C:\proyectos\php\hola_mundo en Windows o ~/proyectos/php/hola_mundo en macOS y Linux.
  1. Abrir la carpeta en PhpStorm:
  • Inicie PhpStorm.
  • Seleccione File > Open... y navegue hasta la carpeta hola_mundo.
  • Abrir la carpeta como proyecto facilita el uso de las funcionalidades de autocompletado y gestión de archivos.
  1. Crear el archivo index.php:
  • En el explorador de archivos de PhpStorm (Project tool window), haga clic derecho sobre la carpeta y seleccione New > PHP File, y nombre el archivo como index.php.
  • Este archivo será el punto de entrada de la aplicación.
  1. Escribir el código PHP:
  • Abra index.php y escriba el siguiente código:
<?php
echo "¡Hola, mundo!";
  • La etiqueta <?php indica el inicio de un bloque de código PHP, y la función echo es utilizada para imprimir texto en la salida.

Iniciar el servidor web integrado:

  1. Abrir una terminal:
  • En PhpStorm, abra el terminal integrado seleccionando View > Tool Windows > Terminal o utilizando el atajo Alt + F12 (Windows y Linux) o Option + F12 (macOS).
  • Alternativamente, puede utilizar una terminal externa si lo prefiere.
  1. Navegar hasta la carpeta del proyecto:
  • Asegúrese de que la terminal esté en la ruta de la carpeta hola_mundo.
  • Si no es así, utilice el comando cd para cambiar de directorio:
cd ruta/de/la/carpeta/hola_mundo
  1. Ejecutar el servidor:
  • Ingrese el siguiente comando para iniciar el servidor web integrado:
php -S localhost:8000
  • El parámetro -S indica que se debe iniciar un servidor web en el host y puerto especificados.
  • Debería aparecer un mensaje confirmando que el servidor ha iniciado:
PHP 8.3.0 Development Server (http://localhost:8000) started

Probar el programa en el navegador:

  1. Acceder a la dirección local:
  • Abra su navegador web preferido.
  • Escriba en la barra de direcciones http://localhost:8000 y presione Enter.
  • Debería visualizar el mensaje:
¡Hola, mundo!

  • Esto indica que el servidor está funcionando y que el script PHP se ha ejecutado correctamente.
  1. Verificar el procesamiento del código PHP:
  • Haga clic derecho en la página y seleccione Ver código fuente de la página.
  • Notará que en el código fuente solo aparece el texto ¡Hola, mundo! y no el código PHP, lo que confirma que el servidor ha interpretado el código en el servidor antes de enviar la respuesta al navegador.

Detener el servidor:

  • Para detener el servidor web integrado, vaya a la terminal donde se está ejecutando y presione Ctrl + C.
  • El servidor se cerrará y la aplicación dejará de estar disponible en http://localhost:8000.

Experimentar con el código:

  1. Modificar el mensaje:
  • Regrese a index.php en PhpStorm.
  • Cambie el contenido a:
<?php
echo "Bienvenido al mundo de PHP";

  • Guarde los cambios presionando Ctrl + S o Cmd + S.
  1. Actualizar el navegador:
  • Vuelva al navegador y refresque la página.
  • Debería ver el nuevo mensaje:
Bienvenido al mundo de PHP
  1. Incorporar HTML y PHP conjuntamente:
  • El lenguaje PHP puede coexistir con HTML en el mismo archivo. Modifique index.php como sigue:
<!DOCTYPE html>
<html lang="es">
     <head>
         <meta charset="UTF-8">
         <title>Primer Programa en PHP</title>
     </head>
     <body>
         <h1><?php echo "¡Hola desde PHP!"; ?></h1>
         <p>Esta es una página generada con PHP y HTML.</p>
     </body>
</html>
  • En este caso, el código PHP está embebido dentro del HTML para generar contenido dinámico.
  1. Visualizar los cambios:
  • Guarde el archivo y actualice la página en el navegador.
  • Debería aparecer el título ¡Hola desde PHP! y el párrafo adicional.

Consejos adicionales:

  • El servidor web integrado es ideal para desarrollo y pruebas locales. No se recomienda para entornos de producción.
  • Asegúrese de que el puerto 8000 no esté en uso por otro servicio. Si es necesario, puede cambiar el puerto, por ejemplo:
php -S localhost:8080
  • Mantenga siempre una buena práctica de programación, organizando el código y los archivos de manera clara y coherente.

Con estos pasos, ha creado y ejecutado con éxito su primer programa en PHP utilizando el servidor web integrado. Esto sienta las bases para desarrollar aplicaciones web más complejas y aprovechar al máximo las capacidades de PHP.

Comandos PHP por terminal

El intérprete de PHP no solo se utiliza para aplicaciones web, sino que también permite ejecutar scripts y comandos directamente desde la terminal. Esta funcionalidad es útil para tareas de automatización, pruebas rápidas y desarrollo de herramientas de línea de comandos. A continuación, se presentan los comandos más utilizados y cómo aprovecharlos.

Ejecutar scripts PHP desde la terminal:

Para ejecutar un script PHP sin necesidad de un servidor web, utilice el comando php seguido del nombre del archivo:

php mi_script.php

Este comando interpreta el archivo mi_script.php y muestra la salida en la terminal. Es esencial que el script comience con la etiqueta <?php y tenga permisos de lectura.

Ejemplo:

Cree un archivo llamado saludo.php con el siguiente contenido:

<?php
echo "Hola desde el terminal\n";

Ejecute el script:

php saludo.php

La terminal mostrará:

Hola desde el terminal

Modo interactivo de PHP:

PHP ofrece un modo interactivo que permite ejecutar comandos en tiempo real. Inicie este modo con:

php -a

Una vez dentro, puede escribir código PHP y obtener resultados inmediatamente.

Ejemplo:

php > echo sqrt(16);
4
php > $nombre = "María";
php > echo "Hola, $nombre\n";
Hola, María
php >

Para salir del modo interactivo, presione Ctrl + c.

Ejecutar código directamente desde la terminal:

Si desea ejecutar una pequeña porción de código sin crear un archivo, utilice la opción -r:

php -r "echo strtoupper('texto en mayúsculas')";

Este comando ejecuta el código proporcionado entre comillas simples. Es útil para operaciones rápidas o pruebas.

Consultar la versión de PHP:

Para verificar la versión instalada de PHP, utilice el comando:

php -v

La salida será algo similar a (teniendo en cuenta la versión que hayas instalado):

PHP 8.3.0 (cli) (built: Nov  8 2024 12:34:56) ( NTS )

Verificar módulos y extensiones instaladas:

Para listar los módulos y extensiones disponibles en su instalación de PHP, ejecute:

php -m

Esto mostrará una lista de módulos como curl, mbstring, openssl, entre otros.

Obtener información de configuración:

El comando php -i muestra una extensa información sobre la configuración de PHP, equivalente a la función phpinfo() en un entorno web.

php -i

Puede filtrar la salida para buscar detalles específicos. Por ejemplo, para conocer la configuración de memory_limit:

php -i | grep memory_limit

Ayuda y opciones del comando PHP:

Para ver todas las opciones y parámetros que admite el comando php, utilice:

php -h

Esto desplegará una lista de opciones útiles, como:

  • -a: Modo interactivo.
  • -f <archivo>: Ejecuta el archivo PHP.
  • -r <código>: Ejecuta el código sin usar etiquetas <?php.
  • -l <archivo>: Realiza una comprobación de sintaxis en el archivo.
  • -w <archivo>: Elimina comentarios y espacios en blanco en el código fuente.

Comprobación de sintaxis:

Antes de ejecutar un script, es posible verificar si hay errores de sintaxis con:

php -l mi_script.php

Si el script es correcto, mostrará:

No syntax errors detected in mi_script.php

En caso contrario, indicará el error y la línea afectada.

Usar PHP como lenguaje de scripting:

Es posible crear scripts PHP ejecutables en sistemas Unix añadiendo una línea shebang al inicio del archivo y otorgando permisos de ejecución.

Ejemplo:

Cree un archivo llamado sumar.php con el contenido:

#!/usr/bin/env php
<?php
$a = $argv[1];
$b = $argv[2];
$suma = $a + $b;
echo "La suma de $a y $b es $suma\n";

Otorgue permisos de ejecución:

chmod +x sumar.php

Ahora puede ejecutar el script directamente:

./sumar.php 5 7

La salida será:

La suma de 5 y 7 es 12

En este ejemplo, $argv es un array que contiene los argumentos pasados al script desde la línea de comandos.

Crear scripts con argumentos y opciones:

PHP permite procesar argumentos y opciones, facilitando la creación de herramientas de línea de comandos más complejas.

Ejemplo:

#!/usr/bin/env php
<?php
$options = getopt("u:p:");

echo "Usuario: " . $options['u'] . "\n";
echo "Contraseña: " . $options['p'] . "\n";

Ejecute el script con opciones:

./script.php -u admin -p 1234

Salida:

Usuario: admin
Contraseña: 1234

Consideraciones al usar PHP en la terminal:

  • Asegúrese de tener el intérprete PHP en el PATH del sistema para que los comandos funcionen correctamente.
  • Los scripts ejecutados en el modo CLI (Command Line Interface) no tienen acceso a variables de servidor como $_SERVER['HTTP_HOST'], ya que no se está en un contexto web.
  • El uso de PHP por terminal es ideal para tareas de automatización, procesamiento de archivos, manipulación de datos y más.

Detección de errores comunes:

Si al ejecutar un script aparece el error Command not found o No se reconoce el comando, verifique que PHP esté correctamente instalado y configurado en el PATH del sistema.

Conexión con bases de datos desde la terminal:

Es posible realizar operaciones con bases de datos desde scripts PHP ejecutados en la terminal. Por ejemplo, conectar a una base de datos MySQL y realizar consultas.

Ejemplo:

<?php
$conexion = new PDO('mysql:host=localhost;dbname=mi_base', 'usuario', 'contraseña');
$consulta = $conexion->query('SELECT * FROM tabla');
foreach ($consulta as $fila) {
    print_r($fila);
}

Ejecute este script desde la terminal y procesará los datos según lo programado.

Ampliando las posibilidades:

El uso de comandos PHP por terminal amplía las posibilidades de desarrollo más allá de las aplicaciones web. Permite crear scripts para administración de sistemas, procesamiento de archivos, gestión de tareas programadas y mucho más, aprovechando todas las funcionalidades que ofrece PHP.

php -v
sudo apt install php8.3-mbstring php8.3-xml php8.3-curl
sudo apt install php8.3
sudo apt install php
sudo apt update
php -v
export PATH="/usr/local/opt/php/bin:$PATH"
brew install php
brew update
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
php -v
Alan Sastre - Autor del tutorial

Alan Sastre

Ingeniero de Software y formador, CEO en CertiDevs

Ingeniero de software especializado en Full Stack y en Inteligencia Artificial. Como CEO de CertiDevs, PHP es una de sus áreas de expertise. Con más de 15 años programando, 6K seguidores en LinkedIn y experiencia como formador, Alan se dedica a crear contenido educativo de calidad para desarrolladores de todos los niveles.

Más tutoriales de PHP

Explora más contenido relacionado con PHP y continúa aprendiendo con nuestros tutoriales gratuitos.

Aprendizajes de esta lección

Instalar PHP en Windows, macOS y Linux. Configurar PHP en diferentes sistemas operativos. Verificar la instalación de PHP. Añadir PHP al PATH del sistema. Entender cómo trabajar con la terminal para ejecutar PHP.

Cursos que incluyen esta lección

Esta lección forma parte de los siguientes cursos estructurados con rutas de aprendizaje