Fix #73805: header() may not actually set header

We document that header() issues `E_WARNING` on failure, and link to
`headers_list()` which might be used to check success of `header()`.
This commit is contained in:
Christoph M. Becker 2021-08-02 17:18:54 +02:00
parent 590f93a2eb
commit f32912d04f
No known key found for this signature in database
GPG key ID: D66C9593118BCCB6

View file

@ -146,6 +146,14 @@ header('WWW-Authenticate: NTLM', false);
</para>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
On failure to schedule the header to be sent, <function>header</function>
issues an <constant>E_WARNING</constant> level error.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@ -280,6 +288,7 @@ exit;
<member><function>setcookie</function></member>
<member><function>http_response_code</function></member>
<member><function>header_remove</function></member>
<member><function>header_list</function></member>
<member>
The section on <link linkend="features.http-auth">HTTP
authentication</link>