eden/folder

File methods

4.0.1 2015-10-13 04:47 UTC

This package is auto-updated.

Last update: 2024-03-13 19:47:25 UTC


README

Build Status

====

Install

composer install eden/folder

====

Introduction

Instantiate folder in this manner.

$folder = eden('folder', '/some/path/to/folder');

====

API

====

create

Creates a folder given the path

Usage

eden('folder', '/some/path/to/folder')->create(int $chmod);

Parameters

  • int $chmod - the UNIX permissions level

Returns Eden\Folder\Index

Example

eden('folder', '/some/path/to/folder')->create();

====

getFiles

Returns a list of files given the path and optionally the pattern

Usage

eden('folder', '/some/path/to/folder')->getFiles(string|null $regex, bool $recursive);

Parameters

  • string|null $regex - Regular expression to match files against
  • bool $recursive - To recursively look in folders

Returns array

Example

eden('folder', '/some/path/to/folder')->getFiles();

====

getFolders

Returns a list of folders given the path and optionally the regular expression

Usage

eden('folder', '/some/path/to/folder')->getFolders(string|null $regex, bool $recursive);

Parameters

  • string|null $regex - Regular expression to match folders against
  • bool $recursive - To recursively look in folders

Returns array

Example

eden('folder', '/some/path/to/folder')->getFolders();

====

getName

Returns the name of the directory.. just the name

Usage

eden('folder', '/some/path/to/folder')->getName();

Parameters

Returns string - the name

====

isFolder

Checks to see if this path is a real file

Usage

eden('folder', '/some/path/to/folder')->isFolder(string|null $path);

Parameters

  • string|null $path - the path to test against

Returns bool

Example

eden('folder', '/some/path/to/folder')->isFolder();

====

remove

Removes a folder given the path

Usage

eden('folder', '/some/path/to/folder')->remove();

Parameters

Returns Eden\Folder\Index

====

removeFiles

Removes files given the path and optionally a regular expression

Usage

eden('folder', '/some/path/to/folder')->removeFiles(string|null regular);

Parameters

  • string|null regular - expression

Returns Eden\Folder\Index

Example

eden('folder', '/some/path/to/folder')->removeFiles();

====

removeFolders

Removes a folder given the path and optionally the regular expression

Usage

eden('folder', '/some/path/to/folder')->removeFolders(string $regex);

Parameters

  • string $regex - Regular expression to test against

Returns Eden\Folder\Index

Example

eden('folder', '/some/path/to/folder')->removeFolders();

====

truncate

Removes files and folder given a path

Usage

eden('folder', '/some/path/to/folder')->truncate();

Parameters

Returns Eden\Folder\Index

====

#Contributing to Eden

Contributions to Eden are following the Github work flow. Please read up before contributing.

##Setting up your machine with the Eden repository and your fork

  1. Fork the repository
  2. Fire up your local terminal create a new branch from the v4 branch of your fork with a branch name describing what your changes are. Possible branch name types:
    • bugfix
    • feature
    • improvement
  3. Make your changes. Always make sure to sign-off (-s) on all commits made (git commit -s -m "Commit message")

##Making pull requests

  1. Please ensure to run phpunit before making a pull request.
  2. Push your code to your remote forked version.
  3. Go back to your forked version on GitHub and submit a pull request.
  4. An Eden developer will review your code and merge it in when it has been classified as suitable.