TRICKS.md

Kluzo PHP Debug Tool: Advanced Topics

How an old dog learns new tricks...

Inspector Tricks

You can add more features to your inspector by utilizing the list of Inspector Tricks. They are a collection of callbacks bound to the Inspector object, that you can extend and modify.

Learning new tricks

Here is a stupid example for a new method that will append "You Fool!"

kluzo::getTricks()->learnTrick('fool', function($pocketName, ...$things)
{
	$things[] = 'You Fool!';
	return $this->log($pocketName, ...$things);
});

That's it. The closures will be bound to the Inspector, so $this is going to be the Inspector object. Once it is added, you can call it like this

kluzo::fool('proba', 'I know that...');

And the logged details will be array('I know that...', 'You Fool!').

Forget tricks

I am not sure why, but you can also remove a trick by "forgetting" it:

kluzo::getTricks()->forgetTrick('fool');

"Same As" Tricks

Another thing you can do is to use several different trick names for the same feature as some sort of alias:

/* kluzo::report() will do the same as kluzo::log() */
kluzo::getTricks()->sameAs('log', 'report');
kluzo::report('proba', $proba);