Easily access and manage your files with PHP

v1.2.2 2023-04-20 19:15 UTC

This package is auto-updated.

Last update: 2024-03-20 21:23:34 UTC


README

FireFS Logo

FireFS

downloads downloads downloads downloads

Manage your file system easily, through php

FireFS is a library allowing you to write/read/delete files and folders of your file system, safely and easily.

It can be used for web applications as well for console applications, without any requirements.

Example

<?php

use ElementaryFramework\FireFS\FireFS;

// Create a new file system instance at the given path
$fs = new FireFS("./app"); // /root/var/www/htdocs/app/

// Check if the path "/root/var/www/htdocs/app/images/" exists
if ($fs->exists("images")) {
    // Change the working directory to the images folder
    $fs->setWorkingDirectory("./images");

    // Create a new file in the working directory
    $fs->mkfile("./logo.png"); // /root/var/www/htdocs/app/images/logo.png

    // Read file from the file system root path
    $logo = $fs->read("logo.png"); // /root/var/www/htdocs/app/logo.png

    // Write into the created file
    $fs->write("./logo.png", $logo); // /root/var/www/htdocs/app/images/logo.png

    // Delete the old file
    $fs->delete("logo.png"); // /root/var/www/htdocs/app/logo.png
}

// Change the working directory to the file system root path
$fs->setWorkingDirectory("./");

// Create a "blog" directory
$fs->mkdir("blog"); // /root/var/www/htdocs/app/blog/

// Move "images" folder from "app" to "app/blog"
$fs->move("images", "blog/images");

// And more !

Features

  • Easy file system management ;
  • Object Oriented file system entities management, through Folder and File classes ;
  • Receive events of what happen to your file system (created, modified, deleted events) and execute a specific action with the file system listener ;
  • Run a file system watcher to watch for files changes in real time (recommended for console applications or long running PHP processes)

Installation

You can install FireFS in your project with composer:

composer require elementaryframework/fire-fs

Once installed, you can access the FireFS api through the ElementaryFramework\FireFS namespace.

How to use

New to FireFS ? From console to web apps, you can read the wiki to know how to use this library into your project.

Additional resources and tutorials

Donate

Liking Elementary Framework? Help us continue to maintain it and provide you better support and awesome functionalities with a small donation!

Donate PayPal Button

License

© 2018-2020 Aliens Group.

Licensed under MIT (read license).