Mr.X


<?php

require_once __DIR__ . "/wfInvalidPathException.php";
require_once __DIR__ . "/wfInaccessibleDirectoryException.php";

class wfFileUtils {

    const CURRENT_DIRECTORY = '.';
    const PARENT_DIRECTORY = '..';
    const DIRECTORY_SEPARATOR = '/';

    public static function isCurrentOrParentDirectory($file) {
        return $file === self::CURRENT_DIRECTORY || $file === self::PARENT_DIRECTORY;
    }

    public static function getContents($directory) {
        $contents = @scandir($directory);
        if ($contents === false)
            throw new wfInaccessibleDirectoryException("Unable to read contents", $directory);
        return array_filter($contents, function ($file) { return !wfFileUtils::isCurrentOrParentDirectory($file); });
    }

    public static function trimSeparators($path, $trimLeft = true, $trimRight = true) {
        if ($trimLeft)
            $path = ltrim($path, self::DIRECTORY_SEPARATOR);
        if ($trimRight)
            $path = rtrim($path, self::DIRECTORY_SEPARATOR);
        return $path;
    }

    public static function joinPaths() {
        $paths = func_get_args();
        $count = count($paths);
        $filtered = array();
        $trailingSeparator = false;
        for ($i = 0; $i < $count; $i++) {
            $path = self::trimSeparators($paths[$i], !empty($filtered));
            if (!empty($path)) {
                $filtered[] = $path;
                $trailingSeparator = substr($paths[$i], -1) === self::DIRECTORY_SEPARATOR;
            }
        }
        return implode(self::DIRECTORY_SEPARATOR, $filtered) . ($trailingSeparator ? self::DIRECTORY_SEPARATOR : '');
    }

    public static function splitPath($path, &$count = null) {
        $components = array_values(array_filter(explode(self::DIRECTORY_SEPARATOR, $path)));
        $count = count($components);
        return $components;
    }

    public static function isReadableFile($file) {
        return @is_file($file) && @is_readable($file);
    }

    public static function belongsTo($child, $parent) {
        $childComponents = self::splitPath($child, $childCount);
        $parentComponents = self::splitPath($parent, $parentCount);
        if ($childCount < $parentCount)
            return false;
        for ($i = 0; $i < $parentCount; $i++) {
            if ($childComponents[$i] !== $parentComponents[$i])
                return false;
        }
        return true;
    }

    public static function matchPaths($a, $b, $allowChild = false) {
        $aComponents = self::splitPath($a, $aCount);
        $bComponents = self::splitPath($b, $bCount);
        if ($allowChild ? ($bCount < $aCount) : ($aCount !== $bCount))
            return false;
        for ($i = 0; $i < $aCount; $i++) {
            if ($aComponents[$i] !== $bComponents[$i])
                return false;
        }
        return true;
    }

    public static function realPath($path) {
        $realPath = realpath($path);
        if ($realPath === false)
            throw new wfInvalidPathException("Realpath resolution failed", $path);
        return $realPath;
    }

    public static function isChild($parent, $child) {
        return self::matchPaths($parent, $child, true);
    }

}