2017 © Pedro Peláez
 

library filesystem

Library for advanced filesystem functions

image

ichhabrecht/filesystem

Library for advanced filesystem functions

  • Monday, September 12, 2016
  • by IchHabRecht
  • Repository
  • 1 Watchers
  • 0 Stars
  • 162 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 7 Versions
  • 0 % Grown

The README.md

filesystem

Library for advanced filesystem functions., (*1)

Latest Stable Version Build Status, (*2)

Installation

It's recommended that you use Composer to include filesystem in your project., (*3)

$ composer require ichhabrecht/filesystem

Usage

Fileidentity

$fileidentity = new \IchHabRecht\Filesystem\Fileidentity();
if (!$fileidentity->canBeValidated('/path/to/file') || $fileidentity->isValid('/path/to/file')) {
    // Do something
}

canBeValidated

Check if the extension of a file has a registered signature in Fileidentity class and so its content can be validated., (*4)

isValid

Test the first bytes of a file to be valid according to its known signature. If the file does not exist or is not readable an error is thrown. You can use canBeValidated() to ensure the file can be validated., (*5)

Filemode

$filemode = new \IchHabRecht\Filesystem\Filemode();
$filemode->setPermissions('/path/to/adjust', $settings);

Settings

The settings parameter is an array with either a key named file or folder or both., (*6)

You can enforce a hard setting of permissions by using a string value or ensure different permissions by defining them in an array., (*7)

// This sets file permissions to read and execute (5) and folder permissions to read, write and execute (7)
$settings = [
    'file' => '555',
    'folder' => '777',
];

// This ensures read and write access (6) for files, as well as write and execute access (3) for folders
$settings = [
    'file' => [
        'user' => 6,
        'group' => 6,
        'other' => 6,
    ],
    'folder' => [
        'user' => 3,
        'group' => 3,
        'other' => 3,
    ],
];

You can use different permissions for the user, group and other values or just specify the ones you want to ensure., (*8)

Filepath

$filepath = new \IchHabRecht\Filesystem\Filepath('/', true);
$filepath->concatenate('/var/', 'www', 'vhosts'); // Returns '/var/www/vhosts'
$filepath->ensureDirectorySeparator('C:\\Users\\All Users\\Favorites'); // Returns 'C:/Users/All Users/Favorites'
$filepath->normalize('/var/www/./../../vhosts'); // Returns '/vhosts'

Initialization

If you initialize a new object, you can specify the directory separator used for further processing as well as declare if this separator should be enforced for given paths. Directory separator can be either slash or backslash., (*9)

Concatenate

You can pass any number of string arguments to this function. All arguments are concatenated with the specified directory separator. Trailing slashes are removed., (*10)

EnsureDirectorySeparator

All directory separators (/ and \) are converted into the specified one., (*11)

Normalize

The functions removes doubled (or multiple) directory separators and resolves path traversals., (*12)

The Versions

12/09 2016

dev-master

9999999-dev https://github.com/IchHabRecht/filesystem

Library for advanced filesystem functions

  Sources   Download

MIT

The Development Requires

by Nicole Cordes

filesystem permissions chmod filemode

12/09 2016

0.4.1

0.4.1.0 https://github.com/IchHabRecht/filesystem

Library for advanced filesystem functions

  Sources   Download

MIT

The Development Requires

by Nicole Cordes

filesystem permissions chmod filemode

20/06 2016

dev-develop

dev-develop https://github.com/IchHabRecht/filesystem

Library for advanced filesystem functions

  Sources   Download

MIT

The Development Requires

by Nicole Cordes

filesystem permissions chmod filemode

20/06 2016

0.4.0

0.4.0.0 https://github.com/IchHabRecht/filesystem

Library for advanced filesystem functions

  Sources   Download

MIT

The Development Requires

by Nicole Cordes

filesystem permissions chmod filemode

09/06 2016

0.3.0

0.3.0.0 https://github.com/IchHabRecht/filesystem

Library for advanced filesystem functions

  Sources   Download

MIT

The Development Requires

by Nicole Cordes

filesystem permissions chmod filemode

08/06 2016

0.2.0

0.2.0.0 https://github.com/IchHabRecht/filesystem

Library for advanced filesystem functions

  Sources   Download

MIT

The Development Requires

by Nicole Cordes

filesystem permissions chmod filemode

07/06 2016

0.1.0

0.1.0.0 https://github.com/IchHabRecht/filesystem

  Sources   Download

MIT

The Development Requires

by Nicole Cordes

filesystem chmod filemode umask