🛠️ Fluent, Secure, and Laravel-Ready: Meet LaraPath

As Laravel developers, we often overlook the complexity of file path generation—until it bites us. Whether you’re building multi-tenant storage systems, handling user uploads, or just trying to avoid naming collisions, path management can quickly become a mess.

Enter LaraPath, a fluent path builder for PHP and Laravel that brings clarity, security, and flexibility to your file handling logic.

🔐 Why Path Building Needs a Rethink

Traditional path concatenation is error-prone:

Hardcoded strings invite bugs
Directory traversal risks sneak in
Naming conflicts lead to data loss

LaraPath flips the script with a fluent API and sanitization strategies that make path building both safe and elegant.

$path = PathBuilder::base('storage')
    ->add('user@email.com', SanitizationStrategy::HASHED)
    ->toString();
// storage/5d41402abc4b2a76b9719d911017c592

🧼 Sanitization Strategies That Just Make Sense

LaraPath offers multiple strategies to transform your path segments:

HASHED: For privacy and uniqueness
SLUG: For URL-friendly names
SNAKE: For consistency
TIMESTAMP: For collision-free temp files

Each strategy is extensible, making it easy to adapt to your app’s needs.

⚙️ Laravel Integration That Feels Native

With Laravel 11+ support, LaraPath plugs right into your storage workflows:

$exists = LaraPath::base('uploads')
    ->add('avatar.jpg')
    ->exists('public'); // Uses Storage::disk('public')->exists()

//if using S3

 $laraPath = LaraPath::base('base')->add('sub')->toString();
 Storage::disk('s3')->makeDirectory($laraPath);

You also get container binding and validation out of the box, including protection against dangerous paths like ../../../etc/passwd.

🚀 Why This Matters for SaaS Builders

If you’re building multi-tenant apps or handling sensitive user data, LaraPath helps you:

Prevent accidental data exposure
Organize storage per user or tenant
Avoid naming collisions without reinventing the wheel

It’s a small package with big impact—especially when security and scalability are top priorities.