PHPackages                             comestro/laravel-disk-override - 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. comestro/laravel-disk-override

ActiveLibrary

comestro/laravel-disk-override
==============================

A drop-in Laravel FilesystemServiceProvider replacement resolving overlapping URI route collision errors.

v1.0.0(1mo ago)11↑2900%MITPHPPHP ^8.2

Since Mar 27Pushed 1mo agoCompare

[ Source](https://github.com/sadique-cws/laravel-disk-override)[ Packagist](https://packagist.org/packages/comestro/laravel-disk-override)[ RSS](/packages/comestro-laravel-disk-override/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

Laravel Disk Override
=====================

[](#laravel-disk-override)

A small Laravel package that gracefully resolves filesystem route collisions (`"The [private] disk conflicts with the [local] disk at [/storage]."`).

When Laravel 13 merges base default configurations with user configurations, default disks automatically appear in the disk list. If your custom disk (e.g. `private`) maps to the same serve URI as a default disk (e.g. `local`), a collision exception is thrown.

This package provides a drop-in replacement for the framework's `FilesystemServiceProvider` that safely deduplicates overlapping URIs by allowing your explicitly defined disks to "win" and override the framework defaults.

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

[](#installation)

You can install the package via Composer:

```
composer require comestro/laravel-disk-override
```

Configuration
-------------

[](#configuration)

Since this overrides a core Laravel binding, it **does not** use normal Package Auto-Discovery. You must manually swap out the framework's `FilesystemServiceProvider`.

### Laravel 11 & 13 (bootstrap/providers.php)

[](#laravel-11--13-bootstrapprovidersphp)

In `bootstrap/providers.php`, add the replacement logic:

```