Synthetic properties support

[jakubkulhan]

Beside properties, it should be possible to annotate also getters and setters with annotations like @PhpArrayOffset, @JsonProperty etc. to support non-trivial cases.

Use cases:

• properties as a functions of other properties

class User
{
    /** @var string */
    public $firstName;

    /** @var string */
    public $lastName;

    /**
     * @return string
     *
     * @PhpArrayOffset("name")
     */
    public function getName()
    {
        return sprintf("%s %s", $this->firstName, $this->lastName);
    }
}

$user = new User();
$user->firstName = "Jakub";
$user->lastName = "Kulhan";

UserMeta::toArray($user);
// ["firstName" => "Jakub", "lastName" => "Kulhan", "name" => "Jakub Kulhan"]

• legacy property names

class Product
{
    /** @var string */
    public $description;

    /**
     * @return string
     *
     * @PhpArrayOffset("descr")
     */
    public function getDescr()
    {
        return $this->description;
    }
}

• convert between non-trivial sub-objects (can only be get/set), e.g. Skrz XML feed (hierarchy deal->variants, https://muj.skrz.cz/doc/xml-feed-rival) vs. Sdovolena XML feed (hierarchy tour->term_groups->terms, https://muj.skrz.cz/doc/xml-feed-sdovolena)

class Product
{
    /** @var Variant */
    public $variants;

    /**
     * @return TermGroup[]
     *
     * @PhpArrayOffset("term_groups")
     */
    public function getTermGroups()
    {
        // converts Variants to TermGroups
    }

    /**
     * @var TermGroup[]
     * @return void
     *
     * @PhpArrayOffset("term_groups")
     */
    public function setTermGroups($termGroups)
    {
        // converts TermGroups to Variants
    }
}