Preparar el entorno de desarrollo de Laravel en Linux, Windows y MacOS

En esta entrada vamos a hablarte del ambiente NO oficial que es perfecto para desarrollar nuestras aplicaciones si estás empleando Windows, que no puede ser otro que el conocido como Laragon; esta peculiar herramienta nos trae todo lo necesario para desarrollar nuestras aplicaciones en este popular framework para PHP; primero, veamos que es Laragon.

Laragon, el entorno más fácil para desarrollar en Laravel

Laragon es una herramienta para desarrolladores que permite crear diferentes entornos de desarrollo web; no solamente para Laravel si no, puedes utilizarlo para otras tecnologías como PHP con otros frameworks, Node, Python, Java, Go, Ruby y un largo etc. Laragon funciona sobre Windows, y esta creado para trabajar con aplicaciones web en el framework Laravel; es decir, apenas bajemos el instalador, podremos crear desde ya proyectos en Laravel sin necesidad de instalar dependencias adicionales. 

Y como premio, Laragon proporciona un entorno de desarrollo aislado, lo que significa, que no hace cambios a nivel del Sistema Operativo si no, vive en una carpeta aparte al Sistema Operativo, por lo tanto, puedes tener paralelamente instaladas otras soluciones como XAMPP y habilitar una u otra.

Además, Laragon es rápido y potente y permite desplegar proyectos con un solo click; en el caso de Laravel, al reiniciar el servidor, automáticamente se genera la URL limpia mediante un Virtual Host de Apache de los proyectos en PHP, incluyendo Laravel, por lo tanto, ya tenemos hasta la URL de acceso al proyecto. Además, Laragon es una opción interesante para aquellos desarrolladores que buscan una solución para trabajar con PHP en Windows; ya que, inclusive instala una consola más amigable que la CMD de Windows para desarrollar.

Problemas al momento de comenzar con Laravel

Una de los inconvenientes que tiene Laravel, es su curva de aprendizaje o los primeros contactos que tenemos con el framework, qué pasa desde la instalación hasta dar los primeros pasos con el mismo; la instalación del ecosistema del framework pasa por varias pasos de complejidad que va desde el abanico de tecnologías que puede abarcar que va desde nuestro LAMP hasta llegar a todo el ecosistema de Node hasta llegar a la instalación del ambiente para desarrollar nuestras aplicaciones en cualquier SO.

En el caso de Windows, no es particularmente fácil instalar todo este ecosistema (aunque en MacOS tampoco es tan sencillo como se esperaría) cuyos pasos oficiales pasan por instalar una virtualización del sistema, es decir instalar una máquina virtual basada en Ubuntu.

Por suerte, existe un herramienta conocida como Laragon, que nos trae todo lo necesario para desarrollar nuestras aplicaciones en Windows.

Como te había comentado anteriormente, par desarrollar nuestras aplicaciones en Laravel, requerimos de múltiples herramientas, un conjunto de herramientas que tenemos que tener instaladas en nuestro equipo y básicamente Laragon nos ofrece un comprimido de todas estas herramientas, así que, en pocas palabras, con tan solo un instalador, podemos tener todo el ecosistema necesario.

Sobre Laragon para desarrollar apps en Laravel

En la web oficial podrás ver todas las características y tecnologías que nos ofrece esta herramienta:

1. PHP
2. Apache
3. Nginx
4. MySQL
5. Node
6. Una terminal decente
7. Entre otras cosas

Instalar Laragon en Windows

Instalar Laragon viene siendo lo usual; descargar e instalar:

Aquí te recomiendo la versión full (Laragon Full) que pesa unos 130Mb

Recuerda darle permisos sobre el SO, ya que el mismo al generar proyectos debe de tocar archivos de sistema, como el host de Windows que tiene que hacer juego con el virtualhost generado que es necesario al momento de generar la URL limpia para poder desarrollar nuestras aplicaciones en Laravel.

Verificar las instalaciones: Composer

Ahora con nuestro Laragon ya a tope, vamos a hacer algunas comprobaciones para instalar el instalador de Laravel aunque suene redundante...

