著者: Li Juncai (jcLee95) : https://blog.csdn.net/qq_28550263
電子メール : [email protected]
記事アドレス: https://blog.csdn.net/qq_28550263/article/details/132892113
【介绍】:Django开发环境配置与第一个Django项目的搭建。包括虚拟隔离环境,命令行工具的使用等。
目次
- 1。概要
- 2.Python開発環境のインストール
- 3. Python 仮想分離環境とその作成
- 4. django-admin コマンドラインツールの分析
-
- 4.1 機能概要
- 4.2 チェックコマンド
- 4.3 コンパイルメッセージコマンド
- 4.4 createcachetable コマンド
- 4.5 dbshell コマンド
- 4.6 diffsettings コマンド
- 4.7 dumpdataコマンド
- 4.8 フラッシュコマンド
- 4.9 Inspectiondb コマンド
- 4.10 ロードデータコマンド
- 4.11 makemessages コマンド
- 4.12 makemigrations コマンド
- 4.13 移行コマンド
- 4.14 optimizemigration コマンド
- 4.15 runserver コマンド
- 4.16 sendtestemail コマンド
- 4.17 シェルコマンド
- 4.18 showmigrations コマンド
- 4.19 sqlflushコマンド
- 4.20 sqlmergeコマンド
- 4.21 sqlsequenceresetコマンド
- 4.22 squashmigrations コマンド
- 4.23 startappコマンド
- 4.24 startprojectコマンド
- 4.25 テストサーバーコマンド
- 5. Django におけるアプリとプロジェクトの関係
1。概要
この記事では、適切なバージョンとダウンロード ソースの選択を含め、Python をインストールする方法について説明します。次に、仮想環境の概念を詳しく掘り下げて、プロジェクトの分離と依存関係の管理に仮想分離環境が重要である理由を説明します。Python のツールを使用して仮想環境を作成する方法venv
と、それをアクティブ化して Django をインストールする方法を学びます。
次に、この記事では Django のコマンド ライン ツールの使用法について詳しく説明しdjango-admin
、データベースの移行、サーバーの起動、アプリケーションの作成など、よく使用されるさまざまなコマンドの機能と使用法を説明します。
最後に、この記事では、開発者が Django プロジェクトのさまざまなコンポーネントをより適切に整理および管理できるように、Django プロジェクトの「プロジェクト」と「アプリ」の概念について説明します。
2.Python開発環境のインストール
この一連の記事は Python3 に基づいているため、インストールする Python のバージョンが一貫していることを確認してください。
3. Python 仮想分離環境とその作成
3.1 仮想分離環境とは何ですか?
仮想隔離環境の概念
Python 仮想分離環境は、さまざまなプロジェクトの Python の依存関係とライブラリを分離するためのツールです。これにより、異なるバージョンの Python と、異なるプロジェクトに必要な依存関係を競合することなく同じマシン上で実行できます。仮想環境は、プロジェクトの独立性を維持し、プロジェクト間の依存関係が相互に干渉しないようにするのに役立ちます。
仮想分離環境の使用が推奨されるのはなぜですか?
まず、依存関係の分離の観点から見ると、プロジェクトごとに異なるバージョンの Python ライブラリと依存関係が必要になる場合があります。仮想環境を作成すると、各プロジェクトの依存関係を個別に管理し、プロジェクト間のライブラリが競合しないようにすることができます。これは、あるプロジェクトを更新するときに別のプロジェクトの依存関係が壊れることを避けるのに役立ちます。
次に、バージョン互換性の観点から、一部のプロジェクトでは特定のバージョンの Python が必要になる場合があります。仮想環境を使用すると、同じコンピューター上で複数の Python バージョンを相互に干渉することなく同時に実行できます。これは、レガシー コードを維持したり、新しいバージョンの Python との互換性テストを行うために重要です。
プロジェクトの独立性の観点から、仮想環境は各プロジェクトを分離し、Python 環境を独立して管理できるようにします。これは、他のプロジェクトへの影響を心配することなく、特定のプロジェクトに必要なライブラリをインストールできることを意味します。これは、プロジェクトをクリーンで独立した状態に保つのに役立ちます。
次に、システム Python の分離の観点から、システム Python は通常、オペレーティング システム レベルのタスクに使用され、システム Python を変更すると、不安定性や問題が発生する可能性があります。仮想環境はプロジェクト固有であるため、仮想環境を使用すると、システム Python への干渉が回避されます。
仮想環境は、他の開発者や展開環境と簡単に共有できます。仮想環境の構成ファイル (requirements.txt など) を他のユーザーと共有して、他のユーザーが同じ環境でプロジェクトを実行できるようにすることができます。
仮想環境を使用すると、開発環境をクリーンな状態に保ち、多数のライブラリや依存関係をグローバルにインストールすることを回避できます。これにより、異なるプロジェクト間を切り替えるときにさらに便利になります。
さらに、仮想環境により、プロジェクトでの単体テストと統合テストの実行が容易になります。テスト用に別の仮想環境を作成して、テストが他のプロジェクトの影響を受けないようにすることができます。
3.2 venv の使用状況の分析
venv は仮想環境の作成と管理に使用される Python のモジュールであり、別途インストールする必要はありません。venv モジュールは、コマンドを通じて 1 つ以上のターゲット ディレクトリに仮想 Python 環境を作成するコマンド ライン ツールを提供します。。その使用形式は次のとおりです。
venv [-h] [--system-site-packages] [--symlinks | --copies] [--clear] [--upgrade] [--without-pip]
[--prompt PROMPT] [--upgrade-deps]
ENV_DIR [ENV_DIR ...]
その中で、位置パラメータは次のとおりです。
- ENV_DIR: 環境を作成するディレクトリを示します。
このコマンドには次のオプションがあります。
-h
、--help
ヘルプメッセージを表示して終了します--system-site-packages
仮想環境がシステムの site-packages ディレクトリ内のパッケージにアクセスできることを示します。--symlinks
プラットフォームのデフォルトではない場合は、ファイルをコピーする代わりにシンボリックリンクを使用してみてください。--copies
プラットフォームがデフォルトでシンボリックリンクを使用する場合でも、コピー ファイルを使用しようとします。--clear
環境を作成する前に、環境ディレクトリが既に存在する場合はその内容を削除します。--upgrade
Python が適切にアップグレードされていることを前提として、このバージョンの Python を使用するように環境ディレクトリをアップグレードします。--without-pip
仮想環境での pip のインストールまたはアップグレードをスキップします (pip はデフォルトで起動してインストールされます)。--prompt PROMPT
この環境用の代替プロンプト接頭辞を提供します。--upgrade-deps
コアの依存関係: pip および setuptools を PyPI の最新バージョンにアップグレードします。
3.3 Django プロジェクトの仮想分離環境を作成する
仮想分離環境を作成し、その中で最初の Django プロジェクトを開発するにはvenv
、次の手順に従います。
1. プロジェクトディレクトリを作成する
まず、Django プロジェクトを格納する新しいディレクトリを作成します。コマンドラインでコマンドを使用して、mkdir
新しいディレクトリを作成できます。次に例を示します。
mkdir mydjango_project
cd mydjango_project
2. 仮想環境を作成する
プロジェクト ディレクトリで、venv
コマンドを使用して新しい仮想環境を作成します。仮想環境の名前は通常 ですenv
が、必要に応じて別の名前を選択できます。
python -m venv env
これにより、プロジェクト ディレクトリに というenv
仮想環境が作成されます。
3. 仮想環境をアクティブ化する
仮想環境を作成したら、Django やその他の依存関係を仮想環境にインストールできるように、仮想環境をアクティブ化する必要があります。コマンドラインで次のコマンドを実行します。
-
Windows の場合:
# 也就是.\env\Scripts\activate env\Scripts\activate
-
Linux の場合:
source env/bin/activate
仮想環境をアクティブ化すると、コマンド ライン プロンプトの前に仮想環境の名前 (たとえば、 (env)
)が表示され、仮想環境が有効になったことを示します。
4.Djangoをインストールする
アクティブ化された仮想環境で、次を使用してpip
Django をインストールします。
pip install django
これにより、Django の最新バージョンがインストールされます。
5. Django プロジェクトを作成する
これで、プロジェクト ディレクトリで次のコマンドを使用して、django-admin
新しい Django プロジェクトを作成できます。
django-admin startproject myproject
システム Python を使用している場合、django-admin ツールはシステム Python のスクリプト ディレクトリにあるため、システム Python のスクリプト ディレクトリをシステムのパス環境変数に追加する必要があることに注意してください (同様のことが、システム Python の pip コマンド (実際にはそこにある実行可能ファイルです)。仮想分離環境の Python であれば、 などを利用して
django-admin
システムpip
パス環境変数に分離環境 Python を追加する必要はなく、上で紹介した方法で対応する Python 仮想分離環境に入ります。
これにより、myproject
という名前の Django プロジェクトが作成され、プロジェクト ディレクトリに関連ファイルとディレクトリが生成されます。
ステップ 6: 開発サーバーを実行する
Django プロジェクト ディレクトリを入力します。
cd myproject
次に、Django の開発サーバーを実行します。
python manage.py runserver
これにより開発サーバーが起動し、デフォルトでリッスンしますhttp://127.0.0.1:8000/
。
注: ポートを自分で指定することもできます。指定したいポート番号を最後に追加するだけです。たとえば、ポート 8001 で Web リクエストをリッスンするように指定した場合は、次のコマンドを実行するだけで済みます。
python manage.py runserver 8001
実行後、いくつかのプロンプトが表示されます。
You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
このプロンプトは Django の移行システムによって提供され、データベースにまだ適用されていないデータベース移行があることを示します。データベース移行は、テーブルの作成、テーブル構造の変更、フィールドの追加などの操作を含む、データベース スキーマ (構造) の変更を管理するために使用されます。
ただし、これによって Django 独自の初期インターフェイスが表示されることは妨げられません。もちろん、実行前に次のコマンドを実行することもできます。
python manage.py migrate
移行コマンドは、Django アプリケーションの移行ファイルに基づいてデータベース構造を Django モデルと同期します。新しい Django プロジェクトを作成する場合、通常、Django の組み込みアプリケーション (admin、auth、contenttypes、sessions など) に必要なデータベース テーブルを作成するために使用される初期移行ファイルがいくつかあります。
したがって、このプロンプトが表示された場合、通常のアプローチは、python manage.py merge を実行して、これらの未適用の移行を適用することです。このようにして、Django はモデル定義を反映するためにデータベース テーブルを作成または更新します。この後、Django プロジェクトは正常に動作するはずです。
移行コマンドの実行時にエラーが発生した場合は、エラー メッセージを確認して問題の具体的な原因を理解し、エラー メッセージに基づいて適切なアクションを実行して問題を解決してください。通常、これらのエラーは、モデル定義を変更するか、ファイルを移行することで解決できます。
ステップ 7: Django プロジェクトにアクセスする
これで、ブラウザでアクセスしてhttp://127.0.0.1:8000/
、Django プロジェクトが実行されているのを確認できるようになります。
このインターフェイスも見たことがある場合は、仮想分離環境の作成とその中での Django プロジェクトの開発に成功しました。おめでとうございます。
4. django-admin コマンドラインツールの分析
4.1 機能概要
django-admin
これは、Django のコマンド ライン ツールであり、Django 関連のさまざまなタスクを実行し、Django プロジェクトを管理するために使用されます。グローバル環境では、Python スクリプト ディレクトリの実行可能ファイルを通じてこのコマンド ライン ツールを実行します。プロジェクトが作成されたら、 をdjango-admin
使用して現在の Django プロジェクトでpython manage.py xxx
同じコマンドを実行できます。
仮想分離環境を使用している場合は、まず対応する仮想分離環境をアクティブ化する必要があることに注意してください。
django-admin によって提供されるコマンドとそれらに対応する機能を次の表に示します。
注文 | 関数 |
---|---|
チェック | 未使用のインポート、名前の競合などの問題やエラーがプロジェクトにないか確認してください。 |
コンパイルメッセージ | 国際的に使用できるように翻訳ファイルをコンパイルする |
キャッシュテーブルの作成 | データベースにキャッシュテーブルを作成する |
DBシェル | データベースクライアント経由でデータベースにアクセスする |
差分設定 | 現在の設定ファイルとデフォルト設定ファイルの違いを比較する |
データをダンプする | 将来使用できるようにデータをファイルにダンプする |
流す | データベース内のすべてのデータをクリアします |
インスペクトデータベース | データベース構造に基づいてモデルコードを生成 |
データを読み込む | ファイルからデータベースにデータをロードします |
メイクメッセージ | Django コードから翻訳可能なテキストを抽出し、翻訳ファイルを作成する |
移住をする | モデル変更に基づいてデータベース移行ファイルを生成する |
移行する | データベースを最新のモデル状態に移行する |
移行の最適化 | データベースの移行を最適化してパフォーマンスを向上させる |
ランサーバー | 開発サーバーを起動して Django アプリケーションをローカルで実行します。 |
テストメールを送信する | テストメールを送信してメール設定を確認する |
シェル | Django プロジェクトとモデルにアクセスできる対話型 Python シェル環境に入ります。 |
ショーマイグレーション | アクティビティとアプリケーションで移行ステータスを表示する |
スクフルフラッシュ | データベースをクリアするための SQL ステートメントを生成する |
sqlマイグレーション | 移行ファイルに基づいて SQL ステートメントを生成および実行する |
SQLシーケンスリセット | 指定されたモデルのシリアル番号をリセットします |
スカッシュマイグレーション | 複数の移行ファイルを 1 つのファイルに結合する |
スタートアップアプリ | 新しい Django アプリケーションを作成する |
プロジェクトを開始する | 新しい Django プロジェクトを作成する |
テスト | Django アプリケーションのテストの実行 |
テストサーバー | Django アプリケーションのテストを実行するための開発サーバーを起動します。 |
4.2 チェックコマンド
django-admin check
Django プロジェクト全体の潜在的な問題やエラーをチェックするために使用されます。その構文形式は次のとおりです。
django-admin check [-h] [--tag TAGS] [--list-tags] [--deploy]
[--fail-level {
CRITICAL,ERROR,WARNING,INFO,DEBUG}] [--database DATABASES] [--version]
[-v {
0,1,2,3}] [--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback] [--no-color]
[--force-color]
[app_label ...]
その中で、位置パラメータ (Positional Arguments) は次のとおりです。
app_label
: オプションのパラメータ。チェックするアプリケーションの名前を示します。1 つ以上のアプリ名が指定されている場合、check
コマンドはそれらのアプリの問題のみをチェックします。アプリ名が指定されていない場合は、プロジェクト全体がチェックされます。
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--tag TAGS
,-t TAGS
: 指定されたラベルのチェックのみを実行します。タグは試験をグループ化するために使用され、特定のタグに対して試験を実行することを選択できます。たとえば、--tag security
セキュリティ関連のチェックのみが実行されます。 -
--list-tags
: 使用可能なタグをリストします。このオプションでは、プロジェクトで使用可能なタグのリストが表示されるので、関連するタグのチェックを実行することを選択できます。 -
--deploy
: 導入設定を確認してください。このオプションを使用すると、展開関連のチェックが実行され、プロジェクト設定が展開要件を満たしているかどうかが確認されます。 -
--fail-level {CRITICAL,ERROR,WARNING,INFO,DEBUG}
: コマンドをゼロ以外のステータスで終了させるメッセージ レベルを指定します。デフォルトのレベルは ですERROR
。これは、エラーが見つかった場合にのみコマンドが終了することを意味します。 -
--database DATABASES
:データベース関連のチェックを実行するデータベース エイリアスを指定します。これにより、特定のデータベース構成のチェックを実行できます--database default
。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
django-admin check
Command は、データベース関連の問題、展開設定の問題、セキュリティの問題など、プロジェクト内の潜在的な問題やエラーを見つけるのに役立つ非常に便利なツールです。プロジェクトをチェックすることで、プロジェクトの健全性を確保し、潜在的なエラーを減らすことができます。必要に応じて、さまざまなオプションを使用して、検査の範囲と詳細レベルをカスタマイズできます。
4.3 コンパイルメッセージコマンド
django-admin compilemessages
組み込みの gettext サポートで使用する.po
ファイルにファイルをコンパイルするために使用されます。.mo
gettext は、Django プロジェクトで多言語翻訳をサポートするために使用される国際化およびローカリゼーション ツールです。その構文形式は次のとおりです。
django-admin compilemessages [-h] [--locale LOCALE] [--exclude EXCLUDE] [--use-fuzzy] [--ignore PATTERN]
[--version] [-v {
0,1,2,3}] [--settings SETTINGS] [--pythonpath PYTHONPATH]
[--traceback] [--no-color] [--force-color]
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--locale LOCALE
,-l LOCALE
: 処理対象のロケール(Locale)を指定します。デフォルトでは、利用可能なすべてのロケールが処理されますが、このオプションを使用して 1 つ以上のロケールを指定できます--locale de_AT
。 -
--exclude EXCLUDE
,-x EXCLUDE
: 除外するロケールを指定します。デフォルトでは除外されるロケールはありませんが、このオプションを使用して、処理する必要のないロケールを除外できます--exclude es_ES
。 -
--use-fuzzy
,-f
: あいまい翻訳を使用します。このオプションが有効な場合、コンパイル プロセスでは、ambiguous としてマークされた翻訳を使用してファイルが生成されます.mo
。ファジー翻訳は、翻訳が完全に正確ではない可能性があり、さらなるレビューが必要であることを示す翻訳ファイル内のフラグです。 -
--ignore PATTERN
,-i PATTERN
: 無視するディレクトリを指定します。ワイルドカードのようなパターンを使用して照合できます。このオプションを複数回使用して、無視する複数のディレクトリを指定できます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
django-admin compilemessages
このコマンドは、多言語アプリケーションをサポートするために、Django プロジェクトのテキスト翻訳をファイルからさまざまな言語に翻訳されたテキストを含むファイルに.po
コンパイルするために使用されます。.mo
通常、このコマンドは、国際化およびローカリゼーションの開発中に、さまざまなロケールでの翻訳を提供するために使用されます。
4.4 createcachetable コマンド
django-admin createcachetable
は、SQL キャッシュ バックエンドを使用するときに必要なキャッシュ テーブルを作成するために使用される Django のコマンドです。その構文形式は次のとおりです。
django-admin createcachetable [-h] [--database DATABASE] [--dry-run] [--version] [-v {
0,1,2,3}]
[--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback] [--no-color]
[--force-color]
[table_name ...]
で:
位置引数:
table_name
: 作成するキャッシュ テーブルの名前を示すオプションのパラメーター。テーブル名が指定されていない場合は、プロジェクトの設定ファイルのCACHES
構成を使用してキャッシュ テーブルの名前が決定されます。
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--database DATABASE
: キャッシュテーブルをインストールするデータベースを指定します。デフォルトでは、キャッシュ テーブルは「default」という名前のデータベースにインストールされます。 -
--dry-run
: テーブルは作成されず、実行される SQL ステートメントのみが出力されます。このオプションを使用すると、実際にテーブルを作成せずに実行される SQL ステートメントをプレビューできます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
django-admin createcachetable
コマンドは、SQL キャッシュ バックエンドを使用するときに必要なキャッシュ テーブルを作成するために使用されます。これらのテーブルは、Django アプリケーションのパフォーマンスを高速化するためにキャッシュされたデータを保存するために使用されます。このコマンドを使用してキャッシュ テーブルを作成し、プロジェクトでキャッシュ機能を使用できます。通常、Django は必要に応じてキャッシュ テーブルを自動的に作成するため、このコマンドを手動で実行する必要はありません。
4.5 dbshell コマンド
django-admin の dbshell コマンドは、指定されたデータベースのコマンド ライン クライアントを起動するために使用されます。データベース名が指定されていない場合は、デフォルトのデータベースが使用されます。その構文形式は次のとおりです。
django-admin dbshell [-h] [--database DATABASE] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color]
[parameters ...]
その中には:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--database DATABASE
: データベースを指定してコマンドラインクライアントを開きます。デフォルトでは、「default」という名前のデータベースが使用されます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
パラメータ:
parameters
: データベース コマンド ライン クライアントに渡される追加パラメータのオプション パラメータ。これらのパラメータは通常、ユーザー名、パスワードなど、データベース コマンド ライン クライアントに固有のオプションです。
django-admin dbshell
コマンドを使用すると、コマンド ラインを通じてデータベースにアクセスし、SQL クエリやその他のデータベース操作を実行できます。オプションを使用して--database
接続先のデータベースを指定したり、parameters
他のデータベース クライアント固有のパラメータをパラメータで渡すことができます。このコマンドは、データベースのデバッグと保守に非常に役立ちます。
4.6 diffsettings コマンド
django-admin diffsettings
このコマンドは、settings.py
現在のプロジェクトの設定ファイル ( ) と Django のデフォルト設定の違いを表示します。その構文形式は次のとおりです。
django-admin diffsettings [-h] [--all] [--default MODULE] [--output {
hash,unified}] [--version]
[-v {
0,1,2,3}] [--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback]
[--no-color] [--force-color]
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--all
: 値に関係なく、すべての設定を表示します。「ハッシュ」モードでは、デフォルト値は「###」プレフィックス付きで表示されます。 -
--default MODULE
: 現在の設定を比較するデフォルト設定モジュールを指定します。このオプションが指定されていない場合は、デフォルトが Django のデフォルト設定と比較されます。 -
--output {hash,unified}
:出力形式を選択します。「ハッシュ」モードでは、変更された各設定が表示され、デフォルト設定にない設定は「###」プレフィックス付きで表示されます。「統合」モードでは、マイナス記号の接頭辞を使用してデフォルト設定を示し、その後にプラス記号の接頭辞を使用して変更された設定を示します。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
django-admin diffsettings
このコマンドは、現在のプロジェクトの設定ファイルと Django のデフォルト設定の違いを比較するために使用されます。これは、プロジェクトのニーズを満たすためにどの設定が変更されたかを確認するのに役立ちます。さまざまな出力形式を選択して、設定の違いをより明確に確認できます。
4.7 dumpdataコマンド
dumpdata
データベースの内容を指定した形式で出力するコマンドで、出力結果をフィクスチャとして利用できます。--all
デフォルトでは、パラメーターが指定されていない限り、各モデルは出力にデフォルトのマネージャーを使用します。
その構文形式は次のとおりです。
django-admin dumpdata [-h] [--format FORMAT] [--indent INDENT] [--database DATABASE] [-e EXCLUDE]
[--natural-foreign] [--natural-primary] [-a] [--pks PRIMARY_KEYS] [-o OUTPUT]
[--version] [-v {
0,1,2,3}] [--settings SETTINGS] [--pythonpath PYTHONPATH]
[--traceback] [--no-color] [--force-color] [--skip-checks]
[app_label[.ModelName] ...]
で
オプション:
app_label[.ModelName]
: 出力データを指定された app_label または app_label.ModelName に制限します。--format FORMAT
: 出力シリアル化形式を指定します。--indent INDENT
:出力時のインデントレベルを指定します。--database DATABASE
: フィクスチャをエクスポートするデータベースを指定します。デフォルトは「デフォルト」データベースです。-e EXCLUDE, --exclude EXCLUDE
: 除外する app_label または app_label.ModelName (--exclude
複数のアプリまたはモデルを除外するために複数を使用できます)。--natural-foreign
: 利用可能な場合は自然外部キーを使用します。--natural-primary
: 可能な場合は自然主キーを使用します。-a, --all
: Django のベース マネージャーを使用して、カスタム マネージャーによってフィルターまたは変更されたモデルを含む、データベース内のすべてのモデルのデータを出力します。--pks PRIMARY_KEYS
: 指定された主キーを持つオブジェクトのみを出力します。主キーのカンマ区切りリストを受け入れます。このオプションはモデルを指定する場合にのみ有効です。-o OUTPUT, --output OUTPUT
: 出力結果を書き込むファイルを指定します。--version
: プログラムのバージョン番号を表示して終了します。-v {0,1,2,3}, --verbosity {0,1,2,3}
: 出力レベルを設定します; 0=最小出力、1=通常出力、2=詳細出力、3=非常に詳細な出力。--settings SETTINGS
: 「myproject.settings.main」などの設定モジュールの Python パスを指定します。このパラメータが指定されていない場合は、DJANGO_SETTINGS_MODULE 環境変数が使用されます。--pythonpath PYTHONPATH
: Python パスに追加されるディレクトリ (「/home/djangoprojects/myproject」など)。--traceback
: コマンドエラー例外が発生した場合に例外をスローします。--no-color
: コマンド出力を色付けしません。--force-color
: コマンド出力の色付けを強制します。--skip-checks
: システムチェックをスキップします。
上記はdjango-admin dumpdata
コマンドの詳細な説明です。必要に応じて、対応するオプションを使用してデータベースの内容をエクスポートできます。
4.8 フラッシュコマンド
django-admin flush
コマンドは、移行中に追加されたデータを含むすべてのデータをデータベースから削除するために使用されます。このコマンドはデータベースを「新規インストール」状態に復元するのではなく、テーブル構造などの他のコンテンツには影響を与えずにデータベース内のデータを消去するだけであることに注意してください。以下は、django-admin flush
コマンドのパラメーターとオプションの分析です。その構文形式は次のとおりです。
django-admin flush [-h] [--noinput] [--database DATABASE] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color] [--skip-checks]
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--noinput
,--no-input
: Django にユーザーに入力を求めないように指示します。このオプションを使用しない場合、コマンドはユーザーにすべてのデータの削除を確認するよう求めます。 -
--database DATABASE
: フラッシュ操作を実行するデータベースを指定します。デフォルトでは、「default」という名前のデータベースが使用されます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。 -
--skip-checks
: システムチェックをスキップします。システムチェックを無視してフラッシュ操作を実行する場合は、このオプションを使用します。
django-admin flush
コマンドは通常、開発データベースまたはテスト データベースのデータをクリアして、データを最初からやり直したり、再設定したりするために使用されます。ユーザーデータやテストデータなどを含むすべてのデータが削除されるため、使用には注意してください。
4.9 Inspectiondb コマンド
django-admin inspectdb
このコマンドは、指定されたデータベース内のテーブルまたはビューを確認し、データベース構造に基づいて対応する Django モデルを生成するために使用されます。その構文形式は次のとおりです。
django-admin inspectdb [-h] [--database DATABASE] [--include-partitions] [--include-views] [--version]
[-v {
0,1,2,3}] [--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback]
[--no-color] [--force-color]
[table ...]
で:
位置引数:
table
: オプションのパラメータ。チェックするテーブルまたはビューを選択します。テーブル名が指定されていない場合、デフォルトですべてのテーブルとビューがチェックされます。
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--database DATABASE
:チェックを行うデータベースを指定します。デフォルトでは、「default」という名前のデータベースが使用されます。 -
--include-partitions
: パーティションテーブルのモデルを出力します。データベースにパーティション テーブルが存在する場合、このオプションを使用すると、対応するモデルが生成されます。 -
--include-views
: データベースビューのモデルを出力します。データベースにビューが存在する場合、このオプションを使用すると、対応するモデルが生成されます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
django-admin inspectdb
コマンドは、指定されたデータベース内のテーブルまたはビューに対応する Django モデルのコードを自動的に生成するために使用されます。これは、手動でモデルを作成する労力を軽減できるため、既存のデータベースのリバース エンジニアリングに役立ちます。生成されたモデル コードを使用して、Django プロジェクトのデータベース テーブルまたはビューのデータにアクセスして操作できます。
4.10 ロードデータコマンド
django-admin loaddata
このコマンドは、指定されたデータ フィクスチャ ファイルをデータベースにロードするために使用されます。これらのフィクスチャ ファイルには、データベースの初期化やデータベース テーブルの設定に使用できる事前定義されたデータが含まれています。その構文形式は次のとおりです。
django-admin loaddata [-h] [--database DATABASE] [--app APP_LABEL] [--ignorenonexistent] [-e EXCLUDE]
[--format FORMAT] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color] [--skip-checks]
fixture [fixture ...]
で:
位置引数:
fixture
: ロードするフィクスチャ タグ。1 つ以上指定できます。フィクスチャ タグは通常、事前定義されたデータを含むファイルに対応します。
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--database DATABASE
: フィクスチャデータをロードするデータベースを指定します。デフォルトでは、「default」という名前のデータベースが使用されます。 -
--app APP_LABEL
: 指定されたアプリケーション内でのみフィクスチャを検索します。このオプションを使用して、フィクスチャの検索範囲を制限できます。 -
--ignorenonexistent
,-i
: シリアル化されたデータには存在するが、現在のモデルには存在しないフィールドを無視します。モデル変更によるフィクスチャのロード失敗を防ぐには、このオプションを使用します。 -
-e EXCLUDE
,--exclude EXCLUDE
: 指定したアプリケーションまたはモデルを除外します。複数回使用して、複数のアプリケーションまたはモデルを除外できます。 -
--format FORMAT
: 標準入力からデータを読み取る際のシリアル化形式を指定します。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。 -
--skip-checks
: システムチェックをスキップします。システムチェックを無視して、代わりにフィクスチャのロードを実行したい場合は、このオプションを使用してください。
django-admin loaddata
コマンドは通常、データベースを初期化するか、事前定義されたデータをデータベースに追加するために使用されます。フィクスチャ ファイルにはモデル データのシリアル化された表現が含まれており、手動でデータを追加しなくてもデータベース テーブルに自動的にデータを取り込むことができます。
4.11 makemessages コマンド
django-admin makemessages
このコマンドは、コードから翻訳が必要とマークされた文字列を抽出し、対応する翻訳ファイルを作成または更新するために使用されます。その構文形式は次のとおりです。
django-admin makemessages [-h] [--locale LOCALE] [--exclude EXCLUDE] [--domain DOMAIN] [--all]
[--extension EXTENSIONS] [--symlinks] [--ignore PATTERN] [--no-default-ignore]
[--no-wrap] [--no-location] [--add-location [{
full,file,never}]] [--no-obsolete]
[--keep-pot] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color]
で:
--locale LOCALE, -l LOCALE
: 作成または更新する言語コードを指定します。このオプションを複数回使用して、複数の言語を指定できます。--exclude EXCLUDE, -x EXCLUDE
: 除外する言語コードを指定します。デフォルトは「なし」です。このオプションを複数回使用して、複数の言語を除外できます。--domain DOMAIN, -d DOMAIN
: 翻訳ファイルのドメインを指定します。デフォルトは「django」です。--all, -a
: 既存のすべての言語の翻訳ファイルを更新します。--extension EXTENSIONS, -e EXTENSIONS
: チェックするファイル拡張子。デフォルトは「html,txt,py」、またはドメインが「djangojs」の場合は「js」です。カンマを使用して複数の拡張子を区切ったり、複数回使用して-e
複数の拡張子を指定したりできます。--symlinks, -s
: 翻訳文字列を抽出するためにソース コードとテンプレートを検査するときにシンボリックリンクをたどるディレクトリ。--ignore PATTERN, -i PATTERN
: 指定されたパターンに一致するファイルまたはディレクトリを無視します。このオプションを複数回使用すると、さらに多くのファイルを無視できます。--no-default-ignore
: 「CVS」、「. 」、「 ~」、「*.pyc」などの一般的なパターンを無視しないでください。--no-wrap
: 長いメッセージ行を複数行に分割しないでください。--no-location
注:「#:filename:linenumber」行は記述しないでください。--add-location [{full,file,never}]
: 「#:filename:linenumber」行を制御します。オプションが「full」の場合(オプションが指定されていない場合のデフォルトは「full」)、行番号にはファイル名と行番号が含まれます。「file」の場合、行番号は省略されます。「never」の場合、行番号は表示されません (--no-location
と同じ)。--add-location
gettext 0.19 以降が必要です。--no-obsolete
: 古い翻訳文字列を削除します。--keep-pot
: デバッグ用に翻訳ファイルを生成した後、.pot ファイルを保存します。--version
: プログラムのバージョン番号を表示して終了します。-v {0,1,2,3}, --verbosity {0,1,2,3}
: 出力の詳細レベルを指定します。0=最小出力、1=通常出力、2=詳細出力、3=非常に詳細な出力。--settings SETTINGS
: 「myproject.settings.main」などの設定モジュールの Python パスを指定します。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE 環境変数が使用されます。--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ (「/home/djangoprojects/myproject」など)。--traceback
: CommandError 例外が発生した場合に例外をスローします。--no-color
: コマンド出力に色を付けません--force-color
: コマンド出力の色付けを強制します。
この情報がお役に立てば幸いです!
4.12 makemigrations コマンド
django-admin makemigrations
コマンドは、アプリケーションの新しいデータベース移行ファイルを作成するために使用されます。その構文形式は次のとおりです。
django-admin makemigrations [-h] [--dry-run] [--merge] [--empty] [--noinput] [-n NAME] [--no-header]
[--check] [--scriptable] [--update] [--version] [-v {
0,1,2,3}]
[--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback] [--no-color]
[--force-color] [--skip-checks]
[app_label ...]
で
位置引数:
app_label
:移行を作成するアプリケーション タグを指定します。スペースで区切って 1 つ以上のアプリケーション ラベルを指定できます。
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--dry-run
: 実際に生成せずに、生成される移行のみを表示します。 -
--merge
: 移行の競合を解決する機能を有効にします。複数の移行ファイルを 1 つにマージするために使用されます。 -
--empty
:空の移行ファイルを作成します。通常は手動編集に使用されます。 -
--noinput
,--no-input
: Django にユーザーに入力を求めないように指示します。 -
-n NAME
,--name NAME
: マイグレーションファイルの名前を指定します。移行ファイルの名前をカスタマイズするために使用できます。 -
--no-header
: 新しい移行ファイルにヘッダー コメントを追加しないでください。 -
--check
: モデル変更に移行がなく、実際に移行が作成されない場合は、ゼロ以外のステータスで終了します。 -
--scriptable
: ログ出力および入力プロンプトを stderr にリダイレクトし、生成された移行ファイルへのパスのみを stdout に書き込みます。 -
--update
: モデルの変更を最新の移行ファイルにマージし、結果の操作を最適化します。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。 -
--skip-checks
: システムチェックをスキップします。システムチェックを無視して移行作成操作を実行する場合は、このオプションを使用します。
django-admin makemigrations
このコマンドは通常、モデルの変更に関連するデータベース移行ファイルを作成し、それらの変更をデータベースに適用するために使用されます。
4.13 移行コマンド
django-admin migrate
コマンドはデータベースのスキーマを更新するために使用されます。移行のあるアプリケーションと移行しないアプリケーションを管理します。次の構文形式は次のとおりです。
django-admin migrate [-h] [--noinput] [--database DATABASE] [--fake] [--fake-initial] [--plan]
[--run-syncdb] [--check] [--prune] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color] [--skip-checks]
[app_label] [migration_name]
で:
位置引数:
app_label
: ステータスを同期するアプリケーションを示すアプリケーション ラベル。1 つ以上のアプリケーション タグを指定できます。migration_name
:データベースの状態は移行後の状態に調整されます。すべての移行の適用を解除するには、名前として「ゼロ」を使用します。
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--noinput
,--no-input
: Django にユーザーに入力を求めないように指示します。 -
--database DATABASE
: 同期するデータベースを指定します。デフォルトでは、「default」という名前のデータベースが使用されます。 -
--fake
: 移行を実行中としてマークしますが、実際には実行しません。これは通常、以前の移行が適用されていることをマークするために使用されますが、データベース スキーマを変更する必要はありません。 -
--fake-initial
: テーブルが既に存在するかどうかを検出し、存在する場合は、初期移行の適用をシミュレートします。このフラグを使用する前に、現在のデータベース スキーマが最初の移行と一致していることを確認してください。 -
--plan
: 実際には実行せずに、実行される移行操作のリストを表示します。 -
--run-syncdb
:移行せずにアプリケーション用のテーブルを作成します。 -
--check
: 未適用の移行がある場合は、実際に移行を適用せずに、ゼロ以外のステータスで終了します。 -
--prune
:django_migrations
存在しない移行レコードをテーブルから削除します。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。 -
--skip-checks
: システムチェックをスキップします。システムチェックを無視して移行操作を実行する場合は、このオプションを使用します。
django-admin migrate
このコマンドは通常、データベース移行を適用して、データベースのスキーマが現在のコードの状態と一致していることを確認するために使用されます。このコマンドは、各アプリケーションで定義された移行操作を実行し、データベースをプロジェクト コードと一致する状態に更新します。
4.14 optimizemigration コマンド
django-admin optimizemigration
コマンドは、指定された移行の操作を最適化するために使用されます。その構文形式は次のとおりです。
django-admin optimizemigration [-h] [--check] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color]
[--skip-checks]
app_label migration_name
で:
位置引数:
app_label
: 移行操作を最適化するアプリケーションのラベル。migration_name
: 最適化する移行の名前。
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--check
: 移行を最適化できる場合は、ゼロ以外のステータスで終了します。このオプションは、実際の最適化操作を実行せずに移行を最適化できるかどうかを確認するために使用されます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
,--verbosity {0,1,2,3}
: コマンドの冗長性を設定します。オプションの値は、0 (最小出力)、1 (通常出力)、2 (詳細出力)、および 3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生したときに例外を発生させて、より詳細なエラー情報を提供します。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。 -
--skip-checks
: システムチェックをスキップします。システムチェックを無視して移行最適化操作を実行する場合は、このオプションを使用します。
django-admin optimizemigration
コマンドは通常、指定された移行のためのデータベース操作を分析し、最適化するために使用されます。これは、データベース操作の複雑さを軽減したり、パフォーマンスを向上させるために移行操作を最適化できるかどうかを理解するのに役立ちます。移行に最適化が必要である可能性があると思われる場合は、このコマンドを使用して検査および分析できます。
4.15 runserver コマンド
django-admin runserver
このコマンドは、軽量の開発 Web サーバーを起動するために使用されます。その構文形式は次のとおりです。
django-admin runserver [-h] [--ipv6] [--nothreading] [--noreload] [--version] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--no-color] [--force-color] [--skip-checks]
[addrport]
で:
位置引数:
addrport
: オプションのポート番号、または IP アドレスとポート番号の組み合わせ (形式は ipaddr:port)。
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--ipv6
,-6
: Django に IPv6 アドレスを使用するように指示します。デフォルトでは、IPv4 アドレスが使用されます。 -
--nothreading
: Django にスレッドを使用しないように指示します。デフォルトでは、Django はスレッドを使用してリクエストを処理します。これは、複数のリクエストの並列処理に役立ちます。 -
--noreload
: Django に自動リローダーを使用しないように指示します。デフォルトでは、Django はコードが変更されると自動的にサーバーをリロードするため、開発者は最新の変更を確認できます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。 -
--skip-checks
: システムチェックをスキップします。システムチェックを無視してサーバーをただちに起動したい場合は、このオプションを使用します。
django-admin runserver
このコマンドは通常、開発中に開発 Web サーバーを起動するために使用されます。--ipv6
オプションのポート番号を指定してサーバーがリッスンするポートを指定することも、このオプションを使用してサーバーに IPv6 アドレスを使用するように指示することもできます。デフォルトでは、サーバーはスレッドを使用してリクエストを処理し、コードが変更されたときにサーバーを更新するために自動再ロードが有効になっています。
4.16 sendtestemail コマンド
django-admin sendtestemail
コマンドは、指定された電子メール アドレスにテスト電子メールを送信するために使用されます。その構文形式は次のとおりです。
django-admin sendtestemail [-h] [--managers] [--admins] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color]
[--skip-checks]
[email ...]
で:
位置引数:
email
: テスト電子メールの送信に使用する 1 つ以上の電子メール アドレス。
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--managers
settings.MANAGERS
:で指定した電子メール アドレスにテスト電子メールを送信します。settings.MANAGERS
Django プロジェクトで管理アラートとエラー通知を受信するために使用される電子メール アドレスのリストです。 -
--admins
settings.ADMINS
:で指定した電子メール アドレスにテスト電子メールを送信します。settings.ADMINS
また、Django プロジェクトで管理アラートやエラー通知を受信するために使用される電子メール アドレスのリストも含まれます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。 -
--skip-checks
: システムチェックをスキップします。システムチェックを無視してテスト電子メールをすぐに送信したい場合は、このオプションを使用します。
django-admin sendtestemail
このコマンドは通常、開発中にプロジェクトの電子メール設定が適切に機能していることをテストし、管理者やマネージャーなどの主要担当者がアラートおよびエラー通知電子メールを受信していることを確認するために使用されます。電子メール アドレスをパラメータとして指定することも、--managers
および--admins
オプションを使用して、事前定義された電子メール アドレスにテスト電子メールを送信することもできます。
4.17 シェルコマンド
django-admin shell
このコマンドにより Python 対話型インタープリターが起動され、Django プロジェクトと対話できるようになります。その構文形式は次のとおりです。
django-admin shell [-h] [--no-startup] [-i {
ipython,bpython,python}] [-c COMMAND] [--version] [-v {
0,1,2,3}]
[--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback] [--no-color]
[--force-color]
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--no-startup
注:純粋な Python 対話型インタープリターを使用する場合は、PYTHONSTARTUP
環境変数と~/.pythonrc.py
スクリプトの設定を無視してください。これは、これらの起動スクリプトが実行されないことを意味します。 -
-i {ipython,bpython,python}
,--interface {ipython,bpython,python}
: インタラクティブなインタープリタ インターフェイスを指定します。使用可能なオプションには、「ipython」、「bpython」、および「python」が含まれます。Django は、利用可能な場合はこれらのツールのいずれかを使用して、より豊かな対話型エクスペリエンスを提供しようとします。 -
-c COMMAND
,--command COMMAND
: 対話型シェルを開く代わりに、Django としてコマンドを実行し、実行後に終了できます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
django-admin shell
コマンドは通常、開発プロセス中に Django プロジェクトのコード スニペットやデータベース クエリなどをテストするため、また対話型のデバッグや実験のために使用されます。さまざまなインターフェイス (IPython や bpython など) を使用して対話性を高めることができます。
4.18 showmigrations コマンド
django-admin showmigrations
このコマンドは、現在のプロジェクトで利用可能なすべての移行に関する情報を表示します。その構文形式は次のとおりです。
django-admin showmigrations [-h] [--database DATABASE] [--list | --plan] [--version] [-v {
0,1,2,3}]
[--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback] [--no-color]
[--force-color] [--skip-checks]
[app_label ...]
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--database DATABASE
: 移行情報を表示するデータベースを指定します。デフォルトは「デフォルト」データベースです。 -
--list
,-l
: すべての移行のリストと、それらが適用されているかどうかを表示します。詳細レベル 2 以上が設定されている場合は、移行が適用された日時の情報も含まれます。 -
--plan
,-p
: すべての移行を適用される順序で表示します。詳細レベル 2 以上が設定されている場合、すべての直接移行の依存関係と逆の依存関係 (run_before
) も含まれます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
django-admin showmigrations
このコマンドは、プロジェクト内の移行情報を表示し、どの移行がデータベースに適用されているかを理解するのに役立ちます。これは移行の管理に役立ち、データベースがアプリケーションのモデル定義と同期していることを確認します。
4.19 sqlflushコマンド
django-admin sqlflush
コマンドは、データベース内のすべてのテーブルを元のインストール後の状態に復元する SQL ステートメントを生成するために使用されます。その構文形式は次のとおりです。
django-admin sqlflush [-h] [--database DATABASE] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color] [--skip-checks]
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--database DATABASE
: SQL ステートメントを生成するデータベースを指定します。デフォルトは「デフォルト」データベースです。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
django-admin sqlflush
このコマンドは通常、テストやその他のニーズのために、データベースのすべてのテーブルを初期のインストール後の状態にリセットする一連の SQL ステートメントを生成するために使用されます。これらの SQL ステートメントをデータベース内で実行すると、すべてのデータが削除され、テーブルの構造が元の状態に戻されます。
4.20 sqlmergeコマンド
django-admin sqlmigrate
このコマンドは、指定された移行の SQL ステートメントを生成し、移行がデータベース構造にどのような影響を与えるかを確認するために使用されます。その構文形式は次のとおりです。
django-admin sqlmigrate [-h] [--database DATABASE] [--backwards] [--version] [-v {
0,1,2,3}]
[--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback] [--no-color]
[--force-color] [--skip-checks]
app_label migration_name
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--database DATABASE
: SQL ステートメントを生成するデータベースを指定します。デフォルトは「デフォルト」データベースです。 -
--backwards
:移行を適用するのではなく、適用を解除する SQL を作成します。このオプションを指定すると、データベースを現在の状態から移行前の状態に復元するための SQL ステートメントが生成されます。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
django-admin sqlmigrate
このコマンドは通常、移行を指定する SQL ステートメントをチェックして、移行がデータベースに正しく適用されるか非適用されるかを確認するために使用されます。生成された SQL ステートメントは、開発およびメンテナンス中のデバッグや分析のために必要に応じて表示できます。
4.21 sqlsequenceresetコマンド
django-admin sqlsequencereset
コマンドは、特定のアプリケーションのデータベース シーケンスをリセットする SQL ステートメントを生成するために使用されます。その構文形式は次のとおりです。
django-admin sqlsequencereset [-h] [--database DATABASE] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color]
[--skip-checks]
app_label [app_label ...]
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--database DATABASE
: SQL ステートメントを生成するデータベースを指定します。デフォルトは「デフォルト」データベースです。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
位置引数:
app_label
: 1 つ以上のアプリケーション ラベル (App Label)。これらのアプリケーションでは、データベース内のシーケンスをリセットするために SQL ステートメントが生成されます。シーケンスは主キーなどの一意の識別子を生成するために使用されます。レコードを削除したり新しいレコードを挿入したりする場合、データベースは主キーの一意性を保証する必要があります。
django-admin sqlsequencereset
このコマンドは通常、シーケンスの正確性を確認するためにデータを手動で挿入する場合に使用されます。これは、データベース内で一意の識別子を正しく割り当て、主キーの競合を回避するのに役立ちます。
4.22 squashmigrations コマンド
django-admin squashmigrations
このコマンドは、一連の既存の移行 (最初の移行から指定された移行まで) を新しい移行にマージするために使用されます。その構文形式は次のとおりです。
django-admin squashmigrations [-h] [--no-optimize] [--noinput] [--squashed-name SQUASHED_NAME] [--no-header]
[--version] [-v {
0,1,2,3}] [--settings SETTINGS] [--pythonpath PYTHONPATH]
[--traceback] [--no-color] [--force-color] [--skip-checks]
app_label [start_migration_name] migration_name
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--no-optimize
: マージ操作を最適化する試みは行われません。 -
--noinput
,--no-input
: Django にユーザーに入力を求めないように指示します。 -
--squashed-name SQUASHED_NAME
: 新しいマージ移行の名前を設定します。デフォルトでは、アプリケーション名と移行されたコンテンツに基づいて名前が自動的に生成されます。 -
--no-header
: 新しいマージ移行にはヘッダー コメントを追加しないでください。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
位置引数:
-
app_label
: アプリケーションのラベル (App Label)。移行およびマージされるアプリケーションを示します。 -
start_migration_name
: この移行を含めて、この移行から開始するマージ。どの移行からマージを開始するかを示します。 -
migration_name
: この移行までをマージします。マージされる最後の移行を表します。
django-admin squashmigrations
コマンドは通常、複数の移行を結合して大規模な移行を行う場合に使用されます。これは、プロジェクトの移行履歴を簡素化し、データベース移行レコードの数を減らすのに役立ちます。
4.23 startappコマンド
django-admin startapp
このコマンドは、新しい Django アプリケーション (アプリ) を作成し、アプリケーションのディレクトリ構造とファイルを生成するために使用されます。その構文形式は次のとおりです。
django-admin startapp [-h] [--template TEMPLATE] [--extension EXTENSIONS] [--name FILES]
[--exclude [EXCLUDE]] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color]
name [directory]
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--template TEMPLATE
:アプリケーション テンプレートのロード元のパスまたは URL を指定します。 -
--extension EXTENSIONS
,-e EXTENSIONS
: レンダリングするファイル拡張子を指定します。デフォルトは「py」(Python ファイル)です。複数の拡張子をカンマで区切って指定したり、-e
オプションを複数回使用して複数の拡張子を追加したりできます。 -
--name FILES
,-n FILES
: レンダリングするファイルの名前を指定します。デフォルトはアプリケーションの名前です。複数のファイル名をカンマで区切って指定したり、-n
オプションを複数回使用して複数のファイル名を追加したりできます。 -
--exclude [EXCLUDE]
, :とディレクトリ-x [EXCLUDE]
を除く、除外するディレクトリ名を指定します。このオプションを複数回使用して、除外する複数のディレクトリを追加できます。.git
__pycache__
-x
-
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
位置引数:
-
name
: アプリケーションまたはプロジェクトの名前。名前を指定する必要があります。これが、作成するアプリケーションの名前になります。 -
directory
: アプリケーションが作成される場所を指定するオプションのターゲット ディレクトリ。ディレクトリが指定されていない場合、アプリケーションは現在のディレクトリに作成されます。
django-admin startapp
このコマンドは通常、新しい Django アプリケーションを起動するときに使用されます。これにより、モデル、ビュー、テンプレート、その他のアプリケーション コンポーネントを追加できるように、必要なファイルとディレクトリを含むスケルトン アプリケーションが作成されます。
4.24 startprojectコマンド
django-admin startproject
このコマンドは、新しい Django プロジェクト (プロジェクト) を作成し、プロジェクトのディレクトリ構造とファイルを生成するために使用されます。その構文形式は次のとおりです。
django-admin startproject [-h] [--template TEMPLATE] [--extension EXTENSIONS] [--name FILES]
[--exclude [EXCLUDE]] [--version] [-v {
0,1,2,3}] [--settings SETTINGS]
[--pythonpath PYTHONPATH] [--traceback] [--no-color] [--force-color]
name [directory]
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--template TEMPLATE
: プロジェクト テンプレートをロードするパスまたは URL を指定します。 -
--extension EXTENSIONS
,-e EXTENSIONS
: レンダリングするファイル拡張子を指定します。デフォルトは「py」(Python ファイル)です。複数の拡張子をカンマで区切って指定したり、-e
オプションを複数回使用して複数の拡張子を追加したりできます。 -
--name FILES
,-n FILES
: レンダリングするファイル名を指定します。デフォルトでは空です。複数のファイル名をカンマで区切って指定したり、-n
オプションを複数回使用して複数のファイル名を追加したりできます。 -
--exclude [EXCLUDE]
, :とディレクトリ-x [EXCLUDE]
を除く、除外するディレクトリ名を指定します。このオプションを複数回使用して、除外する複数のディレクトリを追加できます。.git
__pycache__
-x
-
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
位置引数:
-
name
: プロジェクトの名前。名前を指定する必要があります。これが、作成するプロジェクトの名前になります。 -
directory
: プロジェクトが作成される場所を指定するために使用されるオプションのターゲット ディレクトリ。ディレクトリが指定されていない場合、プロジェクトは現在のディレクトリに作成されます。
django-admin startproject
このコマンドは通常、新しい Django プロジェクトを開始するときに使用します。これにより、プロジェクトのディレクトリ構造と構成ファイルを含む初期プロジェクト スケルトンが作成され、プロジェクトの開発を開始できるようになります。
4.25 テストサーバーコマンド
django-admin testserver
このコマンドは、開発サーバー上で実行され、テストまたは開発の目的で指定されたデータ フィクスチャ (データ スナップショット) をロードするために使用されます。その構文形式は次のとおりです。
django-admin testserver [-h] [--noinput] [--addrport ADDRPORT] [--ipv6] [--version] [-v {
0,1,2,3}]
[--settings SETTINGS] [--pythonpath PYTHONPATH] [--traceback] [--no-color]
[--force-color]
[fixture ...]
で:
オプション:
-
-h
,--help
: ヘルプメッセージを表示して終了します。 -
--noinput
,--no-input
: ユーザーに何も入力を求めず、自動的に実行するように Django に指示します。 -
--addrport ADDRPORT
: サーバーが実行されているポート番号、または IP アドレスとポート番号の組み合わせを指定します。たとえば、--addrport 8000
または--addrport 0.0.0.0:8000
。 -
--ipv6
,-6
: Django に IPv6 アドレスを使用するように指示します。 -
--version
: プログラムのバージョン番号を表示して終了します。 -
-v {0,1,2,3}
、--verbosity {0,1,2,3}
: コマンドの出力詳細レベルを設定します。0 (最小出力)、1 (通常出力)、2 (詳細出力)、3 (非常に詳細な出力) です。 -
--settings SETTINGS
:設定モジュールの Python パスを指定します (例: "myproject.settings.main")。このオプションが指定されていない場合は、DJANGO_SETTINGS_MODULE
環境変数で指定された設定モジュールが使用されます。 -
--pythonpath PYTHONPATH
: Python パスに追加するディレクトリ。これにより、コマンドがプロジェクトに関連するファイルを検索できるように、追加のディレクトリを指定できます。 -
--traceback
:CommandError
例外が発生した場合に例外をスローします。 -
--no-color
: コマンド出力の色付けを無効にします。 -
--force-color
: コマンド出力の色付けを強制します。
位置引数:
fixture
: 開発サーバーにデータをロードするために使用される 1 つ以上のデータ フィクスチャ ファイルへのパス。これらのフィクスチャは、テスト環境または開発環境で使用するために事前に準備されたデータ スナップショットにすることができます。
django-admin testserver
このコマンドは通常、テストまたは開発中に開発サーバーを実行し、テストまたは開発で使用するためにテスト データをロードするために使用されます。これにより、開発者は、テストとデバッグの目的で、開発サーバー上で事前定義されたデータを使用して環境をシミュレートできます。
5. Django におけるアプリとプロジェクトの関係
この記事の前のセクションでは、Django プロジェクトの作成と、プロジェクトとアプリケーションを作成するための startproject コマンドと startapp コマンドについて紹介しました。
Dajngoでは、プロジェクトとアプリケーションは異なる概念です。プロジェクトには、プロジェクトの機能を一緒に構築する 1 つ以上のアプリを含めることができます。アプリケーションは、連携してプロジェクトの全体的な機能を構築するプロジェクトのコンポーネントです。アプリケーションは再利用可能であり、さまざまなプロジェクトで使用できます。これは、機能をモジュール化し、コードの保守性を向上させるのに役立ちます。
5.1 プロジェクト
このプロジェクトは Django プロジェクト全体です。プロジェクトには、1 つ以上のアプリケーションと、プロジェクト レベルの構成ファイルおよび設定ファイルを含めることができます。
プロジェクトには一連のアプリケーションが含まれており、プロジェクトのデータベース接続、URL マッピング、静的ファイル パス、テンプレート パスなどのプロジェクト レベルの設定を構成します。
通常、Django プロジェクトは、さまざまな機能を構築するための複数のアプリケーションを含む完全な Web アプリケーションを表します。
プロジェクトには、プロジェクト レベルの構成ファイル (settings.py など) を含むプロジェクト フォルダー (通常はプロジェクト名) があります。
5.2 アプリケーション(アプリ)
アプリケーションは Django プロジェクトのコンポーネントであり、Django アプリケーションのモジュール単位です。
アプリは、プロジェクトのさまざまな機能を整理および管理するためによく使用されます。各アプリケーションには、モデル、ビュー、テンプレート、URL マッピング、静的ファイルなどを含めることができます。
このアプリケーションは、コードをよりモジュール化し、保守しやすく、さまざまなプロジェクトで再利用できるように設計されています。アプリケーションは複数のプロジェクトで使用できます。
通常、アプリはユーザー認証、ブログ投稿、製品カタログなどの特定の機能領域を処理します。