---
name: laravel:config-env-storage
description: Portable storage configuration across S3/R2/MinIO with optional CDN—env toggles, path-style endpoints, and URL generation
---

# Storage Config (S3/R2/MinIO/CDN)

Configure storage once; switch providers via env.

## Env

```
FILESYSTEM_DISK=s3
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
AWS_DEFAULT_REGION=auto
AWS_BUCKET=...
AWS_ENDPOINT=https://r2.example.com       # for R2/MinIO
AWS_USE_PATH_STYLE_ENDPOINT=true          # if required
MEDIA_CDN_URL=https://cdn.example.com     # optional CDN/base URL
```

## Tips

- Prefer pre‑signed URLs for uploads/downloads when possible
- For CDN, prefix public URLs with `MEDIA_CDN_URL` (app URL generation helper)
- Use path‑style only when necessary; some providers require it

## Testing

- Fake storage in unit tests (`Storage::fake('s3')`)
- Integration tests verify URL formats and ACLs