From e7f40c364d328716584d6a54bce19556f7e82a06 Mon Sep 17 00:00:00 2001 From: Alexandre Daubois Date: Fri, 26 Jun 2026 11:42:34 +0200 Subject: [PATCH] docs: document pcov and imagick incompatibilities in known issues pcov is not thread-safe: it swaps the process-global zend_compile_file and zend_execute_ex engine hooks without synchronization, which races across threads and crashes (SIGSEGV) in classic mode (krakjoe/pcov#132). Imagick is unstable because ImageMagick's OpenMP threads conflict with FrankenPHP's threading model. --- docs/known-issues.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/known-issues.md b/docs/known-issues.md index b005b940a3..f78867c2d4 100644 --- a/docs/known-issues.md +++ b/docs/known-issues.md @@ -13,6 +13,7 @@ The following extensions are known not to be compatible with FrankenPHP: | ----------------------------------------------------------------------------------------------------------- | --------------- |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [imap](https://www.php.net/manual/imap.installation.php) | Not thread-safe | [javanile/php-imap2](https://github.com/javanile/php-imap2), [webklex/php-imap](https://github.com/Webklex/php-imap), [ImapEngine](https://github.com/DirectoryTree/ImapEngine) | | [newrelic](https://docs.newrelic.com/docs/apm/agents/php-agent/getting-started/introduction-new-relic-php/) | Not thread-safe | - | +| [pcov](https://github.com/krakjoe/pcov) | Not thread-safe ([SIGSEGV in classic mode](https://github.com/krakjoe/pcov/issues/132)) | Collect coverage with the CLI SAPI (run PHPUnit/Pest outside FrankenPHP) | ## Buggy PHP extensions @@ -22,6 +23,7 @@ The following extensions have known bugs and unexpected behaviors when used with |---------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------| | [datadog](https://github.com/DataDog) | Experiences instability when profiling FrankenPHP. This bug is [being tracked by DataDog](https://github.com/DataDog/dd-trace-php/issues/3729). | | [blackfire](https://blackfire.io/) | [FrankenPHP support is in beta and not yet feature-complete](https://docs.blackfire.io/php/integrations/frankenphp). | +| [imagick](https://github.com/Imagick/imagick) | ImageMagick's OpenMP threads conflict with FrankenPHP's threads, causing instability and crashes. Mitigate by disabling ImageMagick threading via `Imagick::setResourceLimit(\Imagick::RESOURCETYPE_THREAD, 1)` or by compiling ImageMagick with `--disable-openmp`. | ## get_browser