Cómo agregar Laragon en el PATH de Windows

Video thumbnail

Laragon es un entorno de desarrollo integrado portátil y aislado para el lenguaje de programación PHP y MySQL; aunque, con él, podemos desarrollar fácilmente otras tecnologías como Python, Node y muchos más. Además, Laragon incluye características como la capacidad de desplegar proyectos con un solo clic y la gestión de versiones de software y es el software que personalmente utilizo para desarrollar en windows tanto a nivel profesional como en mis cursos y libros. Laragon está diseñado para ser sencillo de usar y ofrecer una experiencia de usuario fluida.

En el video anterior te recomiendo Laravel Herd en vez de Laragon

Una de los problemas que tenemos con Laragon, es que TODO el ecosistema que tengamos instalado en él, queda establecido en un solo lugar, mediante la terminal que nos viene por defecto, que aunque es excelente, se nos queda corta cuando por ejemplo queremos usar la de sistema, la CMD o cuando desarrollamos en nuestro Visual Studio Code y NO podemos emplear la que nos viene embebida en dicho sistema.

Si usas Laragon en Windows, seguramente te ha pasado esto: todo funciona perfecto dentro de Laragon, pero cuando intentas usar PHP en CMD, PowerShell o Visual Studio Code… simplemente no funciona.

  • El problema no es PHP. Tampoco Laragon.
  • El problema es el PHP Path.

Qué es el PHP Path en Laragon y por qué es importante

El PHP Path es la ruta donde se encuentra el ejecutable de PHP (php.exe) en tu sistema.

En Laragon, normalmente es:

C:\laragon\bin\php\php-[version]\php.exe

Este path es clave porque permite que:

  • Windows encuentre PHP
  • CMD y PowerShell puedan ejecutarlo
  • VS Code lo detecte automáticamente

Si no está configurado, PHP solo funcionará dentro de Laragon.

Por qué Laragon no expone PHP al sistema

Laragon está diseñado como un entorno aislado.

Esto significa que:

  • No modifica tu sistema automáticamente
  • No añade PHP al PATH por defecto
  • Evita conflictos con otras instalaciones

Esto es bueno… pero también es la razón por la que no puedes usar PHP fuera de Laragon sin configurarlo.

Dónde encontrar el PHP Path en Laragon

Ruta por defecto de php.exe

Por defecto, Laragon instala PHP en:

C:\laragon\bin\php\

Dentro encontrarás carpetas como:

php-8.1.10
php-8.2.0

Cada carpeta contiene su propio php.exe.

Cómo saber qué versión de PHP estás usando

Puedes comprobarlo fácilmente:

Opción 1 (desde Laragon)

  • Clic derecho en Laragon
  • Ir a: PHP > Version

Opción 2 (desde terminal)

php -v

Agregar Laragon en las Variables de entorno de Windows

En Laragon, tenemos esta opción, la de agregar Laragon al PATH mediante una variable de entorno oculta a la vista; para realizar esta operación, nos vamos nuestra ventana en Laragon:

Laragon UI
Laragon UI

Le damos un clic derecho en una parte blanca/limpia y nos vamos a la opción de:

Opción de Add Laragon to Path

Y LISTO! con esto podremos disfrutar TODO el ecosistema de Laragon en cualquier terminal en Windows, tanto la CDM, powershell como las que nos provee VSC; ya que, se acaba de agregar en las variables de entorno de Windows.

En resumen:

  • Abre Laragon
  • Clic derecho en la ventana
  • Ve a:
    • Tools > Path > Add Laragon to PATH
  • Reinicia la terminal
  • Ejecuta:
    • php -v

Cómo usar múltiples versiones de PHP en Laragon

Una de las mejores características de Laragon es poder cambiar de versión fácilmente.

Añadir nuevas versiones

Descargar PHP (Thread Safe)

  1. Copiar en:
  2. C:\laragon\bin\php\

Cambiar versión activa

  • Clic derecho en Laragon
  • Ir a:
PHP > Version

Esto cambiará automáticamente la versión usada en el sistema (si usas el PATH de Laragon).

Problemas comunes con Laragon PHP Path (y soluciones)

PHP no se reconoce en CMD

Error:

$ 'php' no se reconoce como un comando

Solución:

  • Añadir Laragon al PATH
  • Reiniciar terminal

VS Code no detecta PHP

Solución:

  • Configurar php.validate.executablePath
  • Reiniciar VS Code

Conflictos con otras instalaciones

Si tienes XAMPP o PHP instalado:

  • Puede ejecutarse otra versión
  • PATH puede estar mal ordenado

Solución:

  • Eliminar rutas duplicadas
  • Priorizar Laragon en el PATH

En mi caso, este fue el problema real: tenía otro PHP instalado y Laragon no se estaba usando.

Cambiaste versión pero no se refleja

Solución:

  • Reiniciar terminal
  • Ejecutar php -v
  • Verificar PATH

Buenas prácticas al usar PHP con Laragon

  • Usa el método automático siempre que puedas
  • Evita múltiples instalaciones de PHP
  • Verifica siempre con php -v
  • Documenta tu entorno si trabajas en equipo

Conclusión

Configurar correctamente el Laragon PHP Path es fundamental para trabajar de forma profesional en Windows.

Aunque Laragon simplifica mucho el desarrollo, necesitas dar este paso para poder usar PHP en herramientas externas como CMD o VS Code.

La buena noticia es que puedes hacerlo en segundos, y una vez configurado, tu flujo de trabajo mejora muchísimo.

FAQs sobre Laragon PHP Path (SEO + tráfico)

  • ¿Cuál es el PHP Path de Laragon?
    • C:\laragon\bin\php\php-[version]\php.exe
  • ¿Cómo añadir Laragon al PATH?
    • Desde:
    • Tools > Path > Add Laragon to PATH
  • ¿Por qué PHP no funciona en CMD?
    • Porque no está añadido al PATH de Windows.
  • ¿Cómo usar PHP de Laragon en VS Code?
    • Añadiendo Laragon al PATH o configurando:
      • php.validate.executablePath
  • ¿Puedo tener varias versiones de PHP en Laragon?
    • Sí, y puedes cambiarlas desde el menú de Laragon fácilmente.
  • ¿Qué hacer si php -v no funciona?
    • Verificar PATH
    • Reiniciar terminal
    • Revisar conflictos
  • ¿Laragon modifica automáticamente el sistema?
    • No, solo lo hace si activas la opción de PATH manualmente.

Aprende a configurar Laragon a nivel del Sistema Operativo en Windows mediante el PATH del sistema, con lo cual, podremos emplear Laragon en cualquier terminal del SO.


Únete a la comunidad de desarrolladores que han decidido dejar de picar código y empezar a construir productos reales. Recibe mis mejores trucos de arquitectura cada semana:

Acepto recibir anuncios de interes sobre este Blog.

Andrés Cruz

EN In english