array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.fgetss.php', 1 => 'fgetss', 2 => 'Ler uma linha de um ponteiro de arquivo e retira as tags HTML', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Funções de Filesystem', ), 'prev' => array ( 0 => 'function.fgets.php', 1 => 'fgets', ), 'next' => array ( 0 => 'function.file.php', 1 => 'file', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/filesystem/functions/fgetss.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

fgetss

(PHP 4, PHP 5, PHP 7)

fgetss — Ler uma linha de um ponteiro de arquivo e retira as tags HTML

Aviso

Esta função foi DESCONTINUADA a partir do PHP 7.3.0 e foi REMOVIDA a partir do PHP 8.0.0. O uso desta função é fortemente desencorajado.

Descrição

fgetss(resource $handle, int $length = ?, string $allowable_tags = ?): string

Idêntico a fgets(), exceto que fgetss() tenta retirar qualquer byte NUL, tag HTML ou PHP do texto que ela lê. A função retém o estado de interpretação de chamada para chamada, e desta forma não É equivalente a chamar strip_tags() no valor de retorno de fgets().

Parâmetros

handle

O ponteiro de arquivo deve ser válido e deve apontar para um arquivo aberto com sucesso por fopen() ou fsockopen() (e ainda não fechado por fclose()).

length

Tamanho da informação a ser recebida.

allowable_tags

Pode-se usar o terceiro parâmetro opcional para especificar as tags que não devem ser removidas. Consulte strip_tags() para detalhes sobre allowable_tags.

Valor Retornado

Retorna uma stirng de até length - 1 bytes lidos do arquivo apontado por handle, com todo o código HTML e PHP removidos.

Se um erro ocorrer, retorna false.

Exemplos

Exemplo #1 Lendo um arquivo PHP linha por linha

<?php
$str = <<<EOD
<html><body>
<p>Bem-vindo! Hoje é <?php echo(date('jS')); ?> de <?= date('F'); ?>.</p>
</body></html>
Texto fora do bloco HTML.
EOD;
file_put_contents('sample.php', $str);

$handle = @fopen("sample.php", "r");
if ($handle) {
while (!feof($handle)) {
$buffer = fgetss($handle, 4096);
echo $buffer;
}
fclose($handle);
}
?>

O exemplo acima produzirá algo semelhante a:

Bem-vindo! Hoje é  de .

Texto fora do bloco HTML.

Notas

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.

Veja Também