Download the PHP package thinktomorrow/magic-attributes without Composer
On this page you can find all versions of the php package thinktomorrow/magic-attributes. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download thinktomorrow/magic-attributes
More information about thinktomorrow/magic-attributes
Files in thinktomorrow/magic-attributes
Package magic-attributes
Short Description Magic assistance for retrieving nested properties
License MIT
Homepage https://github.com/thinktomorrow/magic-attributes
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 magic-attributes
This repository is archived in favor of our new dynamic-attributes repository which provides the same behaviour. Please consider using this package instead since magic attributes will no longer be maintained.
Magic attributes
Retrieve nested property values via dot syntax.
Working with multi-level arrays or objects, it can sometimes prove to be an annoyance to get just that deeper lying property value. You need to manually go through each level. This package provides an easy api for fetching these nested values. Instead of doing something like this:
With this package you could do it like this:
Trait
In order to add the functionality, you need to add a trait to your class. Here's an example:
Magic properties
If you'd like to fetch your values as if they are top level properties of your class, you could setup a __get and __isset method
in order to accomplish this. It can look something like this:
Strict retrieval
The package provides a single point of entry so by default you retrieve values via calling the attr method, e.g. $class->attr('foo.bar').
The benefit here is that this method is highly recognizable in the public api usage. The downside is that it does not strictly protects your class api and properties.
One way of dealing with this is restricting the public usage of the attr method and providing your own public api.
Within the MagicAttributes trait, you will find a disallow_magic_api property which defaults to false. This should be set to true in order to prevent public usage of the attr method.
Any attempt in using this method, will now throw an DisallowedMagicAttributeUsage exception.
In your class you can make use of the magicAttribute method which has the same signature as the attr method but
which is a protected method and can only be used by the internal api.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.
