PHPackages                             farafiri/class-generator-for-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. farafiri/class-generator-for-php

ActiveLibrary[Utility & Helpers](/categories/utility)

farafiri/class-generator-for-php
================================

Library for creating and autoloading classes for common patterns like decorator, null object, composite, lazy loading, proxy object

223PHP

Since Dec 2Pushed 9y ago1 watchersCompare

[ Source](https://github.com/farafiri/class-generator-for-php)[ Packagist](https://packagist.org/packages/farafiri/class-generator-for-php)[ RSS](/packages/farafiri-class-generator-for-php/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependenciesVersions (3)Used By (0)

class-generator-for-php
=======================

[](#class-generator-for-php)

Library for creating and autoloading classes for common patterns like decorator, null object, composite, lazy loading, proxy object All generated classes can be cached so there is no relevant performance impact.

Examples
========

[](#examples)

Let say you have following entity class. Note that the class is not complete (no properties declaration, etc) for sake of readability

```
class Book implements PriceInterface {
    public function __construct($id) {
        $this->id = $id;
        $this->loadPropertiesFromDb($id);
    }

    /**
     * @return \Author
     */
    public function getAuthor() {
        return new Author($this->authorId);
    }

    /**
     * @return int
     */
    public function getPrice() {
        return $this->price;
    }

    /**
     * @return \Tag[]
     */
    public function getTags() {
        return array_map(function($id) {return new Tag($id);}, $this->tagsIds);
    }
}
```

---

Decorating:

```
class DiscountDecorator extends ClassGenerator\BaseDecorator {
    const CG_DECORATED = 'PriceInterface'; //by default you can decorate any class. This const will restrict to given interface or class
    protected $discount;

    public function __construct($discount = 0.8) {
        $this->discount = $discount;
    }

    public function getPrice() {
        return ceil($this->cgDecorated->getPrice() * $this->discount);
    }
}

$book = new DecorableBook($id);
$book->getPrice(); // 100
$book->cgDecorate(new DiscountDecorator(0.9));
$book->getPrice(); // 90

$book instanceof Book //return true
```

---

NullObject:

```
$book = new NullBook($id);
//null object gets expected result type from phpDoc and returns proper empty value
$book->getPrice(); // 0
$book->getTags(); // array()
$book->getAuthor(); // NullAuthor
```

---

LazyConstructor:

```
$book = new LazyConstructorBook($id);
//no DB query performed yet
$book->getPrice();
//retrieved data from DB and proper price returned
```

---

Lazy:

```
$book = new LazyBook($id);
//OR
$book = new LazyBook::cgGet(function() { return new Book($id); });
//no DB query performed yet
$book->getPrice();
//retrieved data from DB and proper price returned
```

Difference between lazy and lazyConstructor:

```
$lazyConstructorBook = new LazyConstructorBook($id); //no DB query performed yet
$lazyBook = new LazyBook($id); //no DB query performed yet

$author1 = $lazyConstructorBook->getAuthor(); // 2 queries performed (book and author)
$author2 = $lazyBook->getAuthor(); // still no queries performed (LazyAuthor returned)
$author2->getFirstName(); //retrieve book and author data
```

---

Composite:

```
$book1 = new Book(1);
$book2 = new Book(2);

$composite = new CompositeBook(array($book1, $book2));

$composite->getAuthor(); //will return composite of book authors (new CompositeAuthor(array($book1->getAuthor(), $book2->getAuthor())))
$composite->getTags(); //will return all tags (array_merge($book1->getTags(), $book2->getTags()))
$composite->getPrice(); // will return first value which evaluate to true
```

We may customize behaviour by adding @composite annotation For example: if we add @composite sum to price method then $composite->getPrice() will return sum of all prices

---

Set up
------

[](#set-up)

At first add into require in your composer.json: "farafiri/class-generator-for-php": "dev-master"

Next call \\ClassGenerator\\Autoloader::register in your code

```
\ClassGenerator\Autoloader::getInstance()->register();
//this is not a Singleton (you can create instance with new ..., also method setInstance is available)
//but i need instance getter and I don't want make this code DI container dependent
```

If you are using Symfony 2 check Doctrine\\README.md

This autoloader is not standalone - it wont load any classes from your php files, you need another loader for this task. It should be registered as last loader - otherwise it will create new class instead of loading it from your project files. (For example: if you have class \\Item and \\NullItem then on attempt to use \\NullItem it will generate new class instead of loading your implementation) Make sure your cache is off in development mode and on in production mode (clear cache with every change in your code). To turn cache on:

```
\ClassGenerator\Autoloader::getInstance()->setCachePath($cacheDirectoryPath)->setEnabledCache(true);
```

Its good to set $cachePath even if cache is not enabled - created classes will be saved and loaded from filesystem instead of simple code eval. Thanks to this in case of error error message will look like "Error in cacheFile.php on line X" instead of "Error in eval code" + your IDE should recognize these classes while they are in files.

###  Health Score

22

—

LowBetter than 23% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/ec7b6fe75e8ba3d550f2dc80526a74a90afad386140ecaa3fa9a808e5b5d83c2?d=identicon)[farafiri](/maintainers/farafiri)

---

Top Contributors

[![farafiri](https://avatars.githubusercontent.com/u/6407542?v=4)](https://github.com/farafiri "farafiri (102 commits)")

### Embed Badge

![Health badge](/badges/farafiri-class-generator-for-php/health.svg)

```
[![Health](https://phpackages.com/badges/farafiri-class-generator-for-php/health.svg)](https://phpackages.com/packages/farafiri-class-generator-for-php)
```

###  Alternatives

[froiden/laravel-installer

Laravel web installer

10883.9k](/packages/froiden-laravel-installer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)