Document worker mode for extensions

Open realFlowControl opened this issue 4 months ago • 2 comments

This PR adds some documentation for extension developers regarding the specifics of supporting FrankenPHP worker mode.

While observing idle phases we stumbled over this and fixed our invalid handling in https://github.com/DataDog/dd-trace-php/pull/3169, this PR adds some docs for future generations.

Aug 19 '25 10:08 realFlowControl

@dunglas would you think this link would make sense?

https://github.com/DataDog/dd-trace-php/blob/e8bedafba359a08710c082a221dfbb3e6cc4624b/profiling/src/timeline.rs#L328-L341

As most extensions are written in C (and not Rust), the link might be not too helpful, I could provide a short C example next week, WDYT?

Aug 20 '25 14:08 realFlowControl

Both would be the best :)

Aug 25 '25 14:08 dunglas