I tried to add a few things in the doc about it, hope this helps 🙂

Hi @alexandre-daubois!
First of all, thank you.

I think this helps, but IMO, we should be clear about our position regarding the extension availability and configuration.

• We are suggesting to install the extension? If yes, I think we should include it in the suggest section of the related packages.
• We should provide a guide on how configure the extension regarding the different SAPIs.

WDYT?

Adding it to the suggest section is a good idea to me! May I create the PR about it or would you like to do it? 🙂

I'm not sure about the configuration of the extension however. I don't think we'd like to write (and maintain) documentation that belongs to other libraries and packages. It is not related to Symfony directly. This is just my opinion, and I think we should ask @javiereguiluz and @OskarStark on this point 🙂

Adding it to the suggest section is a good idea to me! May I create the PR about it or would you like to do it? 🙂

I'll try to provide the PRs today.

I'm not sure about the configuration of the extension however. I don't think we'd like to write (and maintain) documentation that belongs to other libraries and packages. It

I'm not suggesting to write docs about how the extension works, but about the proper configuration in a Symfony app, regarding the potential issues in compiled containers shared between multiple SAPIs.

Adding it to the suggest section is a good idea to me

For the record, we ruled out "suggest" entries from composer.json files (too much maintenance burden).

Adding it to the suggest section is a good idea to me

For the record, we ruled out "suggest" entries from composer.json files (too much maintenance burden).

It's not just about the maintenance; it's also about the low value those suggestions have.

@alexandre-daubois, do you think we have chance to prevent the usage of the extension on the web context? See this example.

I'm not sure. The manual states that unexpected behavior may happen "if any Process Control functions are used within a web server environment". Only the usage if discouraged, not the installation of the extension. Also, the PHP setup is often the same between the CLI and the web env so I'm not sure we can really write something about this here 😕

We've introduced one bug in a single release, which raises awareness of this extension. But I would say it generally shouldn't need such high level of awareness. You only need it, when you need it (i.e. when you rely on process signals).

Symfony takes care of not using signal features when this extension is not available (except for this one case). If anything, we should look into improving our CI to make sure we run a job without the pcntl extension.

Let's get the proposed PR merged 👍