aztech/carnival

Create static facades from instances

Carnival

, _(*1)

Carnival is a simple library to generate static facades from instance objects. In other words, it takes an object, hides it behind a generated static class, effectively transforming your object into a singleton as long as you access it from the static facade., _(*2)

Installation

Composer is the only supported way of installing and using Carnival. From your project's root directory, run:, _(*3)

composer require aztech/carnival

You must then include the Composer autoloader in the entry file of your application:, _(*4)

<?php

require_once __DIR__ . 'vendor/autoload.php';

Dafuq is wrong with you ?

Probably a lot of things. But that fails to answer the question, why this library. Because !, _(*5)

Ok, originally, I wrote it as a troll. But if anyone finds it useful, go ahead, have fun !, _(*6)

And you're using eval ?

Isn't that the root of all evil ? Probably, but it's used in a constrained way, and honestly, if you plan on passing tainted data to Masquerade, allow me to ask dafuq is wrong with you ?, _(*7)

So now that its uselessness is settled, how do I use it anyways ?

Simple, bind whatever object you want to a new, non-existing class name (you can even namespace your facade !) like that:, _(*8)

// This call is only required once, you can place it in your application bootstrap or wherever.
Aztech\Carnival\Masquerade::register(); 

// Bind an object to a class name
Aztech\Carnival\Masquerade::bind('\Facades\SomeArray', new \SplObjectStorage());

// Use your facade
Facades\SomeArray::attach(new \stdClass());

Yup, simple as that., _(*9)