PHPackages                             donald1597/disk-usage - 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. donald1597/disk-usage

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

donald1597/disk-usage
=====================

A package to display and manage disk usage.

1.2.1(1y ago)317MITBladePHP ^8.0

Since Jul 23Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Donald1597/disk-usage)[ Packagist](https://packagist.org/packages/donald1597/disk-usage)[ RSS](/packages/donald1597-disk-usage/feed)WikiDiscussions main Synced yesterday

READMEChangelogDependenciesVersions (6)Used By (0)

Disk Usage Package for Laravel
==============================

[](#disk-usage-package-for-laravel)

**Disk Usage Package** is a Laravel package designed to monitor and manage disk usage within your Laravel application. It provides an intuitive interface to view and manage disk usage statistics, making it easier to keep track of your project's storage.

Features
--------

[](#features)

- View the total size of the Laravel project directory.
- Monitor server disk space including total, free, and used space.
- Visualize disk usage with interactive charts.
- Detailed view of directory contents including file size and type.
- Option to delete files and directories directly from the interface.

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

[](#installation)

1. **Add the Package to Your Project**

    You can install the package via Composer. Run the following command in your Laravel project directory:

    ```
    composer require donald1597/disk-usage
    ```
2. **Add the Service Provider to your `config/app.php`:**

    Open your `config/app.php` file and add the following line to the `providers` array:

    ```
    Donald1597\DiskUsage\Http\DiskUsageServiceProvider::class,
    ```
3. Publishing the Configuration

```
php artisan vendor:publish --provider="Donald1597\DiskUsage\Http\DiskUsageServiceProvider" --tag=config
```

4. Make sure to set these variables in your .env file: for example

```
DISK_USAGE_THRESHOLD_PERCENTAGE=1
DISK_USAGE_THRESHOLD_ABSOLUTE=1048576
DISK_USAGE_NOTIFICATION_EMAIL=user@example.com
```

5. Set Up Queues for Notifications

Notification
------------

[](#notification)

When disk usage exceeds the defined thresholds, an email notification will be sent to the address specified in DISK\_USAGE\_NOTIFICATION\_EMAIL.

To handle email notifications asynchronously, you need to configure Laravel queues. Follow these steps:

Configure the Queue Driver

In your .env file, set up the queue driver:

```
QUEUE_CONNECTION=database
```

You can also choose other queue drivers like redis or sqs depending on your setup.

Create a Queue Table

If you are using the database queue driver, create the necessary tables by running:

```
php artisan queue:table
php artisan migrate
```

6. Run the Queue Worker

Start the queue worker to process the queued jobs:

```
php artisan queue:work
```

Usage
-----

[](#usage)

After installation, you can access the disk usage dashboard via the route: disk-usage

Uninstallation
--------------

[](#uninstallation)

To uninstall the package:

1. **Remove the package via Composer:**

    ```
    composer remove donald1597/disk-usage
    ```
2. **Remove the Service Provider from `config/app.php`:**

    Open your `config/app.php` file and remove the following line from the `providers` array:

    ```
    Donald1597\DiskUsage\Http\DiskUsageServiceProvider::class,
    ```
3. **Clean up any published assets or configurations if necessary.**

Contributing
------------

[](#contributing)

Feel free to contribute to this package by opening issues or submitting pull requests.

License
-------

[](#license)

This package is licensed under the [MIT License](LICENSE).

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance31

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

5

Last Release

705d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/100026197?v=4)[Donald APOVO](/maintainers/donald1597)[@Donald1597](https://github.com/Donald1597)

---

Top Contributors

[![Donald1597](https://avatars.githubusercontent.com/u/100026197?v=4)](https://github.com/Donald1597 "Donald1597 (13 commits)")

### Embed Badge

![Health badge](/badges/donald1597-disk-usage/health.svg)

```
[![Health](https://phpackages.com/badges/donald1597-disk-usage/health.svg)](https://phpackages.com/packages/donald1597-disk-usage)
```

PHPackages © 2026

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