Comment faire fonctionner `temporaryUrl()` de MinIO avec Laravel

Storage::disk('s3')->temporaryUrl() de Laravel génère des URLs signées pour vos fichiers privés dans MinIO. Sauf que dans Docker, les URLs générées pointent vers le hostname interne du conteneur et ne marchent pas dans le navigateur.

Voici la config minimale qui règle le problème.

Étape 1 : Définir un nom de conteneur stable

Dans votre fichier docker-compose.yml, configurez le service MinIO avec un nom de conteneur fixe :

minio:
  image: "minio/minio:latest"
  ports:
    - "9000:9000"
    - "8900:8900"
  container_name: dev.minio.example.com
  environment:
    MINIO_ROOT_USER: "example"
    MINIO_ROOT_PASSWORD: "password"
  volumes:
    - "example-minio:/data/minio"
  networks:
    - example-network
  command: minio server /data/minio --console-address ":8900"

Pourquoi ça marche

Le nom du conteneur sert de hostname. Laravel l’utilise pour joindre MinIO dans Docker, et vous allez le mapper vers 127.0.0.1 sur votre machine (étape suivante) pour que votre navigateur y accède aussi. Pas de VIRTUAL_HOST, pas d’alias réseau.

Étape 2 : Modifier `/etc/hosts` pour un accès local

Sur votre machine locale, ajoutez cette ligne à votre fichier /etc/hosts (Linux/macOS) ou C:\Windows\System32\drivers\etc\hosts (Windows) :

127.0.0.1 dev.minio.example.com

Maintenant http://dev.minio.example.com pointe vers votre machine locale. Les URLs signées marcheront dans votre navigateur.

Étape 3 : Générer des identifiants MinIO

N’utilisez pas les identifiants root dans votre app. Créez une clé dédiée depuis la console MinIO :

Ouvrir la console MinIO : http://localhost:8900
Se connecter avec :
- Utilisateur : example
- Mot de passe : password
Aller dans Identity > Users
Cliquer sur “Create User” et générer :
- AWS_ACCESS_KEY_ID
- AWS_SECRET_ACCESS_KEY
Assigner les droits de lecture et d’écriture à cet utilisateur.

Étape 4 : Configurer Laravel

Mettez à jour votre .env avec les identifiants que vous venez de créer :

AWS_ACCESS_KEY_ID=your_generated_access_key
AWS_SECRET_ACCESS_KEY=your_generated_secret_key
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=test-storage
AWS_URL=http://dev.marketplace-api.example.com:9000/test-storage
AWS_ENDPOINT=http://dev.minio.example.com:9000
AWS_USE_PATH_STYLE_ENDPOINT=true

Ce que chaque champ fait :

Champ	Description
AWS_URL	L’URL de votre app Laravel suivie du port MinIO + nom du bucket
AWS_ENDPOINT	Adresse interne vers le conteneur MinIO
Clés AWS	Générées depuis la console MinIO

Pensez à vider le cache de Laravel après mise à jour :

php artisan config:clear
php artisan cache:clear

Étape 5 : Générer une URL temporaire avec Laravel

C’est tout. Générez une URL signée :

use Illuminate\Support\Facades\Storage;
use Carbon\Carbon;

$filePath = 'documents/sample.pdf';
$expiration = Carbon::now()->addMinutes(60); // URL valide pendant 1h

$url = Storage::disk('s3')->temporaryUrl($filePath, $expiration);

return response()->json(['temporary_url' => $url]);

L’astuce en résumé

Le vrai problème est la résolution du hostname. Les conteneurs Docker utilisent des hostnames internes, mais votre navigateur a besoin d’atteindre le même hostname depuis l’extérieur. Nommer le conteneur comme un domaine et le mapper dans /etc/hosts résout les deux côtés d’un coup.

Cinq minutes de config. Pas de proxy nginx, pas d’alias réseau, pas de middleware custom.

Comment faire fonctionner temporaryUrl() de MinIO avec Laravel