Skip to content

[Sync EN] Restructure persistent connections chapter#251

Open
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-en/persistent-connections
Open

[Sync EN] Restructure persistent connections chapter#251
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-en/persistent-connections

Conversation

@lacatoire
Copy link
Copy Markdown
Member

Bringt features/persistent-connections.xml auf den Stand von upstream doc-en (ee5ee84013). Die englische Seite wurde von einem langen Fließtext in benannte <simplesect>-Blöcke umstrukturiert.

Neue Sektionsstruktur:

  • Was sind persistente Verbindungen? (Intro mit <simplelist> der drei nicht-Anwendungsfälle)
  • Web-Anfragen (mit <note> zu phpinfo / PHP_SAPI und den Werten Apache 2 Handler / FPM/FastCGI)
  • Kommandozeilen-Prozesse (neu: erklärt, dass CLI-PHP keine persistenten Verbindungen zwischen Aufrufen teilt)
  • Wozu sie verwenden?
  • Mögliche Nachteile: Verbindungslimits (Worker-Anzahl, Timeouts)
  • Mögliche Nachteile: Verwaltung des Verbindungszustands (neue <simplelist>: aktive Datenbank, Tabellensperren, offene Transaktionen, temporäre Tabellen, verbindungsspezifische Einstellungen)
  • Schlussbemerkungen (neu: Empfehlung alternativer Lösungen wie Behebung des Verbindungs-Overheads, Connection-Pooling-Proxies, langlaufende Anwendungsserver)
  • Siehe auch (jetzt vollständige <simplelist> mit allen _pconnect-Funktionen plus MySQLi- und PDO-Verbindungs-Links)

Weitere Änderungen:

  • Der veraltete Absatz zu IIS / NSAPI / WebSite Pro wurde entfernt (EN hat ihn gestrichen).
  • Das veraltete <!-- $Revision$ -->-SVN-Marker wurde entfernt.

Bestehender Maintainer: (hholzgra) und Credits (tom) wurden beibehalten.

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
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.

1 participant