TGViewer
Official Psalm channel Official Psalm channel @psalmphp · 66 subscribers
Post #9 198

Forwarded from Daniil Gentili

Psalm v6 Deep Dive: Copy-on-Write + dynamic task dispatching

Psalm is one of the biggest and most powerful PHP Static analysis tools, featuring exclusive features like security analysis.

In Psalm 6.1, I implemented a major refactoring of multithreaded mode (automatically enabled on Linux/Mac OS) based on amphp/parallel, which greatly reduced analysis speeds!

But why was it so effective? To understand, one must first understand that in the vast majority of PHP multithreaded analysis tools, jobs are distributed statically between threads on startup, which means that towards the end of the analysis, a lot of workers just sit there doing nothing, just waiting for the other workers processing bigger and heavier files to finish.

However, the new multithreaded mode now allows Psalm to dynamically distribute jobs to workers immediately, as soon as they finish processing their current task, reducing idle worker time and maximizing CPU usage, thus reducing the overall runtime!

Implementation wasn't as easy as just plugging in amphp/parallel, because Psalm relies heavily on the copy-on-write semantics of fork(): indeed, Psalm's multithreaded mode was quite fast even before the refactoring because it doesn't have to copy all type information to all workers when spawning them, as when workers are spawned using the fork() syscall, the entire memory is not copied to the forked process.

Instead, it is copied only when a memory page is modified by the forked process, which means that unless workers start modifying large amounts of type information (which usually happens pretty rarely, as most of that data is immutable after Psalm's scan phase), most of the memory is not copied, leading to large performance improvements.

amphp/parallel does not support using fork() to spawn workers out of the box, however I managed to add support using a custom context class (taking care to avoid some edge cases around reused file descriptors, which can cause issues with the event loop).

The maintainer of amphp was kind enough to begin integration of Psalm's fork context inside of parallel itself after I pinged him, which means amphp users will soon be able to make use of Psalm's fork context to improve worker spawning performance with copy-on-write fork() semantics.

This release also adds an additional check to ensure VM overcommitting (the feature which allows copy-on-write optimizations) is enabled in the OS when running Psalm, by ensuring that the vm.overcommit_memory kernel setting is always set to 1.

~~~

This post is the first of a series of technical deep dives into Psalm v6's performance improvements, which will be released over the next weeks, subscribe to @danog_blog to always stay up to date on the latest Psalm news and developments!
Daniil Gentili's blog Psalm v6 Deep Dive: Copy-on-Write + dynamic task dispatching - Daniil Gentili's blog A deep dive into Psalm 6.1's performance improvements, powered by CoW optimizations, and dynamic task dispatching with amphp/parallel!
  • 🔥 7
More from @psalmphp
  1. Jul 10, 2025Also announcing the public beta of Psalm v7! Psalm v7 brings huge performance improvements…
  2. Jul 10, 2025Psalm is one of the biggest and most powerful PHP Static analysis tools, featuring exclusi…
  3. May 18, 2025Small overview of the new psalm-review tool I added in Psalm 6.3: https://blog.daniil.it/2…
  4. May 11, 2025And then, a long overdue post about my Autonomous System (AS198747), and an over more over…
  5. May 11, 2025The first series of posts I'll be adding here will be some technical deep dives into the p…
  6. May 11, 2025Happy to announce I've launched a blog, where I'll be posting news about all my different…
Threads Profile ViewerView any public Threads profile without an account.Open ThreadLook →Writing with AI? Make it sound human.Metric37 rewrites AI drafts so they read naturally. Free AI detector, 1,500 words free.Try Metric37 →