演習 - 最初のプロジェクトを作成する

完了

Django の基本的な概念をいくつか説明したので、プロジェクトの作成を開始しましょう。

Django-admin を使用してプロジェクトを作成する

前に強調したように、Django プロジェクトは、作成するプロジェクト全体とアプリケーションのコンテナーです。 プロジェクトを作成しましょう。

Visual Studio Code の [ターミナル] ウィンドウで次のコマンドを実行します。

django-admin startproject helloproject .

重要

コマンドの末尾にあるピリオドは重要です。 django-admin に現在のフォルダーを使用するように指示します。 ピリオドを省略すると、追加のサブディレクトリが作成されます。

上記のコマンドを実行すると、新しいプロジェクトが選択したディレクトリに配置されます。 このインスタンスでは、helloproject という名前の新しいフォルダーが表示されます。

プロジェクトの構造を調べる

Django プロジェクトが作成されたので、その構造を見て、何が含まれているかを確認してみましょう。

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

• コマンドライン ユーティリティ manage.py は、すべての Django プロジェクトで作成されます。 これには、django-admin と同じ機能があります。次の例は、プロジェクト フォルダー内で、使用可能なサブコマンドを確認したい場合の使用方法を示しています。

  python manage.py help
  

• helloproject は、プロジェクトの Python パッケージと見なされます。

• init.py は、このディレクトリをパッケージと見なす必要があることを Python に通知する空のファイルです。

• settings.py には、すべての設定または構成が含まれています。

• urls.py には、プロジェクト内の URL が含まれています。

• asgi.py と wsgi.py は、デプロイされているサーバーの種類に応じて、Web サーバーのエントリ ポイントとして機能します。

プロジェクトを実行する

Django がインストールされ、プロジェクトが作成され、プロジェクトの構造を調べたので、プロジェクトが正しく機能していることを確認します。

1. Visual Studio Code の [ターミナル] ウィンドウで、次のコードを入力してサーバーを起動します。

   python manage.py runserver
   

   プロジェクトはシステム チェックを実行し、開発サーバーを起動します。 開発サーバーのURL (http://localhost:8000 である必要がある) をコピーして、お好みのブラウザーに貼り付けます。 ロケットが離陸する画像を含む Django の [おめでとう] ページが表示されます。

2. プロジェクトを再構成する必要があるため、サーバーを一時的に停止します。 [ターミナル] ウィンドウ内で、 Ctrl+C キーを押します。

Hello World アプリを作成する

ここでは、Django フレームワークの基本を学習し、プロジェクトのフォルダー構造を調べました。 それでは、最初のアプリを作成しましょう。 Hello, world! アプリは、アプリがどのように作成され、Django プロジェクトと連携してどのように機能するかを理解するのに役立ちます。

[ターミナル] ウィンドウ内で、次のコマンドを実行してアプリを作成します。

python manage.py startapp hello_world

このコマンドを使用すると、Django によって必要なフォルダーとファイルが作成され、次の構造が表示されます。

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

プロジェクトにアプリを登録する

Django ではアプリとプロジェクトは分離されているため、アプリをプロジェクトに登録する必要があります。 これを行うには、プロジェクトの settings.py 内の INSTALLED_APPS 変数を更新し、アプリの config クラスへの参照を追加します。 config クラスは apps.py にあり、プロジェクトと同じ名前です。 この例では、このクラスに HelloWorldConfig という名前が付けられています。

1. helloproject 内で、settings.py を開きます。

2. リスト INSTALLED_APPS を探します。これは 33 行目にあります。

3. リスト (角かっこ ([ ]) 内) の末尾に、次のコードを追加します。

   'hello_world.apps.HelloWorldConfig',
   

4. 更新後の INSTALLED_APPS リストは次のようになります。

   INSTALLED_APPS = [
       'django.contrib.admin',
       'django.contrib.auth',
       'django.contrib.contenttypes',
       'django.contrib.sessions',
       'django.contrib.messages',
       'django.contrib.staticfiles',
       'hello_world.apps.HelloWorldConfig',
   ]    
   

5. [ファイル]>[すべて保存] を選択して、すべてのファイルを保存します。

おめでとうございます。 これで、最初の Django プロジェクトとアプリが作成されました。 次に、いくつかの機能を追加するためのパスとビューを作成します。