Instalar el laravel/installer

En la página oficial de Laravel, podrás encontrar toda la información que necesitas para empezar a desarrollar tus aplicaciones en Laravel; entre esa información pertinente tenemos el ecosistema necesario (nuestro Laragon nos sirve perfectamente) y como podemos instalar Laravel.

Para instalar Laravel tienes que abrir tu terminal de Laragon y ejecutar el siguiente comando de composer:

$ composer global require laravel/installer

Y posiciónate sobre la carpeta www de tu Laragon (en caso de que ya no te encuentres allí):

Que sería el que nosotros empleamos para instalar el instalador de Laravel de acuerdo a la documentación oficial:
Y con esto, estamos listos para crear nuestro primer proyecto; para eso ejecutamos:

$ laravel new laratest

Y si reiniciamos nuestro Laragon (Apaga los servicios y arrancamos nuevamente) ya estamos listos para ver nuestro flamante proyecto en el navegador:

http://laratest.test/

En donde la url es básicamente el nombre de tu proyecto con la extensión de .test

Actualización del instalador de Laravel

Laravel Installer es una herramienta de línea de comandos que permite instalar Laravel en tu equipo de manera sencilla; claro, para esto, recueda primero tener instalado tu ambiende de desarrollo como Laragon o Sail que tambien encontrarás artículos en este blog. Cuando ejecutas el comando de:

$ composer global require "laravel/installer" 

Se descarga y se instala la última versión estable de Laravel Installer en tu sistema. A continuación, puedes crear un nuevo proyecto de Laravel utilizando el comando 

$ laravel new <nombre_del_proyecto> 

Automáticamente se empezarán a descargar los archivos necesarios de Internet que conforman nuestro proyecto en Laravel y con esto, se creará automáticamente nuestro proyecto en Laravel sin hacer nada más.

Tener actualizado Laravel installer es importante ya que, muchas veces las últimas versiones del framework requieren tener una versión actualizada del mismo.

Laravel Installer es una herramienta de línea de comandos que permite instalar Laravel en una PC previsamente configurada usando Laragon, Sail, etc; Cuando ejecutas el comando de:

$ composer global require "laravel/installer"

Se descarga y se instala la última versión estable de Laravel Installer en tu sistema. A continuación, puedes crear un nuevo proyecto de Laravel utilizando:

$ laravel new <nombre_del_proyecto> 

Y esperar a que termine el proceso, en el cual, se empezarán a descargar los archivos necesarios de Internet para creear un proyecto en Laravel y con esto, crear nuestro proyecto en Laravel ya listo para emplear. Como todo, a veces es necesario actualizar la versión del mismo, veamos un mecanismo sencillo de hacerlo.

Instalar el nuevo instalador de Laravel usando Composer es fácil, pero ¿qué pasa si ya lo tienes instalado? El último instalador de Laravel será esencial para su flujo de trabajo, por lo que debe asegurarse de obtener la versión más reciente. Si te estás rascando la cabeza, ¡te tenemos cubierto!

Actualización del instalador de Laravel

Si ya tiene laravel/installer requerido globalmente en su máquina local, puede actualizar la última versión de laravel/installer desinstalando e instalando nuevamente el mismo:

$ composer global remove laravel/installer
$ composer global require laravel/installer

Diferencia entre composer.json y composer.lock

Composer es un administrador de dependencias de PHP y para PHP, lo que quiere decir es que podemos instalar paquetes para PHP fácilmente si usamos un proyecto con soporte a PHP; actualmente todos los frameworks para PHP modernos como Laravel o CodeIgniter ya de gratis vienen con soporte a Composer por lo tanto, el uso de esta herramienta es fundamental. 

Composer es una herramienta que permite declarar las bibliotecas de las cuales depende el proyecto y las versiones especificas de estas; automáticamente al hacer un composer install o update se instalan las dependencias.

En Laravel y cualquier proyecto PHP que emplee composer para administrar los paquetes, tenemos dos tipos de archivos, composer.json y composer.lock y en esta entrada veremos cuál es la diferencia entre ellos.

