الصفحة الرئيسية>المتعلقة بالبرمجة>بايثون
تنزيل

مشروع DDD PHP الافتراضي باستخدام Docker + PHPUnit + PHPCS + Symfony Flex (كأداة للبنية التحتية)

الهيكل الأساسي الذي يحتوي على نقطة نهاية /_healthcheck فقط، ويتضمن:

  • بدء تشغيل Dockerized (باستخدام PHP-FPM، تحقق من مجلد /docker و README.md الموجود هناك).
  • PHPUnit (قم بتشغيل bin/phpunit لاجتياز اختبارات الوحدة).
  • PHPCS (ارتباط رمزي إلى /vendor/bin/phpcs ، قم بتشغيل bin/phpcs لتشغيل أداة اكتشاف الأكواد بناءً على معيار PSR2).

إذا كنت تريد تضمين Redis في مشروعك، فقم بتشغيل docker-compose -f docker-compose-with-redis.yml up -d

متطلبات

عامل ميناء

تثبيت

  1. في المجلد الجذر، قم بتشغيل: docker-compose up -d وانتظر حتى يتم تثبيت كافة الحزم المطلوبة.
  2. ادخل إلى الجهاز ( docker exec -ti mylocalproject-php-fpm bash ) وقم بتشغيل composer install من الداخل
  3. انتقل إلى localhost:8000/_healthcheck، حيث يجب أن تكون قادرًا على رؤية هذا الإخراج: 
{
    "status" : " i am ok "
}

الآن، الأمر متروك لك تمامًا كيف تريد أن ينمو مشروعك :)

الذهاب إلى الإنتاج

إذا كنت تعتبر بيئة الإرساء جيدة بما يكفي للإنتاج، فتذكر هاتين الخطوتين:

  1. قم بتشغيل composer install --no-dev --optimize-autoloader --apcu-autoloader
  2. تذكر تغيير APP_ENV إلى pro داخل ملف .env .

يمكنك رؤية أداء جيد إلى حد معقول من خلال تنفيذ أداة Apache Bench، مع حوالي 100 طلب في 10 ثوانٍ متزامنة: ab -n 100 -c 10 http://localhost:8000/_healthcheck

هندسة المشروع

تم تصميم هذا المشروع وفقًا لنمط DDD + CQRS، والذي سيحتوي على ثلاثة أجزاء رئيسية:

  • المجال : يمثل مفاهيم الأعمال ومنطق الأعمال. ولا ينبغي أن يعرف أي شيء عن الأجزاء الأخرى.
  • التطبيق : يحدد المهام وينسق كائنات المجال لحل المشكلات. يمكنه فقط معرفة Domain .
  • البنية التحتية : مسؤول عن واجهة المستخدم (وحدات التحكم) / وحدة التحكم / اهتمامات الأطراف الثالثة. يمكن أن يعرف هذا عن Application Domain .

هيكل المشروع

توسيع البنية السابقة، هذا هو هيكل المجلد الرئيسي داخل المشروع 

 Domain
└─── Exception: Contains `AppException`, responsible for any exception about the application which
|                will contain an internal error code, plus a collection of `ErrorCodes` along the app
|                (important, taking into account that e.g. HTTP error codes sometimes are not informative enough)
|
└─── Model: Core business logic within the aplication, which will also contain validations for correctness.
|           In case that we use events through the system (e.g. creation, updates...) they would be placed here as well.
|           It will contain behavior and data, following[DomainModel](https://martinfowler.com/eaaCatalog/domainModel.html) Martin Fowler's pattern 
|
└─── Repository: Interfaces to access the data model that shall be viewed as a Collection,  with a composition as follows:
     └─── `findOfId`: Find a specific Model from a given unique ID. Ideally returns a Domain exception when not found
     └─── `findOfXxx`: Find the Model through an unique ID
     └─── `save`: responsible of create/update the model
     └─── `delete`: responsible of delete the model from the collection


Application
└─── Command: Executes an use case by orchestrating domain objects, and ideally produces an output in the shape of an event
|    └─── Request: Value objects representing a request per command
|
└─── Query: Implementation of specialized queries (anything different of a `findOfId`) to the model.
     |      Note: those are part of the Application because the Domain should not be aware at all about the expected Responses
     └─── Request: Value objects representing a request per query
     └─── Response: Set of Value Objects which we expect to obtain as a result of the query, ideally implementing a `Serializable`


Infrastructure
└───  EventListener: Even though those could be part of the Application layer (as actors regarding different events), 
|                    right now they are an infrastructure concern as the infra too is implemented as an Event schema.
|                    This could be different depending on your framework of choice (e.g. in Zend they would be middlewares)
|
└───  Repository: Contains folders with the different sources of implementation per repository (e.g, `MySqlUsersRepository`)
|
└───  Service: Third-party specific implementations of services and connectors (REST, MongoDB, Stripe...)
|
└───  Ui: Contains the user interface communication, mainly Console commands (cron/daemons) and Web commands (controllers)
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل