PHPackages                             alicemajere/wonderland-thread - 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. alicemajere/wonderland-thread

ActiveLibrary[Utility & Helpers](/categories/utility)

alicemajere/wonderland-thread
=============================

Simple multi-threading management library

1.0.0(7y ago)1152[1 issues](https://github.com/AliceMajere/wonderland-thread/issues)[1 PRs](https://github.com/AliceMajere/wonderland-thread/pulls)MITPHPPHP >=7.2

Since Oct 20Pushed 7y ago2 watchersCompare

[ Source](https://github.com/AliceMajere/wonderland-thread)[ Packagist](https://packagist.org/packages/alicemajere/wonderland-thread)[ RSS](/packages/alicemajere-wonderland-thread/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

[![Build Status](https://camo.githubusercontent.com/044859d6f71d1a86c9b00e5112d6f861216420262c21ce9a016c1dbe35c97f9d/68747470733a2f2f7472617669732d63692e6f72672f416c6963654d616a6572652f776f6e6465726c616e642d7468726561642e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/AliceMajere/wonderland-thread)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/634ff58c11bab388a73f1ea3ffdaea5aa2701637fa845af055960c9cb683576c/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f416c6963654d616a6572652f776f6e6465726c616e642d7468726561642f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/AliceMajere/wonderland-thread/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/2053fdad61d025856e9d8595e6de5b6830ff67c559724d5c1c7ca3540e0efa1c/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f416c6963654d616a6572652f776f6e6465726c616e642d7468726561642f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/AliceMajere/wonderland-thread/?branch=master)[![Code Intelligence Status](https://camo.githubusercontent.com/7dd39f0caf0c9cc78e4c9bdee76549f699ea2ea4c34d9348148374b665931da5/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f416c6963654d616a6572652f776f6e6465726c616e642d7468726561642f6261646765732f636f64652d696e74656c6c6967656e63652e7376673f623d6d6173746572)](https://scrutinizer-ci.com/code-intelligence)[![License](https://camo.githubusercontent.com/250d352418b73f8395af0748df4a1bacded3fecde36bd8355ff27c256c45e670/68747470733a2f2f706f7365722e707567782e6f72672f616c6963656d616a6572652f776f6e6465726c616e642d7468726561642f6c6963656e7365)](https://packagist.org/packages/alicemajere/wonderland-thread)

Wonderland Thread
=================

[](#wonderland-thread)

A small simple multi-threading library to include in projects

Recent Update
-------------

[](#recent-update)

The project just got released on packagist with release 1.0.0.

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

[](#installation)

You need to have composer and autloader installed. To be able to install the package, add this entry in the "repositories" index of your composer.json

```
      {
        "type": "vcs",
        "url":  "git@github.com:AliceMajere/wonderland-thread.git"
      }

```

Just require the package with composer

```
composer require alicemajere/wonderland-thread

```

### Usage

[](#usage)

To start a multi-threading Pool, just create a new instance of ThreadPool

```
$threadPool = new ThreadPool();
```

We setup a maximum number of Thread to run at the same time. If we add 200 Threads to the Pool, only 5 of them will run at the same time until the Pool processed all the 200 Threads

```
$threadPool->setMaxRunningThreadNb(5);
```

Add one or more Thread to the Pool by creating a new instance of Thread. A Thread take two parameters, a name and a closure function that will tell the Thread what to do. The closure have to return an exit status from the ones defined in the Thread class constants.

```
$thread = ThreadFactory::create(
    'ThreadName',
    function ($processName) {
        // Implements the Thread processing here
        echo $processName . PHP_EOL;

        // return an exit status at the end of the thread
        return Thread::EXIT_STATUS_SUCCESS;
    }
)

$threadPool->addThread($thread);
```

To run the ThreadPool, you can just do

```
$threadPool->run();

```

You can add Listeners that will trigger on a particular Event while the Pool is running the Threads. Using Listeners can be useful if you need to do particular things for every Threads, like opening a separate mysql connection for every Thread. A Listener object constructor need the Event name to listen to and a closure function that will tell the Listener what to do for this Event. The full list of Event definition is found in the Event class.

```
$threadPool->addListener(new Listener(
    Event::POOL_RUN_START, // Event to trigger the listener
    function (Event $event) use ($website) {
        // Implements the listener
    })
);
$threadPool->addListener(new Listener(
    Event::POOL_RUN_STOP,
    function (Event $event) {
        $this->io->progressFinish();
    })
);
```

Prerequisites
-------------

[](#prerequisites)

PHP >= 7.2

Getting help
------------

[](#getting-help)

If you've instead found a bug in the library or would like new features added, go ahead and open issues or pull requests against this repo!

Authors
-------

[](#authors)

- **Alice Praud** - *Initial work* - [AliceMajere](https://github.com/AliceMajere/wonderland-thread/)

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2761d ago

### Community

Maintainers

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

---

Top Contributors

[![AliceMajere](https://avatars.githubusercontent.com/u/16051792?v=4)](https://github.com/AliceMajere "AliceMajere (20 commits)")

---

Tags

multi-threading-librarythreadthread-pool

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/alicemajere-wonderland-thread/health.svg)

```
[![Health](https://phpackages.com/badges/alicemajere-wonderland-thread/health.svg)](https://phpackages.com/packages/alicemajere-wonderland-thread)
```

PHPackages © 2026

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