phptraitor

A collection of traits for PHP >= 5.4. The aim is to provide a set of common used functionalities to improve productivity by reducing repetivite tasks like writing getters and setters.

At the moment this is in a very early alpha stage and experimental, so use at your own risk.

Example

Some quick examples so you get an idea what this is all about.

GetSet: Create setters and getters automatically

<?php
class Sample {
    use \Traitor\GetSet;

    /**
     * @ZendValidator("Between", options={"min":1,"max":10})
     */
    private $score;
}

The GetSet trait now reads the annotation of the fields and automatically provides a setter and a getter for the class Sample. If the setter is called, Zend_Validate_Between is called that will check if the passed value is between 1 and 10:

<?php
$sample = new Sample();
$sample->setScore(5); // will work
$sample->setScore(14); // will throw an InvalidArgumentException

SmartIterator: Convenience methods for iterators

class SampleIterator
    implements \Iterator 
{
    use Traitor\SmartIterator;
}

SampleIterator automatically implements all Iterator methods plus it provides an all(), any(), select() and map() method. You can also specify an anonymous guard function that will check all values that are added to the Iterator.

$smartIterator = new SampleIterator();
$smartIterator->setGuard(function($e) { return is_int($e); });
$smartIterator->add(5)->add(10)->add(15);
$smartIterator->all(function($e) { return $e < 12; }); // will return false, because not all elements are < 12
$smartIterator->any(function($e) { return $e < 12; }); // will return true, because there is at least one element < 12
$smartIterator->select(function($e) { return $e < 12; })->toArray(); // will return array(5, 10)
$smartIterator->map(function($e) { return $e*2; })->toArray(); // will return array(10, 20, 30)
$smartIterator->add('2'); // will fail, because the guard function evaluates to false

Installation

Add this to your composer.json:

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/moee/phptraitor"
    }
],
"require": {
    "moee/phptraitor": "dev-master"
}

Usage

For some examples on how to use phptraitor, see the phptraitor_demo repository.

Build Status