Joomla! Programmierung/Framework/JFolder/files

JFolder/files ist eine Helferfunktion um die Dateinamen eines Ordners einzulesen.

Syntax

static files( $path, [$filter], [$recurse], [$fullpath], [$exclude] )

static files( $path, [$filter], [$recurse], [$fullpath], [$exclude], [$excludefilter] )

• @return array Dateien im angegebenen Verzeichnis.
• @since

Parameter	Datentyp	Beschreibung	Standardwert
$path	string	Der Pfad zum Verzeichnis
[$filter]	string	Filter für Dateinamen (regulärer Ausdruck)	'.'
[$recurse]	mixed	True um Unterverzeichnisse rekursiv zu durchsuchen oder ein integer der die maximale rekursionstiefe angibt.	false
[$fullpath]	boolean	True um den kompletten Pfad zurückzugeben.	false
[$exclude]	array	Array mit Dateinamen die bei der Suche ausgeschlossen werden sollen.	array('.svn', 'CVS') array('.svn', 'CVS', '.DS_Store', '__MACOSX')
[$excludefilter]	array	Array mit regulären Ausdrücken für Dateien, die bei der Suche ausgeschlossen werden sollen.	array('^\..*','.*~')

Beispiele

Alle Dateien in einem Verzeichnis	Ausgabe
$path = JPATH_ADMINISTRATOR.DS.'components'.DS.'com_users'; $files = JFolder::files($path); print_r($files);	Array (     [3] => config.xml     [5] => controller.php     [4] => index.html     [1] => users.class.php     [2] => users.php     [0] => users.xml )

Nur Dateien die mit users beginnen	Ausgabe
$files = JFolder::files($path, '^users');	Array (     [1] => users.class.php     [2] => users.php     [0] => users.xml )

Alle Dateien mit Ausnahme der Dateien  index.html und  .svn	Ausgabe
$files = JFolder::files($path, '.', false, false, array('index.html', '.svn')); Weiteres Beispiel: Dateien die mit .xml oder .php enden $files = JFolder::files($path, '.xml$|.php$');	Array (     [3] => config.xml     [4] => controller.php     [1] => users.class.php     [2] => users.php     [0] => users.xml )

Siehe auch

• JFolder->files() auf api.joomla.org

Quellcode

 libraries

•  joomla
  •  filesystem
    •  folder.php

public static function files($path, $filter = '.', $recurse = false, $full = false, $exclude = array('.svn', 'CVS', '.DS_Store', '__MACOSX'),
   $excludefilter = array('^\..*', '.*~'))
{
   // Check to make sure the path valid and clean
   $path = JPath::clean($path);
 
   // Is the path a folder?
   if (!is_dir($path))
   {
      JError::raiseWarning(21, JText::sprintf('JLIB_FILESYSTEM_ERROR_PATH_IS_NOT_A_FOLDER_FILES', $path));
      return false;
   }
 
   // Compute the excludefilter string
   if (count($excludefilter))
   {
      $excludefilter_string = '/(' . implode('|', $excludefilter) . ')/';
   }
   else
   {
      $excludefilter_string = '';
   }
 
   // Get the files
   $arr = self::_items($path, $filter, $recurse, $full, $exclude, $excludefilter_string, true);
 
   // Sort the files
   asort($arr);
   return array_values($arr);
}