Função file() do PHP

Definição e uso

A função file() lê todo o arquivo em um array.

Com file_get_contents() Semelhante, mas diferente, o file() retorna o arquivo como um array. Cada unidade do array é uma linha correspondente do arquivo, incluindo o caractere de nova linha.

Se falhar, retorna false.

Sintaxe

file(path,include_path,context)
Parâmetro Descrição
path Obrigatório. Define o arquivo a ser lido.
include_path Opcional. Se também quiser procurar arquivos no include_path, defina esse parâmetro como "1".
context

Opcional. Define o ambiente do descritor de arquivo.

context É um conjunto de opções que podem modificar o comportamento do fluxo. Se usar null, ignore.

Descrição

Para context suporte foi adicionado no PHP 5.0.0.

Cada linha do array retornado inclui o caractere de fim de linha, portanto, se não for necessário, é necessário usar a função rtrim().

Avisos e comentários

Comentário:A partir do PHP 4.3.0, pode-se usar file_get_contents() Para ler o arquivo em uma string e retorná-lo.

Comentário:A partir do PHP 4.3.0, o file() pode ser usado de forma segura para arquivos binários.

Comentário:Se o PHP não reconhecer o caractere de fim de linha do arquivo Macintosh ao ler o arquivo, pode ativar a opção de configuração de tempo de execução auto_detect_line_endings.

Exemplo

<?php
print_r(file("test.txt"));
?>

Saída:

Array
(
[0] => Olá Mundo. Testando, testando!
[1] => Outro dia, outra linha.
[2] => Se o array pega essa linha:
[3] => então é uma pergunta retórica?
)