oscar car rental

Alquiler de coches Óscar

Docker ejecutando Nginx, PHP-FPM, Composer, MySQL y PHPMyAdmin.

Descripción general

1. Instalar requisitos previos

   Antes de instalar el proyecto, asegúrese de que se hayan cumplido los siguientes requisitos previos.

2. Clonar el proyecto

   Descargaremos el código de su repositorio en GitHub.

3. Ejecute la aplicación

   En este punto tendremos todas las piezas del proyecto en su lugar.

4. Usar comandos de Docker

   Cuando se ejecuta, puede usar los comandos de Docker para realizar operaciones recurrentes.

5. Solicitud de prueba

---

Instalar requisitos previos

Para ejecutar los comandos de la ventana acoplable sin usar sudo, debe agregar el grupo de la ventana acoplable a su usuario :

 sudo usermod -aG docker your-user

Por ahora, este proyecto ha sido creado principalmente para Unix (Linux/MacOS) . Quizás podría funcionar en Windows.

Todos los requisitos deben estar disponibles para su distribución. Los más importantes son:

• git
• Estibador
• Composición acoplable

Compruebe si docker-compose ya está instalado ingresando el siguiente comando:

which docker-compose

Verifique la compatibilidad de Docker Compose:

• Referencia de la versión 3 del archivo de redacción

En Ubuntu y Debian, estos están disponibles en el metapaquete build-essential. En otras distribuciones, es posible que necesites instalar el compilador GNU C++ por separado.

sudo apt install build-essential

Imágenes para usar

• nginx
• mysql
• PHP-FPM
• Compositor
• PHPMyAdmin

Debes tener cuidado al instalar servidores web de terceros como MySQL o Nginx.

Este proyecto utiliza los siguientes puertos:

Servidor	Puerto
mysql	8989
PHPMyAdmin	8080
nginx	8000

---

Clonar el proyecto

Para instalar Git, descárgalo e instálalo siguiendo las instrucciones:

git clone https://github.com/sahedbs23/oscar-car-rental.git

Vaya al directorio del proyecto:

 cd oscar-car-rental

árbol de proyectos

 .
├── Makefile
├── README.md
├── data
│   └── db
│       ├── dumps
│       └── mysql
├── doc
├── docker-compose.yml
├── etc
│   ├── nginx
│   │   ├── default.conf
│   │   └── default.template.conf
│   ├── php
│   │   └── php.ini
│   └── ssl
└── web
    ├── app
    │   ├── composer.json.dist
    │   ├── phpunit.xml.dist
    │   ├── src
    │   │   └── App.php
    │   └── test
    │       └── bootstrap.php
    └── public
        └── index.php

1. Inicie la aplicación:

   docker-compose up -d

   Espere, esto puede tardar varios minutos...

   docker-compose logs -f # Follow log output

2. Abre tu navegador favorito:

   • http://localhost:8000
   • http://localhost:8080 PHPMyAdmin (nombre de usuario: dev, contraseña: dev)

3. Detener y borrar servicios

   docker-compose down -v

---

Usar comandos de Docker

Instalando paquete con compositor

docker run --rm -v $( pwd ) /web/app:/app composer require symfony/yaml

Actualizando dependencias de PHP con Composer

docker run --rm -v $( pwd ) /web/app:/app composer update

Probando una aplicación PHP con PHPUnit

docker-compose exec -T php ./app/vendor/bin/phpunit --colors=always --configuration ./app

Analizando el código fuente con PHP Mess Detector

docker-compose exec -T php ./app/vendor/bin/phpmd ./app/src text cleancode,codesize,controversial,design,naming,unusedcode

Comprobando las extensiones PHP instaladas

docker-compose exec php php -m

Manejo de base de datos

Acceso al shell MySQL

docker exec -it mysql bash

y

mysql -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " 

Crear una copia de seguridad de todas las bases de datos.

mkdir -p data/db/dumps

 source .env && docker exec $( docker-compose ps -q mysqldb ) mysqldump --all-databases -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " > " data/db/dumps/db.sql " 

Restaurar una copia de seguridad de todas las bases de datos.

 source .env && docker exec -i $( docker-compose ps -q mysqldb ) mysql -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " < " data/db/dumps/db.sql " 

Crear una copia de seguridad de una única base de datos

Notice: reemplace "YOUR_DB_NAME" por su nombre personalizado.

 source .env && docker exec $( docker-compose ps -q mysqldb ) mysqldump -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " --databases YOUR_DB_NAME > " data/db/dumps/YOUR_DB_NAME_dump.sql " 

Restaurar una copia de seguridad de una única base de datos

 source .env && docker exec -i $( docker-compose ps -q mysqldb ) mysql -u " $MYSQL_ROOT_USER " -p " $MYSQL_ROOT_PASSWORD " < " data/db/dumps/YOUR_DB_NAME_dump.sql " 

Ejecute la aplicación

La aplicación expuso algunos puntos finales de API

Notice: importe la colección de cartero desde api-doc/postman_collection.json

Notice: importe el entorno de cartero desde api-doc/postman_environment.json

Notice: una licencia de automóvil es única a nivel de base de datos. Puede importar el contenido del archivo solo una vez.

• OBTENGA http://localhost:8000/cars para ver una lista y buscar colecciones de automóviles.
• OBTENGA http://localhost:8000/cars/{car id} para leer detalles sobre un automóvil.
• PUBLICAR http://localhost:8000/cars para crear un automóvil nuevo.
• Obtenga http://localhost:8000/read-files para leer el contenido de los archivos CSV y JSON.
• PUBLICAR http://localhost:8000/write-files para importar el contenido de los archivos CSV y JSON a la base de datos.