En composer.json especificas qué paquetes se deben instalar y con qué versiones, es decir se encuentran los paquetes que conforman el proyecto. Por ejemplo:

   "require": {
       "artesaos/seotools": "^1.3",
       "laravel/framework": "^11.0",

Este archivo es generado por composer y es empleado por el mismo para descargar e instalar las dependencias del proyecto en Laravel u otro.

En el ejemplo anterior, estamos indicando los paquetes de laravel/framework y artesaos/seotools que deben ser instalados con la version 1.3 o superior y 11 o superior respectivamente, si quisieras una versión exacta, removerías el carácter de ^.

En este archivo también se encuentra otras reglas como nombre, descripción del proyecto y versiones mínimas, como:

"php": "^8.2",

El composer.json  sirve para mucho más, pero, esto es lo fundamental.

Mientras que el composer.lock registra las versiones especificas que esta instalando y es el que lee composer al momento de ejecutar composer update, este archivo es generado automáticamente al momento de ejecutar el comando anterior.

Actualizar proyecto

Usualmente, cuando se quiere actualizar el proyecto, se puede eliminar este archivo y ejecutar nuevamente el comando de 

$ composer install

Con esto, se vuelve a generar el .lock con nuevas versiones.

Extra: Actualizar Composer a la versión 2

Vamos a conocer cómo puedes migrar o actualizar tu versión de composer de 1 a la 2 empleando Laragon, aunque, los pasos los puedes repetir independientemente del sistema que estés usando.

Posicionarse en el directorio de la instalación de composer

En tu terminal, tienes que hacer un cd para posicionarse en la ubicación de la instalación de composer en Laragon:

? cd..
C:\laragon\www
?

Verificar la versión de Composer V1

Para saber con que version de composer estás trabajando, tienes que ejecutar el siguiente comando:

composer -V

En mi caso, me arroja algo como lo siguiente:

Composer version 1.10.7 2020-12-03 17:18:15

Descargar Composer 2

La descarga e instalación de composer en su versión 2 la podemos hacer mediante la línea de comandos empleando php; para ello:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

El comando anterior lo que hace es descargar el instalador de composer 2 en el directorio en donde estamos posicionados; ahora tenemos que ejecutar el mismo.

Instalar (ejecutar el script php) Composer V2

php composer-setup.php

Y listo, ya con esto tenemos composer en su versión 2, por lo tanto, ya podemos eliminar el instalador:

Eliminar el instalador

Para eliminar el instalador de composer una vez utilizado podemos emplear la función unlink de php mediante el siguiente comando:

php -r "unlink('composer-setup.php');"

Verificar la versión de Composer V2

Por último, vamos a verificar la versión de composer que tenemos instalada, que en este punto, si hicimos todo bien, debería ser la 2.x

composer -V

Un versión que incluya el 2.x

Composer version 2.0.8 2026-12-03 17:20:38

Instalación de Valet Linux en CachyOS

Para los desarrolladores que eligen Linux como su entorno de trabajo principal, la gestión del entorno local de Laravel presenta desafíos particulares. A diferencia de macOS o Windows, que cuentan con herramientas oficiales integradas, en Linux no disponemos de una versión oficial de entornos gráficos dedicados. Las alternativas comunes se reducen a utilizar contenedores mediante Laravel Sail —lo cual añade la capa de complejidad de Docker— o configurar todo el servidor web, PHP y las bases de datos manualmente, un proceso que suele ser tedioso.

Para resolver esto, la comunidad desarrolló Valet Linux. Es importante destacar que no es una herramienta oficial del core de Laravel, sino un fork mantenido por la comunidad. Valet Linux funciona de manera similar a su contraparte de Valet para macOS: levanta un entorno de desarrollo ágil y ligero basado en Nginx, pero sin interfaz gráfica y con ciertas limitaciones, como una menor flexibilidad para alternar rápidamente entre versiones de PHP. A pesar de ello, su rendimiento es excelente y su configuración inicial es sumamente sencilla.

Existe un puerto de Laravel Valet mantenido por la comunidad para Linux (cpriego/valet-linux) que gestiona Nginx y DnsMasq de fondo para darte dominios .test locales automáticamente ya que, el equipo de Laravel NO da soporte a Laravel Herd y Valet en Linux.

Entorno Objetivo: Arch Linux / CachyOS (Sistemas basados en pacman con la shell Fish)
Servicios incluidos: PHP 8.x, Composer, MariaDB, Nginx (vía Valet), DnsMasq y Extensiones de Base de Datos.

Prerrequisitos y dependencias del sistema

Antes de proceder con la instalación global de Valet, es recomendado preparar el sistema operativo con las dependencias necesarias. A diferencia de las soluciones empaquetadas, aquí debemos instalar PHP y sus extensiones de forma manual.

Actualización General del Sistema

Antes de instalar dependencias críticas, es obligatorio sincronizar los repositorios principales de CachyOS y Arch para evitar conflictos de librerías compartidas:

$ sudo pacman -Syu --noconfirm

El principal reto en Linux es la fragmentación de distribuciones, ya que cada una maneja un gestor de paquetes diferente. Los siguientes pasos e instrucciones están diseñados específicamente para CachyOS (y distribuciones basadas en Arch Linux que utilizan pacman). Si utilizas otra distribución (como Ubuntu, Debian o Fedora), puedes adaptar estos paquetes a los comandos correspondientes de tu gestor (apt o dnf).

Este apartado muestra de manera técnica y estructurada para instalar y configurar Laravel Valet (Linux) en Linux, específicamente en distribuciones Arch, aunque puedes pedirle a un chat IA que te traduzca los comandos para la distribucion que estés empleando. 

A diferencia de Docker o entornos pesados, Valet ofrece una velocidad nativa inigualable consumiendo el mínimo de recursos del sistema.

Instalación de PHP y Extensiones Esenciales

Laravel y Valet requieren componentes específicos de PHP para compilar ademas de nginx, realizar conexiones seguras y procesar datos estructurados. Instalamos el paquete base junto con sus extensiones habituales:

$ sudo pacman -S php php-fpm php-gd php-intl php-sqlite php-sodium php-imagick --noconfirm

Otras extensiones:

$ sudo pacman -S nginx curl git unzip jq base-devel nss xsel networkmanager libsodium --noconfirm

Valet gestiona de forma automatizada servidores proxy inversos (Nginx), solicitudes DNS (DnsMasq) y certificados SSL (NSS). Instalamos las herramientas que Valet invocará en segundo plano:

• nss: Para que Valet pueda generar e inyectar certificados SSL locales (https://).
• jq: Procesador de JSON para leer las configuraciones.
• xsel: Copia automáticamente las URLs .test generadas a tu portapapeles.
• networkmanager: Para la gestión de DNS locales (CachyOS ya lo trae por defecto, pero no está de más asegurar).

Puedes ver los requerimientos oficiales en:

https://cpriego.github.io/valet-linux/requirements

php-fpm

php-fpm (FastCGI Process Manager) es la herramienta que permite a Nginx procesar el código PHP. Cuando instalas y corres valet install:

• Valet modifica automáticamente los archivos de configuración de php-fpm.
• Configura un "socket" de Linux para que Nginx le envíe las peticiones de tus sitios .test de forma directa y ultrarrápida.
• Gestiona el servicio por ti (lo inicia, lo detiene o lo reinicia cuando cambias algo).

Habilitas con:

$ sudo systemctl enable --now php-fpm

Configuración del Archivo php.ini

Por defecto, Arch Linux mantiene desactivadas casi todas las extensiones en el archivo de configuración global. Debemos habilitar los módulos necesarios editando el archivo:

$ sudo nano /etc/php/php.ini

Busca las siguientes líneas quitándoles el punto y coma (;) al inicio para activarlas:

extension=bcmath
extension=curl
extension=exif
extension=fileinfo
extension=gd
extension=iconv
extension=intl
extension=mbstring
extension=openssl
extension=pdo_mysql
extension=pdo_sqlite
extension=sodium
extension=zip

O

$ sudo sed -i 's/;extension=curl/extension=curl/' /etc/php/php.ini
$ sudo sed -i 's/;extension=iconv/extension=iconv/' /etc/php/php.ini
$ sudo sed -i 's/;extension=mbstring/extension=mbstring/' /etc/php/php.ini
$ sudo sed -i 's/;extension=openssl/extension=openssl/' /etc/php/php.ini
$ sudo sed -i 's/;extension=pdo_mysql/extension=pdo_mysql/' /etc/php/php.ini
$ sudo sed -i 's/;extension=zip/extension=zip/' /etc/php/php.ini
$ sudo sed -i 's/;extension=sodium/extension=sodium/' /etc/php/php.ini
$ sudo sed -i 's/;extension=bcmath/extension=bcmath/' /etc/php/php.ini

El comando sudo sed -i modifica archivos directamente en el sistema. Se compone de dos partes:

1. sed: Es un editor de texto que busca, reemplaza o elimina patrones.
2. -i: Indica que los cambios se aplican "en el lugar", alterando el archivo original de forma permanente.

Instalación de Composer (Global)

Descargamos el gestor de dependencias estándar de PHP de los repositorios de Arch, asegurando su acceso global inmediato:

$ sudo pacman -S composer --noconfirm

Configuración del PATH para la Shell Fish

Los binarios globales instalados por Composer se alojan en el directorio del usuario. Para que tu terminal reconozca comandos como valet o laravel, añade la ruta al archivo de configuración de Fish:

$ fish_add_path ~/.config/composer/vendor/bin

Instalación y Despliegue de Laravel Valet

Con todo el ecosistema de dependencias listo, instalamos el paquete ejecutable de Valet Linux a través de Composer:

$ composer global require cpuncker/valet-linux

Agregamos composer en el path:

$ fish_add_path ~/.config/composer/vendor/bin

Lanzamiento del Instalador de Valet

Ejecuta el instalador nativo. Este comando modificará tus configuraciones locales de red, creará los proxies en Nginx y levantará DnsMasq automáticamente:

$ valet install

Flujo de Trabajo Técnico (Uso Diario)

Para desplegar proyectos de forma inmediata sin configurar servidores virtuales de forma manual, sigue este procedimiento estándar:

1. Crea una carpeta raíz en tu directorio de usuario donde vivirán tus desarrollos:

   $ mkdir -p ~/Sites && cd ~/Sites

2. Registra esa carpeta en el motor de mapeo de rutas de Valet:

   $ valet park

3. Agregar el instalador de Laravel al PATH en fish:

4. $ fish_add_path ~/.config/composer/vendor/bin

1. El comando valet park registra la ubicación actual. A partir de este momento, cualquier carpeta de un proyecto Laravel que se encuentre dentro de ese directorio será accesible desde el navegador web mediante una URL limpia estructurada como http://nombre-de-la-carpeta.test.

1. Crea cualquier proyecto PHP o Laravel dentro de esa carpeta. Por ejemplo:

   $ laravel new mi-proyecto

2. Abre tu navegador de inmediato e ingresa a http://mi-proyecto.test sin necesidad de configurar hosts ni levantar puertos de forma manual.

Comandos de Diagnóstico y Utilidades Comunes

A continuación se listan las herramientas clave para administrar el ciclo de vida del entorno:

• valet stop: Detiene todos los servicios (Nginx, PHP-FPM, DnsMasq) para liberar memoria RAM.
• valet start: Inicializa de nuevo el entorno de desarrollo.
• valet status: Muestra el estatus de los servicios que usa Valet.
• valet restart: Útil tras modificar el archivo php.ini para aplicar los cambios de inmediato.
• valet secure [nombre-proyecto]: Genera certificados SSL locales firmados para simular entornos HTTPS de producción.

Instalación y Configuración de MariaDB

MariaDB provee el motor de bases de datos relacionales en el entorno local.

$ sudo pacman -S mariadb --noconfirm

Inicialización del Directorio de Datos

Antes de arrancar el servicio por primera vez, es imperativo inicializar la estructura interna del motor:

$ sudo mariadb-install-db --user=mysql --basedir=/usr --datadir=/var/lib/mysql

Activación del Servicio e Inicio de Seguridad

Habilitamos el servicio para que inicie de forma automática con la máquina y procedemos a configurar las credenciales base:

$ sudo systemctl enable --now mariadb
$ sudo mariadb-secure-installation

Importar base de datos

Si quieres exportar una base de datos existentes:

# 2. Importa el archivo pasando el usuario 'root' y la contraseña 'root'
mariadb -u root -proot nombre_de_tu_bd < tu_archivo_respaldo.sql

Otros comandos útiles

Reiniciar el servicio PHP-FPM:

$ sudo systemctl restart php-fpm

El rendimiento es brutal, pero cambiar de versión es manual

• Velocidad: Al no haber capas de virtualización ni contenedores de por medio, las peticiones PHP se procesan a la
  velocidad máxima que permita tu hardware.
• Versiones: En Arch/CachyOS, al ser distribuciones rolling release, cuando instalas php siempre obtendrás la última
  versión absoluta disponible (por ejemplo, PHP 8.4 u 8.5 según el repositorio actual).
• El inconveniente: Si tienes un proyecto viejo que requiere obligatoriamente una versión anterior (como PHP 8.2), en
  Valet Linux no puedes cambiar de versión con un simple clic como en Herd.
  • Tendrías que recurrir a paquetes AUR
    específicos (como php82) y configurar Valet manualmente para que apunte a ese binario.

Problemas con cache

Si vez que haces cambios en el código y NO se reflejan en el navegador, prueba desactivar la cache de código de operación (que es una cache que permite a PHP almacenar código precompilado):

$ sudo nano /etc/php/php.ini

Busca las siguientes líneas y asegúrate de dejarlas así (si tienen un ; al inicio, bórralo para activarlas):

opcache.enable=0
opcache.enable_cli=0

Reinicia Valet para que aplique la nueva configuración de PHP:

$ valet restart

Extensión para Laravel 12 Visual Studio Code OFICIAL

Como Editor, te recomiendo Visual Studio Code con su extensión oficial.

Esto significa que ya no es necesario instalar 40 extensiones distintas de diferentes desarrolladores. En principio, solo necesitas esta, que centraliza las funcionalidades esenciales para trabajar con Laravel.

Aunque, en mi caso, también tuve que instalar el formateador de Laravel Blade, ya que por alguna razón la extensión oficial aún no me lo reconocía correctamente (aunque según la descripción debería hacerlo). Aun así, es un enorme paso adelante tener un paquete oficial y unificado.

Requisitos y compatibilidad

Ten en cuenta que esta extensión requiere PHP 8 o superior, lo cual tiene todo el sentido, ya que la versión mínima soportada por las últimas versiones de Laravel es PHP 8.2.

⚠️ Precaución con las extensiones falsas

Un punto muy importante: asegúrate de instalar la extensión correcta, desde el enlace oficial anterior.
Actualmente están apareciendo muchas extensiones maliciosas en el Marketplace, así que revisa siempre el identificador del editor, que debe ser:

laravel.vscode-laravel

De esta forma, te aseguras de que estás instalando la extensión oficial del equipo de Laravel y no una copia falsa o potencialmente peligrosa.

Starter Kits Infinitos en Laravel Gracias a la Comunidad - Filament, Svelte, Wave y mucho +

Al momento de crear un proyecto en Laravel, tenemos varios sabores o configuraciones que podemos utilizar.

Esta funcionalidad nos permite indicar directamente el “template” o plantilla base que queremos utilizar, aprovechando proyectos comunitarios existentes.

¿En qué consiste?

Básicamente, cualquier persona puede crear su propia instalación de Laravel, modificarla agregando los paquetes, configuraciones o estructuras que considere útiles, y luego compartirla como una plantilla reutilizable.

De esta forma, nosotros podemos clonar y crear un nuevo proyecto basado en esa plantilla con un solo comando.

Cómo se usa

Al momento de crear el proyecto, simplemente utilizamos la opción --using seguida del repositorio que contiene el template:

$ laravel new example-app --using=<REPO>

Por ejemplo, si queremos usar una plantilla específica alojada en GitHub, solo tenemos que indicar la URL del repositorio.

Ejemplo práctico

Un ejemplo de repositorio que implementa esta funcionalidad es el siguiente:

https://github.com/tnylea/laravel-new

En pocas palabras, en lugar de clonar manualmente un proyecto que encontraste en internet, ahora puedes hacerlo directamente desde el comando de creación de Laravel, lo que hace el proceso mucho más rápido y limpio.

Cómo arreglar el comando Laravel no encontrado para zsh en MacOS

Los comandos por terminal son estupendos en el ecosistema Laravel ya que permiten desde crear el proyecto hasta poder administrar distintas parte del mismo; cuando instalamos el instalador de Laravel de manera global con composer, muchas veces no es reconocido como un comando valido hasta que agregamos el mismo al path; veamos como hacerlo.

Para permitir el uso de comandos que comienzan con 'laravel', deberá editar su archivo .zshrc; usualmente esto sucede al momento de ejecutar el instalador de laravel:

$ laravel new proyectolaravel

Este archivo debe estar en su carpeta de inicio.

Primero, verifique si el archivo existe:

open -e ~/.zshrc

A continuación, agregue el siguiente código en la parte inferior de su archivo .zshrc:

PATH="$HOME/.composer/vendor/bin:$PATH"

Guarda el archivo. Los cambios ahora se implementarán en cualquier nueva sesión de terminal. Detenga la sesión actual o ejecute el código a continuación, y luego también funcionará para la sesión actual:

source ~/.zshrc

Cómo arreglar Problema con la extensión pdo_sqlite

Importante señalar que, debes de tener al menos PHP en su versión 8.3.3 para trabajar con Laravel 11; en mi canal de YouTube, explico cómo puedes instalar versiones de PHP en Laragon.

Por lo demás, Laragon ya nos trae todo lo que necesitamos para empezar a trabajar en Laravel.

Desde el botón que dice "Iniciar Todo", incias tanto Apache como MySQL (lo cual debes hacer para poder trabajar con Laravel); así que, si tienes otro ambiente LAMP habilitado en tu equipo, primero, debes de bajar dichos servicios y luego levantar este con el mencionado botón:

Además de instalar Laragon, debes de habilitar la siguiente extensión "pdo_sqlite":

O al momento de crear el proyecto en Laravel puede que se detenga mediante un error o al momento de iniciar el servidor de un error como el siguiente:

could not find driver PRAGMA foreign_keys = ON;

Y es porque debes de habilitar la extensión anterior.

En linux, puedes instalar la siguiente dependencia:

$ sudo apt-get install php-sqlite3

Y es para evitar que lance un error como el siguiente:

   INFO  Application key set successfully.

    > @php -r "file_exists('database/database.sqlite') || touch('database/database.sqlite');"
    > @php artisan migrate --ansi

   Illuminate\Database\QueryException

  could not find driver (Connection: sqlite, SQL: PRAGMA foreign_keys = ON;)

  at vendor\laravel\framework\src\Illuminate\Database\Connection.php:813
    809                     $this->getName(), $query, $this->prepareBindings($bindings), $e
    810                 );
    811             }
    812
    813           throw new QueryException(
    814                $this->getName(), $query, $this->prepareBindings($bindings), $e
    815             );
    816         }
    817     }

Además de instalar Laragon, debes de habilitar la siguiente extensión “pdo_sqlite”.

Aunque Laragon era estupenda, ahora es de pago y esta en la lista como una opción más, pero, para desarrollos modernos, te recomiendo Laravel Herd para el desarrollo de aplicaciones en Laravel.