Fillagring og indholdsstyring
Din applikation har et dedikeret indholdsfilsystem til lagring af brugeruploadede filer som billeder, dokumenter, PDF'er og videoer. Dette er adskilt fra din applikationskode og er designet til dynamisk indhold, som brugere opretter eller uploader, mens de bruger din app.
Grænser og vigtige bemærkninger
- Individuelle filer kan være op til 500MB store
- Filsletning er permanent - der er ingen papirkurv
- Lagerforbrug tæller med i din kontokvote
Hvad indholdsfilsystemet muliggør
Indholdsfilsystemet giver kraftfulde filhåndteringsfunktioner til din applikation:
- Gem brugeravatarer, profilbilleder og billedgallerier
- Accepter dokumentuploads som CV'er, kontrakter eller PDF'er
- Byg fildelingsfunktioner mellem brugere i din app
- Opret billedtunge applikationer med automatisk optimering
- Lad brugerne downloade filer de har uploadet eller som tilhører dem
- Byg administrative værktøjer, hvor du administrerer filer på vegne af brugere
Hvordan det virker
Når du over for AI'en beskriver en funktion, der kræver fillagring, håndterer den automatisk hele implementeringen:
Opretter uploadgrænsefladen — Opretter formularer eller træk-og-slip-zoner, hvor brugere kan vælge filer fra deres enhed
Konfigurerer adgangskontrol — Bestemmer, hvem der kan se, uploade eller slette filer baseret på det, du bygger
Implementerer billedoptimering — Ændrer automatisk størrelse og serverer billeder effektivt, så din app indlæses hurtigt
Opretter lagerstrukturen — Organiserer filer i logiske mapper som /content/uploads/ eller /content/avatars/
Håndterer backend — Styrer den faktiske fillagring, hentning og levering uden at du behøver at tænke over det
Filer gemmes på stier som /content/uploads/photo.jpg og kan refereres direkte i din app. Systemet sporer, hvem der har uploadet hver fil, hvornår den blev oprettet, og håndhæver dine adgangsregler.
Adgangskontrol til filer
Ligesom databasetabeller og edge functions har filer sikkerhedspolitikker, der styrer, hvem der kan få adgang til dem. Filer er private som standard — ingen kan få adgang til dem, før du konfigurerer tilladelser. AI sætter disse op baseret på det, du bygger:
Offentlige filer
Alle kan se dem, selv uden at logge ind. Loggede brugere kan uploade, og kun den person, der har uploadet en fil, kan slette den. Perfekt til fotogallerier, offentlig billeddeling eller brugergenererede indholdswebsteder.
Private filer
Kun den bruger, der har uploadet en fil, kan se eller slette den. Bruges til følsomme dokumenter, private billeder, medicinske journaler eller noget, brugere ikke vil have, at andre skal se.
Organisationsdelte filer
Brugere fra samme organisation kan se filer uploadet af alle i deres organisation. Enkeltpersoner kan kun slette filer, de har uploadet. Velegnet til deling af teamdokumenter, virksomhedsressourcer eller fælles arbejdsområder.
Adgang kun for ejer
Kun dig (app-skaberen) kan få adgang til disse filer, ikke dine slutbrugere. Nyttigt til lagring af systemfiler, skabeloner eller administrative ressourcer, der driver din app, men som ikke bør være brugervendt.
Avanceret adgangskontrol
AI'en kan skabe sofistikerede adgangsregler baseret på filmetadata. For eksempel:
- Publicerede artikler er offentlige, men udkast er kun synlige for forfatteren
- Filer, der er mærket med en afdeling er kun synlige for brugere i den pågældende afdeling
- Premium-indhold kræver et abonnementsflag på brugerens konto
- Delte filer er synlige for samarbejdspartnere, der er angivet i filens metadata
Billedoptimering
Billeder uploadet til indholdsfilsystemet optimeres automatisk til hurtig indlæsning. Når du viser et billede, kan du anmode om en bestemt bredde, og systemet klarer 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" />
Sådan fungerer optimering
Progressiv indlæsning — Første gang nogen anmoder om en optimeret størrelse, serverer systemet den nærmeste tilgængelige version og genererer den nøjagtige størrelse i baggrunden. Alle efterfølgende anmodninger får det optimerede billede i den rigtige størrelse. Den originale fil er altid bevaret.
Moderne formatlevering — Systemet serverer automatisk moderne billedformater (AVIF eller WebP) til browsere, der understøtter dem, med automatisk fallback til JPEG eller PNG for ældre browsere. Det sker uden, at du mærker det: du angiver bare bredden, og brugerne får den hurtigst indlæsende version, som deres browser kan håndtere.
Ydeevneoptimering — Brug mindre bredder til at forbedre ydeevnen. Et 200px miniaturebillede indlæses meget hurtigere end det originale 4000px billede og bruger mindre båndbredde. Vælg den bredde, der passer til, hvordan du viser billedet.
Brug af filer i din applikation
AI'en integrerer automatisk indholdsfilsystemet i din React-applikation. Når du beder om funktioner, der involverer filer, opretter den UI-komponenterne, kobler upload- og downloadlogikken sammen og håndterer fejl.
Almindelige mønstre, som AI'en implementerer
Upload af avatar — En grænseflade til upload af profilbilleder, der validerer billedtyper, viser uploadfremskridt, forhåndsviser billedet og gemmer stien til brugerens profil.
Dokumentgalleri — En filbrowser, der viser uploadede dokumenter, viser miniaturer for billeder, giver download-links og tillader filtrering eller søgning.
Upload med træk og slip — En intuitiv uploadzone, hvor brugere kan trække filer fra deres skrivebord, se uploadstatus, annullere uploads i gang og få fejlmeddelelser for ugyldige filer.
Filvælger — En modal eller sidebjælke, der viser filer, som brugeren tidligere har uploadet, giver dem mulighed for at vælge en til genbrug og viser miniaturebilleder og filnavne.
Integration med edge functions
Edge functions (din kode på serversiden) kan få adgang til indholdsfilsystemet for at behandle filer, generere filer programmatisk eller implementere tilpasset filhåndteringslogik.
Hvad edge functions kan gøre med filer
- Generer PDF-rapporter, og gem dem, så brugerne kan downloade dem
- Behandl uploadede billeder (anvend vandmærker, opret miniaturer, udtræk metadata)
- Scan uploadede dokumenter for følsomme data, før du accepterer dem
- Implementer tilpasset backup- eller arkiveringslogik
- Analyser filindhold og udtræk strukturerede data
- Udløs workflows, når bestemte filer uploades
Advarsel: Vigtig sikkerhedsbemærkning
Edge functions omgår normal adgangskontrol. Når din funktion tilgår filer, er den ikke begrænset af de "offentlige" eller "ejer" regler, der gælder for brugere. Det betyder, at du skal implementere dine egne autorisationstjek i funktionskoden for at sikre, at brugere kun kan få adgang til filer, de skal se.
For eksempel, hvis en bruger kalder din funktion og anmoder om en fil, skal du bekræfte, at vedkommende ejer filen eller har tilladelse til at få adgang til den, før du returnerer indholdet. AI'en håndterer dette, når du bygger dine funktioner, men det er vigtigt at forstå, at funktionskoden kører med forhøjede rettigheder.
Organisering af lageret
AI organiserer filer i logiske mapper baseret på det, du bygger. Du behøver ikke at oprette mappestrukturer manuelt - beskriv blot, hvad du har brug for, og AI'en opsætter passende stier.
Almindelige mønstre for organisering
/content/uploads/— Generelle brugeruploads/content/avatars/— Brugerprofilbilleder/content/documents/— PDF'er og dokumenter/content/gallery/— Fotogalleribilleder/content/private/— Private brugerfiler/content/public/— Offentligt tilgængelige filer/content/temp/— Midlertidige filer, der kan slettes
AI'en kan oprette indlejrede mapper som /content/uploads/2024/ eller /content/users/[username]/, når det er relevant for din brug. Filer spores af deres fulde sti, så flytning eller omdøbning af filer opdaterer alle referencer automatisk.
Overvågning og fejlretning
Alle filhandlinger logges - uploads, downloads, adgangsnægtelser og fejl. Du kan se disse logfiler i administrationsgrænsefladen for at forstå, hvordan dit fillager bliver brugt:
- Se hvilke filer der uploades oftest
- Identificer mislykkede uploads, og hvad der gik galt
- Spor downloadmønstre og populære filer
- Overvåg lagerbrug og vækst over tid
- Fejlret problemer med adgangskontrol, når brugere ikke kan få adgang til filer, de forventer at se
Systemet sporer også lagermålinger - samlede lagrede filer, samlet størrelse, vækstrate og største filer. Dette hjælper dig med at forstå din apps lagerforbrug og planlægge skalering.
Grænser og begrænsninger
Som standard kan individuelle filer være op til 500MB. Dette er konfigurerbart - AI'en kan justere grænsen baseret på, hvad du bygger. For de fleste applikationer (billeduploads, dokumentdeling, PDF'er) er standardgrænsen mere end tilstrækkelig.
Filer gemmes redundant for pålidelighed. Hvis du sletter en fil, fjernes den permanent fra systemet – der er ingen papirkurv, så sletningen er øjeblikkelig og endelig.
Sådan arbejder du med AI'en
Når du beskriver funktioner, der kræver fillagring, skal du være specifik med:
- Hvem der kan få adgang til filerne — Offentlige, private, organisationsdelte eller tilpassede regler
- Hvilke typer filer — Kun billeder, PDF'er, enhver filtype, størrelsesbegrænsninger
- Hvordan filer er organiseret — Mapper, navngivningskonventioner, om brugere kan oprette undermapper
- Hvad der sker efter upload — Vis i et galleri, vedhæft til en post, bearbejd med en funktion
AI bruger disse oplysninger til at konfigurere lageret korrekt, opsætte adgangspolitikker og skabe en grænseflade, der matcher dine behov.
Relateret dokumentation: