---
title: "Introduction"
description: "Generic invocation and introspection of Backbone operations by id, with plain array parameters and structured failures"
type: "docs"
category: "doc"
tags: []
authors: [Anonymous]
date: "2026-10-10"
last_update: "2026-10-10"
time_minutes: 2
draft: false
unlisted: false
url: "https://www.derafu.dev/docs/core/backbone-dispatcher/introduction"
---

# Safely Invoke Any Backbone Operation, From Anywhere

[![GitHub](https://img.shields.io/badge/github-derafu%2Fbackbone--dispatcher-blue?logo=github)](https://github.com/derafu/backbone-dispatcher)
![GitHub last commit](https://img.shields.io/github/last-commit/derafu/backbone-dispatcher/main)
![CI Workflow](https://github.com/derafu/backbone-dispatcher/actions/workflows/ci.yml/badge.svg?branch=main&event=push)
![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/derafu/backbone-dispatcher)
![GitHub Issues](https://img.shields.io/github/issues-raw/derafu/backbone-dispatcher)
![Total Downloads](https://poser.pugx.org/derafu/backbone-dispatcher/downloads)
![Monthly Downloads](https://poser.pugx.org/derafu/backbone-dispatcher/d/monthly)

Generic invocation and introspection for [Backbone](https://www.derafu.dev/docs/core/backbone) services: turn any worker's operation into something safely callable by id, with plain array parameters, from outside PHP's own type system.

## Why

A [Backbone](https://www.derafu.dev/docs/core/backbone) worker's public methods are ordinary, statically-typed PHP methods — great for an in-process PHP caller, useless for anything else. Backbone Dispatcher adds a generic invocation layer on top: it turns a string operation id (`"package.component.worker::operation"`) plus a plain associative array of parameters into a real, reflection-resolved, type-coerced method call on the right worker, and turns whatever comes back — a return value **or** an uncaught exception — into a plain, serializable shape.

That is what makes it possible for a caller with no concept of PHP reflection, PHP's type system, or PHP exceptions — Python code across a [`phpy`](https://www.derafu.dev/docs/core/backbone-bridge-python) boundary, an HTTP client through [Backbone API](https://www.derafu.dev/docs/core/backbone-api), or anything else — to invoke any Backbone operation and get back a predictable, serializable answer either way.

## Installation

```bash
composer require derafu/backbone-dispatcher
```

## Requirements

PHP 8.5+. Depends on [`derafu/backbone`](https://www.derafu.dev/docs/core/backbone), [`derafu/cache`](https://www.derafu.dev/docs/core/cache) and [`derafu/translation`](https://www.derafu.dev/docs/core/translation).



---
Last updated on 10/10/2026