17

This is a sample code from the book I am reading:

ob_start();
include("{$path}.ini");
$string = ob_get_contents();
ob_end_clean();
$pairs = parse_ini_string($string);

My question is, how does ob_get_contents() know what to get contents from? ({$path}.ini in this situation)?

Rudi Visser
  • 21,350
  • 5
  • 71
  • 97
Koray Tugay
  • 22,894
  • 45
  • 188
  • 319

4 Answers4

14

ob_get_contents simply gets the contents of the output buffer since you called ob_start(). Essentially, an output buffer in PHP catches anything that would have been output to the browser (excluding headers). It's useful in cases where you may need to filter some output, or you're using a PHP method (such as var_dump) that writes output directly to screen, and you would instead like the return value of the method in a string.

In this case, because you're include()ing the .ini file, it's contents will be essentially output to screen, and ob_get_contents() will get the content of the file.

If you were to put echo "I'm a little teapot short and stout"; underneath the include, this would also be included in $string after the body of the .ini file.

In your specific case, however, output buffering is an unnecessary overhead, simply use file_get_contents on the .ini file. I'm not sure why a book would even have this code in it at all.

Rudi Visser
  • 21,350
  • 5
  • 71
  • 97
  • Just a quick question, when you say "because you're include()ing the .ini file, it's contents will be essentially output to screen", but I do not see that contents of the path.ini on the screen? – Koray Tugay Feb 03 '13 at 11:38
  • ... because you're using output buffering, that's kindof the point. `ob_end_clean()` removes the contents of the output buffer (which are now in `$string`), and it will never be output to the screen unless you `echo $string;`. – Rudi Visser Feb 03 '13 at 11:39
  • @KorayTugay When you remove ob_start() function, you will see it on the screen. – Nemanja Boric Feb 03 '13 at 11:39
  • @Burgos Thanks, I was able to see after I remove ob_end_clean(); not ob_start()... Strange.. – Koray Tugay Feb 03 '13 at 11:43
  • Because `ob_start()` only begins the capture, if you don't clear (with `ob_end_clean()`) the buffer, it will be flushed to your screen at the end of the script. – Rudi Visser Feb 03 '13 at 11:43
6

The "ob" stands for "output buffer". When you call ob_start(), PHP reroutes all output (using echo, etc) to the output buffer. Then you can use the other ob_* functions to retrieve and/or clear the buffer contents.

In your example, it will buffer any output generated by the file referenced by "{$path}.ini". When you include it, its output is added to the buffer, and when you call ob_get_contents(), it retrieves the contents of the buffer.

leftclickben
  • 4,564
  • 23
  • 24
4

From PHP:

ob_start — Turn on output buffering
ob_get_contents — Return the contents of the output buffer
ob_end_clean — Clean (erase) the output buffer and turn off output buffering

Now, ob_get_contents can collect all buffer that outputted.

[1] http://www.php.net/manual/en/book.outcontrol.php

2

ob_get_contents() is getting everything that is echoed after calling ob_start() function, so there is not anything special about {$path}.ini - you are required to echo data you want to collect (yes, even outputs of simple echo or print_r calls will be collected - sometimes useful for debugging simple scripts).

You may understand ob_start() function as a simple redirection from screen to (invisible) PHP internal buffer which is later read by ob_get_contents(). So you will be able to redirect anything that you may see on the screen without calling ob_start() function (even the whole web pages).

Nemanja Boric
  • 21,627
  • 6
  • 67
  • 91