|
| 1 | +--- |
| 2 | +i18nReady: true |
| 3 | +title: "@studiocms/s3-storage" |
| 4 | +type: integration |
| 5 | +catalogEntry: studiocms-s3 |
| 6 | +description: "Le module d'extension Gestionnaire de stockage S3 de StudioCMS fournit la prise en charge du stockage S3 d'AWS pour StudioCMS." |
| 7 | +sidebar: |
| 8 | + badge: |
| 9 | + text: NOUVEAU |
| 10 | + variant: success |
| 11 | +--- |
| 12 | + |
| 13 | +import { PackageManagers } from 'starlight-package-managers' |
| 14 | +import { Steps } from '@astrojs/starlight/components'; |
| 15 | + |
| 16 | +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. |
| 17 | + |
| 18 | +## Utilisation |
| 19 | + |
| 20 | +<Steps> |
| 21 | + |
| 22 | +1. Installez le paquet à l'aide de la commande suivante : |
| 23 | + |
| 24 | + <PackageManagers type='add' pkg='@studiocms/s3-storage' /> |
| 25 | + |
| 26 | +2. Ajoutez ce module d'extension à votre fichier de configuration de StudioCMS. (`studiocms.config.mjs`) |
| 27 | + |
| 28 | + ```ts title="studiocms.config.mjs" {5} |
| 29 | + import { defineStudioCMSConfig } from 'studiocms/config'; |
| 30 | + import s3Storage from '@studiocms/s3-storage'; |
| 31 | + |
| 32 | + export default defineStudioCMSConfig({ |
| 33 | + storageManager: s3Storage() |
| 34 | + }); |
| 35 | + ``` |
| 36 | + |
| 37 | +3. Configurez les variables d'environnement requises dans votre fichier `.env` : |
| 38 | + |
| 39 | + ```sh title=".env" |
| 40 | + CMS_S3_PROVIDER=AWS |
| 41 | + CMS_S3_REGION=us-east-1 |
| 42 | + CMS_S3_ENDPOINT= # Laisser vide pour AWS |
| 43 | + CMS_S3_ACCESS_KEY_ID=votre_clé_d_accès |
| 44 | + CMS_S3_SECRET_ACCESS_KEY=votre_clé_secrète |
| 45 | + CMS_S3_BUCKET_NAME=nom_de_votre_seau |
| 46 | + CMS_S3_FORCE_PATH_STYLE=false |
| 47 | + # CMS_S3_PUBLIC_ENDPOINT= # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers |
| 48 | + ``` |
| 49 | + |
| 50 | +</Steps> |
| 51 | + |
| 52 | +## Exemples de variables d'environnement |
| 53 | + |
| 54 | +### AWS |
| 55 | + |
| 56 | +```sh title=".env" |
| 57 | +CMS_S3_PROVIDER=AWS |
| 58 | +CMS_S3_REGION=us-east-1 |
| 59 | +CMS_S3_ENDPOINT= # Laisser vide pour AWS |
| 60 | +CMS_S3_ACCESS_KEY_ID=votre_clé_d_accès |
| 61 | +CMS_S3_SECRET_ACCESS_KEY=votre_clé_secrète |
| 62 | +CMS_S3_BUCKET_NAME=nom_de_votre_seau |
| 63 | +CMS_S3_FORCE_PATH_STYLE=false |
| 64 | +CMS_S3_PUBLIC_ENDPOINT= # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers |
| 65 | +``` |
| 66 | + |
| 67 | +### Cloudflare R2 |
| 68 | + |
| 69 | +```sh title=".env" |
| 70 | +CMS_S3_PROVIDER=Cloudflare R2 |
| 71 | +CMS_S3_REGION=auto |
| 72 | +CMS_S3_ENDPOINT=https://your-account-id.r2.cloudflarestorage.com |
| 73 | +CMS_S3_ACCESS_KEY_ID=votre_clé_d_accès_r2 |
| 74 | +CMS_S3_SECRET_ACCESS_KEY=votre_clé_secrète_r2 |
| 75 | +CMS_S3_BUCKET_NAME=nom_de_votre_seau |
| 76 | +CMS_S3_FORCE_PATH_STYLE=false |
| 77 | +CMS_S3_PUBLIC_ENDPOINT= # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers |
| 78 | +``` |
| 79 | + |
| 80 | +### DigitalOcean Spaces |
| 81 | + |
| 82 | +```sh title=".env" |
| 83 | +CMS_S3_PROVIDER=DigitalOcean Spaces |
| 84 | +CMS_S3_REGION=nyc3 |
| 85 | +CMS_S3_ENDPOINT=https://nyc3.digitaloceanspaces.com |
| 86 | +CMS_S3_ACCESS_KEY_ID=votre_clé_spaces |
| 87 | +CMS_S3_SECRET_ACCESS_KEY=votre_secret_spaces |
| 88 | +CMS_S3_BUCKET_NAME=nom_de_votre_espace |
| 89 | +CMS_S3_FORCE_PATH_STYLE=false |
| 90 | +CMS_S3_PUBLIC_ENDPOINT= # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers |
| 91 | +``` |
| 92 | + |
| 93 | +### Backblaze B2 |
| 94 | + |
| 95 | +```sh title=".env" |
| 96 | +CMS_S3_PROVIDER=Backblaze B2 |
| 97 | +CMS_S3_REGION=us-west-004 |
| 98 | +CMS_S3_ENDPOINT=https://s3.us-west-004.backblazeb2.com |
| 99 | +CMS_S3_ACCESS_KEY_ID=id_de_votre_clé_b2 |
| 100 | +CMS_S3_SECRET_ACCESS_KEY=clé_de_votre_application_b2 |
| 101 | +CMS_S3_BUCKET_NAME=nom_de_votre_seau |
| 102 | +CMS_S3_FORCE_PATH_STYLE=false |
| 103 | +CMS_S3_PUBLIC_ENDPOINT= # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers |
| 104 | +``` |
| 105 | + |
| 106 | +### MinIO |
| 107 | + |
| 108 | +```sh title=".env" |
| 109 | +CMS_S3_PROVIDER=MinIO |
| 110 | +CMS_S3_REGION=us-east-1 |
| 111 | +CMS_S3_ENDPOINT=http://localhost:9000 |
| 112 | +CMS_S3_ACCESS_KEY_ID=minioadmin |
| 113 | +CMS_S3_SECRET_ACCESS_KEY=minioadmin |
| 114 | +CMS_S3_BUCKET_NAME=nom_de_votre_seau |
| 115 | +CMS_S3_FORCE_PATH_STYLE=true # Requis pour MinIO |
| 116 | +CMS_S3_PUBLIC_ENDPOINT= # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers |
| 117 | +``` |
| 118 | + |
| 119 | +### Wasabi |
| 120 | + |
| 121 | +```sh title=".env" |
| 122 | +CMS_S3_PROVIDER=Wasabi |
| 123 | +CMS_S3_REGION=us-east-1 |
| 124 | +CMS_S3_ENDPOINT=https://s3.us-east-1.wasabisys.com |
| 125 | +CMS_S3_ACCESS_KEY_ID=votre_clé_wasabi |
| 126 | +CMS_S3_SECRET_ACCESS_KEY=votre_secret_wasabi |
| 127 | +CMS_S3_BUCKET_NAME=nom_de_votre_seau |
| 128 | +CMS_S3_FORCE_PATH_STYLE=false |
| 129 | +CMS_S3_PUBLIC_ENDPOINT= # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers |
| 130 | +``` |
| 131 | + |
| 132 | +### Linode Object Storage |
| 133 | + |
| 134 | +```sh title=".env" |
| 135 | +CMS_S3_PROVIDER=Linode |
| 136 | +CMS_S3_REGION=us-east-1 |
| 137 | +CMS_S3_ENDPOINT=https://us-east-1.linodeobjects.com |
| 138 | +CMS_S3_ACCESS_KEY_ID=votre_clé_linode |
| 139 | +CMS_S3_SECRET_ACCESS_KEY=votre_secret_linode |
| 140 | +CMS_S3_BUCKET_NAME=nom_de_votre_seau |
| 141 | +CMS_S3_FORCE_PATH_STYLE=false |
| 142 | +CMS_S3_PUBLIC_ENDPOINT= # Facultatif : point de terminaison public personnalisé pour accéder aux fichiers |
| 143 | +``` |
0 commit comments