PHPackages                             vairogs/functions-handler - 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. vairogs/functions-handler

Abandoned → [valksor/php-functions-handler](/?search=valksor%2Fphp-functions-handler)Library[Utility & Helpers](/categories/utility)

vairogs/functions-handler
=========================

A PHP library providing function handling utilities including a Chain of Responsibility pattern implementation and function execution utilities

00PHP

Since Apr 16Pushed 11mo agoCompare

[ Source](https://github.com/vairogs/functions-handler)[ Packagist](https://packagist.org/packages/vairogs/functions-handler)[ RSS](/packages/vairogs-functions-handler/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Vairogs Functions: Handler
==========================

[](#vairogs-functions-handler)

A PHP library providing function handling utilities including a Chain of Responsibility pattern implementation and function execution utilities.

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require vairogs/functions-handler
```

Requirements
------------

[](#requirements)

PHP 8.4 or higher

Usage
-----

[](#usage)

The Handler package provides several utilities for handling function execution and implementing the Chain of Responsibility pattern.

### Chain Class

[](#chain-class)

The Chain class implements a simple pipeline pattern for function composition:

```
use Vairogs\Functions\Handler\Chain;

// Create a new chain with an initial value
$chain = new Chain('initial value');

// Or use the static factory method
$chain = Chain::of('initial value');

// Pipe the value through a series of transformations
$result = $chain
    ->pipe(fn($value) => strtoupper($value))
    ->pipe(fn($value) => $value . ' - transformed')
    ->get();

// $result now contains "INITIAL VALUE - transformed"
```

### Handler Interface and AbstractHandler

[](#handler-interface-and-abstracthandler)

The Handler interface and AbstractHandler class implement the Chain of Responsibility pattern:

```
use Vairogs\Functions\Handler\AbstractHandler;
use Vairogs\Functions\Handler\Handler;

// Create custom handlers by extending AbstractHandler
class CustomHandler extends AbstractHandler
{
    public function handle(...$arguments): mixed
    {
        // Process the request
        $result = $this->processRequest(...$arguments);

        // If this handler can't process the request, pass it to the next handler
        if (null === $result) {
            return parent::handle(...$arguments);
        }

        return $result;
    }

    private function processRequest(...$arguments): mixed
    {
        // Custom processing logic
        // Return null if this handler can't process the request
    }
}

// Chain handlers together
$handler1 = new CustomHandler();
$handler2 = new AnotherCustomHandler();
$handler3 = new FinalHandler();

$handler1->next($handler2);
$handler2->next($handler3);

// Process a request through the chain
$result = $handler1->handle($request);
```

### FunctionHandler

[](#functionhandler)

The FunctionHandler executes a specified function as part of the chain:

```
use Vairogs\Functions\Handler\FunctionHandler;

// Create a handler for a global function
$handler = new FunctionHandler('strtoupper');
$result = $handler->handle('hello'); // Returns "HELLO"

// Create a handler for an object method
$object = new YourClass();
$handler = new FunctionHandler('methodName', $object);
$result = $handler->handle($arg1, $arg2); // Calls $object->methodName($arg1, $arg2)

// Chain with other handlers
$nextHandler = new AnotherHandler();
$handler->next($nextHandler);
$result = $handler->handle('hello'); // If the function returns null, passes to next handler
```

Features
--------

[](#features)

For a complete list of all classes and methods available in this package, see [Features](docs/features.md).

License
-------

[](#license)

This package is licensed under the [BSD-3-Clause License](LICENSE).

About Vairogs
-------------

[](#about-vairogs)

This package is part of the [vairogs/vairogs](https://github.com/vairogs/vairogs) project - a comprehensive PHP library and Symfony bundle that provides a collection of utilities, components, and integrations for Symfony applications.

The main project includes:

- Various utility functions and components
- Doctrine ORM tools and extensions
- API Platform integrations
- Symfony bundle for easy configuration
- And much more

If you find this Handler component useful, you might want to check out the full Vairogs project for additional tools and utilities that can enhance your Symfony application development.

To install the complete package:

```
composer require vairogs/vairogs
```

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 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/c4db85e32518c5a6caa2fd625032a2b016ef42d60cf8a101c165cc5c0048b221?d=identicon)[k0d3r1s](/maintainers/k0d3r1s)

---

Top Contributors

[![k0d3r1s](https://avatars.githubusercontent.com/u/38725938?v=4)](https://github.com/k0d3r1s "k0d3r1s (3 commits)")

### Embed Badge

![Health badge](/badges/vairogs-functions-handler/health.svg)

```
[![Health](https://phpackages.com/badges/vairogs-functions-handler/health.svg)](https://phpackages.com/packages/vairogs-functions-handler)
```

PHPackages © 2026

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