Joomla! Programmierung/Framework/JFolder/folders

JFolder/folders ist eine Helferfunktion um die Ordnernamen eines Ordners einzulesen.

Syntax

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

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

• @return array Ordner innerhalb eines angegebenen Ordners.
• @since

Parameter	Datentyp	Beschreibung	Standardwert
$path	string	Der Pfad zum einzulesenden Ordner
[$filter]	string	Filter für Ordnernamen (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 Ordnernamen 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 Ordner, die bei der Suche ausgeschlossen werden sollen.	array('^\..*')

Beispiel

Alle Ordner innerhalb eines Ordners ausgeben	Ausgabe
$pfad = JPATH_ADMINISTRATOR.DS.'components'.DS.'com_media'; $ordner = JFolder::folders($pfad); print_r($ordner);	Array (     [1] => assets     [0] => controllers     [4] => helpers     [2] => images     [5] => models     [3] => views )

Weitere Beispiele

• Siehe JFolder::files()

Siehe auch

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

Quellcode

 libraries

•  joomla
  •  filesystem
    •  folder.php

public static function folders($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_FOLDER', $path));
      return false;
   }
 
   // Compute the excludefilter string
   if (count($excludefilter))
   {
      $excludefilter_string = '/(' . implode('|', $excludefilter) . ')/';
   }
   else
   {
      $excludefilter_string = '';
   }
 
   // Get the folders
   $arr = self::_items($path, $filter, $recurse, $full, $exclude, $excludefilter_string, false);
 
   // Sort the folders
   asort($arr);
   return array_values($arr);
}