Django-ს შესავალი სახელმძღვანელო: სწრაფად შექმენით თქვენი პირველი ვებ აპლიკაცია

Django არის მაღალი დონის Python-ის ვებ-ფრეიმვორკი, რომელიც მიზნად ისახავს სწრაფ განვითარებასა და ლაკონურ დიზაინს. ის მიჰყვება მოდელი-თარგი-ხედვის (MTV) არქიტექტურას, ხელს უწყობს კოდის ხელახლა გამოყენებას და კომპონენტურობას. ეს სახელმძღვანელო გაგიძღვებათ ეტაპობრივად Django-ს მარტივი აპლიკაციის შექმნაში, რაც საშუალებას მოგცემთ სწრაფად დაიწყოთ მუშაობა.

1. გარემოს მომზადება

პირველ რიგში, დარწმუნდით, რომ თქვენს სისტემაზე დაინსტალირებულია Python. Django გირჩევთ გამოიყენოთ Python 3.6 ან უფრო ახალი ვერსია.

1.1 Python-ის ინსტალაცია

თუ თქვენს სისტემაზე არ არის დაინსტალირებული Python, შეგიძლიათ ჩამოტვირთოთ და დააინსტალიროთ ის Python-ის ოფიციალური ვებ-გვერდიდან.

1.2 ვირტუალური გარემოს შექმნა (Virtual Environment)

სხვადასხვა პროექტებს შორის დამოკიდებულებების იზოლირებისთვის, მკაცრად გირჩევთ გამოიყენოთ ვირტუალური გარემო.

1. გახსენით ტერმინალი ან ბრძანების სტრიქონი.

2. შექმენით პროექტის დირექტორია, მაგალითად myproject:

   mkdir myproject
   cd myproject
   

3. შექმენით და გაააქტიურეთ ვირტუალური გარემო:

   python3 -m venv venv  # ან python -m venv venv
   source venv/bin/activate  # Linux/macOS
   venv\Scripts\activate  # Windows
   

   ვირტუალური გარემოს გააქტიურების შემდეგ, თქვენი ტერმინალის ბრძანების სტრიქონი აჩვენებს (venv)-ს, რაც მიუთითებს, რომ თქვენ იყენებთ ვირტუალურ გარემოს.

1.3 Django-ს ინსტალაცია

გააქტიურებულ ვირტუალურ გარემოში გამოიყენეთ pip Django-ს დასაინსტალირებლად:

pip install Django

შეამოწმეთ, წარმატებით დაინსტალირდა თუ არა:

python -m django --version

თქვენ უნდა ნახოთ Django-ს ვერსიის ნომერი.

2. Django-ს პროექტის შექმნა

Django-ს ინსტალაციის შემდეგ, შეგიძლიათ შექმნათ ახალი Django-ს პროექტი.

1. კვლავ თქვენს პროექტის დირექტორიაში (myproject), გაუშვით შემდეგი ბრძანება:

   django-admin startproject mysite
   

   ეს შექმნის mysite დირექტორიას myproject დირექტორიაში, რომელიც შეიცავს Django-ს პროექტის ჩარჩო ფაილებს.

2. გადადით mysite დირექტორიაში:

   cd mysite
   

3. Django-ს პროექტის დირექტორიის სტრუქტურა შემდეგია:

   mysite/
       manage.py
       mysite/
           __init__.py
           settings.py
           urls.py
           asgi.py
           wsgi.py
   

   • manage.py: ბრძანების ხაზის ინსტრუმენტი Django-ს პროექტის სამართავად.
   • mysite/: შეიცავს პროექტის კონფიგურაციის Python პაკეტს.
     • __init__.py: ცარიელი ფაილი, რომელიც ეუბნება Python-ს, რომ ეს დირექტორია უნდა ჩაითვალოს Python პაკეტად.
     • settings.py: პროექტის კონფიგურაციის ფაილი, როგორიცაა მონაცემთა ბაზის პარამეტრები, გამართვის რეჟიმი და ა.შ.
     • urls.py: URL მარშრუტიზაციის კონფიგურაცია, რომელიც URL-ებს აკავშირებს ხედვის ფუნქციებთან.
     • asgi.py: ASGI (Asynchronous Server Gateway Interface) კონფიგურაციის ფაილი, გამოიყენება ასინქრონული აპლიკაციების განსათავსებლად.
     • wsgi.py: WSGI (Web Server Gateway Interface) კონფიგურაციის ფაილი, გამოიყენება ტრადიციული სინქრონული აპლიკაციების განსათავსებლად.

3. განვითარების სერვერის გაშვება

Django-ს მოყვება მსუბუქი განვითარების სერვერი, რომელიც მოსახერხებელია ლოკალურად განვითარებისა და ტესტირებისთვის.

1. mysite დირექტორიაში გაუშვით შემდეგი ბრძანება:

   python manage.py runserver
   

2. გახსენით თქვენი ბრაუზერი და ეწვიეთ http://127.0.0.1:8000/. თქვენ უნდა ნახოთ გვერდი წარწერით "It worked! Congratulations on your first Django-powered page.".

