
Somo fupi · Kiswahili
Jinsi ya kuwaruhusu watumiaji kupakia picha
Pakia, fungua tena na ufute picha za majaribio zilizotolewa huku ukikagua mipaka ya ukubwa na umiliki wa akaunti.
Somo hili ni la nani?
Kwa watu wanaotaka wageni wapakie picha. Unaweza kutumia mradi ulio tayari na msaidizi wa programu bila kuandika sera za hifadhi au msimbo wa kupakia.
Kabla ya kuanza
Mradi tofauti wa Supabase wa mazoezi wenye akaunti mbili za majaribio unazodhibiti. Faili ndogo, kubwa kupita kiasi na isiyokubaliwa zimetolewa. Mwombe msaidizi aandae hifadhi binafsi ya avatars na sera zilizotolewa kwenye mradi huu wa kutupwa.
Muda unaokadiriwa: 25–42 dakika
Makadirio yanatumia faili za kuanzia zilizotolewa, huku akaunti na zana zinazohitajika zikiwa tayari. Usanidi, foleni za uchapishaji na kusubiri barua pepe au DNS huhitaji muda zaidi. Zoezi linahusu hifadhi ya picha yenye mipaka na umiliki. Ukaguzi wa kivinjari na mipangilio ya MIME si mfumo kamili wa kukagua programu hasidi/maudhui kwa faili yoyote inayopakiwa na umma.
Utakachojifunza
- Tofautisha mwonekano wa awali wa ndani ya kifaa na faili iliyopakiwa na kuhifadhiwa.
- Jaribu faili zilizotolewa zinazokubaliwa na zinazokataliwa.
- Kagua ufutaji wa mwenye akaunti pekee na mipaka ya akaunti nyingine.
Hatua 1
Elewa mwonekano wa awali unathibitisha nini
Jina la faili lililochaguliwa, upload iliyohifadhiwa na picha inayosomeka ni matokeo matatu tofauti.
Fungua programu na msaidizi na chagua fixtures/avatar-small.webp. Kabla ya kubofya Upload image, kichagua faili kinaonyesha jina ulilochagua. Mfano huu hauonyeshi picha ya ndani wakati wa kuchagua; picha huonekana baada ya upload na ufikiaji uliosainiwa kufaulu.
Programu nyingine zinaweza kuonyesha picha ya ndani bila kuihifadhi. Hapa pia kuchagua jina pekee hakuthibitishi upload ya mbali. Tofautisha kuchagua, kuhifadhi kwa mtoa huduma na kusoma picha baadaye.
Mfano halisi
Kuchagua avatar-small.webp kunaweza kuonyesha jina kabla ya akaunti ya hifadhi kusanidiwa. Kuthibitisha hifadhi ya mbali baadaye, pata object kwa mtoa huduma na uhakiki mwonekano uliosainiwa unaoisoma.
Tumia warsha kamili ya kupakia picha na mradi wangu wa Supabase wa kutupwa. Nisaidie kusanidi kuingia, bucket binafsi ya avatars, kikomo kilichotajwa cha MB 2 na miundo ya picha inayoruhusiwa kwa sera zilizotolewa. Usiweke funguo binafsi kwenye faili za umma. Endesha ukurasa na uniongoze kwenye majaribio ya faili ndogo, kubwa kupita kiasi na isiyokubaliwa na ukaguzi wa kufuta kwa akaunti tofauti. Shughulikia mabadiliko ya msimbo kwa ajili yangu.Faili za hatua hii

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Hifadhi picha, si hakiki ya ndani pekee
Hakiki inayotengenezwa kutoka faili lililochaguliwa haithibitishi huduma ya kuhifadhi imelipokea.
Kivinjari hushikilia kwanza faili lililochaguliwa. Kupakia hutuma baiti zake kwenye huduma ya kuhifadhi faili kama objects, ambayo hulipa njia na kutekeleza kanuni za ufikiaji.
Tutatumia bucket ya siri ya Supabase yenye folda moja ya mmiliki kwa kila akaunti. Programu hupakia faili, kisha huomba URL iliyosainiwa ya hakiki ya muda mfupi. Haifanyi kila picha iliyopakiwa isomeke na umma.
Mfano uliotatuliwa
Hakiki ya blob: ya ndani inaweza kufanya kazi bila ombi lolote la mtandao. Jaribio letu litakagua faili lililohifadhiwa kweli na kulipata kupitia njia yenye ruhusa.
Extra implementation exercise
Picha iliyochaguliwa inaonekana mara moja kwa URL ya blob. Je, lazima upakiaji uwe umefanyika?
Onyesha mfano wa suluhisho
Hapana. Hakikisha kitendo cha kuhifadhi na faili linalolingana kabla ya kudai limepakiwa.
- Anatenganisha hakiki ya ndani na hifadhi ya mbali.
- Anakagua matokeo ya kupakia na faili lililohifadhiwa.
Kosa linalofanywa mara nyingi
Kuita kuchagua faili kuwa upakiaji uliokamilika.
Hatua 2
Andaa hifadhi binafsi ya majaribio
Tumia mipangilio iliyotolewa na msaidizi kwa usanidi.
Katika mradi wako wa kutupwa, mwombe msaidizi asanidi bucket binafsi ya avatars, mipaka ya ukubwa na umbizo na policies.sql. Anzisha programu kamili ya kuingia na kupakia kwa HTTP.
Thibitisha bucket ni ya faragha na akaunti na mradi ni vilivyokusudiwa. Usiondoe ulinzi wa hifadhi ili ombi lililoshindwa lifanikiwe.
Mfano halisi
Kiolesura cha mgeni kinaweza kusaidia kukataa faili, lakini huduma ya hifadhi lazima itekeleze kanuni zake pia.
Supabase: udhibiti wa ufikiaji wa hifadhi
Jaribu mwenyewe
Mipangilio ipi ya hifadhi imetekelezwa, na akaunti yako ya majaribio inaweza kufungua programu inayoendeshwa?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Rekodi ya mfano: “Msaidizi aliandaa bucket binafsi avatars kwenye mradi wa kufutika, akaweka kikomo cha 2 MB na aina PNG/JPEG/WebP pamoja na sheria za kabrasha la mwenyewe. Programu ya HTTP inafunguka na A anaingia.”
Upload ikishindwa kabla ya ukaguzi huu kukamilika, andika hatua inayokosekana. Kufanya bucket ya umma au kuondoa sheria za umiliki si njia sahihi ya mkato.
- Anataja mradi wa kufutika, bucket binafsi avatars na mipaka ya aina/ukubwa iliyowekwa.
- Anaandika programu ya kuingia/upload inayoendeshwa na kikwazo cha usanidi bila kudhoofisha ulinzi wa hifadhi.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Unda bucket ya siri na kanuni za mmiliki
Mipangilio ya bucket na sera za ufikiaji hutekeleza sehemu tofauti za kazi.
Unda bucket ya avatars kuwa ya siri. Weka kikomo cha 2MB na aina za MIME zinazoruhusiwa, kisha tumia policies.sql. Majukumu ya kivinjari yaruhusiwe kuingiza na kusoma tu njia zilizo chini ya ID yake iliyothibitishwa ya mtumiaji.
Sifa ya accept kwenye kivinjari hurahisisha uchaguzi, si ukaguzi wa usalama. Kanuni za ukubwa/aina na sera za umiliki za huduma bado hutumika kwa maombi ya moja kwa moja. Lebo za MIME pekee hazithibitishi maudhui yoyote ya faili ni salama; usiwasilishe zoezi hili kuwa huduma kamili ya kuchanganua usalama.
Kwa faili linaloitwa USER_A/avatar-1.webp, storage.foldername(name) hurudisha sehemu za folda; [1] huchagua ya kwanza katika array hii ya PostgreSQL. Lazima ilingane na ID ya mtumiaji aliyethibitishwa. USER_B/avatar-1.webp hushindwa kwa A. Kanuni hii ya hifadhi ni tofauti na chaguo la faili na ukaguzi wa awali wa MIME wa kivinjari.
Sehemu ya kwanza ya njia hubaki ID ya mtumiaji hata kukiwa na folda ndani ya nyingine: USER_A/subfolder/avatar.webp bado ina USER_A kama sehemu ya folda [1]. Njia inayoanza subfolder/USER_A/... haitalingana. Weka ID ya mmiliki kwanza; usilegeze sera ili kukubali njia iliyokosewa.
Mfano uliotatuliwa
Mwanzo wa njia ya folda hutoka kwa mtumiaji aliyeingia, na sera ya hifadhidata huulinganisha na auth.uid(). Kubadilisha njia ya kivinjari kwenda folda ya mtu mwingine hakupaswi kutoa ruhusa.
create policy "upload own avatar" on storage.objects for insert to authenticated
with check (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
create policy "read own avatar" on storage.objects for select to authenticated
using (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
Supabase: udhibiti wa ufikiaji wa hifadhi
Extra implementation exercise
Kwa nini kukagua kiendelezi cha faili kwa JavaScript pekee hakutoshi?
Onyesha mfano wa suluhisho
Mwombaji anaweza kutuma ombi la moja kwa moja lenye taarifa tofauti au njia nyingine. Tekeleza bucket inayokusudiwa na kanuni za mmiliki kwenye mpaka wa huduma.
- Anatambua mwombaji anaweza kupita JavaScript.
- Anahitaji vizuizi na ukaguzi wa ruhusa kwenye huduma ya hifadhi.
Kosa linalofanywa mara nyingi
Kufanya bucket yote iwe ya umma ili kurekebisha hakiki iliyoshindwa.
Hatua 3
Pakia picha ndogo ya jaribio
Kagua kitu kilichohifadhiwa pamoja na picha inayoonekana.
Ingia kama akaunti A na upakie picha ndogo iliyotolewa. Tafuta kitu chake kwa mtoa huduma na utumie mwonekano wa awali unaotokana nacho au njia ya ufikiaji iliyotiwa saini.
Uhifadhi ukifaulu lakini mwonekano wa awali ukishindwa, chunguza kusoma na mwonekano wa awali kabla ya kupakia nakala nyingine. Hifadhi rejea ya kitu uliyorekodi.
Mfano halisi
Kukosekana kwa mwonekano wa awali hakumaanishi lazima upakiaji wenyewe umeshindwa.
Jaribu mwenyewe
Picha ndogo ilihifadhiwa, na iliweza kusomwa baadaye?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Rekodi ya mfano: “A alipakia avatar-small.webp. Mtoa huduma alionyesha object chini ya kabrasha la A; nilihifadhi rejea bila siri. Picha ilionekana baadaye kupitia mwonekano uliosainiwa wa muda mfupi.”
Matokeo ya sehemu yanaweza kusema: “Object ipo, lakini mwonekano umeshindwa kufikiwa.” Hilo linahitaji kukagua kusoma/ufikiaji wa object ileile, si kupakia nakala nyingi bila kujua kama hifadhi ilifaulu.
- Anaunganisha upload ya A iliyofaulu na rejea halisi ya object iliyohifadhiwa.
- Anaandika tofauti kama mwonekano uliosainiwa uliweza kusoma object hiyo.
Faili za hatua hii
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Pakia kwa njia ya kipekee ya mmiliki
Tumia jina lililotengenezwa badala ya kuamini njia ya mwombaji au kuandika juu ya faili lililopo.
Baada ya kuingia, programu huchagua njia kwa ID iliyothibitishwa na jina la faili la nasibu. Hukagua ukubwa/aina kabla ya kuomba kupakia, lakini huo si mbadala wa udhibiti wa mtoa huduma.
Upakiaji hauwashi upsert. Kuhifadhi kukifaulu lakini kutengeneza URL iliyosainiwa kukishindwa, kiolesura huripoti uchunguzi huo tofauti. Hakisemi “hakuna kilichopakiwa” wakati faili linaweza kuwa tayari lipo.
Mfano uliotatuliwa
Jina lililotengenezwa huepusha kugongana kwa bahati na picha nyingine inayoitwa photo.jpg. Lenyewe si mfumo wa ruhusa.
Extra implementation exercise
Faili lipo lakini kutengeneza hakiki kumeshindwa. Je, upakie nakala nyingine mara moja?
Onyesha mfano wa suluhisho
Kagua kwanza njia ya faili na sera ya kusoma. Kupakia tena kunaweza kuunda nakala za ziada bila kurekebisha tatizo la hakiki.
- Anatenganisha mafanikio ya kupakia na ruhusa ya hakiki.
- Anachunguza sera ya kusoma/njia kabla ya kuunda nakala rudufu.
Kosa linalofanywa mara nyingi
Kuchukulia majina ya nasibu ya faili kuwa mbadala wa udhibiti wa ufikiaji.
Hatua 4
Jaribu hali za kushindwa zilizotolewa
Zoezi lina faili ambazo hazipaswi kupakiwa.
Tumia fixtures/avatar-too-large.png na fixtures/not-an-image.txt. Rekodi namna ukurasa na hifadhi zinavyojibu. Mwombe msaidizi achunguze kukataliwa kunakochanganya au faili isiyo halali iliyopita.
Faili zilizokataliwa zisigeuke kuwa vitu vilivyohifadhiwa. URL halali iliyotiwa saini inaweza kuruhusu mwenye kiungo kuona picha kwa muda wa uhalali wake; hilo pekee halithibitishi bucket imekuwa ya umma.
Mfano halisi
Kizuizi cha kichaguzi cha faili na utekelezaji halisi wa hifadhi ni ukaguzi tofauti.
Jaribu mwenyewe
Nini kilitokea kwa faili kubwa kupita kiasi na zisizokubaliwa, na ulijaribu njia ipi halisi ya ufikiaji?
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Rekodi ya mfano: “PNG kubwa mno ilikataliwa na hakuna object mpya. Faili ya maandishi pia ilikataliwa; msaidizi alisaidia kuijaribu ikiwa kichagua kilificha aina zisizoruhusiwa.”
“URL iliyosainiwa ya picha halali ilifunguka katika muda wake mfupi. Ilionyesha ufikiaji kupitia URL hiyo, si kwamba bucket binafsi imekuwa ya umma.” Kichujio cha kichagua faili pekee si jaribio la moja kwa moja la mipaka ya hifadhi.
- Anaandika tofauti kukataliwa na hali ya hifadhi kwa faili zote mbili batili zilizotolewa.
- Anatofautisha kusoma kwa muda kupitia kiungo kilichosainiwa na ufikiaji wa umma usio na mipaka.
Faili za hatua hii

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Hakikisha kukataliwa na ufikiaji wa muda
Jaribu kanuni za huduma na uelewe ruhusa inayotolewa na kiungo kilichosainiwa.
Pakia fixtures/avatar-small.webp kwa akaunti A. Kagua njia yake ya kuhifadhi na ufungue onyesho lililoidhinishwa kwa kiungo kilichosainiwa. Kisha jaribu fixtures/avatar-too-large.png inayozidi 2MiB na fixtures/not-an-image.txt ya aina isiyoruhusiwa; zote zikatazwe. Faili zote tatu zimetolewa.
Tumia B kuomba kiungo kilichosainiwa kwa njia ya A; sera ya mmiliki ikatae. URL iliyosainiwa iliyopewa A kihalali inaweza bado kutumiwa na yeyote anayeipata hadi iishe muda. Kutoka kwenye kivinjari hakubatilishi kila URL iliyotolewa papo hapo.
Mfano uliotatuliwa
Ripoti yenye manufaa huweka njia iliyofichwa taarifa nyeti na muda wa kuisha, si URL nzima ya ufikiaji wa muda.
Extra implementation exercise
Mtu mwenye URL sahihi iliyosainiwa anafungua picha bila kuingia. Je, hilo pekee linathibitisha sera ya bucket ya siri imeshindwa?
Onyesha mfano wa suluhisho
Hapana. Jaribu kama akaunti isiyo na ruhusa inaweza kutengeneza URL au kusoma bila ruhusa iliyoidhinishwa. Chukulia URL zilizotolewa kuwa nyeti hadi ziishe muda.
- Anatambua URL zilizosainiwa kuwa ruhusa za muda kwa anayezishikilia.
- Anatofautisha kutumia URL na ruhusa ya kuitengeneza.
Kosa linalofanywa mara nyingi
Kuchapisha URL iliyosainiwa kwenye ripoti ya hitilafu na kutarajia ibaki ya siri.
Hatua 5
Ongeza ufutaji wa mwenye akaunti pekee
Hakiki anayeweza kuondoa kitu kilichopakiwa.
Mwombe msaidizi aongeze kufuta kwa mwenyewe kama zoezi linavyoeleza. Kama A, futa object X ya kwanza na uhakiki haipo. Pakia Y mpya kama A; weka rejea yake bila siri kwa ukaguzi unaofuata.
Katika kikao tofauti cha B, msaidizi ajaribu kufuta Y moja kwa moja. Andika mtendaji B, lengwa Y na matokeo, kisha hakiki Y ya A bado ipo. Kukagua kitufe kilichofichwa tu au kujaribu kufuta X iliyokwishaondoka hakuthibitishi mpaka wa umiliki.
Mfano halisi
Kuondoa picha kwenye skrini si sawa na kufuta kitu kilichohifadhiwa.
Jaribu mwenyewe
Vifaa vya kuanzia
Faili na maudhui ya majaribio yametolewa. Uthibitishaji halisi bado unahitaji akaunti, barua au kikoa chako kama masharti yanavyoeleza. Unaweza kuchunguza ndani ya kompyuta; andika hatua za mtandaoni ambazo hujafanya kama hazijajaribiwa.
Toa ufutaji wa mwenye akaunti na jaribio la akaunti ya pili pamoja na matokeo halisi ya vitu.
Unachopaswa kuandaa Matokeo ya kupakia na kufuta na ukaguzi halisi wa faili halali, kubwa kupita kiasi, isiyokubaliwa na kati ya akaunti.
Jadili jibu lako na msaidizi wa somo
Onyesha mfano wa suluhisho
Rekodi ya mfano: “A alifuta X na mtoa huduma akathibitisha haipo. A akapakia Y mpya. Kikao tofauti cha B kilijaribu kufuta Y; A alihakiki Y bado ipo.”
Msaidizi ataje mtendaji B na lengwa Y kabla ya kuendesha jaribio lililotengwa. Kufuta X tena kungejaribu object ambayo tayari haipo, si ulinzi wa mwenyewe pekee.
- Anafuta object ya kwanza ya A kama mwenyewe na kuthibitisha object hiyo kamili haipo.
- Anapakia object mpya ya A, anaijaribu kutoka B na kuhakiki bado imehifadhiwa.
Faili za hatua hii

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- policies.sqlPakua faili hii
- public/app.jsPakua faili hii
- upload-tests.txtPakua faili hii
- worksheet.htmlPakua faili hii
- reference/assignment-walkthrough.txtPakua faili hii
- reference/START-HERE.txtPakua faili hii
- reference/public/index.htmlPakua faili hii
- reference/public/app.jsPakua faili hii
- reference/delete-policy.sqlPakua faili hii
- fixtures/avatar-small.webpPakua faili hii
- fixtures/avatar-too-large.pngPakua faili hii
- fixtures/not-an-image.txtPakua faili hii
How it works (optional)
Kazi yako: ongeza kufuta kwa mmiliki pekee
Kitendo kipya kinahitaji sera yake na majaribio yake ya kukataliwa.
Ongeza kidhibiti cha kufuta faili lililopakiwa na sera ya DELETE yenye mipaka ya folda ya mmiliki. Usipanue bucket iwe sehemu ya pamoja ya umma.
Hakikisha A anaweza kufuta faili lake na B hawezi. Weka hali ya hifadhi ilingane na kiolesura baada ya kufuta kushindwa.
Mfano uliotatuliwa
Sera za awali huruhusu kuingiza/kusoma pekee kimakusudi. Ruhusa ya kupakia haitoi moja kwa moja ruhusa ya kufuta.
Maelezo kamili ya hatua za suluhisho yanapatikana katika reference/assignment-walkthrough.txt. Linganisha hatua zake na matokeo yako; jaza rekodi ya majaribio kwa ulichokiona katika mradi wako mwenyewe.
Extra implementation exercise
Tekeleza kufuta kwa mmiliki pekee na uonyeshe majaribio yanayoruhusiwa na yanayokatazwa.
Onyesha mfano wa suluhisho
Tumia bucket ya siri ya avatars yenye mipangilio ya ukubwa/aina ya huduma na sera za folda ya mmiliki. Pakia picha inayoruhusiwa kama A; kagua matokeo ya hifadhi, kisha ufungue hakiki iliyosainiwa ya muda mfupi. Hakiki ya blob pekee haithibitishi kupakia kwa mbali.
Jaribu faili lisiloruhusiwa au kubwa mno na ujaribu kupakia/kusoma chini ya folda ya B. A asipate ruhusa kwa kubadilisha tu njia kwenye zana za msanidi. URL zilizosainiwa hutoa kwa makusudi ufikiaji wa muda hadi ziishe.
Kwa kufuta, ongeza sera ya DELETE yenye sharti lilelile la bucket/folda ya mmiliki na uite remove kwa njia halisi iliyohifadhiwa. Hakikisha faili halipo baadaye na kufuta kutoka akaunti nyingine hakuondoi faili la mmiliki wake. Moduli ya marejeo ya kufuta imetenganishwa ili ukague njia na sera kabla ya kuiunganisha.
- Ruhusa ya kufuta hukagua bucket na folda ya mmiliki aliyethibitishwa.
- Majaribio yanayoshindwa hayafuti faili la akaunti nyingine wala kuondoa kwa uongo taarifa kwenye kiolesura.
Kosa linalofanywa mara nyingi
Kumpa kila mtumiaji aliyethibitishwa DELETE ili kitufe kifanye kazi tu.
Somo hili lilikufaa?
Bonyeza kupenda au mshirikishe mtu anayeweza kufaidika nalo.
Endelea kujifunza
- Jinsi ya kutengeneza tovuti yako binafsi ya kwanza
- Jinsi ya kuchapisha tovuti yako kutoka GitHub
- Jinsi ya kuunganisha kikoa chako na tovuti yako
- Jinsi ya kusanidi barua pepe kwenye kikoa chako
- Jinsi ya kufanya tovuti yako itumike vizuri kwenye simu
- Jinsi ya kufanya picha za tovuti zipakie haraka zaidi
- Jinsi ya kupokea maoni ya tovuti kwenye kikasha chako
- Jinsi ya kuongeza usajili wa barua pepe kwenye tovuti yako
- Jinsi ya kutuma barua pepe za kiotomatiki kutoka tovuti yako
- Jinsi ya kuhifadhi ujumbe wa fomu kwenye hifadhidata
- Jinsi ya kuwaruhusu watu kuingia kwenye tovuti yako
- Jinsi ya kuweka ukurasa kuwa wa siri
- Jinsi ya kuwaruhusu watumiaji kuhariri taarifa za wasifu wao
- Jinsi ya kuweka funguo za API nje ya msimbo wa kivinjari
- Jinsi ya kuonyesha data kutoka API ya huduma nyingine kwenye tovuti yako
- Jinsi ya kuongeza chatbot ya AI kwenye tovuti yako
- Jinsi ya kufanya chatbot ijibu kwa maudhui yako
- Jinsi ya kuongeza blogu kwenye tovuti yako
- Jinsi ya kuongeza utafutaji kwenye tovuti yako
- Jinsi ya kuongeza lugha nyingine kwenye tovuti yako
- Jinsi ya kusaidia Google ipate tovuti yako
- Jinsi ya kurekebisha hakiki ya tovuti yako unaposhiriki kiungo
- Jinsi ya kupima ziara na vitendo vyenye manufaa kwenye tovuti yako
- Jinsi ya kuwawezesha wageni kuweka miadi
- Jinsi ya kupokea malipo kwenye tovuti yako
- Jinsi ya kuhakiki mabadiliko ya tovuti kabla ya kuchapisha
- Jinsi ya kutengua uchapishaji wa tovuti ulioharibika
- Jinsi ya kuhifadhi nakala rudufu na kurejesha data ya tovuti yako
- Jinsi ya kupata na kurekebisha makosa kwenye tovuti yako ya umma