readfile-funktio

readfile-funktio lukee tiedoston ja lähettää sen sisällön välittömästi tulostepuskuriin. Se palauttaa luettujen tavujen määrän tai false virheen sattuessa. Ensimmäinen parametri on polku tiedostoon, toinen (valinnainen) on lippu tiedoston etsimiseksi include_pathista, kolmas (valinnainen) on striimikonteksti.

Syntaksi

phpreadfile(
  string $filename,
  bool $use_include_path = false,
  ?resource $context = null
): int|false

Esimerkki

Tulostetaan tekstitiedoston sisältö:

php<?php
  $res = readfile('example.txt');
  echo "luetut tavut: " . $res;
?>

Esimerkki

Yritetään lukea olematonta tiedostoa:

php<?php
  $res = readfile('nonexistent.txt');
  
  if ($res === false) {
    echo "Tiedoston lukeminen epäonnistui";
  }
?>

Esimerkki

Include_path-lippu käytössä:

php<?php
  $res = readfile('config.ini', true);
  echo $res !== false ? "Luku onnistui" : "Luku epäonnistui";
?>

Katso myös

  • funktion file_get_contents,
    joka lukee tiedoston merkkijonoksi
  • funktion fpassthru,
    joka tulostaa tiedoston loppuosan
  • funktion file,
    joka lukee tiedoston taulukoksi