Traversing files and directories

The atkDirectoryTraverser can be used to recursively traverse a directory structure.
For each directory or file encountered, it calls callback methods on one or more callbackobjects.
This is similar to the unix 'find' command with an execute option.
You pass a callbackobject that performs the actual action. The full pathname of the file is passed as a parameter to the callback method.

Example where directory traverser is used to find all localization files in the temporary directory:

 class localefinder
 {
   var $m_locales = array();
   
   function visitFile($file)
   {
     $exploded = explode('/',$file);
     $filename = array_pop($exploded);
     $filepath = implode('/',$exploded).'/';
     
     if (substr($filename,0,strlen('localization_'))==='localization_' && substr($filename,-5)==='.conf')
     {
       $this->m_locales[] = $file;
     }
   }
   
   function getLocales()
   {
     return $this->m_locales;
   }
 }
 
 // Initialise objects
 $traverser = &atknew('atk.utils.atkdirectorytraverser');
 $localefinder = new localefinder();
 $traverser->addCallbackObject($localefinder);

 // Traverse the temporary directory
 $traverser->traverse(atkconfig('atktempdir'));

 // Get all the found files
 $locales = $localefinder->getLocales();