6: Instala y configura un proyecto fresco de Laravel

 

Tutorial 6: Instala y configura un proyecto fresco de Laravel

Introducción

En este tutorial aprenderás a instalar y configurar un proyecto Laravel desde cero utilizando Composer. Laravel es el framework que servirá como base para integrar todas las tecnologías de nuestro stack, incluyendo Vue, Tailwind CSS e Inertia.

Requisitos previos

Antes de comenzar, asegúrate de tener instalado:

  • PHP (versión 8.0 o superior)

  • Composer (gestor de dependencias para PHP)

  • Editor de código (Sublime Text, VS Code, PHPStorm, etc.)

Paso 1: Crear el proyecto con Composer

Abre tu terminal o línea de comandos y navega hasta la ubicación donde deseas crear tu proyecto. Luego ejecuta el siguiente comando:

bash
composer create-project laravel/laravel portfolio-cpa

Explicación del comando:

  • composer create-project: Crea un nuevo proyecto usando Composer

  • laravel/laravel: Especifica que queremos el paquete principal de Laravel

  • portfolio-cpa: Nombre de la carpeta donde se instalará el proyecto (puedes cambiar este nombre)

Nota: Este proceso puede tomar algunos minutos mientras Composer descarga todas las dependencias necesarias.

Paso 2: Verificar la instalación

Una vez completada la instalación, navega a la carpeta del proyecto:

bash
cd portfolio-cpa

Ahora ejecuta el servidor de desarrollo de Laravel:

bash
php artisan serve

Abre tu navegador y ve a: http://localhost:8000

Deberías ver la página de bienvenida predeterminada de Laravel, confirmando que la instalación fue exitosa.

https://laravel.com/img/docs/laravel-welcome.png

Paso 3: Configuración de la base de datos

Laravel viene configurado por defecto para usar MySQL, pero en este tutorial utilizaremos SQLite por su simplicidad.

3.1 Configurar SQLite

Abre el archivo .env en la raíz del proyecto y modifica la sección de base de datos:

env
# Comenta o elimina estas líneas
# DB_CONNECTION=mysql
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel
# DB_USERNAME=root
# DB_PASSWORD=

# Agrega esta línea para usar SQLite
DB_CONNECTION=sqlite

3.2 Crear el archivo de base de datos

Dentro de la carpeta database, crea un archivo vacío llamado database.sqlite:

bash
# En Windows
type nul > database/database.sqlite

# En macOS/Linux
touch database/database.sqlite

3.3 Verificar la configuración

Para confirmar que la base de datos está configurada correctamente, ejecuta:

bash
php artisan migrate

Si ves el mensaje "Nothing to migrate" o una salida exitosa, ¡la configuración está lista!

Paso 4: Explorando la estructura del proyecto

Una vez instalado, tu proyecto tendrá la siguiente estructura:

text
portfolio-cpa/
├── app/                # Lógica principal de la aplicación
├── bootstrap/          # Archivos de inicio
├── config/             # Configuraciones del sistema
├── database/           # Migraciones, seeds y fábricas
│   └── database.sqlite # Base de datos SQLite
├── public/             # Archivos públicos (CSS, JS, index.php)
├── resources/          # Vistas, assets y archivos compilables
├── routes/             # Definición de rutas
├── storage/            # Archivos generados (logs, caché)
├── tests/              # Pruebas automatizadas
├── vendor/             # Dependencias de Composer
├── .env                # Configuración de entorno
└── artisan             # Herramienta CLI de Laravel

Paso 5: Verificar la versión de Laravel

Para confirmar la versión instalada:

bash
php artisan --version

Ejemplo de salida:

text
Laravel Framework 9.10.0

Nota importante: Si tienes una versión diferente (como la 10), no te preocupes. El curso está diseñado para funcionar desde la versión 9 en adelante. Las diferencias son mínimas y no afectarán el contenido.

Paso 6: Comandos útiles para el desarrollo

Servidor de desarrollo

bash
php artisan serve

Inicia el servidor local en http://localhost:8000

Cambiar el puerto

bash
php artisan serve --port=8080

Ver rutas disponibles

bash
php artisan route:list

Limpiar caché de configuración

bash
php artisan config:clear

Solución de problemas comunes

Composer no está instalado

Descarga e instala Composer desde: getcomposer.org

Error de permisos en Linux/macOS

