file into an array.
flags can be one or more of the following
Search for the file in the include path as set in the php.ini file
Do not add a newline at the end of the array elements
Skip any empty lines