PHPackages                             ahmadaldali/helper-files - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. ahmadaldali/helper-files

ActiveLibrary[File & Storage](/categories/file-storage)

ahmadaldali/helper-files
========================

Make dealing with Files easier

v1.0.3(4y ago)241MITPHP

Since Feb 24Pushed 4y ago1 watchersCompare

[ Source](https://github.com/ahmadaldali/FilesHelper)[ Packagist](https://packagist.org/packages/ahmadaldali/helper-files)[ RSS](/packages/ahmadaldali-helper-files/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (5)Used By (0)

Files Helper
============

[](#files-helper)

*Make dealing with Files easier*
--------------------------------

[](#make-dealing-with-files-easier)

Files Helper is a package that allows you to deal with files easier. It will contain some methods like:

- Upload a new file (image, video, txt, pdf, etc ..) / *COMPLETED*.
- Upload a new file (image, video, txt, pdf, etc ..) with determining the driver storage / *COMPLETED*.
- Remove a file.

*Any Suggestion?*

Installation
------------

[](#installation)

Install the package in your application.

```
cd your_project
composer require ahmadaldali/helper-files
```

Usage
-----

[](#usage)

- Upload File (Testing with local and public drivers) .
    You can upload your file, by passing it with the stored folder(s) name, and the disK.
    The disk or the storage driver is optional and the default driver is "local".

```
use AhmadAldali\FilesHelper\UploadFile;

$response =  UploadFile::fileUpload($your_file,'folder_name');
OR
$response =  UploadFile::fileUpload($your_file,'folder_name', $disk);
```

Notes
-----

[](#notes)

1. The file will be stored in your\_folder inside determined storage driver.
2. your\_folder maybe many sub folders, Ex: ahmad\\sub\_ahmad\\images\\png\\
3. If you would use public disk, don't forget to create symolink with public folder.
4. full\_stored\_path = storage driver (disk) + stored\_path.
5. if it is uploaded successfully, you can see the result as follows, any failure happens you will get a null response.

```
{
    "origin_name": "xxxx.ext",
    "full_stored_path": "the full stored path inside the storage folder",
    "web_public_path": "path inside the public when create symlink",
    "stored_path": "path of the file and containg folder inside the disk",
    "extension": "txt | pdf | png | etc .. ",
    "size": in Bytes
}
```

Ex:

```
$response = UploadFile::fileUpload($request->file,'ahmad_folder','public');
{
    "origin_name": "Screenshot from 2022-02-23 22-13-11.png",
    "full_stored_path": "/storage/app/public/ahmad_folder/pax6QLXLp5.png",
    "web_public_path": "/myfiles/ahmad_folder/pax6QLXLp5.png",
    "stored_path": "/ahmad_folder/pax6QLXLp5.png",
    "extension": "png",
    "size": 239276
}
```

License
-------

[](#license)

MIT

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

4

Last Release

1584d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/32056043?v=4)[Ahmad Aldali](/maintainers/ahmadaldali)[@ahmadaldali](https://github.com/ahmadaldali)

---

Top Contributors

[![ahmadaldali](https://avatars.githubusercontent.com/u/32056043?v=4)](https://github.com/ahmadaldali "ahmadaldali (26 commits)")[![ahmadda95](https://avatars.githubusercontent.com/u/32056043?v=4)](https://github.com/ahmadda95 "ahmadda95 (26 commits)")

### Embed Badge

![Health badge](/badges/ahmadaldali-helper-files/health.svg)

```
[![Health](https://phpackages.com/badges/ahmadaldali-helper-files/health.svg)](https://phpackages.com/packages/ahmadaldali-helper-files)
```

###  Alternatives

[venveo/craft-compress

Create smart zip files from Craft assets on the fly

124.7k](/packages/venveo-craft-compress)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)