oscar car rental

オスカー レンタカー

Nginx、PHP-FPM、Composer、MySQL、および PHPMyAdmin を実行する Docker。

概要

1. 前提条件をインストールする

   プロジェクトをインストールする前に、次の前提条件が満たされていることを確認してください。

2. プロジェクトのクローンを作成する

   GitHub 上のリポジトリからコードをダウンロードします。

3. アプリケーションを実行する

   この時点で、プロジェクトのすべての要素が整います。

4. Docker コマンドを使用する

   実行中に、docker コマンドを使用して繰り返し操作を行うことができます。

5. テストアプリケーション

---

前提条件をインストールする

sudo を使用せずに docker コマンドを実行するには、 dockerグループをyour-userに追加する必要があります。

 sudo usermod -aG docker your-user

今のところ、このプロジェクトは主に Unix (Linux/MacOS)向けに作成されています。おそらく Windows でも動作するかもしれません。

ディストリビューションに必要なものがすべて揃っている必要があります。最も重要なものは次のとおりです。

• Git
• ドッカー
• Docker Compose

次のコマンドを入力して、 docker-composeがすでにインストールされているかどうかを確認します。

which docker-compose

Docker Compose の互換性を確認します。

• Compose ファイル バージョン 3 のリファレンス

Ubuntu と Debian では、これらはメタパッケージ build-essential で入手できます。他のディストリビューションでは、GNU C++ コンパイラを個別にインストールする必要がある場合があります。

sudo apt install build-essential

使用する画像

• Nginx
• MySQL
• PHP-FPM
• 作曲家
• PHPMyAdmin

MySQL や Nginx などのサードパーティ Web サーバーをインストールする場合は注意が必要です。

このプロジェクトは次のポートを使用します。

サーバ	ポート
MySQL	8989
PHPMyAdmin	8080
Nginx	8000

---

プロジェクトのクローンを作成する

Git をインストールするには、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コマンドを使用する

Composer を使用してパッケージをインストールする

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

Composer を使用した PHP 依存関係の更新

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

PHPUnit を使用した PHP アプリケーションのテスト

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 から postman コレクションをインポートします

Notice: api-doc/postman_environment.json から postman 環境をインポートします

Notice:自動車免許はデータベース レベルで一意です。ファイルからコンテンツをインポートできるのは 1 回だけです。

• 車のコレクションをリストおよび検索するには、http://localhost:8000/cars を取得します。
• 車の詳細を確認するには、http://localhost:8000/cars/{car id} を取得します。
• http://localhost:8000/cars を POST して新しい車を作成します。
• http://localhost:8000/read-files を取得して、CSV および JSON ファイルの内容を読み取ります。
• http://localhost:8000/write-files を POST して、CSV および JSON ファイルの内容をデータベースにインポートします。