Skip to content

[Sync EN] Major rewrite of the setcookie reference page#252

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

[Sync EN] Major rewrite of the setcookie reference page#252
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-en/setcookie

Conversation

@lacatoire
Copy link
Copy Markdown
Member

Bringt reference/network/functions/setcookie.xml auf den Stand von upstream doc-en (6122a8317c). Größere Überarbeitung der englischen Seite.

Änderungen:

  • Viele Inline-<para>-Blöcke nach <simpara> konvertiert (Spiegelung der EN-Struktur).
  • Beschreibung und Hinweise in den sachlichen, unpersönlichen Stil umformuliert (statt der "Sie"-Form).
  • options-Parameter: neuer <note>, der erklärt, dass samesite="None" zwingend secure=true erfordert (sonst ValueError ab PHP 8.0.0).
  • Neuer Abschnitt <refsect1 role="errors">: E_WARNING vor PHP 8.0.0, ValueError ab PHP 8.0.0 für unbekannte Options.
  • Changelog: neue 8.0.0-Zeile, strukturelle Bereinigung.
  • Beispiele überarbeitet: neuer Einleitungstext zu den Entwicklertools des Browsers (Speicher / Anwendung), zusätzliche deutsche Code-Kommentare im Sende-Beispiel, zwei kurze <simpara>-Blöcke für das Lösch-Beispiel, "Array von Cookies"-Formulierung aktualisiert.
  • Häufige Fallstricke, Punkt 4 aktualisiert: Browser speichert separate Cookies pro Pfad/Domain, json_encode/json_decode statt explode.
  • Hinweis zur Ausgabepufferung in unpersönlicher Form umgeschrieben.
  • Siehe auch-Block: umschließendes <para> entfernt.
  • <!-- $Revision$ -->-SVN-Marker entfernt.

Bestehender Maintainer: (sammywg) und Reviewed: yes / Rev-Revision wurden beibehalten. xml:id-Parität geprüft.

Brings reference/network/functions/setcookie.xml up to date with
the upstream rewrite (EN-Revision 6122a8317ca0068fc71f6a5167e0a2d99166ec7c):

- Most inline <para> blocks converted to <simpara> (mirror EN).
- Description and notes rephrased to impersonal/factual style
  ("in the script", "this function is called") instead of the
  old "your script"/"you place calls to" phrasing.
- options parameter: new <note> about samesite="None" requiring
  secure=true, ValueError from PHP 8.0.0 onward.
- New <refsect1 role="errors"> section: E_WARNING before PHP 8.0.0,
  ValueError as of PHP 8.0.0 for unknown options.
- Changelog: new 8.0.0 row, structural simpara cleanups.
- Examples reworked: new intro about browser developer tools
  (Storage/Application tab), German code comments in the send
  example, two short <simpara>s for the delete example, refreshed
  Array von Cookies wording.
- Common Pitfalls bullet 4 updated: browser stores separate cookies
  for each path/domain, json_encode/json_decode instead of explode.
- Output-buffering note rewritten in impersonal form.
- See-also block: wrapping <para> dropped.
- Obsolete <!-- $Revision$ --> SVN marker dropped.

Existing Maintainer (sammywg) and Reviewed: yes / Rev-Revision kept.
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