This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
uphp:functions:include [2017/04/12 09:56] jeff |
uphp:functions:include [2021/09/13 05:57] (current) |
||
---|---|---|---|
Line 7: | Line 7: | ||
====Description==== | ====Description==== | ||
- | <well size=" | + | <well size=" |
- | < | + | <span style=" |
- | <span style=" | + | |
- | </ | + | |
- | [[include]] ( | + | |
- | < | + | |
<span style=" | <span style=" | ||
<span style=" | <span style=" | ||
<span style=" | <span style=" | ||
- | </ | + | </ |
- | </ | + | |
This function includes and evaluates the specified file. When a file is included, the code it contains inherits the variable scope of the line on which the include occurs. Any variables available at that line in the calling file will be available within the called file, from that point forward. If the include occurs inside a function within the calling file, then all of the code contained in the called file will behave as though it had been defined inside that function. So, it will follow the variable scope of that function. | This function includes and evaluates the specified file. When a file is included, the code it contains inherits the variable scope of the line on which the include occurs. Any variables available at that line in the calling file will be available within the called file, from that point forward. If the include occurs inside a function within the calling file, then all of the code contained in the called file will behave as though it had been defined inside that function. So, it will follow the variable scope of that function. | ||
Line 23: | Line 18: | ||
====Parameter==== | ====Parameter==== | ||
- | < | + | < |
- | ====Return | + | ====Return |
None | None | ||
- | ====See Also==== | + | ====Notes==== |
+ | |||
+ | This function is very useful for including frequently repeated code in multiple scripts. It is also useful for including different code depending upon configuration or provided files (varying " | ||
+ | |||
+ | The code contained in the included file is compiled into the script the first time the script is run. If changes are made to the contents of an included file without modifying the script that contains [[include]] then recompilation must be forced (by deleting the .cgc file). | ||
+ | |||
+ | The included file is interpreted as HTML unless it contains the opening and closing uPHP Tags ''<?'' | ||
+ | |||
+ | ====Also See==== | ||
[[call_user_func()]] - Call a user defined function with optional parameters | [[call_user_func()]] - Call a user defined function with optional parameters |