bash
chmod -R 755 storage bootstrap/cache

Error "Class '...' not found"

Ejecuta:

bash
composer dump-autoload

Problemas con SQLite

Asegúrate de que PHP tenga habilitada la extensión SQLite en tu php.ini:

ini
extension=pdo_sqlite
extension=sqlite3

Resumen

¡Felicidades! Has instalado y configurado exitosamente un proyecto Laravel fresco. Ahora tienes:

✅ Una instalación completa de Laravel
✅ Configuración de base de datos SQLite
✅ Servidor de desarrollo funcionando
✅ Conocimiento de la estructura del proyecto

En la próxima clase instalaremos Laravel Jetstream, que nos permitirá integrar Tailwind CSS, Vue e Inertia para crear una interfaz moderna y potente.

Recursos adicionales

¿Tienes preguntas o comentarios? No dudes en consultar los cursos de fundamentos de Laravel para obtener una explicación más detallada de cada proceso

Comentarios

Publicar un comentario

Entradas más populares de este blog

Tareas con Laravel + Inertia + Jetstream

  Tareas con Laravel + Inertia + Jetstream 📋 Descripción del Proyecto Aplicación ultra simple de tareas: ✅ Agregar una tarea ✅ Ver una tarea guardada ✅ Almacenar en arreglo (sesión) ❌ Sin listas largas, sin editar, sin eliminar 🚀 1. INSTALACIÓN (PASO A PASO) 1.1 Crear proyecto bash # Crear proyecto Laravel 10 (compatible con PHP 8.0+) composer create-project laravel/laravel:^10.0 tareas-app composer create-project laravel/laravel tareas-app cd tareas-app 1.2 Instalar Jetstream con Inertia bash # Instalar Jetstream composer require laravel/jetstream # Instalar Jetstream con Inertia (sin equipos) php artisan jetstream:install inertia 1.3 Instalar dependencias frontend bash # Instalar paquetes NPM npm install # Compilar assets npm run build 1.4 Configurar entorno bash # Crear archivo .env cp .env.example .env copy .env.example .env # Generar clave php artisan key:generate # Configurar base de datos SQLite touch database/database.sqlite type nul > databas...
Leer más

HACER CAMBIOS-AL EJEMPLO POR DEFECTO

  Una vez que has configurado tu proyecto con Laravel, Inertia y el Starter Kit elegido, el siguiente paso es entender cómo modificar la página de bienvenida por defecto y empezar a construir tu aplicación. En el ecosistema de Laravel con Inertia, la página de bienvenida ya no es una plantilla Blade tradicional, sino un componente de Vue o React que funciona como el punto de entrada de tu interfaz. Aquí tienes un tutorial paso a paso para hacer tus primeros cambios. 🚀 Entendiendo la Estructura del Proyecto Con el Starter Kit de Laravel (que incluye Vue/React e Inertia), la página de bienvenida que ves al acceder a la raíz de tu proyecto ya no está en resources/views/welcome.blade.php . En su lugar, es un componente de frontend gestionado por Inertia . El punto de entrada del frontend : El archivo resources/js/app.js (o app.ts si usas TypeScript) es donde se configura y arranca la aplicación Inertia . El componente principal : La página de inicio se encuentra en resources/js/Page...
Leer más

Laravel + Inertia - ejemplo

  Perfecto! Vamos a construir un ejemplo mínimo y funcional con Laravel + Inertia + Vue 3 . El ejemplo tendrá: Un input para escribir una tarea. Un botón para guardar esa tarea. La tarea se almacenará en sesión (para no complicar con base de datos) y se mostrará debajo. 1. Estructura de archivos que vamos a tocar text routes/web.php → ruta principal app/Http/Controllers/TareaController.php → controlador resources/js/Pages/Tarea.vue → componente Vue (la vista) 2. Ruta y Controlador routes/web.php php <?php use App \ Http \ Controllers \ TareaController ; use Illuminate \ Support \ Facades \ Route ; Route :: get ( '/tarea' , [ TareaController :: class , 'index' ] ) -> name ( 'tarea.index' ) ; Route :: post ( '/tarea' , [ TareaController :: class , 'store' ] ) -> name ( 'tarea.store' ) ; app/Http/Controllers/TareaController.php php <?php namespace App \ Http \ Controllers ; use Illuminate \ Http \ ...
Leer más