Download the PHP package cviebrock/eloquent-typecast without Composer

On this page you can find all versions of the php package cviebrock/eloquent-typecast. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package eloquent-typecast

EloquentTypecast

A trait that allows a Laravel project's Eloquent models to cast attribute values to native PHP variable types.

Latest Stable Version Total Downloads

Background: Why Do I Need This?

For some database drivers, all the attributes you get back from a query are returned as strings, even when the underlaying column-type is INTEGER or FLOAT or BOOLEAN.

Rather than have to use these "integer-looking" strings, etc., and rely on PHP's type-juggling, this trait will cast those attribute values to the proper native PHP variable type automagically for you.

This is also going to be very handy if you are, say, building an API and would like to just return JSON-versions of Eloquent models. Using this trait, all the JSON elements are going to be the right type for consumers of your API -- instead of all strings -- saving them type-juggling on their end.

Note: I believe if you are using the mysqlnd drivers in your PHP installation, then you don't need this trait as mysqlnd handles this type casting for you. Try it out by doing a var_dump($model->getKey()). If it shows that the value is an integer, you don't need this package. If it shows it's a string, read on.

Installation & Requirements

In your project's composer.json file:

In your project's models (or your own base model):

That's it. No service providers or facades required. Because it's a trait, however, you will need to be running PHP 5.4 or later.

Usage

Anytime you request an attribute listed in the $cast array, it will be converted from the (usually) string that your database returned into a the native PHP variable type you specified.

The keys of the $cast array are the attribute (i.e. column) names, and the values are the types you want to cast to. Anything supported by PHP's settype() function is valid ... although casting to arrays, objects, or null could be problematic.

If you set the $castOnSet property on your model to true, then setting an attribute that's in the $cast array will typecast that value before setting it. For example:

In general, this setting isn't really necessary as Laravel and most databases will handle the string-to-column-type conversion for you on save. However, maybe there are cases where it's useful, so it's added for "feature completion".

Notes

Because of the way the trait works, you should make sure that your $cast array does not include:

$model->toArray() triggers the casting as well. $model->getAttributes(), however, does not. It returns the raw values from the query (not even the date mutation).

Bugs, Suggestions and Contributions

Please use Github for bugs, comments, suggestions.

  1. Fork the project.
  2. Create your bugfix/feature branch and write your (well-commented) code.
  3. Create unit tests for your code:
    • Run composer install --dev in the root directory to install required testing packages.
    • Add your test methods to eloquent-typecast/tests/TypecastTest.php.
    • Run vendor/bin/phpunit to the new (and all previous) tests and make sure everything passes.
  4. Commit your changes (and your tests) and push to your branch.
  5. Create a new pull request against the develop branch.

Please note that you must create your pull request against the develop branch.

Copyright and License

Eloquent-Typecast was written by Colin Viebrock and released under the MIT License. See the LICENSE.md file for details.

Copyright 2014 Colin Viebrock


All versions of eloquent-typecast with dependencies

PHP Build Version
Package Version
Requires php Version >=5.4.0
illuminate/database Version 4.*
illuminate/support Version 4.*
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package cviebrock/eloquent-typecast contains the following files

Loading the files please wait ....