Web | This Site

Learning PHP
Advanced PHP
PHP Function Reference
PHP Useful Resources
Selected Reading
© 2011 TutorialsPoint.COM

| Home |  | References |  | Discussion Forums |  | About TP

# PHP Function file()

## Syntax

array file ( string $filename [, int $flags [, resource $context]] );

## Definition and Usage

Reads an entire file into an array.

## Paramters

Parameter | Description
--- | ---
filename | Path to the file.
flags | The optional parameter flags can be one, or more, of the following constants:

- FILE_USE_INCLUDE_PATH: Search for the file in the include_path.
- FILE_IGNORE_NEW_LINES: Do not add newline at the end of each array element
- FILE_SKIP_EMPTY_LINES: Skip empty lines
- FILE_TEXT; The content is returned in UTF-8 encoding. You can specify a different encoding by creating a custom context. This flag cannot be used with FILE_BINARY. This flag is only available since PHP 6.
- FILE_BINARY: The content is read as binary data. This is the default setting and cannot be used with FILE_TEXT. This flag is only available since PHP 6.

context | A context resource created with the stream_context_create() function.

## Return Value

Returns the file in an array. Each element of the array corresponds to a line in the file, with the newline still attached. Upon failure, file() returns FALSE.

## Example

Following is the usage of this function:

    <?php
    // Get a file into an array.
    $lines = file('http://www.tutorialspoint.com/');

    // Loop through our array,
    foreach ($lines as $line_num => $line) {
      echo "Line #<b>{$line_num}</b> : " . htmlspecialchars($line)
      echo "<br />\n";
    }
    ?>

Advertisement

Online Image Processing

Indian Baby Names