omaralalwi / laravel-trash-cleaner
clean logs and debug files (clockwork , laravel telescope and more)
Requires
- php: ^7.4|^8.1|^8.2|^8.3|^8.4
This package is auto-updated.
Last update: 2025-06-29 22:10:44 UTC
README
Laravel Trash Cleaner is a lightweight and powerful utility package that helps you keep your Laravel application clean and performant by:
- ๐งน Deleting debug and log files (Clockwork, Debugbar).
- โก Clearing compiled view caches and frontend build directories.
- ๐ ๏ธ Optionally rebuilding frontend assets using tools like
npm
,yarn
, orpnpm
.
๐ Installation
Install the package via Composer:
composer require omaralalwi/laravel-trash-cleaner
๐ง Publish Configuration
Optionally, publish the configuration file to customize paths and build settings:
php artisan vendor:publish --tag=laravel-trash-cleaner
๐งน Usage
๐ธ Clean Debug Files
Cleans out storage/debugbar
and storage/clockwork
folders with a progress bar:
php artisan trash:clean
๐ธ Clean Asset Folders
Removes frontend-related build caches and compiled view files based on your config:
php artisan trash:clean-assets
๐ธ Clean + Rebuild Frontend (Optional)
Use the --build
flag to also run your frontend build steps (npm install && npm run build
or equivalent):
php artisan trash:clean-assets --build
This is ideal for resetting the build process after switching branches, clearing corrupted caches, or deploying updates.
customize Assets paths & commnds
Note: You can fully customize the asset cleanup paths and build commands in the configuration file. For example, if you're using
pnpm
instead of the defaultnpm
, make sure to update the config key to'package_manager' => 'pnpm'
.
โฐ Scheduling Automatic Cleanup
To automate cleanup using Laravel's scheduler:
- Enable it in your config:
'schedule' => true, 'frequency' => 'daily',
- Ensure Laravel's scheduler is running via cron:
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1
๐ค Contributing
Contributions are welcome! Please see CONTRIBUTING for details.
๐ก๏ธ Security
If you discover any security vulnerabilities, please contact: omaralwi2010@gmail.com
๐ License
Licensed under the MIT License.
๐ Helpful Open Source Packages
-
Lexi Translate simplify managing translations for multilingual Eloquent models with power of morph relationships and caching .
-
Gpdf Open Source HTML to PDF converter for PHP & Laravel Applications, supports Arabic content out-of-the-box and other languages..
-
laravel Taxify Laravel Taxify provides a set of helper functions and classes to simplify tax (VAT) calculations within Laravel applications.
-
laravel Deployer Streamlined Deployment for Laravel and Node.js apps, with Zero-Downtime and various environments and branches.
-
laravel Time Craft simple trait and helper functions that allow you, Effortlessly manage date and time queries in Laravel apps.
-
Laravel Startkit Laravel Admin Dashboard, Admin Template with Frontend Template, for scalable Laravel projects.