Skip to content

CakePHP DTO plugin - quickly generate useful data transfer objects for your app (mutable/immutable)

License

Notifications You must be signed in to change notification settings

dereuromark/cakephp-dto

Repository files navigation

CakePHP DTO plugin

CI codecov Latest Stable Version Minimum PHP Version License Total Downloads Coding Standards

A Data Transfer Object (DTO) is an object used to pass typed data between layers in your application, similar in concept to Structs in C, Martin Fowler's Transfer Objects, or Value Objects.

The goal of this package is to structure "unstructured data", replacing simple (associative) arrays with a more speaking solution.

  • By making all fields typeable, we can be sure that their values are never something we didn't expect. Especially with modern PHP and more strict typehinting moving forward this is rather important to detect and fail early.
  • We can have full IDE autocomplete and typehinting.
  • We can use tools like PHPStan to statically analyze the code (more strictly).
  • We can simplify the logic where required fields will now just throw a meaningful exception.
  • We can work with different inflections of field names more easily.
  • Easy way of immutable DTOs with required fields, to trust them in following code.
  • Works out of the box with any value object that is serializable (either as array or string).

For more see Motivation and Background.

This plugin will provide you with a tool to quickly generate custom and optimized DTOs for your special use cases.

This branch is for use with CakePHP 5.0+. For details see version map.

Examples

Live examples in the Sandbox: Github Demo.

See Examples for basic, immutable and complex entity use cases. The generated demo DTOs of those are in tests/test_app/src/Dto/.

Note: Param/return types are enabled and strict types disabled by default.

Installation

You can install this plugin into your CakePHP application using Composer.

composer require dereuromark/cakephp-dto

Then load the plugin with the following command:

bin/cake plugin load CakeDto

Usage

See Docs for details.

About

CakePHP DTO plugin - quickly generate useful data transfer objects for your app (mutable/immutable)

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published