JFile/read

JFile/read liest den Inhalt einer Datei.

Syntax

static read( $filename, [$incpath], [$amount], [$chunksize], [$offset] )

• @return mixed - string Der Inhalt der Datei / bool false bei einem Fehler
• @since

Parameter	Datentyp	Beschreibung	Standardwert
$filename	string	Der komplette Pfad zur Datei	---
[$incpath]	boolean	Soll der Include Path genutzt werden ?	false
[$amount]	integer	Die Menge die von der Datei gelesen werden soll	0
[$chunksize]	integer	Die Grösse der Stücke (chunks)	8192
[$offset]	integer	Der Versatz (offset)	0

Beispiel

$fileName = 'pfad'.DS.'zur'.DS.'datei.txt';
 
if( ! $buffer = JFile::read($fileName) )
{
   echo 'Die Datei konnte nicht gelesen werden';
   return false;
}
 
echo $buffer;

Siehe auch

• JFile->read() auf api.joomla.org

Quellcode

 libraries

•  joomla
  •  filesystem
    •  file.php

public static function read($filename, $incpath = false, $amount = 0, $chunksize = 8192, $offset = 0)
{
   // Initialise variables.
   $data = null;
   if ($amount && $chunksize > $amount)
   {
      $chunksize = $amount;
   }
 
   if (false === $fh = fopen($filename, 'rb', $incpath))
   {
      JError::raiseWarning(21, JText::sprintf('JLIB_FILESYSTEM_ERROR_READ_UNABLE_TO_OPEN_FILE', $filename));
 
      return false;
   }
 
   clearstatcache();
 
   if ($offset)
   {
      fseek($fh, $offset);
   }
 
   if ($fsize = @ filesize($filename))
   {
      if ($amount && $fsize > $amount)
      {
         $data = fread($fh, $amount);
      }
      else
      {
         $data = fread($fh, $fsize);
      }
   }
   else
   {
      $data = '';
      // While it's:
      // 1: Not the end of the file AND
      // 2a: No Max Amount set OR
      // 2b: The length of the data is less than the max amount we want
      while (!feof($fh) && (!$amount || strlen($data) < $amount))
      {
         $data .= fread($fh, $chunksize);
      }
   }
   fclose($fh);
 
   return $data;
}