oscar car rental

Оскар Прокат автомобилей

Docker работает под управлением Nginx, PHP-FPM, Composer, MySQL и PHPMyAdmin.

Обзор

1. Установить необходимые компоненты

   Перед установкой проекта убедитесь, что выполнены следующие предварительные условия.

2. Клонировать проект

   Мы загрузим код из репозитория на GitHub.

3. Запустите приложение

   К этому моменту у нас будут готовы все части проекта.

4. Используйте команды Docker

   Во время работы вы можете использовать команды Docker для выполнения повторяющихся операций.

5. Тестовое приложение

---

Установить необходимые компоненты

Чтобы запускать команды docker без использования sudo, вы должны добавить группу docker в свой-user :

 sudo usermod -aG docker your-user

На данный момент этот проект в основном создан для Unix (Linux/MacOS) . Возможно, это могло бы работать в Windows.

Все реквизиты должны быть доступны для вашего дистрибутива. Наиболее важными являются:

• Гит
• Докер
• Докер Составление

Проверьте, установлен ли docker-compose , введя следующую команду:

which docker-compose

Проверьте совместимость Docker Compose:

• Справка по созданию файла версии 3

В Ubuntu и Debian они доступны в мета-пакете build-essential. В других дистрибутивах вам может потребоваться установить компилятор GNU C++ отдельно.

sudo apt install build-essential

Изображения для использования

• Нгинкс
• MySQL
• PHP-FPM
• Композитор
• PHPMyAdmin

Будьте осторожны при установке сторонних веб-серверов, таких как MySQL или Nginx.

В этом проекте используются следующие порты:

Сервер	Порт
MySQL	8989
PHPMyAdmin	8080
Нгинкс	8000

---

Клонировать проект

Чтобы установить Git, загрузите его и установите, следуя инструкциям:

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

Перейдите в каталог проекта:

 cd oscar-car-rental

Дерево проекта

 .
├── 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. Запустите приложение:

   docker-compose up -d

   Пожалуйста, подождите, это может занять несколько минут...

   docker-compose logs -f # Follow log output

2. Откройте ваш любимый браузер:

   • http://локальный хост:8000
   • http://localhost:8080 PHPMyAdmin (имя пользователя: dev, пароль: dev)

3. Остановить и очистить службы

   docker-compose down -v

---

Используйте команды Docker

Установка пакета с помощью композитора

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

Обновление зависимостей PHP с помощью композитора

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

Тестирование PHP-приложения с помощью PHPUnit

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

Анализ исходного кода с помощью PHP Mess Detector

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

Проверка установленных расширений PHP

docker-compose exec php php -m

Обработка базы данных

Доступ к оболочке MySQL

docker exec -it mysql bash

и

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

Создание резервной копии всех баз данных

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 " 

Восстановление резервной копии всех баз данных

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

Создание резервной копии одной базы данных

Notice: Замените «YOUR_DB_NAME» на свое собственное имя.

 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 " 

Восстановление резервной копии одной базы данных

 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 " 

Запустите приложение

Приложение предоставило несколько конечных точек API.

Notice: Импортируйте коллекцию почтальонов из api-doc/postman_collection.json.

Notice: Импортируйте среду почтальона из api-doc/postman_environment.json.

Notice: Автомобильные права являются уникальными на уровне базы данных. Вы можете импортировать содержимое из файла только один раз.

• ПОЛУЧИТЕ http://localhost:8000/cars для получения списка и поиска коллекций автомобилей.
• ПОЛУЧИТЕ http://localhost:8000/cars/{car id}, чтобы прочитать подробную информацию об автомобиле.
• POST http://localhost:8000/cars Чтобы создать новую машину.
• Получите http://localhost:8000/read-files, чтобы прочитать содержимое файлов CSV и JSON.
• POST http://localhost:8000/write-files для импорта содержимого файлов CSV и JSON в базу данных.