@studiocms/s3-storage

Le module d’extension Gestionnaire de stockage S3 de StudioCMS fournit la prise en charge du stockage S3 d’AWS pour StudioCMS. Ce module d’extension vous permet d’utiliser Amazon S3 ou tout autre service de stockage compatible avec S3 comme backend pour stocker les fichiers de votre application StudioCMS.

Utilisation

1. Installez le paquet à l’aide de la commande suivante :

   npm

   npm i @studiocms/s3-storage

   pnpm

   pnpm add @studiocms/s3-storage

   yarn

   yarn add @studiocms/s3-storage

2. Ajoutez ce module d’extension à votre fichier de configuration de StudioCMS. (studiocms.config.mjs)

   studiocms.config.mjs

   import { defineStudioCMSConfig } from 'studiocms/config';
   import s3Storage from '@studiocms/s3-storage';
   
   export default defineStudioCMSConfig({
      storageManager: s3Storage()
   });

3. Configurez les variables d’environnement requises dans votre fichier .env :

   .env

   CMS_S3_PROVIDER=AWS
   CMS_S3_REGION=us-east-1
   CMS_S3_ENDPOINT=  # Laisser vide pour AWS
   CMS_S3_ACCESS_KEY_ID=votre_clé_d_accès
   CMS_S3_SECRET_ACCESS_KEY=votre_clé_secrète
   CMS_S3_BUCKET_NAME=nom_de_votre_seau
   CMS_S3_FORCE_PATH_STYLE=false
   # CMS_S3_PUBLIC_ENDPOINT=  # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers

Exemples de variables d’environnement

AWS

.env

CMS_S3_PROVIDER=AWS
CMS_S3_REGION=us-east-1
CMS_S3_ENDPOINT=  # Laisser vide pour AWS
CMS_S3_ACCESS_KEY_ID=votre_clé_d_accès
CMS_S3_SECRET_ACCESS_KEY=votre_clé_secrète
CMS_S3_BUCKET_NAME=nom_de_votre_seau
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers

Cloudflare R2

.env

CMS_S3_PROVIDER=Cloudflare R2
CMS_S3_REGION=auto
CMS_S3_ENDPOINT=https://your-account-id.r2.cloudflarestorage.com
CMS_S3_ACCESS_KEY_ID=votre_clé_d_accès_r2
CMS_S3_SECRET_ACCESS_KEY=votre_clé_secrète_r2
CMS_S3_BUCKET_NAME=nom_de_votre_seau
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers

DigitalOcean Spaces

.env

CMS_S3_PROVIDER=DigitalOcean Spaces
CMS_S3_REGION=nyc3
CMS_S3_ENDPOINT=https://nyc3.digitaloceanspaces.com
CMS_S3_ACCESS_KEY_ID=votre_clé_spaces
CMS_S3_SECRET_ACCESS_KEY=votre_secret_spaces
CMS_S3_BUCKET_NAME=nom_de_votre_espace
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers

Backblaze B2

.env

CMS_S3_PROVIDER=Backblaze B2
CMS_S3_REGION=us-west-004
CMS_S3_ENDPOINT=https://s3.us-west-004.backblazeb2.com
CMS_S3_ACCESS_KEY_ID=id_de_votre_clé_b2
CMS_S3_SECRET_ACCESS_KEY=clé_de_votre_application_b2
CMS_S3_BUCKET_NAME=nom_de_votre_seau
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers

MinIO

.env

CMS_S3_PROVIDER=MinIO
CMS_S3_REGION=us-east-1
CMS_S3_ENDPOINT=http://localhost:9000
CMS_S3_ACCESS_KEY_ID=minioadmin
CMS_S3_SECRET_ACCESS_KEY=minioadmin
CMS_S3_BUCKET_NAME=nom_de_votre_seau
CMS_S3_FORCE_PATH_STYLE=true  # Requis pour MinIO
CMS_S3_PUBLIC_ENDPOINT=  # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers

Wasabi

.env

CMS_S3_PROVIDER=Wasabi
CMS_S3_REGION=us-east-1
CMS_S3_ENDPOINT=https://s3.us-east-1.wasabisys.com
CMS_S3_ACCESS_KEY_ID=votre_clé_wasabi
CMS_S3_SECRET_ACCESS_KEY=votre_secret_wasabi
CMS_S3_BUCKET_NAME=nom_de_votre_seau
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers

Linode Object Storage

.env

CMS_S3_PROVIDER=Linode
CMS_S3_REGION=us-east-1
CMS_S3_ENDPOINT=https://us-east-1.linodeobjects.com
CMS_S3_ACCESS_KEY_ID=votre_clé_linode
CMS_S3_SECRET_ACCESS_KEY=votre_secret_linode
CMS_S3_BUCKET_NAME=nom_de_votre_seau
CMS_S3_FORCE_PATH_STYLE=false
CMS_S3_PUBLIC_ENDPOINT=  # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers