Instalación

La instalación

Como ya hemos comentado Laravel , uno de los frameworks de PHP más populares, simplifica el desarrollo web mediante una estructura organizada y herramientas potentes.
Para comenzar un proyecto en Laravel, existen dos enfoques principales:

• Crear un proyecto con composer
• Instalar un programa llamado laravel . Este programa permitirá crear proyectos de laravel con toda la estructura de carpetas y ficheros necesarios.

Instalar composer

Composer documentación Oficial

🌐 getcomposer.org

Lo primero que necesitamos es tener composer instalado en nuestro sistema

Composer es un sistema de gestión de dependencias para PHP que permite especificar y manejar las librerías de las cuales sus proyectos dependen, a través de un fichero llamado composer.json .
Igualmente, composer permite aportar documentación sobre el proyecto y automatizar la autocarga de clases para la ejecución del mismo.

Funciona descargando e instalando estas librerías y sus dependencias en el proyecto, asegurando compatibilidad y facilitando la actualización.

Es esencial para proyectos modernos de PHP, ya que automatiza y gestiona tareas complejas de gestión de paquetes de forma eficiente.

1

  composer -V

Instalar el instalardor Laravel

Laravel dispone de una utilidad, un ejecutable que nos va a permitir crear proyectos con la estructura de un proyecto laravel. En este punto es un creador de proyectos de laravel

Laravel installer

Laravel no es ni un EDI, ni un lenguaje de programación , es un framework .

Necesitamos de alguna manera un programa que nos permita crear un proyecto nuevo con la estructura y todas las utilidades que ofrece el framework.

Podemos instalar un instalador de laravel con composer: Instalador de Laravel :
Alternativamente, puedes utilizar el instalador de Laravel, una herramienta ligera que se instala globalmente en tu sistema a través del comando

1

composer global require laravel/installer

Creando un proyecto

• Uso de Composer :
  Puedes crear un nuevo proyecto Laravel ejecutando el comando

  1	composer create-project laravel/laravel nombre_proyecto

  
  Este método instala Laravel y todas sus dependencias, configurando una estructura de directorios lista para comenzar a desarrollar tu aplicación.
• A diferencia del instalador de laravel, no te asistirá ni ayudará durante el proceso de creación del proyecto

Este instalador permite crear nuevos proyectos rápidamente con el comando laravel new nombre_proyecto.

Además utilizando esta herramiena, el comando laravel durante el proceso de instalación, se irán planteando opciones durante que puedes elegir

Para crear un proyecto nuevo en laravel

1

laravel new nombre_proyecto

Instala dependencias

Laravel tiene una serie de requisitos que necesita satisfacer para poder funcionar.

• PHP >= 8.2 Extensiones necesarias queya se instalan por defecto:

• Ctype PHP Extension

• Fileinfo PHP Extension

• Filter PHP Extension

• Hash PHP Extension

• OpenSSL PHP Extension (si no lo estuviera php-openssl)

• PCRE PHP Extension

• Session PHP Extension

• Tokenizer PHP Extension

• Extensiones que hay que instalar

• cURL PHP Extension php-curl

• DOM PHP Extension php-xml

• Mbstring PHP Extension php-mbstring

• PDO PHP Extension php-mysql

• XML PHP Extension php-xml

Para instalar estas extensiones en linux, usaremos apt :

1

apt install php-curl php-xml php-mbstring php-mysql php-xml

1. Abre php.ini en un editor de texto como Notepad++, o bien xammp/wammp nos ofrece editar el fichero directamente .

2. Busca las líneas correspondientes a las extensiones y descoméntalas eliminando el punto y coma (;) al inicio.

   1 2 3 4 5 6

   extension=curl extension=dom extension=mbstring extension=mysqli extension=pdo_mysql extension=xml

   Si alguna extensión no la tuvieses, eso implica que habría que descargar el dll https://windows.php.net/download

Poner el proyecto en ejecución

La base de datos se ejecuta en Docker, configurada mediante el archivo .env.

En el archivo package.json tenemos scripts para facilitar el desarrollo local.
Por ejemplo, el script npm run dev se encarga de lanzar Vite para compilar y recargar automáticamente nuestros assets (JavaScript, CSS, etc.).

Además, usamos php artisan serve para levantar el servidor web de Laravel, que por defecto escucha en el puerto 8000.

Script básico para desarrollo

En la sección "scripts" de package.json podemos tener algo así:

"scripts": {
"dev": "vite",
"build": "vite build"
}

Usar Docker para la base de datos

Con Docker podemos levantar la base de datos MySQL y phpMyAdmin fácilmente.
El archivo docker-compose.yml define los servicios y mapea puertos para acceder desde el host.

Para iniciarlo en segundo plano:

docker compose up -d

Crear un script para todo en uno

Podemos crear un script que ejecute a la vez:

• Docker para la base de datos
• Vite (npm run dev)
• Laravel (php artisan serve)

Para ello instalamos el paquete concurrently:

npm install --save-dev concurrently

Y añadimos en package.json:

"scripts": {
"dev": "vite",
"build": "vite build",
"localdev": "docker compose up -d && concurrently \"npm run dev\" \"php artisan serve\""
}

Así, con un solo comando:

npm run localdev

se pondrá en marcha todo el entorno local de desarrollo.

Resumen:

• npm run dev → lanza Vite para desarrollo frontend
• php artisan serve → levanta el servidor Laravel en localhost:8000

  En lugar de usar el ejecutable php, se puede usar @php artisan serve en los scripts del package.json. Esto hace que el comando sea más portable entre distintos sistemas operativos, ya que utiliza el ejecutable de PHP que está configurado en el PATH del sistema.

• docker compose up -d → arranca la base de datos y phpMyAdmin
• npm run localdev → todo junto, usando concurrently