Need help with pthreads?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

3.5K Stars 511 Forks Other 1.5K Commits 56 Opened issues


Threading for PHP - Share Nothing, Do Everything :)

Services available


Need anything else?

Contributors list

Threading for PHP - Share Nothing, Do Everything :)

Build Status Build status Average time to resolve an issue Percentage of issues still open Join the chat at

This project provides multi-threading that is compatible with PHP based on Posix Threads.


  • An easy to use, quick to learn OO Threading API for PHP 7.2+
  • Execute any and all predefined and user declared methods and functions, including closures.
  • Ready made synchronization included
  • A world of possibilities ...

Technical Features

  • High Level Threading
  • Synchronization
  • Worker Threads
  • Thread Pools
  • Complete Support for OO - ie. traits, interfaces, inheritance etc
  • Full read/write/execute support for Threaded objects


  • PHP 7.2+
  • ZTS Enabled ( Thread Safety )
  • Posix Threads Implementation

Testing has been carried out on x86, x64 and ARM, in general you just need a compiler and pthread.h


For PHP7, pthreads has been almost completely rewritten to be more efficient, easier to use and more robust. I will give a brief changelog here:

The API for v3 has changed, the following things have been removed:

  • Mutex
    , and
  • Threaded::lock
  • Threaded::isWaiting
  • Threaded::from
  • Thread::kill
    (there be dragons)
  • Thread::detach
  • Worker::isWorking
  • Threaded::getTerminationInfo
    (this was unsafe, a better, safe impl can be done in userland)
  • Special behaviour of
    methods on

The following things have significant changes:

  • The method by which
    objects are stored as member properties of other
  • The structure used by a
    for stack (
    objects to execute inserted by
  • The
    mechanism was moved from
    for a more robust
    and simpler
  • The method by which iteration occurs on
    objects, such that it uses memory more efficiently.
  • Threaded::synchronized
    provides true synchronization (state and properties lock).
  • Worker
    objects no longer require that you retain a reference to
    objects on the stack.
  • Unified monitor (cond/mutex/state) for
  • Threaded
    members of
    objects are immutable
  • Volatile
    objects, exempt from immutability
  • array
    coerced to
    when set as member of
  • Collectable
    converted to interface, to make
    extends Volatile implements Collectable

Some blog posts explaining these changes:

Supported PHP Versions

pthreads v3 requires PHP7 or above. PHP5 needs to use pthreads v2 which can be found in the PHP5 branch.

Note that only PHP 7.2+ is now supported (requiring the current master branch of pthreads). This is due to safety issues with ZTS mode on PHP 7.0 and 7.1.

Unix-based Building from Source

Building pthreads from source is quite simple on Unix-based OSs. The instructions are as follows: * Clone this repository and checkout the release to use (or master for the latest updates) *

cd pthreads
make install
(may need sudo) * Update your php.ini file to load the
file using the

Windows Support

Yes !! Windows support is offered thanks to the pthread-w32 library.

Releases for Windows can be found:

Simple Windows Installation
  • Add
    (included with the Windows releases) to the same directory as
  • Add
    to PHP extension folder eg.

Mac OSX Support

Yes !! Users of Mac will be glad to hear that pthreads is now tested on OSX as part of the development process.

Hello World

As is customary in our line of work:

$thread->start() && $thread->join();

Are you serious ?

Absolutely, this is not a hack, we don't use forking or any other such nonsense, what you create are honest to goodness posix threads that are completely compatible with PHP and safe ... this is true multi-threading :)

SAPI Support

pthreads v3 is restricted to operating in CLI only: I have spent many years trying to explain that threads in a web server just don't make sense, after 1,111 commits to pthreads I have realised that, my advice is going unheeded.

So I'm promoting the advice to hard and fast fact: you can't use pthreads safely and sensibly anywhere but CLI.

Thanks for listening ;)


Documentation can be found in the PHP manual:, and some examples can be found in the "examples" folder in the master repository.

Further insights and occasional announcements can be read at the site where pthreads is developed and tested in the real world.

Here are some links to articles I have prepared for users: everybody should read them before they do anything else:


If you have had the time to put any cool demo's together and would like them showcased on please get in touch.


It's possible to write code that optionally takes advantage of parallelism where the environment has


This is made possible by pthreads-polyfill which can be found on packagist.

Having required the appropriate package in your composer.json, the following code is executable everywhere:

if (extension_loaded("pthreads")) {
        echo "Using pthreads\n";
} else  echo "Using polyfill\n";

$pool = new Pool(4);

$pool->submit(new class extends Threaded { public function run() { echo "Hello World\n"; } });

while ($pool->collect()) continue;

$pool->shutdown(); ?>

Some guidance on getting started, and detail regarding how the polyfill came to exist can be found here.


Please submit issues, and send your feedback and suggestions as often as you have them.

Reporting Bugs

If you believe you have found a bug in pthreads, please open an issue: Include in your report minimal, executable, reproducing code.

Minimal: reduce your problem to the smallest amount of code possible; This helps with hunting the bug, but also it helps with integration and regression testing once the bug is fixed.

Executable: include all the information required to execute the example code, code snippets are not helpful.

Reproducing: some bugs don't show themselves on every execution, that's fine, mention that in the report and give an idea of how often you encounter the bug.

It is impossible to help without reproducing code, bugs that are opened without reproducing code will be closed.

Please include version and operating system information in your report.

Please do not post requests to help with code on github; I spend a lot of time on Stackoverflow, a much better place for asking questions.

Have patience; I am one human being.


There is no defined API for you to create your own threads in your extensions, this project aims to provide Userland threading, it does not aim to provide a threading API for extension developers. I suggest you allow users to decide what they thread and keep your own extension focused on your functionality.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.