Crear una nueva aplicación

Requisitos

• Estar dentro del sistema operativo linux elegido y contar con un usuario con permisos de administrador (con acceso a comandos sudo).

• Contar con conexión a internet.

Procedimiento

1. Abrir una terminal de comandos (CLI)

2. Navegar al sitio en el que se creará la carpeta del proyecto, recomiendo hacerlo en la carpeta local del usuario (se puede cambiar la ubicación más tarde)

    cd /home/edwinhdz
   

3. Ejecutar el comando de creación del nuevo proyecto

    composer create-project laravel/laravel NombreDeLaAplicación
   

   Esto iniciará la descarga y configuración del framework para poder usarlo de inmediato. Una vez termine sin errores, podemos continuar con la configuración.

   💡

   Los errores más comunes de este paso se deben a la falta de librerías y/o herramientas necesarias. Para saber más de la falla, analiza el código de error que proporciona la terminal.

4. Abrir la carpeta del proyecto

   En el editor de código, navegar al menú archivo → abrir carpeta (o usar el atajo ctrl + k ctrl + o).

5. Copiar el archivo .env.example y renombrarlo como .env en la raíz de la carpeta, posteriormente modificar el archivo para incluir las variables de entorno:

    # Visible en la pestaña del navegador, correos y al compartir el enlace en redes
    APP_NAME="Nombre de la aplicación"
    # Zona horaria de la aplicación, necesario para gestionar fechas
    APP_TIMEZONE=America/Mexico_City
    # Idioma de la aplicación
    APP_LOCALE=es
    # Colocar la url en la que se trabajará (localhost/subdominio de trabajo/url final)
    APP_URL=http://dominio-de-prueba/aplicacion
    # Nombre de la conexión a base de datos, se creará en pasos posteriores
    DB_CONNECTION=nombre-de-la-conexión
    # Nombre de la base, se creará en pasos posteriores
    DB_DATABASE=nombre-de-la-base-de-datos
    # Usuario postgresql
    DB_USERNAME=usuario
    # Contraseña del usuario postgresql
    DB_PASSWORD=contraseña
   

6. Configurar la conexión de base de datos

   En el archivo config/database.php, ubicar la variable conenctions y crear/clonar tantos bloques de código como conexiones a bases de datos se necesiten. Esto nos permite usar más de una base de datos en la aplicación, solo asegúrate de usar el driver pgsql.

    'connections' => [
            'local-connection' => [
                'driver' => 'pgsql',
                'url' => env('DB_URL'),
                'host' => env('DB_HOST', '127.0.0.1'),
                'port' => env('DB_PORT', '5432'),
                'database' => env('DB_DATABASE_GENERAL'),
                'username' => env('DB_USERNAME'),
                'password' => env('DB_PASSWORD'),
                'charset' => env('DB_CHARSET', 'utf8'),
                'prefix' => '',
                'prefix_indexes' => true,
                'search_path' => 'public',
                'sslmode' => 'prefer',
            ],
            ...
            'remote-connection' => [
                'driver' => 'pgsql',
                'url' => env('DB_URL'),
                'host' => env('DB_HOST', '127.0.0.1'),
                'port' => env('DB_PORT', '5432'),
                'database' => env('DB_DATABASE_GENERAL'),
                'username' => env('DB_USERNAME'),
                'password' => env('DB_PASSWORD'),
                'charset' => env('DB_CHARSET', 'utf8'),
                'prefix' => '',
                'prefix_indexes' => true,
                'search_path' => 'public',
                'sslmode' => 'prefer',
            ],
    ]
   

   💡

   Si notas, estamos creando dos conexiones, una local y una remota, ambas usando postgresql y las variables de entorno previamente definidas en .env ; Los nombres de las conexiones son local-connection y remote-connection, son estos los que se deben configurar en el archivo .env del paso anterior.

7. Instalación de librerías adicionales

   Regresar a la terminal o abrir el terminal integrado de vscode con ctrl + ñ y asegurarse de estar dentro de la raíz de la carpeta del proyecto. Posteriormente, usar npm y/o composer para descargar lo necesario (cada proyecto es distinto y se pueden requerir más o menos librerías. Se listarán las básicas).

    npm install bootstrap@latest
    npm install jquery
    npm i @fortawesome/fontawesome-free
    composer require realrashid/sweet-alert
   

8. Incluir los archivos multimedia necesarios

   Si se tienen imágenes, videos o cualquier archivo estático que se requiera mostrar a los usuarios, este es un buen momento para incluirlos en el proyecto. Solo hay que copiar cada archivo a la carpeta public.

   💡

   Recomiendo estructurar los archivos usando screaming architecture. Para esto, dentro de la carpeta public se deberán incluir subcarpetas que enfaticen el propósito de los recursos (welcome-page, admin-dashboard, icons, emails,….)

9. Crear la base de datos

   Este paso puede ser un poco complejo si no se tiene experiencia con postgresql, por ello, recomiendo el uso de la interfaz gráfica para realizarlo. Cuida que el nombre de la base coincida con el que configuraste previamente en el archivo .env

10. Iniciar la base de datos

    Una vez la aplicación fue creada y configurada y tenemos la base de datos, hay que crear las mínimas tablas requeridas para que Laravel pueda funcionar. Para esto, dentro de una terminal en la raíz del proyecto, ejecutar el siguiente comando.

    # Para ver los comandos sql que serán ejecutados (útil para ver si hay errores)
    php artisan migrate --pretend
    # Realiza la ejecución
    php artisan migrate
    

    Si los comandos no tienen ningún error, la aplicación está lista para usarse.