PHPackages                             recoil/dev - 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. [Queues & Workers](/categories/queues)
4. /
5. recoil/dev

ActiveComposer-plugin[Queues & Workers](/categories/queues)

recoil/dev
==========

Development and debugging tools for Recoil applications.

0.4.2(4y ago)44.1k1[3 issues](https://github.com/recoilphp/dev/issues)[1 PRs](https://github.com/recoilphp/dev/pulls)2MITPHPPHP >=7.4

Since Dec 7Pushed 1y ago1 watchersCompare

[ Source](https://github.com/recoilphp/dev)[ Packagist](https://packagist.org/packages/recoil/dev)[ Docs](https://github.com/recoilphp/dev)[ RSS](/packages/recoil-dev/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (10)Dependencies (12)Versions (17)Used By (2)

Recoil Development Tools
========================

[](#recoil-development-tools)

[![Build Status](https://camo.githubusercontent.com/5a1721662c8cf1a0885eb3ba72ea8ed5ce57868f89dc4ee74acacdc55fe10c2e/687474703a2f2f696d672e736869656c64732e696f2f7472617669732f7265636f696c7068702f6465762f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/recoilphp/dev)[![Code Coverage](https://camo.githubusercontent.com/2566fc8358b707aafecef03bc4818131585def9943da9df32fbdd2d97f5ac032/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f7265636f696c7068702f6465762f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://codecov.io/github/recoilphp/dev)[![Code Quality](https://camo.githubusercontent.com/79cda5d9b2798f492672b40fae1429e663f6f8da8335f4e656c3b6c4aea960ad/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f7265636f696c7068702f6465762f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/recoilphp/dev/)[![Latest Version](https://camo.githubusercontent.com/44dc5c82e6cb65945d575bf55734cde3e47a7aa03cd51c0cb9bbd5dac13e5aa5/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7265636f696c2f6465762e7376673f7374796c653d666c61742d737175617265266c6162656c3d73656d766572)](https://semver.org)

Development and debugging tools for [Recoil](https://github.com/recoilphp/recoil) applications.

```
composer require --dev recoil/dev

```

Usage
-----

[](#usage)

Primarily, `recoil/dev` is a Composer plugin that automatically instruments coroutine functions to provide meaningful stack traces in the event of an exception. Without `recoil/dev`, stack traces tend to show details about the internals of the Recoil kernel, rather than the coroutines it is executing.

Instrumentation is performed automatically, by plugging in to the autoload pipeline. For most use cases no change is required in your code (other than the note below), and you should immediately see more usable stack traces.

The instrumentor identifies functions as coroutines if they have a return type hint of `Coroutine`, where `Coroutine` is an alias for `Generator`, for example:

```
// Alias Generator as Coroutine.
use Generator as Coroutine;

function doNothing(int $value): Coroutine // Mark function as a coroutine.
{
    yield;
}
```

The instrumentor will not instrument functions that use a return type hint of `Generator`, as without the alias it has no way to distinguish between an actual coroutine and a regular generator function.

Troubleshooting
---------------

[](#troubleshooting)

Check the following:

1. Ensure that [assertions are enabled](https://www.php.net/manual/en/function.assert.php) on your development environment.
2. Ensure that your coroutines are explicitly identified using `: Coroutine`type hint, as described above.
3. Syntax errors in your source files may break the PHP parsing used to generate instrumentation, leaving those files uninstrumented -- check your syntax!
4. For further issues with autoload, or to disable instrumentation, see [these further notes](res/autoload.php.tmpl).

Building and testing
--------------------

[](#building-and-testing)

Please see [CONTRIBUTING.md](.github/CONTRIBUTING.md) for information about running the tests and submitting changes.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 92.8% 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.

###  Release Activity

Cadence

Every ~147 days

Recently: every ~386 days

Total

14

Last Release

1535d ago

PHP version history (4 changes)0.1.0PHP ^7

0.3.5PHP ^7.1

0.4.0PHP ^7.2

0.4.1PHP >=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/93a71bd75fcd51efee464532dbdd54927cd00e938805998c76e0a804d38fa3fb?d=identicon)[jmalloc](/maintainers/jmalloc)

---

Top Contributors

[![jmalloc](https://avatars.githubusercontent.com/u/761536?v=4)](https://github.com/jmalloc "jmalloc (141 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![koden-km](https://avatars.githubusercontent.com/u/1037307?v=4)](https://github.com/koden-km "koden-km (4 commits)")[![langabi](https://avatars.githubusercontent.com/u/790661?v=4)](https://github.com/langabi "langabi (2 commits)")

---

Tags

asyncasynchronousdebugexceptionstacktraceinstrumentationrecoil

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/recoil-dev/health.svg)

```
[![Health](https://phpackages.com/badges/recoil-dev/health.svg)](https://phpackages.com/packages/recoil-dev)
```

###  Alternatives

[amphp/amp

A non-blocking concurrency framework for PHP applications.

4.4k123.4M323](/packages/amphp-amp)[revolt/event-loop

Rock-solid event loop for concurrent PHP applications.

92343.6M138](/packages/revolt-event-loop)[amphp/parallel

Parallel processing component for Amp.

85046.2M74](/packages/amphp-parallel)[amphp/sync

Non-blocking synchronization primitives for PHP based on Amp and Revolt.

19052.8M39](/packages/amphp-sync)[amphp/serialization

Serialization tools for IPC and data storage in PHP.

13551.1M18](/packages/amphp-serialization)[recoil/recoil

Asynchronous coroutines for PHP 7.

78961.5k7](/packages/recoil-recoil)

PHPackages © 2026

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