Skip to content

ext/session: document the 8.4.0 INI deprecations, drop the removed hash_function recommendation - #5800

Open
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-src/session-fixes
Open

ext/session: document the 8.4.0 INI deprecations, drop the removed hash_function recommendation#5800
lacatoire wants to merge 1 commit into
php:masterfrom
lacatoire:sync-src/session-fixes

Conversation

@lacatoire

@lacatoire lacatoire commented Aug 26, 2026

Copy link
Copy Markdown
Member

The 8.4.0 session INI deprecations are conditional: PHP only emits E_DEPRECATED when a setting is moved away from its default value. The wording therefore says changing / enabling / setting a non-empty value rather than describing the settings themselves as deprecated, which is also how reference/session/ini.xml already words the deprecations added earlier.

reference/session/ini.xml

  • session.sid_length and session.sid_bits_per_character: keep the availability note and add the deprecation as a <warning>, matching the five other 8.4.0 deprecations in this file
  • align the two summary table rows with the same wording

reference/session/security.xml

  • add the deprecation warnings for session.use_trans_sid, session.trans_sid_tags, session.trans_sid_hosts and session.referer_check
  • drop the session.hash_function recommendation: the setting was removed in PHP 7.1.0, and the entry still recommended feeding it entropy through session.entropy_length, removed at the same time
  • fix a sentence fragment in the session.referer_check item

Sources

Change Source
Changing session.sid_length / session.sid_bits_per_character RFC: Deprecations for PHP 8.4 - guards val != 32 / val != 4 in ext/session/session.c
Enabling session.use_trans_sid, setting session.trans_sid_tags / session.trans_sid_hosts / session.referer_check RFC: Deprecate transparent session id
session.hash_function removed PHP 7.1.0, already documented in ini.xml

@lacatoire lacatoire added the 8.4 label Aug 26, 2026
@lacatoire lacatoire added this to the PHP 8.4 milestone Aug 26, 2026
@lacatoire
lacatoire force-pushed the sync-src/session-fixes branch 2 times, most recently from 67b8f63 to 8dc4427 Compare August 26, 2026 09:27
@lacatoire lacatoire changed the title ext/session: document remaining 8.4.0 INI deprecations, drop removed hash_function recommendation ext/session: document the 8.4.0 INI deprecations, drop the removed hash_function recommendation Aug 26, 2026
…unction recommendation

The 8.4.0 session INI deprecations are conditional: PHP only emits
E_DEPRECATED when a setting is moved away from its default value, so the
wording says "changing" / "enabling" / "setting a non-empty value" rather
than describing the settings themselves as deprecated.

reference/session/ini.xml
- session.sid_length and session.sid_bits_per_character: keep the
  availability note, add the deprecation as a <warning>, matching the
  other 8.4.0 deprecations in this file
- align the two summary table rows with the same wording

reference/session/security.xml
- add the deprecation warnings for session.use_trans_sid,
  session.trans_sid_tags, session.trans_sid_hosts and
  session.referer_check
- drop the session.hash_function recommendation, the setting was removed
  in PHP 7.1.0
- fix a sentence fragment in the session.referer_check item

Sources
- Changing session.sid_length / session.sid_bits_per_character:
  https://wiki.php.net/rfc/deprecations_php_8_4#sessionsid_length_and_sessionsid_bits_per_character
  ext/session/session.c (val != 32, val != 4 guards)
- use_trans_sid, trans_sid_tags, trans_sid_hosts, referer_check:
  https://wiki.php.net/rfc/deprecate-get-post-sessions
- session.hash_function removed in PHP 7.1.0
@lacatoire
lacatoire force-pushed the sync-src/session-fixes branch from 8dc4427 to db59ac1 Compare August 26, 2026 09:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant