fwrite

(PHP 3, PHP 4 , PHP 5)

fwrite -- Gravação em arquivos binary-safe

Descrição

int fwrite ( resource handle, string string [, int comprimento] )

fwrite() grava os conteúdos de string para o stream de arquivo apontado por handle. Se o argumento comprimento é dado, a gravação irá parar depois de que comprimento bytes foram escritos ou o fim da string é alcançada, o que ocorrer primeiro.

fwrite() retorna o número de bytes gravados, ou FALSE em caso de erro.

Note que se o argumento comprimento é dado, então a opção de configuração magic_quotes_runtime será ignorada e nenhuma barra será retirada do string.

Nota: Em sistemas que diferenciam entre arquivos binários e texto (por exemplo Windows) o arquivo tem que ser aberto com 'b' incluído no parametro mode do fopen().

Exemplo 1. Exemplo fwrite

<?php
$filename
= 'teste.txt';
$somecontent = "Acrescentando isto no arquivo\n";

// Tendo certeza que o arquivo existe e que há permissão de escrita primeiro.
if (is_writable($filename)) {

    
// Em nosso exemplo, nós estamos abrindo $filename em modo de append (acréscimo).
    // O ponteiro do arquivo estará no final dele desde
    // que será aqui que $somecontent será escrito com fwrite().
    
if (!$handle = fopen($filename, 'a')) {
         print
"Erro abrindo arquivo ($filename)";
         exit;
    }

    
// Escrevendo $somecontent para o arquivo aberto.
    
if (!fwrite($handle, $somecontent)) {
        print
"Erro escrevendo no arquivo ($filename)";
        exit;
    }

    print
"Sucesso: escrito ($somecontent) no arquivo ($filename)";

    
fclose($);

} else {
    print
"The file $filename is not writable";
}
?>

Veja também fread(), fopen(), fsockopen(), popen() e fputs().