Skip to content

[Sync EN] Restructure persistent connections chapter#251

Merged
msamesch merged 10 commits into
php:masterfrom
lacatoire:sync-en/persistent-connections
Jun 10, 2026
Merged

[Sync EN] Restructure persistent connections chapter#251
msamesch merged 10 commits into
php:masterfrom
lacatoire:sync-en/persistent-connections

Conversation

@lacatoire

@lacatoire lacatoire commented May 29, 2026

Copy link
Copy Markdown
Member

Restructure features/persistent-connections.xml into named <simplesect> blocks (Was sind / Web-Anfragen / CLI / Wozu / Nachteile / Schluss / Siehe auch), mirroring upstream ee5ee84013. Drops the obsolete IIS/NSAPI/WebSite-Pro paragraph and adds the CLI section, the connection-state checklist and the alternatives section from EN. Maintainer hholzgra and Credits tom kept.

Brings features/persistent-connections.xml up to date with the upstream
rewrite (EN-Revision ee5ee84013f11aaaf01b09484bc9aa3225379748):

- Page is restructured into named <simplesect> blocks instead of one
  long flow: Was sind persistente Verbindungen?, Web-Anfragen,
  Kommandozeilen-Prozesse, Wozu sie verwenden?, Mögliche Nachteile
  (Verbindungslimits, Verwaltung des Verbindungszustands),
  Schlussbemerkungen, Siehe auch.
- New CLI section explains that command-line PHP does not share
  persistent connections between invocations.
- New note about phpinfo / PHP_SAPI to check the Server API and which
  values ("Apache 2 Handler", "FPM/FastCGI") actually keep
  persistent connections alive.
- Drawbacks section expanded: explicit list of connection-state items
  to clean up (selected database, table locks, uncommitted transactions,
  temporary tables, profiling-style settings), guidance on connection
  limits with PHP-FPM workers, cleanup via destructors or
  register_shutdown_function().
- New final-words section recommending alternatives such as fixing
  connection-creation overheads (e.g. reverse DNS), dedicated connection
  pooling proxies, or long-running application servers for high-volume
  APIs.
- See-also block converted to a proper simplelist with all the
  _pconnect functions plus MySQLi and PDO connection-management links.
- The obsolete IIS/NSAPI/WebSite-Pro paragraph is dropped (matches EN).
- The obsolete <!-- $Revision$ --> SVN marker is dropped.

Existing Maintainer (hholzgra) and Credits (tom) are kept.
@lacatoire lacatoire force-pushed the sync-en/persistent-connections branch from cec6537 to 7581667 Compare May 29, 2026 19:59
@msamesch

msamesch commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Thanks a lot, looks good!
There are some suggestions from Claude AI...

Comment thread features/persistent-connections.xml Outdated
Comment thread features/persistent-connections.xml Outdated
Comment thread features/persistent-connections.xml Outdated
Comment thread features/persistent-connections.xml Outdated
lacatoire and others added 5 commits June 8, 2026 14:08
Co-authored-by: Martin Samesch <samesch@php.net>
Co-authored-by: Martin Samesch <samesch@php.net>
Co-authored-by: Martin Samesch <samesch@php.net>
Co-authored-by: Martin Samesch <samesch@php.net>
Comment thread features/persistent-connections.xml Outdated
Comment thread features/persistent-connections.xml Outdated
Comment thread features/persistent-connections.xml Outdated
Comment thread features/persistent-connections.xml Outdated
lacatoire and others added 3 commits June 8, 2026 14:38
Co-authored-by: Martin Samesch <samesch@php.net>
Co-authored-by: Martin Samesch <samesch@php.net>
Co-authored-by: Martin Samesch <samesch@php.net>

@msamesch msamesch left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks again!

Co-authored-by: Martin Samesch <samesch@php.net>
@msamesch msamesch merged commit f492496 into php:master Jun 10, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants