array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.file.php', 1 => 'file', 2 => 'Lê todo o arquivo para um array', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funções de Filesystem', ), 'prev' => array ( 0 => 'function.fgetss.php', 1 => 'fgetss', ), 'next' => array ( 0 => 'function.file-exists.php', 1 => 'file_exists', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/filesystem/functions/file.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

file

(PHP 4, PHP 5, PHP 7, PHP 8)

file — Lê todo o arquivo para um array

Descrição

file(string $filename, int $flags = 0, ?resource $context = null): array|false

Carrega todo um arquivo em um array.

Nota:

Pode-se utilizar file_get_contents() para retornar o conteúdo de um arquivo como uma string.

Parâmetros

filename

Caminho para o arquivo.

Dica

Uma URL pode ser usada como um nome de arquivo com esta função se os empacotadores fopen estiverem habilitados. Consulte a função fopen() para mais detalhes sobre como especificar o nome do arquivo. Consulte os Protocolos e empacotadores suportados para obter links para informações sobre as capacidades de cada empacotador, notas de uso e informações sobre quaisquer variáveis predefinidas que eles possam fornecer.

flags

O parâmetro opcional flags pode ser uma ou mais das seguintes constantes:

FILE_USE_INCLUDE_PATH
Procurar pelo arquivo no include_path.
FILE_IGNORE_NEW_LINES
Omite a quebra de linha no final de cada elemento do array.
FILE_SKIP_EMPTY_LINES
Pula linhas vazias.
FILE_NO_DEFAULT_CONTEXT
Não usa o contexto padrão.

context

Um resource de contexto de fluxo.

Valor Retornado

Retorna o arquivo em um array. Cada elemento do array corresponde a uma linha no arquivo, ainda com a quebra de linha. Em caso de falha, file() retorna false

Nota:

Cada linha no array incluirá a quebra de linha, a não ser que FILE_IGNORE_NEW_LINES seja usado.

Nota: Se o PHP não estiver reconhecendo corretamente os finais de linha ao ler arquivos em um computador Macintosh ou que foram criados em um, habilitar a opção de configuração em tempo de execução auto_detect_line_endings pode ajudar a resolver o problema.

Erros/Exceções

A partir do PHP 8.3.0, lança uma exceção ValueError se flags incluir qualquer valor inválido, tal como FILE_APPEND.

Emite um aviso E_WARNING se o arquivo não existe.

Registro de Alterações

Versão Descrição
8.3.0 Uma exceção ValueError é lançada para qualquer valor inválido no parâmetro flags.

Exemplos

Exemplo #1 Exemplo de file()

<?php
// Lê um arquivo em um array. Nesse exemplo será obtido o código fonte HTML de
// uma URL via HTTP
$lines = file ('http://www.example.com/');

// Percorre o array, mostrando o fonte HTML com numeração de linhas.
foreach ($lines as $line_num => $line) {
echo "Linha #<b>{$line_num}</b> : " . htmlspecialchars($line) . "<br />\n";
}

// Usando o parâmetro de opções opcionais
$trimmed = file('somefile.txt', FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
?>

Notas

Aviso

Ao usar SSL, o Microsoft IIS violará o protocolo fechando a conexão sem enviar uma notificação close_notify. O PHP reportará isso como "SSL: Fatal Protocol Error" quando chegar ao final dos dados. Para contornar isso, o valor de error_reporting deve ser reduzido a um nível que não inclua avisos. O PHP pode detectar servidores IIS defeituosos quando o fluxo é aberto usando o empacotador https:// e suprimirá o aviso. Ao usar fsockopen() para criar um soquete ssl://, o desenvolvedor é responsável por detectar e suprimir este aviso.

Veja Também