oscar car rental

奧斯卡 租車

Docker 運行 Nginx、PHP-FPM、Composer、MySQL 和 PHPMyAdmin。

概述

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 組合

輸入以下指令檢查docker-compose是否已安裝：

which docker-compose

檢查 Docker Compose 相容性：

• 撰寫文件版本 3 參考

在 Ubuntu 和 Debian 上，這些可以在元包 build-essential 中找到。在其他發行版上，您可能需要單獨安裝 GNU C++ 編譯器。

sudo apt install build-essential

使用的影像

• nginx
• MySQL
• PHP-FPM
• 作曲家
• PHP我的管理員

安裝第三方 Web 伺服器（例如 MySQL 或 Nginx）時應小心。

此項目使用以下連接埠：

伺服器	港口
MySQL	8989
PHP我的管理員	8080
nginx	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 命令

使用 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 shell 訪問

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:汽車駕照在資料庫層級是唯一的。您只能從文件中匯入一次內容。

• GET http://localhost:8000/cars 以列出和搜尋汽車集合。
• GET 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 檔案內容匯入資料庫。