PHPackages                             neighborhoods/kojo - 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 &amp; Workers](/categories/queues)
4. /
5. neighborhoods/kojo

ActiveLibrary[Queues &amp; Workers](/categories/queues)

neighborhoods/kojo
==================

Neighborhoods Kōjō is a distributed task manager.

5.5.0(4y ago)1520.6k↓50%5[12 PRs](https://github.com/neighborhoods/kojo/pulls)2MITPHPPHP ^7.2|^8.0

Since May 2Pushed 4y ago26 watchersCompare

[ Source](https://github.com/neighborhoods/kojo)[ Packagist](https://packagist.org/packages/neighborhoods/kojo)[ RSS](/packages/neighborhoods-kojo/feed)WikiDiscussions 5.x Synced 1mo ago

READMEChangelog (10)Dependencies (13)Versions (134)Used By (2)

⚡ Neighborhoods Kōjō ⚡
======================

[](#-neighborhoods-kōjō-)

工場
==

[](#工場)

A distributed task manager.

### `Kōjō` is a collection of the following components:

[](#kōjō-is-a-collection-of-the-following-components)

- Distributed task management.
- Distributed, cooperative, process-aware semaphores and mutexes.
- Static cron scheduling.
- Multi-process model.
- Distributed IPC.

Trying out Kōjō
---------------

[](#trying-out-kōjō)

Real-world use cases for Kōjō and instructions for getting Kōjō up and running in your project can be found at [KojoFitness](https://github.com/neighborhoods/KojoFitness).

Debugging Kōjō
--------------

[](#debugging-kōjō)

XDebug version greater than `xdebug-2.7.0alpha1` is required when trying to debug Kōjō. This version of XDebug resolves issues () caused by the way the Kōjō forks using `pcntl`.

If you are using PhpStorm and you have more concurrent Kōjō jobs running than the `Max. simultaneous connections` defined for your XDebug listener, Kōjō will appear to hang. To avoid this, increase your `Max. simultaneous connections` to the max value of `20` in PhpStorm's preferences under `Languages & Frameworks` &gt; `PHP` &gt; `Debug`, `External connections` section.

Kōjō appears to be hanging during local development?
----------------------------------------------------

[](#kōjō-appears-to-be-hanging-during-local-development)

- Stop all local containers and rebuild them
- Run `ps -auxf` to see if any processes are still running Kōjō with a title like `neighborhoods-kojo: /server[8]/root[22]/job[30]`
    - If yes run `pkill -9 -f kojo` to SIG\_KILL all the processes containing the word `kojo`
- Run `docker-compose exec redis redis-cli monitor` to see if Kōjō is creating any activity in redis.
    - If nothing is streaming by like `"GET" "/neighborhoods/kojo/area_manager/job_state_changelog_processor.lock"` messages then something else is blocking the execution of Kōjō internals. This is typically due to a debugger.
- Turn off the debugger. Sometimes this will mess with Kojo
- Check your version of XDebug (version before `2.7.0` won't work and `2.8.2` has seen some odd behavior. Recommend `2.9.2`)
- Checkout the debugging logs [Troubleshooting common PHP debugging issues - Help | PhpStorm](https://www.jetbrains.com/help/phpstorm/troubleshooting-php-debugging.html#)

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity34

Limited adoption so far

Community25

Small or concentrated contributor base

Maturity86

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 52.3% 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 ~23 days

Recently: every ~47 days

Total

57

Last Release

1643d ago

Major Versions

3.3.3 → 6.x-dev2018-07-31

4.16.0 → 5.0.02019-12-26

4.17.0 → 5.1.02020-01-08

4.17.1 → 5.1.12020-01-29

4.x-dev → 5.3.02021-05-06

PHP version history (3 changes)1.0.0PHP &gt;=7.1

4.17.0PHP ^7.2

5.4.0PHP ^7.2|^8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8584765?v=4)[neighborhoods.com](/maintainers/neighborhoods)[@neighborhoods](https://github.com/neighborhoods)

---

Top Contributors

[![rhift](https://avatars.githubusercontent.com/u/1008958?v=4)](https://github.com/rhift "rhift (250 commits)")[![alexberryman](https://avatars.githubusercontent.com/u/1881846?v=4)](https://github.com/alexberryman "alexberryman (123 commits)")[![mucha55](https://avatars.githubusercontent.com/u/32273336?v=4)](https://github.com/mucha55 "mucha55 (89 commits)")[![Nat3Dogg](https://avatars.githubusercontent.com/u/31739570?v=4)](https://github.com/Nat3Dogg "Nat3Dogg (9 commits)")[![jpmarcotte](https://avatars.githubusercontent.com/u/3035072?v=4)](https://github.com/jpmarcotte "jpmarcotte (4 commits)")[![timrourke](https://avatars.githubusercontent.com/u/8141770?v=4)](https://github.com/timrourke "timrourke (2 commits)")[![arielallon](https://avatars.githubusercontent.com/u/1356396?v=4)](https://github.com/arielallon "arielallon (1 commits)")

---

Tags

distributed-task-schedulinghacktoberfestphptask-managementtask-manager

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/neighborhoods-kojo/health.svg)

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

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M650](/packages/sylius-sylius)[jolicode/castor

A lightweight and modern task runner. Automate everything. In PHP.

53541.0k3](/packages/jolicode-castor)[contao/core-bundle

Contao Open Source CMS

1231.6M2.3k](/packages/contao-core-bundle)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)

PHPackages © 2026

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