Download the PHP package fsubal/donphan without Composer
On this page you can find all versions of the php package fsubal/donphan. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fsubal/donphan
More information about fsubal/donphan
Files in fsubal/donphan
Package donphan
Short Description Utility traits for type-safe & immutable entity in PHP
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package donphan
Donphan
Utility traits for type-safe & immutable entity in PHP.
Install
https://packagist.org/packages/fsubal/donphan
Why Donphan ?
In PHP application without certain frameworks, arrays are often used as domain models.
When refactoring these mess (or migrating to completely new framework) seems too hard, Donphan may help you.
What Donphan does
It provides two utility traits.
\Donphan\Validatable: provides::validatemethod, and lifecycle hooks.\Donphan\Immutable: provides::fromfactory method.
Not perfect, but now you have type safety with ease.
How to use
- Define your own model class
use \Donphan\Immutableinside- Define
const REQUIRED = [...], andconst OPTIONAL = [...]if you want. - If you need, define
static functionsbeforeTypeCheckorafterTypeCheck(See Lifecycle methods)
Then, you can use YourClass::from(array $params) or YourClass::validate(array $params).
Type checking
Donphan supports these types.
mixedintfloatnumericstringbooleanarray- and any defined
classname.
numeric looks like an original type ? Yes, but it is just validated by is_numeric ( https://secure.php.net/manual/en/function.is-numeric.php ).
It is almost like int|string, useful for some ids in $_GET or $_POST or something.
These types are not supported.
nullobjectresourcecallableClosureExceptionError
Lifecycle methods
If you want to have default value ? Or if you allow additional validation to your Immutable object ?
Then, the lifecycle methods might be needed.
\Donphan\Validatable provides two lifecycle methods.
beforeTypeCheck: Executed just before type checking. It gets original params, and you must return anarray.afterTypeCheck: Executed just after type checking. It gets original params, and you must NOT return anything.
beforeTypeCheck is useful for mutating the original array, and afterTypeCheck is useful for performing additional validations.
Example below
Note that the url added in beforeTypeCheck is also type checked (if it is written in REQUIRED or OPTIONAL).
Requirements
PHP 5.6+ ( Needs to be writable const with array in classes )
LICENSE
This is licensed under MIT License.
