oscar car rental

Oscar Aluguel de Carros

Docker rodando Nginx, PHP-FPM, Composer, MySQL e PHPMyAdmin.

Visão geral

1. Pré-requisitos de instalação

   Antes de instalar o projeto, certifique-se de que os seguintes pré-requisitos foram atendidos.

2. Clonar o projeto

   Faremos download do código de seu repositório no GitHub.

3. Execute o aplicativo

   Neste ponto, teremos todas as peças do projeto no lugar.

4. Use comandos do Docker

   Durante a execução, você pode usar comandos docker para realizar operações recorrentes.

5. Aplicação de teste

---

Pré-requisitos de instalação

Para executar os comandos do docker sem usar sudo você deve adicionar o grupo docker ao seu usuário :

 sudo usermod -aG docker your-user

Por enquanto, este projeto foi criado principalmente para Unix (Linux/MacOS) . Talvez pudesse funcionar no Windows.

Todos os requisitos devem estar disponíveis para sua distribuição. Os mais importantes são:

• Git
• Docker
• Composição do Docker

Verifique se docker-compose já está instalado digitando o seguinte comando:

which docker-compose

Verifique a compatibilidade do Docker Compose:

• Referência da versão 3 do arquivo de composição

No Ubuntu e no Debian, eles estão disponíveis no metapacote build-essential. Em outras distribuições, pode ser necessário instalar o compilador GNU C++ separadamente.

sudo apt install build-essential

Imagens para usar

• Nginx
• MySQL
• PHP-FPM
• Compositor
• PHPMeuAdmin

Você deve ter cuidado ao instalar servidores web de terceiros, como MySQL ou Nginx.

Este projeto usa as seguintes portas:

Servidor	Porta
MySQL	8989
PHPMeuAdmin	8080
Nginx	8.000

---

Clonar o projeto

Para instalar o Git, baixe-o e instale seguindo as instruções:

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

Vá para o diretório do projeto:

 cd oscar-car-rental

Árvore do projeto

 .
├── 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 o aplicativo:

   docker-compose up -d

   Aguarde, isso pode levar alguns minutos...

   docker-compose logs -f # Follow log output

2. Abra seu navegador favorito:

   • http://localhost:8000
   • http://localhost:8080 PHPMyAdmin (nome de usuário: dev, senha: dev)

3. Parar e limpar serviços

   docker-compose down -v

---

Use comandos do Docker

Instalando pacote com compositor

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

Atualizando dependências do PHP com o compositor

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

Testando aplicação PHP com PHPUnit

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

Analisando código-fonte com PHP Mess Detector

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

Verificando extensões PHP instaladas

docker-compose exec php php -m

Manipulando banco de dados

Acesso ao shell MySQL

docker exec -it mysql bash

e

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

Criando um backup de todos os bancos de dados

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 " 

Restaurando um backup de todos os bancos de dados

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

Criando um backup de um único banco de dados

Notice: Substitua "YOUR_DB_NAME" pelo seu nome 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 " 

Restaurando um backup de um único banco de dados

 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 " 

Execute o aplicativo

O aplicativo expôs alguns endpoints de API

Notice: importe a coleção do carteiro de api-doc/postman_collection.json

Notice: importe o ambiente postman de api-doc/postman_environment.json

Notice: Uma licença de carro é única no nível do banco de dados. Você pode importar o conteúdo do arquivo apenas uma vez.

• GET http://localhost:8000/cars para listar e pesquisar coleções de carros.
• GET http://localhost:8000/cars/{car id} para ler detalhes sobre um carro.
• POST http://localhost:8000/cars para criar um novo carro.
• Obtenha http://localhost:8000/read-files para ler o conteúdo dos arquivos CSV e JSON.
• POST http://localhost:8000/write-files para importar o conteúdo dos arquivos CSV e JSON para o banco de dados.