From 2a432a960eaf53a876af7708b79892f77db08450 Mon Sep 17 00:00:00 2001
From: Philip Olson <philip@php.net>
Date: Tue, 5 Apr 2005 22:04:02 +0000
Subject: [PATCH] include(): Show how to "include a file into a variable", and
 see also the auto_(prepend|append)_file directives.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@183691 c90b9560-bf6c-de11-be94-00142212c4b1
---
 language/control-structures.xml | 39 ++++++++++++++++++++++++++++-----
 1 file changed, 34 insertions(+), 5 deletions(-)

diff --git a/language/control-structures.xml b/language/control-structures.xml
index d65e794c48..eca7d85eae 100644
--- a/language/control-structures.xml
+++ b/language/control-structures.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.114 $ -->
+<!-- $Revision: 1.115 $ -->
  <chapter id="language.control-structures">
   <title>Control Structures</title>
 
@@ -1549,11 +1549,40 @@ echo $bar; // prints 1
     the included file.
    </para>
    <simpara>
-    A few other ways to "include" files into variables are with 
-    <function>fopen</function>, <function>file</function> or by using 
-    <function>include</function> along with 
-    <link linkend="ref.outcontrol">Output Control Functions</link>.
+    Another way to "include" a PHP file into a variable is to capture the 
+    output by using the <link linkend="ref.outcontrol">Output Control 
+    Functions</link> with <function>include</function>. For example:
    </simpara>
+   <para>
+    <example>
+     <title>Using output buffering to include a PHP file into a string</title>
+      <programlisting role="php">
+<![CDATA[
+<?php
+$string = get_include_contents('somefile.php');
+
+function get_include_contents($filename) {
+    if (is_file($filename)) {
+        ob_start();
+        include $filename;
+        $contents = ob_get_contents();
+        ob_end_clean();
+        return $contents;
+    }
+    return false;
+}
+
+?>
+]]>
+      </programlisting>
+    </example>
+   </para>
+   <para>
+    In order to automatically include files within scripts, see also the
+    <link linkend="ini.auto-prepend-file">auto_prepend_file</link> and 
+    <link linkend="ini.auto-append-file">auto_append_file</link>
+    configuration options in &php.ini;.
+   </para>
    
    &note.language-construct;