Django ve Flask ile Dosya Yükleme Nasıl Yapılır?

Adı : Django ve Flask ile Dosya Yükleme Nasıl Yapılır?

Web uygulamalarının günümüzde en önemli ihtiyaçlardan biri, kullanıcı tarafından seçilen dosyaları yükleme işlemidir. Bu ihtiyacı, Django ve Flask gibi Python tabanlı web çerçeveleriyle kolay bir şekilde karşılayabilirsiniz. Bu yazıda, dosya yükleme işlemlerini nasıl gerçekleştirebileceğiniz konusunda detaylı bilgiler ve örnekler paylaşacağız.

Django ile Dosya Yükleme

Django, kullanıcıların seçtiği dosyaları çok kolay bir şekilde yükleyebilmenizi sağlayan farklı seçeneklere sahiptir. Bunları inceleyelim.

1. Model Alanı Kullanarak Dosya Yükleme

Django'da, kullanıcı tarafından gönderilen dosyaları modele kaydetmek için FileField veya ImageField gibi alanları kullanabilirsiniz. Bu alanlar, sunucudaki medya dosyalarını yönetmek için optimize edilmiştir.

class MyModel(models.Model):
my_file = models.FileField(upload_to='files/')

Yukarıdaki örnekte, MyModel adındaki modelde my_file adında bir alan tanımlıyoruz. Bu alan, upload_to parametresi aracılığıyla dosyanın nereye yükleneceğini belirler.

Şimdi, bu modeli kullanarak dosya yükleme işlemini gerçekleştirebiliriz. Bunun için, önce modelformumuzu tanımlamamız gerekiyor.

from django import forms
from .models import MyModel

class MyModelForm(forms.ModelForm):
class Meta:
model = MyModel
fields = ['my_file']

Yukarıdaki örnekte, MyModelForm adlı modelformumuzu tanımlıyoruz. Meta sınıfı içinde, modelimizi ve alanlarımızı belirterek hangi alanların formda yer alacağını belirliyoruz.

Ardından, formumuzu görüntüleyen bir view fonksiyonu yazabiliriz.

from django.shortcuts import render
from .forms import MyModelForm

def upload(request):
form = MyModelForm(request.POST or None, request.FILES or None)
if form.is_valid():
form.save()
context = {
'form': form
}
return render(request, 'upload.html', context)

Yukarıdaki örnekte, view fonksiyonumuzu upload() adıyla tanımlıyoruz. Formumuz hata gösterirse hataları form ile beraber context değişkenimize ekleyerek ekrana yansıtıyoruz. Formun geçerliliğini kontrol edip kaydettikten sonra, formu tekrar yüklemek için render() fonksiyonunu kullanıyoruz. Bu şekilde modelin file alanını kullanarak dosya yüklemeyi gerçekleştirebiliriz.

2. Dosya Yükleme Formu Kullanarak Dosya Yükleme

Django ayrıca, dosya yükleme işlemleri için özel olarak tasarlanmış form field'ları da sağlar. Bunlar FileField veya ImageFiend değil, FileInput veya ImageInput gibi form field'larıdır.

from django import forms

class MyFileForm(forms.Form):
my_file = forms.FileField()

Yukarıdaki örnekte, MyFileForm adındaki dosya yükleme formumuzu tanımlıyoruz. Formumuzda sadece bir alan yer alacak. Bu alanın türü FileField'dır.

Aşağıdaki adımları izleyerek, formun render edilmesi yoluyla bir dosya yükleyebilirsiniz.

1. view'da bu formu görüntüleyin.

from django.shortcuts import render
from .forms import MyFileForm

def upload(request):
if request.method == 'POST':
form = MyFileForm(request.POST, request.FILES)
if form.is_valid():
return HttpResponse('Dosya başarıyla yüklendi.')
else:
form = MyFileForm()
return render(request, 'upload.html', {'form': form})

İlk olarak, upload() adında bir view fonksiyonu tanımlıyoruz. Formun gönderilip gönderilmediğini kontrol ediyoruz. Eğer form gönderilmişse ve geçerliyse HttpResponse objesi oluşturarak dosyanın başarıyla yüklendiğini belirtiyoruz. Eğer form gönderilmemişse, formu görüntülemek için dosya yükleme formumuzu form değişkenimize atıyoruz.

2. Formu görüntüleme HTML şablonu oluşturma.

{% extends 'base.html' %}

{% block content %}

Dosya Yükleme

{% csrf_token %}
{{ form.as_p }}
Yükle

{% endblock %}

{% block javascript %}
{% endblock %}

Şablonda bir form oluşturduk ve bu formu post yöntemiyle view fonksiyonumuzda tanımladık. Formun görüntülenmesi için, başlangıçta tanımladığımız MyFileForm adlı formumuzu form değişkeni ile içeriye aktarıyoruz. Dosya yükleme işlemi için, enctype özniteliğini \"multipart/form-data\" olarak belirlemek gerektiğini unutmayın.

Flask ile Dosya Yükleme

Flask, web uygulamalarında dosya yükleme işlemlerinin yönetimini büyük ölçüde basitleştirmektedir. Nasıl gerçekleştireceğinizi, aşağıdaki örneklerle birlikte öğrenelim.

1. Dosya Yükleme Formu Kullanarak Dosya Yükleme

