Fillagring og innholdsbehandling
Applikasjonen din har et dedikert innholdsfilsystem for lagring av brukeropplastede filer som bilder, dokumenter, PDF-er og videoer. Dette er atskilt fra applikasjonskoden din og er designet for dynamisk innhold som brukere lager eller laster opp mens de bruker appen din.
Begrensninger og viktige merknader
- Individuelle filer kan være opptil 500MB store
- Filsletting er permanent — det finnes ingen søppelkasse eller papirkurv
- Lagringsbruk teller mot kontokvoten din
Hva innholdsfilsystemet muliggjør
Innholdsfilsystemet gir kraftige filbehandlingsfunksjoner for applikasjonen din:
- Lagre brukeravatarer, profilbilder og bildegallerier
- Godta dokumentopplastinger som CVer, kontrakter eller PDF-er
- Bygg fildelingsfunksjoner mellom brukere i appen din
- Lag bildetunge applikasjoner med automatisk optimalisering
- La brukere laste ned filer de har lastet opp eller som tilhører dem
- Bygg administrative verktøy der du administrerer filer på vegne av brukere
Hvordan det fungerer
Når du beskriver en funksjon som trenger fillagring til AI, håndterer den automatisk hele implementeringen:
Setter opp opplastingsgrensesnittet — Oppretter skjemaer eller dra-og-slipp-soner der brukere kan velge filer fra enheten sin
Konfigurerer tilgangskontroll — Bestemmer hvem som kan se, laste opp eller slette filer basert på hva du bygger
Implementerer bildeoptimalisering — Endrer automatisk størrelse og viser bilder effektivt slik at appen din lastes raskt
Oppretter lagringsstrukturen — Organiserer filer i logiske mapper som /content/uploads/ eller /content/avatars/
Håndterer backend — Administrerer selve fillagringen, hentingen og leveringen uten at du trenger å tenke på det
Filer lagres på stier som /content/uploads/photo.jpg og kan refereres direkte i appen din. Systemet sporer hvem som lastet opp hver fil, når den ble opprettet, og håndhever tilgangsreglene dine.
Tilgangskontroll for filer
Akkurat som databasetabeller og edge functions, har filer sikkerhetspolicyer som kontrollerer hvem som har tilgang til dem. Filer er private som standard — ingen har tilgang til dem før du konfigurerer tillatelser. AI setter disse opp basert på hva du bygger:
Offentlige filer
Alle kan se dem, selv uten å logge på. Påloggede brukere kan laste opp, og bare personen som lastet opp en fil kan slette den. Perfekt for fotogallerier, offentlig bildedeling eller brukergenererte innholdssider.
Private filer
Bare brukeren som lastet opp en fil kan se eller slette den. Brukes til sensitive dokumenter, private bilder, medisinske journaler eller noe brukere ikke vil at andre skal se.
Organisasjonsdelte filer
Brukere fra samme organisasjon kan se filer lastet opp av alle i deres organisasjon. Enkeltpersoner kan bare slette filer de lastet opp. Flott for teamdokumentdeling, bedriftsressurser eller samarbeidende arbeidsområder.
Kun eiertilgang
Bare du (appskaperen) har tilgang til disse filene, ikke sluttbrukerne dine. Nyttig for lagring av systemfiler, maler eller administrative ressurser som driver appen din, men som ikke skal være brukervendt.
Avansert tilgangskontroll
AI kan lage sofistikerte tilgangsregler basert på filmetadata. For eksempel:
- Publiserte artikler er offentlige, men utkast er kun synlige for forfatteren
- Filer merket med en avdeling er kun synlige for brukere i den avdelingen
- Premium-innhold krever et abonnementsflagg på brukerens konto
- Delte filer er synlige for samarbeidspartnere oppført i filens metadata
Bildeoptimalisering
Bilder som lastes opp til innholdsfilsystemet, optimaliseres automatisk for rask lasting. Når du viser et bilde, kan du be om en bestemt bredde og systemet håndterer resten:
<!-- Thumbnail (200px wide) -->
<img src="/content/gallery/photo.jpg?w=200" />
<!-- Standard display (800px wide) -->
<img src="/content/gallery/photo.jpg?w=800" />
<!-- Hero image (1920px wide) -->
<img src="/content/gallery/photo.jpg?w=1920" />
<!-- Original, full-size image -->
<img src="/content/gallery/photo.jpg" />
Hvordan optimalisering fungerer
Progressiv lasting — Første gang noen ber om en optimalisert størrelse, serverer systemet den nærmeste tilgjengelige versjonen og genererer den nøyaktige størrelsen i bakgrunnen. Hver forespørsel etter det får det optimaliserte bildet i perfekt størrelse. Den opprinnelige filen er alltid bevart.
Moderne formatlevering — Systemet leverer automatisk moderne bildeformater (AVIF eller WebP) til nettlesere som støtter dem, med automatisk fallback til JPEG eller PNG for eldre nettlesere. Dette skjer transparent - du spesifiserer bare bredden, og brukerne får den raskest lastende versjonen nettleseren deres kan håndtere.
Ytelsesoptimalisering — Bruk mindre bredder for å forbedre ytelsen. Et 200px-miniatyrbilde lastes mye raskere enn det originale 4000px-bildet og bruker mindre båndbredde. Velg bredden som samsvarer med hvordan du viser bildet.
Bruke filer i applikasjonen din
AI integrerer innholdsfilsystemet i React-applikasjonen automatisk. Når du ber om funksjoner som involverer filer, oppretter den UI-komponentene, kobler opp opplastings-/nedlastingslogikken og håndterer feil.
Vanlige mønstre AI implementerer
Avataropplasting — Et grensesnitt for opplasting av profilbilder som validerer bildetyper, viser opplastingsfremdrift, forhåndsviser bildet og lagrer banen til brukerens profil.
Dokumentgalleri — En filbehandler som viser opplastede dokumenter, viser miniatyrbilder for bilder, gir nedlastingskoblinger og tillater filtrering eller søking.
Dra-og-slipp-opplasting — En intuitiv opplastingssone der brukere kan dra filer fra skrivebordet, se opplastingsfremdrift, avbryte opplastinger som pågår og få feilmeldinger for ugyldige filer.
Filvelger — En modal eller sidefelt som viser filer som brukeren tidligere har lastet opp, lar dem velge en for gjenbruk og viser miniatyrbilder og filnavn.
Integrasjon med edge functions
Edge functions (koden din på serversiden) kan få tilgang til innholdsfilsystemet for å behandle filer, generere filer programmatisk eller implementere tilpasset filhåndteringslogikk.
Hva Edge Functions kan gjøre med filer
- Generer PDF-rapporter og lagre dem slik at brukerne kan laste dem ned
- Behandle opplastede bilder (bruk vannmerker, lag miniatyrbilder, trekk ut metadata)
- Skann opplastede dokumenter for sensitive data før du godtar dem
- Implementer tilpasset sikkerhetskopiering eller arkiveringslogikk
- Analyser filinnholdet og trekk ut strukturerte data
- Utløs arbeidsflyter når bestemte filer lastes opp
Advarsel: Viktig sikkerhetsmerknad
Edge functions omgår normal tilgangskontroll. Når funksjonen din får tilgang til filer, er den ikke begrenset av "offentlige" eller "eier"-reglene som gjelder for brukere. Dette betyr at du må implementere dine egne autorisasjonssjekker i funksjonskoden for å sikre at brukere bare kan få tilgang til filer de skal se.
For eksempel, hvis en bruker kaller funksjonen din og ber om en fil, må du bekrefte at vedkommende eier filen eller har tillatelse til å få tilgang til den før du returnerer innholdet. AI håndterer dette når du bygger funksjonene dine, men det er viktig å forstå at funksjonskoden kjører med forhøyede rettigheter.
Organisering av lagring
AI organiserer filer i logiske mapper basert på hva du bygger. Du trenger ikke lage mappestrukturer manuelt - bare beskriv hva du trenger, og AI setter opp passende baner.
Vanlige organisasjonsmønstre
/content/uploads/— Generelle brukeropplastinger/content/avatars/— Brukerprofilbilder/content/documents/— PDF-er og dokumenter/content/gallery/— Bildegalleribilder/content/private/— Private brukerfiler/content/public/— Offentlig tilgjengelige filer/content/temp/— Midlertidige filer som kan slettes
AI kan lage nestede mapper som /content/uploads/2024/ eller /content/users/[username]/ når det passer for ditt bruksområde. Filer spores etter deres fulle bane, så flytting eller omdøping av filer oppdaterer alle referanser automatisk.
Overvåking og feilsøking
Alle filoperasjoner logges – opplastinger, nedlastinger, tilgangsnektelser og feil. Du kan se disse loggene i administrasjonsgrensesnittet for å forstå hvordan fillagringen din blir brukt:
- Se hvilke filer som lastes opp oftest
- Identifiser mislykkede opplastinger og hva som gikk galt
- Spor nedlastingsmønstre og populære filer
- Overvåk lagringsbruk og vekst over tid
- Feilsøk problemer med tilgangskontroll når brukere ikke får tilgang til filer de forventer å se
Systemet sporer også lagringsverdier - totalt lagrede filer, total størrelse, veksthastighet og største filer. Dette hjelper deg å forstå appens lagringsfotavtrykk og planlegge for skalering.
Grenser og begrensninger
Som standard kan individuelle filer være opptil 500MB. Dette er konfigurerbart - AI kan justere grensen basert på hva du bygger. For de fleste applikasjoner (bildeopplasting, dokumentdeling, PDF-er) er standardgrensen mer enn tilstrekkelig.
Filer lagres redundant for pålitelighet. Hvis du sletter en fil, blir den permanent fjernet fra systemet – det finnes ingen søppelkasse eller papirkurv, så slettingen er umiddelbar og endelig.
Jobber med AI
Når du beskriver funksjoner som trenger fillagring, vær spesifikk om:
- Hvem som har tilgang til filene — Offentlige, private, organisasjonsdelte eller tilpassede regler
- Hvilke typer filer — Kun bilder, PDF-er, alle filtyper, størrelsesgrenser
- Hvordan filer er organisert — Mapper, navnekonvensjoner, om brukere kan opprette undermapper
- Hva som skjer etter opplasting — Vis i et galleri, legg ved en post, bearbeid med en funksjon
AI bruker denne informasjonen til å konfigurere lagringen riktig, sette opp tilgangspolicyer og lage et grensesnitt som matcher dine behov.
Relatert dokumentasjon: