Download the PHP package magdicom/hooks without Composer

PHP Action Hooks

Inspired by WordPress, action hooks are functions that you define to be triggered in specific places of your code, it helps you maintain an organized code by slicing giant code blocks into separated files and/or classes.

Installation

You can install the package via composer:

Usage

Quick Start

The above example will output

Output

When you call any of toArray methods.

Callbacks

Closure

Function Name

Object Method

or

Static Method

in case this is not a static method, an object will be created and the provided method will be called.

Parameters

With each of hook callback functions execution an array of parameters could be passed to it to help it perform the required action.

Global Parameters

Global parameters could be defined using setParameters methods and these parameters will be available across all hook points and callbacks.

Scoped parameters

The opposite of global parameters, the scoped parameters only available for the specified action hook point, and could be provided as the second argument of last methods.

When you provide it as an array, the values of scoped parameters will temporarily replace (similar key entries) global parameters and passed to the register methods' callback as a merged array.

When the parameter provided as a class object it will be accessible from the register method as the first argument, and the global parameters will be accessible via the second argument.

Priority

When you need to ensure that certain hook functions should be executed in sequence order, here it comes $priority which is the 3rd and last argument of register method.

Methods

__construct

The class constructor method will optionally accept a name, value pair array.

register

Register all your hook functions via this method:

• $hookName this can be anything you want, its like a group name where all other related action hook functions will be attached to.
• $callback only accepts callable functions.
• $priority (optional) used to sort callbacks before being executed.

all

Will execute all callback functions of the specified hook name, by default it will return the output as string, check output section for more options.

• $hookName the hook name you want to execute its callback functions.
• $parameters optional key, value pair array (or object) that you want to provide for all callback functions related to the same hook point.

Please Note: parameters provided via this method will be available only in the scope of the specified hook point, to specify global parameters use setParameters methods instead.

first

Similar to all method in every aspect with the exception that only the first callback (after sorting) will be executed.

last

Similar to all method in every aspect with the exception that only the last callback (after sorting) will be executed.

toArray

Will return output of the last executed hook name functions as an array.

toString

Will return output of the last executed hook name functions as one string.

• $separator could be used to separate the output as you need (e.g: "\n", "<br>").

setParameter

Use this method to define a parameter that will be accessible from any hook function.

• $name name of the parameter.
• $value value of the parameter could be string, array or even an object.

P.S: if the parameter already defined then its old value will be replaced by the value provided here.

setParameters

Same as setParameter but here it accepts a name, value pair array as its only argument.

setSourceFile

Used in conjunction with the debug method.

debug

To enable the debug feature you need to call this method by providing a callback function, this function should accept a single argument that will be the debug info/message.

will output

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Credits

• Mohamed Magdi

License

The MIT License (MIT). Please see License File for more information.