Download the PHP package rnr1721/le7-entify without Composer

le7-entify

Entify is entity framework for le7 PHP MVC framework or any PHP project

This project is a universal validator/converter. With it, it is possible to validate/normalize arrays. For example, you can use this project using the rules:

• Validate/render forms (and uploaded files)
• Validate/render arrays
• Validate/render data from the database

Requirements

• PHP 8.1
• Composer

Installation

Testing

Usage

1. Create rules in a class or array.
2. Create a DataProvider with Data
3. Get the entity
4. Get the verified entity

But it is basic usage. You can make more great things with Entify.

Rules in classes

For some reasons you may need to store rules in class, not in arrays. It great for storing rules for many-time usage from different places of your code. For example, we create file in namespaces Entities:

Thats all! Now we can use our rules. This example similar with previous example, but in this case we use rules model, not array:

DataProviders

By default you can use Array and Form providers in Entification class, but you can write own DataProviders (DataProviderInterface) or Renderers (EntityRendererInterface).

Rules

You can use many rules for validation and normalisation entities. Rules runs one-by-one, list of rules for each field is queue. For example, in this case filter 'filter' will run after 'convert'

Available filters

validate

This is validation filter. It uses le7-validator for validate, and you can read more about validation rules here: https://github.com/rnr1721/le7-validator

Required field. Can be: string

• required: The field must be filled
• min:{n}: Field value must be at least {n}
• max:{n}: Field value must be no more than {n}
• minlength:{n}: The length of the string field value must be at least {n}
• maxlength:{n}: The length of the string field value must be no more than {n}
• email: The field value must be a valid email address
• notempty: The field value must not be empty or contain only spaces
• numeric: Validates that only numeric data
• email_dns: validates the format of an email address and checks if the domain part of the email address has a valid DNS record
• url: Validate URL
• url_active: If URL address is valid and exists
• date: Validates that value is date
• date_format:{n}: Validates date format: Example: date_format:Y-m-d
• date_before:{n}: Validate date before some date. Example: date_before:2022-05-15
• date_after:{n}: Validate date after some date. Example: date_after:2022-05-15
• boolean: Validate boolean

for example:

label

This is label (human-readable name) of field. You can use gettext functions such as _('My great label') for internationalisation. It used by validator, when it form errors messages, or you can use it when you render entity in future.

Required field. Can be: string

for example:

check

This filter used for own callable for check field. Callable can return true if succes, or string as error.

Not-Required field. Can be: false or callable

default

If field not exists in entity, it will be added and when you will get entity, field will be present with this default value

Not-Required field Can be: mixed

convert

Convert value to some data type

Not-Required field Can be: string (values: 'int', 'string', 'bool', 'float', 'double', 'bool')

for example:

hide

Hide value in entity. You will get entity without value

Not-Required field Can be: true or false

for example:

escape

Value will be escaped with htmlspecialchars() function

Not-Required field Can be: true or false

for example:

allowed

This filter will process value with strip_tags PHP function

Not-Required field Can be: null or string - second argument for strip_tags function

for example:

filter

This filter allow to process value with your own callable. Callable need return mixed value

Not-Required field Can be: callable

for example:

string, int, float, null, array, object, resource, callable

This filter will throw exception if value will not be some type

ot-Required field Can be: null or true

meta

Any meta information for your purposes

Not-Required field Can be: mixed

Entities

If you make entity from array, or form or write your own DataProvider, you need to know that DefaultHandler need these types of arrays:

If you use this type of array:

You will got the error.

Use options while got entity

Steps in Default Handler while array of data come from DataProvider to Entity: (this processes run in EntityHandlerDefault, method handle()):

1. Check array format
2. Standartization (Check if in entity present all fields in rules or for redundant fields)
3. Validation (run validator for all entities)
4. Filters (run filters)
5. Remove hide ('hide') fields

In these example you can read how use some options: