simple file browser

Feel free to improve it here, but PLEASE fill the 'notes' field below to explain your contribution.

documentation

An url like http://www.your-site.com/index.php/browser/**virtual_root**/**path** will allow people to browse directories and files that are under path from absolute_path. You define an absolute_path (in the file system of the server) for a virtual_root with this array

var $roots = array(
    'virtual_root' => 'absolute_path',
    //...
    );
   

This may allow us to browse files that are outside your web root, forcing the browsing via CI, and allowing us full control on accesses (not provided for the moment).

todo

• stats for directories and files
• links for sorting directories and files
• clever css markup
• several examples of stylesheets
• bells and hooks and whistles and filters to check accesses
• ...

changes

2009-10-22 - annoted in-code, line 98 of controller, '.$absolute.' changed to $absolute

the controller

<?php

// may only work if this controller is not in a subfolder

class Browser extends Controller {

    var $roots = array(
        'test' => '/home'
    );

    function Browser()
    {
        parent::Controller();
        // FAL check here
    }
    
    function _remap()
    {
        $segment_array = $this->uri->segment_array();
        
        // first and second segments are our controller and the 'virtual root'
        $controller = array_shift( $segment_array );
        $virtual_root = array_shift( $segment_array );
        
        if( empty( $this->roots )) exit( 'no roots defined' );
        
        // let's check if a virtual root is choosen
        // if this controller is the default controller, first segment is 'index'
        if ( $controller == 'index' OR $virtual_root == '' ) show_404();
        
        // let's check if a virtual root matches
        if ( ! array_key_exists( $virtual_root, $this->roots )) show_404();
        
        // build absolute path
        $path_in_url = '';
        foreach ( $segment_array as $segment ) $path_in_url.= $segment.'/';
        $absolute_path = $this->roots[ $virtual_root ].'/'.$path_in_url;
        $absolute_path = rtrim( $absolute_path ,'/' );
        
        // is it a directory or a file ?
        if ( is_dir( $absolute_path ))
        {
            // we'll need this to build links
            $this->load->helper('url');
            
            $dirs = array();
            $files = array();
            // let's traverse the directory
            if ( $handle = @opendir( $absolute_path ))
            {
                while ( false !== ($file = readdir( $handle )))
                {
                    if (( $file != "." AND $file != ".." ))
                    {
                        if ( is_dir( $absolute_path.'/'.$file ))
                        {
                            $dirs[]['name'] = $file;
                        }
                        else
                        {
                            $files[]['name'] = $file;
                        }
                    }
                }
                closedir( $handle );
                sort( $dirs );
                sort( $files );
                
                
            }
            // parent directory
            // here to ensure it's available and the first in the array
            if ( $path_in_url != '' )
                array_unshift ( $dirs, array( 'name' => '..' ));
            
            // send the view
            $data = array(
                'controller' => $controller,
                'virtual_root' => $virtual_root,
                'path_in_url' => $path_in_url,
                'dirs' => $dirs,
                'files' => $files,
                );
            $this->load->view( 'browser', $data );
        }
        else
        {
            // it's not a directory, but is it a file ?
            if ( is_file( $absolute_path ))
            {
                // let's serve the file
                header ('Cache-Control: no-store, no-cache, must-revalidate');
                header ('Cache-Control: pre-check=0, post-check=0, max-age=0');
                header ('Pragma: no-cache');
                 
                header('Content-Description: File Transfer');
                header('Content-Type: application/octet-stream');
                // header('Content-Length: ' . filesize( ".$absolute_path." ));  // Modified
                header('Content-Length: ' . filesize( $absolute_path ));
                header('Content-Disposition: attachment; filename=' . basename( $absolute_path ));
                
                @readfile( $absolute_path );
            }
            else
            {
                show_404();
            }
        }
    }
}

the view

<h1><?=$virtual_root?></h1>
<h2><?='/'.$path_in_url?></h2>
<?php
    $prefix = $controller.'/'.$virtual_root.'/'.$path_in_url;
    if (!empty($dirs)) foreach( $dirs as $dir )
        echo 'd '.anchor($prefix.$dir['name'], $dir['name']).'<br>';

    if (!empty($files)) foreach( $files as $file )
        echo anchor($prefix.$file['name'], $file['name']).'<br>';
?>