<?xml version="1.0" encoding="utf-8"?>

<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="pthreads.setup">

&reftitle.setup;

<section xml:id="pthreads.requirements">

&reftitle.required;

<simpara>

pthreads requires a build of PHP with ZTS (Zend Thread Safety) enabled

(<option role="configure">--enable-zts</option>, or on non-Windows systems prior to PHP 8.0.0,

<option role="configure">--enable-maintainer-zts</option>)

</simpara>

<caution>

<simpara>

Zend Thread Safety cannot be enabled post build; it is a build time configuration option.

</simpara>

</caution>

<simpara>

pthreads should build anywhere there is a working Posix Threads header (pthread.h) and ZTS build of PHP, including Windows (using the pthread-w32 project from redhat).

</simpara>

</section>

<section xml:id="pthreads.installation">

&reftitle.install;

<simpara>

pthreads releases are hosted by PECL and the source code by

<link xlink:href="&url.git.hub;krakjoe/pthreads">github</link>,

the easiest route to installation is the normal PECL route:

<link xlink:href="&url.pecl.package;pthreads">&url.pecl.package;pthreads</link>.

</simpara>

<simpara>

Windows users can download prebuilt release binaries from the <link xlink:href="&url.pecl.package;pthreads">PECL</link> website.

</simpara>

<caution>

<simpara>

Windows users need to take the additional step of adding pthreadVC2.dll (distributed with Windows releases) to their <envar>PATH</envar>.

</simpara>

</caution>

</section>

</chapter>