From the [manual](http://php.net/manual/en/function.halt-compiler.php):

```
void __halt_compiler ( void )

```

> 
> This function halts the execution of the compiler. This can be useful to embed data in PHP scripts, like the installation files.
> 
> 
> Note: `__halt_compiler()` can only be used from the outermost scope. 
> 
> 
> 

Can anyone provide an actually case where this function is useful?