[doc-en] master: session_set_save_handler(): note that the object signature doesn't support named arguments (#5987)

Author: qodelicious (qodelicious) Committer: GitHub (web-flow) Pusher: lacatoire Date: 2026-10-22T12:07:38+02:00 Commit: https://github.com/php/doc-en/commit/594c8c0a0188faae493b7070b3c1e331678e1655 Raw diff: https://github.com/php/doc-en/commit/594c8c0a0188faae493b7070b3c1e331678e1655.diff session_set_save_handler(): note that the object signature doesn't support named arguments (#5987) * session_set_save_handler(): note that the object signature doesn't support named arguments * Mention alternative signatures in the named arguments section * Use exceptionname for Error * Reword the alternative signature note Changed paths: M language/functions.xml M reference/session/functions/session-set-save-handler.xml Diff: diff --git a/language/functions.xml b/language/functions.xml index 1148a25c65f1..93ce79f580bf 100644 --- a/language/functions.xml +++ b/language/functions.xml @@ -759,6 +759,13 @@ var_dump(foo(...[1, 2], b: 20)); // Fatal error. Named parameter $b overwrites p </programlisting> </example> + <simpara> + Some internal functions document an alternative signature, such as + <function>session_set_save_handler</function>, whose parameter names do not + exist in the function itself. These names cannot be used as named + arguments and result in an error. + </simpara> + </sect2> </sect1> diff --git a/reference/session/functions/session-set-save-handler.xml b/reference/session/functions/session-set-save-handler.xml index 105af55df3c4..410decd0484c 100644 --- a/reference/session/functions/session-set-save-handler.xml +++ b/reference/session/functions/session-set-save-handler.xml @@ -19,9 +19,7 @@ <methodparam choice="opt"><type>callable</type><parameter>validate_sid</parameter></methodparam> <methodparam choice="opt"><type>callable</type><parameter>update_timestamp</parameter></methodparam> </methodsynopsis> - <para> - It is possible to register the following prototype: - </para> + <simpara>Alternative signature (not supported with named arguments):</simpara> <methodsynopsis> <type>bool</type><methodname>session_set_save_handler</methodname> <methodparam><type>object</type><parameter>sessionhandler</parameter></methodparam>