Flask'ta da Django'da olduğu gibi, form field'larını kullanarak dosya yükleme işlemlerini gerçekleştirebilirsiniz. Formunuza FileField veya ImageField alanları yerine, FileField veya FileInput alanlarını eklemeniz yeterlidir.

from flask_wtf import FlaskForm
from flask_wtf.file import FileField, FileRequired
from wtforms import SubmitField

class UploadForm(FlaskForm):
my_file = FileField('Dosya', validators=[FileRequired()])
submit = SubmitField('Yükle')

Yukarıdaki örnekte, FlaskForm tabanlı UploadForm adındaki formumuzu tanımlıyoruz. Bu formda, my_file adlı bir dosya alanı ve yükle butonu yer alıyor. Dosya alanını FileField kullanarak oluşturmamız yeterlidir.

Bir sonraki adımda, formu görüntülemek için bir view fonksiyonu yazalım.

from flask import render_template, request
from .forms import UploadForm

@app.route(\"/upload\", methods=['GET','POST'])
def upload():
form = UploadForm()
if request.method == 'POST':
if form.validate_on_submit():
file = form.my_file.data
filename = file.filename
file.save(os.path.join(
UPLOAD_FOLDER, filename
))
return 'Dosya başarıyla yüklendi'
return render_template('upload.html', form=form)

Yukarıdaki örnekte, Flask'a uyan bir view fonksiyonu tanımlıyoruz. Formumuzu tanımlamak için UploadForm'ı kullanıyoruz. Bunun yanı sıra, request.method'ı üzerinden bir kontrol yazarak dosyanın doğru bir şekilde seçilip seçilmediğini kontrol ediyoruz. Dosya doğru bir şekilde seçilmişse, dosyayı servisin dizini içinde belirtilen yere yazıyoruz.

2. Flask Uploads ile Dosya Yükleme

Flask, Flask-Uploads uzantısı sayesinde, web uygulamalarınız için dosya yükleme özelliği eklemenin bir başka yöntemini de seçmenize olanak tanır. Flask-Uploads, dosya yüklemeleri için bir dizi önceden tanımlanmış seçenek sunar. Uzantının kurulması ve tanımlanması şu şekildedir.

from flask import Flask
from flask_uploads import UploadSet, IMAGES, configure_uploads

app = Flask(__name__)
photos = UploadSet('photos', IMAGES)

app.config['UPLOADED_PHOTOS_DEST'] = 'uploads/photos'

configure_uploads(app, photos)

Burada, photos adlı bir UploadSet nesnesi oluşturuyoruz. Bu, bizim belirttiğimiz belirli kriterlere göre yüklenen dosyaları barındıracak olan yükleme klasörünün yolu olan app.config['UPLOADED_PHOTOS_DEST'] ile konfigure edilmiştir. Son olarak, uzantıyı Flask uygulamamıza kaydediyoruz.

Şimdi, dosya yükleme formumuzu tanımlayalım.

from flask_wtf import FlaskForm
from wtforms import SubmitField
from flask_wtf.file import FileField, FileRequired

class UploadForm(FlaskForm):
photo = FileField(validators=[FileRequired()])
submit = SubmitField('Yükle')

UploadForm sınıfımızın burada tek alanı yer alıyor. Bu alan, photo adı verilen dosyalardır. Doğrulama yaptığı için, bir dosya seçilmediğinde kullanıcıya bir hata mesajı döndürür.

Görüntüleme için, bir görünüm işlevi oluşturalım.

from flask import Flask, render_template, request, redirect, url_for
from .forms import UploadForm

@app.route('/upload')
def upload_file():
form = UploadForm()
return render_template('upload.html', form=form)

@app.route('/upload', methods=['POST'])
def upload():
form = UploadForm()
if form.validate_on_submit() == False:
return render_template('upload.html', form=form), 400

filename = photos.save(request.files['photo'])
return redirect(url_for('uploaded_file', filename=filename))

@app.route('/uploads/')
def uploaded_file(filename):
return send_from_directory(app.config['UPLOADED_PHOTOS_DEST'], filename)

Yukarıdaki örnekte, UPLOAD_PHOTOS_DEST küresel değişkenindeki fotoğraf yükleme klasörüne fotoğraflar kaydedilir. Ayrıca, gönderilen yükümlüğü doğrulamak ve kaydetmek için run() kodunu da ekleyin.

Sık Sorulan Sorular

1. Yüklenmeyen bir dosyayı nasıl ele alırım?

Django or Flask, görünüşte işlevsel bir yükleyici, ancak yüklenmeyen dosyalar yine de ortaya çıkabilir. Bu durumda, formun hatalarını veya kullanıcılardan gelen hataları kullanarak bir hata mesajı oluşturun.

2. Dosya yükleme işleminin güvenliği nasıl sağlanır?

Flask ve Django, kullanıcı tarafından gönderilen dosyaları kontrol edebilme yeteneğine sahiptir. Dosyanın uzantısını doğrulayabilir, boyutunu kontrol edebilir veya belirli bir boyuttan büyük dosyaları reddedebilirsiniz.

3. Dosya yükleme işlemi boyut sınırlarına nasıl maruz kalır?

Flask'ta, önceden tanımlanmış boyut sınırı gibi özellikler sunan Flask-Uploads uzantısı kullanabilirsiniz. Django'da, Model alanlarının validators parametresi kullanılarak dosya boyut sınırları özelleştirilebilir."