4. Django აპლიკაციის შექმნა

Django პროექტს შეუძლია შეიცავდეს მრავალ აპლიკაციას. მოდით შევქმნათ აპლიკაცია სახელად myapp.

1. გახსენით ახალი ტერმინალის ფანჯარა (განაგრძეთ განვითარების სერვერის მუშაობა).

2. mysite დირექტორიაში გაუშვით შემდეგი ბრძანება:

   python manage.py startapp myapp
   

   ეს შექმნის დირექტორიას სახელად myapp mysite დირექტორიაში, რომელიც შეიცავს Django აპლიკაციის ჩარჩო ფაილებს.

3. Django აპლიკაციის დირექტორიის სტრუქტურა შემდეგია:

   myapp/
       __init__.py
       admin.py
       apps.py
       migrations/
           __init__.py
       models.py
       tests.py
       views.py
   

   • __init__.py: ცარიელი ფაილი, რომელიც ეუბნება Python-ს, რომ ეს დირექტორია უნდა ჩაითვალოს Python პაკეტად.
   • admin.py: გამოიყენება Django-ს ადმინისტრაციული პანელის კონფიგურაციისთვის.
   • apps.py: აპლიკაციის კონფიგურაცია.
   • migrations/: გამოიყენება მონაცემთა ბაზის მიგრაციების სამართავად.
   • models.py: განსაზღვრავს მონაცემთა მოდელებს (მონაცემთა ბაზის ცხრილებს).
   • tests.py: ტესტების დასაწერად.
   • views.py: განსაზღვრავს ხედვის ფუნქციებს, რომლებიც ამუშავებენ მოთხოვნებს და აბრუნებენ პასუხებს.

4. mysite/settings.py-ში დაამატეთ myapp INSTALLED_APPS სიაში:

   INSTALLED_APPS = [
       'django.contrib.admin',
       'django.contrib.auth',
       'django.contrib.contenttypes',
       'django.contrib.sessions',
       'django.contrib.messages',
       'django.contrib.staticfiles',
       'myapp',  # დაამატეთ myapp
   ]
   

5. მარტივი ხედვის შექმნა

ახლა ჩვენ შევქმნით მარტივ ხედვას, რომელიც ბრაუზერში აჩვენებს "Hello, Django!"-ს.

1. შეცვალეთ myapp/views.py ფაილი და დაამატეთ შემდეგი კოდი:

   from django.http import HttpResponse
   
   def index(request):
       return HttpResponse("Hello, Django!")
   

2. შექმენით myapp/urls.py ფაილი და დაუკავშირეთ URL ხედვის ფუნქციას:

    from django.urls import path
    from . import views

    urlpatterns = [
        path('', views.index, name='index'),
    ]
    ```

3.  `myapp/urls.py`-ის ჩართვა `mysite/urls.py`-ში:

    ```python
    from django.urls import include, path
    from django.contrib import admin

    urlpatterns = [
        path('admin/', admin.site.urls),
        path('myapp/', include('myapp.urls')),  # დაამატეთ myapp-ის URL კონფიგურაცია
    ]
    ```

4.  ეწვიეთ `http://127.0.0.1:8000/myapp/`-ს.  თქვენ უნდა ნახოთ გვერდი წარწერით \1. `myapp` დირექტორიაში შექმენით დირექტორია სახელად `templates`, ხოლო `templates` დირექტორიაში შექმენით დირექტორია სახელად `myapp` (`myapp/templates/myapp`).

2. `myapp/templates/myapp` დირექტორიაში შექმენით ფაილი სახელად `index.html` და დაამატეთ შემდეგი კოდი:

    ```html
    

        
            Hello, Django!
        

        The current time is: {{ current_time }}
    
    ```

3. შეცვალეთ `myapp/views.py` ფაილი, გამოიყენეთ შაბლონი:

    ```python
    from django.shortcuts import render
    import datetime

    def index(request):
        now = datetime.datetime.now()
        return render(request, 'myapp/index.html', {'current_time': now})
    ```

    `render` ფუნქცია ჩატვირთავს შაბლონს და გადასცემს მონაცემებს შაბლონს რენდერისთვის. // `render` ფუნქცია ტვირთავს შაბლონს და გადასცემს მონაცემებს რენდერისთვის.

4. ხელახლა ეწვიეთ `http://127.0.0.1:8000/myapp/`-ს. თქვენ უნდა ნახოთ გვერდი, რომელიც შეიცავს მიმდინარე დროს.

## 9. დასკვნა

ამ სახელმძღვანელოს საშუალებით თქვენ გაეცანით Django-ს ძირითად კონცეფციებსა და გამოყენების მეთოდებს, მათ შორის გარემოს დაყენებას, პროექტებისა და აპლიკაციების შექმნას, მოდელების განსაზღვრას, ხედების შექმნას და შაბლონების გამოყენებას. ეს მხოლოდ დასაწყისია, Django გთავაზობთ მდიდარ ფუნქციებს, შეგიძლიათ გააგრძელოთ სწავლა და გამოკვლევა, შექმნათ უფრო რთული ვებ აპლიკაციები.