Tutorial 3: Instalar Laravel 8 y Crear la Base de Datos

3: Instalar Laravel 8 y Crear la Base de Datos

1. Introducción

En este tutorial instalaremos Laravel 8 paso a paso y crearemos la base de datos que utilizaremos para nuestro sistema de citas médicas. Aprenderemos a configurar el entorno de desarrollo y a vincular el proyecto con la base de datos.

---

2. Requisitos Previos

Antes de comenzar, asegúrate de tener instalado:

• PHP 7.3 o superior (con extensiones necesarias)

• Composer (gestor de dependencias)

• Servidor web (XAMPP, WAMP, Laragon o similar)

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

---

3. Instalación de Laravel 8 con Composer

Paso 1: Abrir la terminal en la carpeta de proyectos

Dependiendo de tu servidor local, la carpeta puede ser:

Servidor	Ruta de proyectos
XAMPP	C:\xampp\htdocs\
WAMP	C:\wamp\www\
Laragon	C:\laragon\www\

En este ejemplo usaremos XAMPP. Abre la terminal o símbolo del sistema y navega a la carpeta:

bash

cd C:\xampp\htdocs

Paso 2: Crear el proyecto con Composer

Ejecuta el siguiente comando para instalar Laravel 8:

bash

composer create-project --prefer-dist laravel/laravel clinica-l8

Explicación del comando:

• composer create-project → Crea un nuevo proyecto

• --prefer-dist → Descarga la versión comprimida (más rápida)

• laravel/laravel → El paquete de Laravel

• clinica-l8 → El nombre de nuestro proyecto

⏱️ Nota: La instalación puede tardar unos minutos dependiendo de tu conexión a internet.

Paso 3: Verificar la instalación

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

bash

cd clinica-l8

Para verificar que todo funciona correctamente, inicia el servidor:

bash

php artisan serve

El servidor se iniciará en http://127.0.0.1:8000. Si ves la pantalla de bienvenida de Laravel, ¡la instalación fue exitosa!

---

4. Estructura del Proyecto

Después de la instalación, el proyecto tendrá esta estructura básica:

text

clinica-l8/
├── app/               # Lógica principal
├── bootstrap/         # Archivos de arranque
├── config/            # Configuraciones
├── database/          # Migraciones y seeders
│   └── migrations/    # Migraciones por defecto
├── public/            # Archivos públicos
│   ├── index.php      # Punto de entrada
│   └── ...
├── resources/         # Vistas y assets
├── routes/            # Definición de rutas
│   └── web.php        # Rutas web
├── storage/           # Archivos temporales
├── tests/             # Pruebas
├── .env               # Variables de entorno
├── .env.example       # Ejemplo de .env
└── composer.json      # Dependencias del proyecto

---

5. Creación de la Base de Datos

Método 1: Con phpMyAdmin (Recomendado)

1. Abre tu navegador y ve a: http://localhost/phpmyadmin

2. Haz clic en la pestaña "Nueva" o "New" en el panel izquierdo

3. Escribe el nombre de la base de datos:

   text

   clinica_l8

4. Selecciona la codificación: utf8_general_ci

5. Haz clic en "Crear"

Método 2: Con línea de comandos MySQL

Abre la terminal MySQL:

bash

mysql -u root -p

Luego ejecuta:

sql

CREATE DATABASE clinica_l8 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Nota: Si tienes contraseña para el usuario root, ingrésala cuando se te solicite.

---

6. Configurar la Base de Datos en Laravel

Paso 1: Crear el archivo .env

El archivo .env contiene la configuración del entorno. Si no existe, cópialo desde el ejemplo:

bash

cp .env.example .env

Paso 2: Editar las variables de base de datos

Abre el archivo .env en tu editor de código y busca la sección de base de datos. Configura los valores según tu entorno:

env

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=clinica_l8
DB_USERNAME=root
DB_PASSWORD=

Si usas Windows y no tienes contraseña, déjalo vacío.

Si usas Linux/Mac o tienes contraseña configurada, coloca la contraseña correcta.

Paso 3: Generar la clave de la aplicación

Ejecuta este comando para generar la APP_KEY automáticamente:

bash

php artisan key:generate

Verás un mensaje como:

text

Application key set successfully.

Esto añade automáticamente la clave al archivo .env.

---

7. Verificar la Conexión a la Base de Datos

Opción 1: Con el comando de migración

Laravel incluye migraciones por defecto. Para verificar que la conexión funciona:

bash

php artisan migrate

Si todo está bien, verás que las tablas se crean en tu base de datos.

Opción 2: Con Tinker (consola interactiva)

bash

php artisan tinker

Luego ejecuta:

php

DB::connection()->getPdo();

Si no hay errores, la conexión es exitosa.

---

8. Verificación desde el Navegador

Para ver que Laravel está instalado correctamente:

1. Asegúrate de que el servidor esté en ejecución:

   bash

   php artisan serve

2. Abre tu navegador y visita:

   text

   http://127.0.0.1:8000

3. También puedes acceder mediante la ruta pública (si no usas serve):

   text

   http://localhost/clinica-l8/public

---

9. Resumen Visual del Proceso

text

┌─────────────────────────────────────────────────────────────┐
│                    INSTALACIÓN LARAVEL 8                    │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. Crear proyecto                                         │
│     composer create-project laravel/laravel clinica-l8    │
│                        ↓                                    │
│  2. Entrar a la carpeta                                    │
│     cd clinica-l8                                         │
│                        ↓                                    │
│  3. Configurar .env                                       │
│     DB_DATABASE=clinica_l8                               │
│     DB_USERNAME=root                                      │
│     DB_PASSWORD=                                         │
│                        ↓                                    │
│  4. Generar clave                                          │
│     php artisan key:generate                              │
│                        ↓                                    │
│  5. Verificar conexión                                    │
│     php artisan migrate                                   │
│                        ↓                                    │
│  6. Iniciar servidor                                      │
│     php artisan serve                                     │
│                                                             │
└─────────────────────────────────────────────────────────────┘

---

10. Solución de Problemas Comunes

Problema	Causa	Solución
Composer command not found	Composer no está instalado	Descargar e instalar Composer
Could not open input file	Permisos de carpeta	Asegurar permisos de escritura
Connection refused	Base de datos no iniciada	Iniciar MySQL en XAMPP/WAMP
Access denied for user	Credenciales incorrectas	Revisar .env y crear usuario en MySQL
public folder not found	Ruta incorrecta	Usar php artisan serve en lugar de URL directa

---

11. Comandos Rápidos de Referencia

bash

# Instalar Laravel 8
composer create-project --prefer-dist laravel/laravel clinica-l8

# Navegar al proyecto
cd clinica-l8

# Generar clave de aplicación
php artisan key:generate

# Iniciar servidor de desarrollo
php artisan serve

# Ejecutar migraciones
php artisan migrate

# Verificar conexión a base de datos
php artisan migrate:status

---

12. Conclusión

🎉 ¡Felicidades! Has instalado correctamente Laravel 8 y has creado la base de datos para tu sistema de citas médicas.

En el siguiente tutorial modificaremos la tabla de usuarios para adaptarla a nuestro sistema y comenzaremos a implementar los roles de usuario (administrador, doctor, secretaria, paciente)