PHP ob_start() Function

❮ PHP Output Control Functions

Example

Create an output buffer:

<?php
ob_start();
echo "This content will not be sent to the browser.";
ob_end_clean();

echo "This content will be sent to the browser.";
?>
Try it Yourself »

Definition and Usage

The ob_start() function creates an output buffer. A callback function can be passed in to do processing on the contents of the buffer before it gets flushed from the buffer. Flags can be used to permit or restrict what the buffer is able to do.


Syntax

ob_start(callback, chunk_size, flags);

Parameter Values

Parameter Description
callback Optional. A callback used to process the contents of the buffer before it gets flushed.

The callback function should have the following parameters:
Parameter Description
buffer The contents of the output buffer
phase A bitmask which may have any number of the following flags:
PHP_OUTPUT_HANDLER_START - If the output buffer was just created
PHP_OUTPUT_HANDLER_FLUSH - If the output buffer is currently being flushed
PHP_OUTPUT_HANDLER_FINAL - If the output buffer will be deleted right after this operation
chunk_size Optional. Defaults to 0. When set to a value greater than zero, the buffer will automatically be flushed as soon as the length of the contents exceeds this value
flags Optional. Defaults to PHP_OUTPUT_HANDLER_STDFLAGS.

A bitmask which determines what operations the buffer is permitted to do. It may contain the following flags:

PHP_OUTPUT_HANDLER_CLEANABLE - Calls to ob_clean(), ob_end_clean() and ob_get_clean() are permitted.

PHP_OUTPUT_HANDLER_FLUSHABLE - Calls to ob_flush(), ob_end_flush() and ob_get_flush() are permitted.

PHP_OUTPUT_HANDLER_REMOVABLE - Calls to ob_end_clean(), ob_end_flush() and ob_get_flush() are permitted.

PHP_OUTPUT_HANDLER_STDFLAGS - Equivalent to

PHP_OUTPUT_HANDLER_CLEANABLE|
PHP_OUTPUT_HANDLER_FLUSHABLE|
PHP_OUTPUT_HANDLER_REMOVABLE

Technical Details

Return Value: TRUE on success, FALSE on failure
PHP Version: 4+

❮ PHP Output Control Functions
Copyright 1999-2023 by Refsnes Data. All Rights Reserved.