ehough/filesystem

Fork of Symfony's Filesystem Component compatible with PHP 5.2+

Installs: 971

Dependents: 1

Watchers: 1

Forks: 20

Language: PHP

v2.5.4 2014-09-24 16:39 UTC

README

Fork of Symfony's Filesystem component compatible with PHP 5.2+.

Motivation

Symfony's Filesystem component is a fantastic filesystem library, but it's only compatible with PHP 5.3+. While 97% of PHP servers run PHP 5.2 or higher, 32% of all servers are still running PHP 5.2 or lower (source). It would be a shame to exempt this library from nearly a third of the world's servers just because of a few version incompatibilities.

Once PHP 5.3+ adoption levels near closer to 100%, this library will be retired.

Differences from Symfony's Filesystem component

The primary difference is naming conventions of the Symfony classes. Instead of the \Symfony\Component\Filesystem namespace (and sub-namespaces), prefix the Symfony class names with ehough_filesystem and follow the PEAR naming convention

An examples of class naming conversion:

\Symfony\Component\Filesystem\Filesystem   ----->    ehough_filesystem_Filesystem

Usage

<?php

$filesystem = new ehough_filesystem_Filesystem();

$filesystem->copy($originFile, $targetFile, $override = false);

$filesystem->mkdir($dirs, $mode = 0777);

$filesystem->touch($files, $time = null, $atime = null);

$filesystem->remove($files);

$filesystem->chmod($files, $mode, $umask = 0000, $recursive = false);

$filesystem->chown($files, $user, $recursive = false);

$filesystem->chgrp($files, $group, $recursive = false);

$filesystem->rename($origin, $target);

$filesystem->symlink($originDir, $targetDir, $copyOnWindows = false);

$filesystem->makePathRelative($endPath, $startPath);

$filesystem->mirror($originDir, $targetDir, \Traversable $iterator = null, $options = array());

$filesystem->isAbsolutePath($file);

Releases and Versioning

Releases are synchronized with the upstream Symfony repository. e.g. ehough/filesystem v2.3.1 has merged the code from Symfony/Filesystem v2.3.1.