Working with case insensitive filesystems

By default this package assumes you're working with a case sensitive filesystem, meaning you can have 2 files a and A inside a same directory. However this is not possible on a case insensitive filesystem (such as APFS on macOS), it will create only one of both.

If you're dealing with a case insensitive filesystem then you need to specify it on the adapter like this:

use Innmind\Filesystem\{
    Adapter,
    CaseSensitivity,
};
use Innmind\Url\Path;

$adapter = Adapter::mount(
    Path::of('somewhere/'),
    CaseSensitivity::insensitive,
)->unwrap()
$adapter instanceof Adapter; // true, use $adapter as usual

If you persist user provided files on a filesystem you should use normalized names (like UUIDs) and keep the original names in a database to avoid collisions.