StorageGuard Module for TableTrack

Important Requirement:

• This module is an add-on and requires installation of TableTrack – The Complete SaaS Restaurant Management Solution ( MAIN APP )
• It is not a standalone product and cannot be used without the main app

StorageGuard Module for TableTrack

The StorageGuard Module provides a robust safety layer for Laravel applications, ensuring all critical storage and cache directories exist at runtime. This prevents common errors like file_put_contents: No such file or directory by automatically creating required storage paths (such as storage/framework, storage/framework/cache/data, and more) whenever your app or Laravel’s filesystem needs them. StorageGuard transparently wraps Laravel’s filesystem and cache write operations for maximum reliability, even after deployments, cache clears, or in fresh container environments.

Note: StorageGuard is a drop-in module that requires no application code changes, no extra configuration, and is safe for both production and development environments.

Technical Features

• Automatically ensures all critical Laravel storage and cache directories exist before write operations
• Prevents application crashes from missing storage paths for cache, logs, and view compilation
• Custom Laravel filesystem binding that auto-creates directories as needed (put, append, prepend)
• Middleware checks and enforces directory structure on every web request (integrated with the web group)
• Compatible with all standard Laravel cache and logging mechanisms

Usage Requirements

• Laravel application (no minimum version specified; tested on Laravel 8+)

Setup & Operation

1. Install and enable the StorageGuard module in your Laravel app (the service provider is auto-registered).
2. No migrations or manual setup needed—the module handles all paths and registration internally.
3. To run directory checks manually, use the included service:

   Modules\StorageGuard\Services\PathEnsurer::ensureBasePaths()

4. The middleware alias storageguard.ensure is auto-applied to all web requests but can be invoked or removed as needed.

StorageGuard virtually eliminates missing-directory errors in Laravel, reducing deployment headaches and runtime instability.