Doc #64977 [Opn]: ob_start() fails when passed default parameters

[email protected] Sun, 07 Jan 2024 14:03:10 +0000
Newsgroups php.doc.bugs
Message-ID <[email protected]>
Edit report at https://bugs.php.net/bug.php?id=64977&edit=1

 ID:                 64977
 Updated by:         [email protected]
 Reported by:        rewilliams at newtekemail dot com
 Summary:            ob_start() fails when passed default parameters
 Status:             Open
 Type:               Documentation Problem
 Package:            Output Control
 PHP Version:        5.5.0RC2
 Block user comment: N
 Private report:     N

 New Comment:

Closed by https://github.com/php/doc-en/pull/3073


Previous Comments:
------------------------------------------------------------------------
[2014-11-19 12:14:49] [email protected]

See also Doc Bug #62019

------------------------------------------------------------------------
[2014-11-19 09:31:48] [email protected]

PHP_OUTPUT_HANDLER_STARTED just indicates that the handler has been called previously with PHP_OUTPUT_HANDLER_START set, so it would not get that flag again, unless it has also seen PHP_OUTPUT_HANDLER_FINAL in the meantime.

So:
handler(PHP_OUTPUT_HANDLER_START) => flags |= STARTED
handler(PHP_OUTPUT_HANDLER_FINAL) => flags ^= STARTED

PHP_OUTPUT_HANDLER_DISABLED: 
Internal output handlers can mark them self as disabled with php_output_handler_hook(PHP_OUTPUT_HANDLER_HOOK_DISABLE), when they f.e. detect an error; see README.NEW-OUTPUT-API.
Also, when a call to an internal or userland handler fails, or the userland handler returns FALSE.

------------------------------------------------------------------------
[2013-10-01 18:37:07] [email protected]

OK, documentation is done except for the PHP_OUTPUT_BUFFER_STARTED and 
PHP_OUTPUT_BUFFER_DISABLED constants, mostly because I can't figure out how 
they're useful.

Mike, help please? :)

------------------------------------------------------------------------
[2013-10-01 18:35:20] [email protected]

Automatic comment from SVN on behalf of aharvey
Revision: http://svn.php.net/viewvc/?view=revision&amp;revision=331632
Log: Document the ob_start() changes in PHP 5.4.

Mostly fixes doc bug #64977 (ob_start() fails when passed default parameters).

------------------------------------------------------------------------
[2013-09-27 18:44:22] [email protected]

We probably should have picked that up at the time. Whoops.

OK, I'll assign this to myself and figure out how to document it. Probably won't 
be today.

------------------------------------------------------------------------


The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at

    https://bugs.php.net/bug.php?id=64977


--
Edit this bug report at https://bugs.php.net/bug.php?id=64977&edit=1