Download the PHP package flaviovs/yii2-data-transformation without Composer
On this page you can find all versions of the php package flaviovs/yii2-data-transformation. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download flaviovs/yii2-data-transformation
More information about flaviovs/yii2-data-transformation
Files in flaviovs/yii2-data-transformation
Package yii2-data-transformation
Short Description Data transformation behavior for Yii2 models
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 yii2-data-transformation
Data transformation behavior for Yii2 models
This extension provides a behavior that makes easy to add data-transformed attributes into Yii2 models. It does that by creating virtual attributes that automatically convert data back-and-forth upon set/get operations.
Common use cases:
-
You store dates in the database using Unix timestamps and/or date strings, but want to manipulate them as DateTime objects
-
Automatically data serialization
- Calculated attributes
See the Data Transformation section in the ActiveRecord documentation for more information about what problems this extensions helps you to solve.
Installation
How to use
This extension provides an abstract class that you can use to create data transformation attributes. In other words, you need to define your own behavior class to do the transformations you want (or look for one created by somebody else).
To create a data transformation class, extend from
\fv\yii\behaviors\DataTransformation and add the following methods:
-
transform($value)(required) - apply data transformation to original model value$value(e.g. a Unix timestamp) and return the transformed result (e.g. a\DateTimeImmutable). transformBack($value)(optional) - apply data transformation to a transformed value$value(e.g. a\DateTimeImmutable) and return the original model representation (e.g. a Unix timestamp). This method is optional -- the inherited implementation just cast$valuetostring.
NULL handling
By default data transformation methods will never receive null
values -- fv\yii\behaviors\DataTransformation will automatically
intercept then, and automatically return null. You can change this
behavior by setting $autoConvertNull to false in your class (in
which case, of course, your conversion methods must be prepared to
handle null values).
For example:
Model usage
When adding data-transformation behaviors to models, you should
specify the attributes to be transformed in an attributes key in the
configuration array. Attributes must be specified as key/value pair,
where key is the transformed (virtual) attribute, and value is the
original attribute.
Examples
Automatic date conversion
This behavior will allow \DateTime objects access to Unix
timestamps-based attributes:
Now on your model:
In your code:
