PHP Index File List/Link with Blacklist
New here? Learn about Bountify and follow @bountify to get notified of new bounties! x

Deliver a PHP file 'index.php' that when put into a folder on most PHP capable web hosts, will act as a file listing for the other files in the same folder. So when I put it in a folder on my webserver and browse to that URL, it will display a list of files in the same directory and include links to each file as well. If there's a folder, it will display that as a link to that folder, but will not search it's contents.

You should have a blacklist of files it won't display, including the index.php file itself, as well as directory commands like (. and ..).

Tip if you have have the PHP file also handle folder traversal into sub-folders (below it's own location, not above). This option should be able to be switched off, too.

Yes, there's open-source solutions out there. I want very basic, easy to understand code. I appreciate tight loops and a lack of extraneous code or styling. I'm looking to dissect the delivered code to see if I can learn more PHP.

awarded to magicmarkker

Crowdsource coding tasks.

2 Solutions


Here you have working solution:

In zip archive you have compressed index.php file.


// step 1: list of forbidden files
$forbidden = array('index.php');

// step 2: open directory, read files and close
$dir = opendir(".");
while ($entry = readdir($dir)) {
    $dir_contents[] = $entry;

// step 3: count and sort alphabetically
$dir_count = count($dir_contents);

// iterate on array from step 2
for ($index = 0; $index < $dir_count; $index++) {
    if (substr($dir_contents[$index], 0, 1) != "." && !in_array($dir_contents[$index], $forbidden)) {
        // print file/dir name with link, type and size
        echo "<a href=\"$dir_contents[$index]\">$dir_contents[$index]</a> - type: ".filetype($dir_contents[$index])." - size: ".filesize($dir_contents[$index])."<br>";


Below is what I use on my server and here is what it looks like. Directories are clickable and take you to a listing of that directory, and files are clickable as well. Pretty sure im just using famfamfam icons.
function have_filesize($bytes) {

    $size = $bytes / 1024;
    if($size < 1024) {
        $size = number_format($size, 2);
        $size .= ' KB';
     } else {
        if($size / 1024 < 1024) {
            $size = number_format($size / 1024, 2);
            $size .= ' MB';
        } else if ($size / 1024 / 1024 < 1024) {
            $size = number_format($size / 1024 / 1024, 2);
            $size .= ' GB';
    return $size; 
// Set the file's URL to a variable for easy reference
if(strstr($_SERVER['SCRIPT_FILENAME'], "/index.php") !== FALSE) {
    $self = $_SERVER['REQUEST_URI'];
    $directory = explode("/", $self);
    $counter = count($directory);
    $your_dir = "for /".$directory[$counter-2];
    if($_POST) {

        $target_path = $directory[$counter-2].'/';

        $target_path = basename( $_FILES['uploadedfile']['name']); 

        if(move_uploaded_file($_FILES['uploadedfile']['tmp_name'], $target_path)) {
            echo "The file ".  basename( $_FILES['uploadedfile']['name']). 
            " has been uploaded";
        } else{
            echo "There was an error uploading the file, please try again!";



<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "">
<html xmlns="">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Directory Listing <?=$your_dir;?></title>

<style type="text/css">

body {

    font-family: 'Lucida Sans', Verdana, Arial, Sans-Serif;
    color: #333;
    font-size: 76%;


ul {

    list-style-type: none;
    padding: 10px;
    margin: 0;
    width: 600px;


li span {

    float: right;


li {

    border-collapse: collapse;
    vertical-align: bottom;
    border-bottom: 1px solid #eee;
    padding: 8px 10px 3px 5px;


li.alt {

    border-collapse: collapse;
    vertical-align: bottom;
    border-bottom: 1px solid #eee;
    background-color: #fcfcfc;


li:hover {

    background-color: #f4f4f4;


a {

    color: #333;
    text-decoration: none;


a:hover {

    color: #f0a;


img {

    border: none;
    margin: 0 3px -3px 0;


h1 {

    color: #3a3;
    font-family: 'Lucida Sans', Verdana, Arial, Sans-Serif;
    font-size: 1.8em;
    font-weight: 100;
    margin-bottom: 0;



<form enctype="multipart/form-data" action="index.php" method="post">
<input type="hidden" name="MAX_FILE_SIZE" value="100000" />
Choose a file to upload: <input name="uploadedfile" type="file" /><br />
<input type="submit" value="Upload File" />

// Set the background color for table cells to alternate between

?><h1>Directory Listing <?=$your_dir;?></h1><?
// Read the files from the directory
$Dir = ".";
$Open = opendir ($Dir);
while ($Files = readdir ($Open)) {
    $Filename = "$Dir/" . $Files;
    $Type = filetype ("$Filename");
    if ($Files == '..'|| $Files == '.' || $Files == 'index.php') {
    } else {
        //If the file is a directory, list it out with a folder icon
        if (is_dir ($Filename)) {
            $Name = "<a href=\"".$Filename."\"><img src=\"/i/folder.png\" alt=\"Directory\" />$Files</a>";
            $Size = "Directory"; //Set Size column to "Directory"
        } else {
            //This grabs whatever is after the last . in the filename. This is good for files that have multiple periods in it's name
            $last = substr(strrchr($Files, "."), 1); 
            //Create a list of file types to associate with icons
            $types = array("jpg", "jpeg", "gif", "png", "php", "mp3", "zip", "psd", "pdf"); 
            //If the filetype of the file in the directory matches one in the types array above then set an icon for it
            if(in_array($last, $types)) {
                switch($last) {
                    case "jpg":
                    case "jpeg":
                    case "gif":
                    case "pdf":
                    case "png": $image = "/i/image.png"; break;
                    case "psd": $image = "/i/psd.png"; break;
                    case "php": $image = "/i/php.png"; break;
                    case "mp3": $image = "/i/mp3.png"; break;
                    case "zip": $image = "/i/zip.png"; break;
                    default: $image = "/i/default.png"; break;
            } else {
                //Set a default icon for the filetype
                $image = "/i/default.png"; 
            //Create the link to the file with the icon
            $Name = "<a href=\"".$Filename."\"><img src=\"".$image."\" alt=\"".$last." File\" />$Files</a>";
            //Set the filesize of the file
            $filesize = filesize ($Filename);
            //Create friendly filesize
            $Size = have_filesize($filesize);
    //Set name, size and type arrays
    $FileArray[] = $Name;
    $SizeArray[] = $Size;
    $TypeArray[] = $Type;
//Close directory
closedir ($Open);

// Define the two ways to sort the directory contents
$Sort = $_GET['sort'];
switch ($Sort) {
    case "SortByLow":
        array_multisort ($SizeArray, SORT_ASC, $FileArray);
        $sorting = "?sort=SortByHigh";
    case "SortByHigh":
        array_multisort ($SizeArray, SORT_DESC, $FileArray);
        $sorting = "?sort=SortByLow";
        array_multisort ($TypeArray, $FileArray, $SizeArray);
        $sorting = "?sort=SortByLow";
$cl = "";
// Print out the contents of the directory
echo "<ul>\n";
echo "<li><span><a href=\"".$sorting."\">Size</a></span><a href=\"".$_SERVER['PHP_SELF']."\">Filename</a></li>\n";

for ($n = 0; $n < count($FileArray); $n++) {
//This is used to place a class in every other list item for a different colored background
if($num = is_float($n/2)) {
    $cl = " class=\"$cellcolor2\"";
} else { $cl=""; }
    if($SizeArray[$n] == "directory") {
        echo ("<li".$cl."><span>$SizeArray[$n]</span>$FileArray[$n]</li>\n");
    } else {
        echo ("<li".$cl."><span>$SizeArray[$n]</span>$FileArray[$n]</li>\n");
echo "</ul>";


View Timeline