oscar car rental

أوسكار لتأجير السيارات

يقوم Docker بتشغيل Nginx وPHP-FPM وComposer وMySQL وPHPMyAdmin.

ملخص

1. تثبيت المتطلبات الأساسية

   قبل تثبيت المشروع تأكد من استيفاء المتطلبات الأساسية التالية.

2. استنساخ المشروع

   سنقوم بتنزيل الكود من مستودعه على GitHub.

3. قم بتشغيل التطبيق

   عند هذه النقطة سيكون لدينا جميع أجزاء المشروع في مكانها الصحيح.

4. استخدم أوامر دوكر

   عند التشغيل، يمكنك استخدام أوامر عامل الإرساء للقيام بعمليات متكررة.

5. تطبيق الاختبار

---

تثبيت المتطلبات الأساسية

لتشغيل أوامر عامل الإرساء دون استخدام sudo، يجب عليك إضافة مجموعة عامل الإرساء إلى المستخدم الخاص بك :

 sudo usermod -aG docker your-user

في الوقت الحالي، تم إنشاء هذا المشروع بشكل أساسي لنظام التشغيل Unix (Linux/MacOS) . ربما يمكن أن تعمل على نظام التشغيل Windows.

يجب أن تكون جميع المتطلبات متاحة للتوزيع الخاص بك. أهمها:

• بوابة
• عامل ميناء
• عامل الميناء يؤلف

تحقق مما إذا كان docker-compose مثبتًا بالفعل عن طريق إدخال الأمر التالي:

which docker-compose

التحقق من توافق Docker Compose :

• إنشاء مرجع للإصدار 3 من الملف

تتوفر هذه العناصر في Ubuntu وDebian في الحزمة التعريفية الأساسية. في التوزيعات الأخرى، قد تحتاج إلى تثبيت مترجم GNU C++ بشكل منفصل.

sudo apt install build-essential

الصور للاستخدام

• نجينكس
• ماي إس كيو إل
• PHP-التيار الوطني الحر
• الملحن
• PHPMyAdmin

يجب أن تكون حذرًا عند تثبيت خوادم ويب تابعة لجهات خارجية مثل MySQL أو Nginx.

يستخدم هذا المشروع المنافذ التالية:

الخادم	ميناء
ماي إس كيو إل	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://localhost:8000
   • http://localhost:8080 PHPMyAdmin (اسم المستخدم: dev، كلمة المرور: dev)

3. إيقاف ومسح الخدمات

   docker-compose down -v

---

استخدم أوامر دوكر

تثبيت الحزمة مع الملحن

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

Notice: قم باستيراد بيئة ساعي البريد من api-doc/postman_environment.json

Notice: رخصة السيارة فريدة على مستوى قاعدة البيانات. يمكنك استيراد المحتوى من الملف مرة واحدة فقط.

• احصل على http://localhost:8000/cars لقائمة مجموعات السيارات والبحث فيها.
• احصل على http://localhost:8000/cars/{car id} لقراءة تفاصيل السيارة.
• انشر http://localhost:8000/cars لإنشاء سيارة جديدة.
• احصل على http://localhost:8000/read-files لقراءة محتويات ملفات CSV وJSON.
• POST http://localhost:8000/write-files لاستيراد محتويات ملف CSV وJSON إلى قاعدة البيانات.