はてなブックマーク

Django のインストール方法¶ このドキュメントを読めば、Django をセットアップして、起動することができます。 Python をインストールする¶ Django は Python のウェブフレームワークです。詳しくは どのバージョンの Python で Django が使えますか? を参照してください。 最新版のPythonを https://www.python.org/downloads/ もしくはOSのパッケージ管理ツールで取得してください。 Apache と mod_wsgi のインストール¶ もし単に Django を使って実験したいだけなら、このセクションは飛ばしてください。 Django には軽量 web サーバーが含まれており、テスト用にそれが使えます。本番環境にデプロイするときまで、 Apache をセットアップする必要はありません。 本番サイトで Django

モデルからフォームを作成する¶ ModelForm¶ class ModelForm[ソース]¶ データベース中心のアプリケーションを作成している場合、Django モデルに密接にマップするフォームを使うことになるでしょう。例えば、BlogComment モデルを持っていて、閲覧者がコメントを送信できるフォームを作成したくなったとしましょう。この場合、すでにモデル内にフィールドが定義されているので、フォーム内にフィールドタイプを改めて定義するのは冗長でしょう。 このためDjango には、Django モデルから Form クラスを生成できるようなヘルパークラスを用意してあります。 例えば次のようにします: >>> from django.forms import ModelForm >>> from myapp.models import Article # Create the for

Django を uWSGI とともに使うには？¶ uWSGI は高速かつ自己回復的、開発者やシステム管理者にとって使いやすいアプリケーションコンテナサーバーで、純粋な C 言語で記述されています。 参考 uWSGI のドキュメントは、Django、nginx および uWSGI をカバーした tutorial を提供しています (たくさんあるセットアップ方法の一例です)。以下のドキュメントは、Django を uWSGI と統合する方法に焦点を当てています。 前提条件: uWSGI¶ uWSGI の wiki には、いくつかの installation procedures が記載されています。Python のパッケージマネージャーであるpipを使って、あらゆるバージョンの uWSGI を一つのコマンドでインストールすることができます。たとえば: # Install current st

Migration Operations¶ Migration files are composed of one or more Operations, objects that declaratively record what the migration should do to your database. Django also uses these Operation objects to work out what your models looked like historically, and to calculate what changes you’ve made to your models since the last migration so it can automatically write your migrations; that’s why they’

Performing raw SQL queries¶ Django gives you two ways of performing raw SQL queries: you can use Manager.raw() to perform raw queries and return model instances, or you can avoid the model layer entirely and execute custom SQL directly. Explore the ORM before using raw SQL! The Django ORM provides many tools to express queries without writing raw SQL. For example: The QuerySet API is extensive. Yo

Djangoの認証システムを使用する¶ このドキュメントでは、デフォルト設定でのDjangoの認証システムの使用方法を説明します。この設定は、タスクの適切な範囲を管理することで、最も一般的なプロジェクトのニーズにかなうよう徐々に発展してきました。そして、パスワードや権限の入念な実装を持っています。デフォルトの認証システムからの変更が必要なプロジェクトのために、Djangoは認証システムの広範囲の 拡張とカスタマイズ をサポートします。 Djangoの認証は、認証 (authentication) 機能と認可 (authorization) 機能の両方を提供しています。そして、一般的に、これらの機能を合わせて認証システムと呼びます。 User オブジェクト¶ User オブジェクトは、認証システムの中核です。一般的に、このオブジェクトはあなたのサイトに関係する人々を表し、アクセスを制限するこ

クエリを作成する¶ 一度 データモデル を作成すれば、Django はデータオブジェクトの作成、取得、更新および削除を行えるようにデータベースを抽象化した API を自動的に提供します。本ドキュメントではこの API をどのように用いるかを説明します。多様なモデル探索オプション全てに関する詳細については データモデルの項目 を参照ください。 このガイド（およびリファレンス）全体を通して、以下のモデルを参照します。これらはブログアプリケーションを構成するものです。 from datetime import date from django.db import models class Blog(models.Model): name = models.CharField(max_length=100) tagline = models.TextField() def __str__(self

はじめての Django アプリ作成、その 7¶ このチュートリアルは チュートリアル その6 の続きです。ここでは、引き続き Web 投票アプリケーションの開発を続け、 チュートリアル その2 で少し触れた、Django が 自動生成する管理サイトのカスタマイズに焦点を当てます。 admin フォームのカスタマイズ¶ admin.site.register(Question) の呼び出しによって Question モデルを登録したことで、Django はデフォルトの形式でオブジェクトを表示できました。 admin フォームの表示方法や操作の仕方をデフォルトから変更したいこともよくあります。それには、オブジェクトを登録する時にオプションを指定します。 ためしに、編集フォームでのフィールドの並び順を並べ替えてみましょう。 admin.site.register(Question) の行を以下

コンテンツ Django ドキュメント目次 索引、用語集、表 移動 次へ: Django ドキュメント 目次 総合索引 Pythonモジュール索引 現在の場所: Django 5.1 ドキュメント Django ドキュメント目次 助けを求める FAQ FAQ では、よくある質問とそれに対する答えが読めます。 目次, モジュールの目次, or 目次 特定の情報を見つけたい場合に便利です。 Django Discord Server Join the Django Discord Community. Official Django Forum Join the community on the Django Forum. Ticket tracker Django または Django ドキュメントにバグを見つけた場合は、チケットトラッカーから報告してください。 ダウンロード: オフライン

Aggregation¶ The topic guide on Django’s database-abstraction API described the way that you can use Django queries that create, retrieve, update and delete individual objects. However, sometimes you will need to retrieve values that are derived by summarizing or aggregating a collection of objects. This topic guide describes the ways that aggregate values can be generated and returned using Djang

組み込みテンプレートタグとフィルタ¶ このドキュメントでは、 Django の組み込みテンプレートタグとフィルタについて述べます。 また 自動ドキュメンテーション を使えばインストールされている組み込みタグとカスタムタグのドキュメントを読めるのでお勧めです。 組み込みタグリファレンス¶ autoescape¶ 自動エスケープ機能を制御します。このタグは引数に on または off を取り、ブロック内の自動エスケープの有効・無効を決定します。ブロックの最後は endautoescape タグで閉じるようにします。 使用例： 自動エスケープがオンの場合、すべての変数由来の値を出力前に HTML エスケープします (他のフィルタはエスケープの前に適用されます)。この動作は、変数に escape フィルタを手動で適用した場合と同じです。 ただ一つの例外は、すでにエスケープに関して "safe" と

コンテンツ Django を使う 移動 前へ: Djangoにはじめて貢献する 次へ: Django のインストール方法 目次 総合索引 Pythonモジュール索引 現在の場所: Django 5.1 ドキュメント Django を使う 助けを求める FAQ FAQ では、よくある質問とそれに対する答えが読めます。 目次, モジュールの目次, or 目次 特定の情報を見つけたい場合に便利です。 Django Discord Server Join the Django Discord Community. Official Django Forum Join the community on the Django Forum. Ticket tracker Django または Django ドキュメントにバグを見つけた場合は、チケットトラッカーから報告してください。 ダウンロード: オフ

はじめての Django アプリ作成、その 3¶ このチュートリアルは チュートリアルその 2 の続きです。ここでは、引続き Web 投票アプリケーションの開発を例にして、公開用のインタフェース、ビュー(view) の作成を焦点に解説します。 概要¶ ビューとは、 Django のアプリケーションにおいて特定の機能を提供するウェブペー ジの「型 (type)」であり、各々のテンプレートを持っています。例えばブログアプリケーションなら、以下のようなビューがあるでしょう: Blog ホームページ - 最新エントリーをいくつか表示 エントリー詳細ページ - 1エントリーへのパーマリンク (permalink) ページ 年ごとのアーカイブページ - 指定された年のエントリーの月を全て表示 月ごとのアーカイブページ - 指定された月のエントリーの日をすべて表示 日ごとのアーカイブページ - 指定され

Django 2.0 release notes¶ December 2, 2017 Welcome to Django 2.0! These release notes cover the new features, as well as some backwards incompatible changes you’ll want to be aware of when upgrading from Django 1.11 or earlier. We’ve dropped some features that have reached the end of their deprecation cycle, and we’ve begun the deprecation process for some features. This release starts Django’s us

Password management in Django¶ Password management is something that should generally not be reinvented unnecessarily, and Django endeavors to provide a secure and flexible set of tools for managing user passwords. This document describes how Django stores passwords, how the storage hashing can be configured, and some utilities to work with hashed passwords. See also Even though users may use stro

高度なチュートリアル: 再利用可能アプリの書き方¶ この高度なチュートリアルは、チュートリアル その8 が終わったところから始まります。Web投票アプリケーションを、新しいプロジェクトで再利用でき、他の人に共有できる独立した Python のパッケージへと変えていきましょう。 最近、チュートリアル 1〜8 を完了したのではない場合は、以下に記載されている内容と一致するように、例題プロジェクトを見直すことをお勧めします。 再利用性の問題¶ Web アプリケーションの設計、開発、テスト、そしてメンテナンスには多大な労力が必要です。そして多くの Python プロジェクト、 Django プロジェクトは共通の問題を抱えています。この繰り返し作業を減らせたら良いと思いませんか？ 再利用可能性はPythonの生き様とも言えるものです。Python Package Index (PyPI) にはあなた

Django を Apache と mod_wsgi とともに使うには？¶ Apache と mod_wsgi と共にDjangoをデプロイすることは、Djangoを製品とする際に試され、テストされた方法です。 mod_wsgi は、Djangoを含む任意のPythonの WSGI アプリケーションをホストできるApacheのモジュールです。 Djangoはmod_wsgiをサポートしているApacheのすべてのバージョンで動作します。 mod_wsgi の使い方の詳細については、the official mod_wsgi documentation を参照してください。installation and configuration documentation から始めるとよいでしょう。 基本設定¶ mod_wsgiをインストールして有効にしたら、Apacheサーバーの httpd.conf

Please take a few minutes to complete the 2024 Django Developers Survey. Your feedback will help guide future efforts. QuerySet API リファレンス¶ このドキュメントでは、QuerySet API の詳細を説明しています。モデル と データベースクエリ ガイドにある説明を前提としていますので、このドキュメントを読む前にこの 2 つを読んでおいた方がよいでしょう。 このリファレンスでは、 データベースクエリガイド で提供された Blogモデルの例 を使用します。 QuerySet が評価されるタイミング¶ 内部的には、 QuerySet は実際にデータベースにアクセスすることなく、構築、フィルタリング、スライス、受け渡しを行うことができます。クエリセットを評価する

データベース¶ Django は次のデータベースを公式にサポートしています。 PostgreSQL MariaDB MySQL Oracle SQLite サードパーティから提供されているデータベースバックエンド も多数あります。 Django はすべてのデータベースで可能な限り多くの機能をサポートするように努めています。しかし、すべてのデータベースバックエンドが似ているわけではないため、どの機能をサポートし、どのような前提なら安全に想定できるのかについて、設計上の決断を下す必要がありました。 このファイルは Django の利用に関係する可能性のある一部の機能を説明しています。サーバー固有のドキュメントやリファレンスマニュアルを置換することを意図したものではありません。 一般的なメモ¶ 持続的 (persistent) な接続¶ 持続的な接続は HTTP リクエストごとにデータベースへの

はじめての Django アプリ作成、その 2¶ このチュートリアルは チュートリアルその 1 の続きです。ここでは、データベースをセットアップして、最初のモデルを作成し、そして Django が自動的に生成してくれる管理サイトについて、簡単なイントロダクションをします。 Database の設定¶ それでは、 mysite/settings.py を開いてください。これは、 Django の設定を表現するモジュールレベルの変数を持つ通常の Python モジュールです。 デフォルトでは、DATABASES の設定はSQLiteを使用します。もしデータベースに不慣れであったり、Djangoを試してみたいだけの場合、これが最も簡単な選択です。SQLiteはPythonに含まれているため、データベースをサポートするために追加でインストールする必要はありません。ただし、最初の本格的なプロジェクト

複数のデータベース¶ ここでは、Djangoがサポートする複数データベースの扱いについて説明します。残りのDjangoのドキュメントの大部分は、あなたが一つのデータベース扱うことを前提としています。複数のデータベースを使いたいなら、いくつかの追加ステップを踏む必要があります。 データベースを定義する¶ Django でデータベースを使う最初のステップは、利用するデータベースサーバーを Django に教えることです。これは、DATABASES の設定で行います。この設定は、データベースへのエイリアスです。Django を通してデータベースを参照するためのデータベースエイリアスを、辞書にマッピングします。この辞書の設定の詳細は、DATABASES ドキュメントで説明しています。 データベースには、選択した任意のエイリアスを付けることができます。しかし、エイリアス default は特別な意味

はじめての Django アプリ作成、その 1¶ さあ、例を交えながら学んでゆきましょう。 このチュートリアルでは、簡単な投票 (poll) アプリケーションの作成に取り組ん でもらいます。 Poll アプリケーションは 2 つの部分からなります: ユーザが投票したり結果を表示したりできる公開用サイト 投票項目の追加、変更、削除を行うための管理 (admin) サイト Django は既にインストール済み として説明を進めます。Django がインストールされているかどうか、またどのバージョンがインストールされているかを調べるには、以下のコマンドをシェルプロンプト（先頭の $ は入力待ちを示す記号です）で実行します。 Django がインストールされていれば、インストールされている Django のバージョンがわかります。もしなければ "No module named django" とエ

クロスサイトリクエストフォージェリ (CSRF) 対策¶ CSRF ミドルウェアとテンプレートタグは、簡単に扱える Cross Site Request Forgeries 対策を提供しています。このタイプの攻撃は、訪問者のログイン情報を悪用してあなたのサイトに何らかの操作を行うことを目的とした、リンクやフォームボタン、 JavaScript を設置した悪意のあるウェブサイトによって行われます。また、関連する攻撃として、ユーザーを騙して別のユーザー権限でログインさせる 'ログイン CSRF' と呼ばれる攻撃もありますが、これも対策に含まれます。 CSRF 攻撃に対する第一の防御は、 GET リクエスト (および RFC 9110 Section 9.2.1 で定義された ‘安全な’ メソッド) から副作用を取り除くというものです。そして、 POST、PUT、DELETE のような、’安全で

from django import forms class UploadFileForm(forms.Form): title = forms.CharField(max_length=50) file = forms.FileField() このフォームをハンドリングするビューは、ファイルのデータを request.FILES というディクショナリの中に受け取ります。このディクショナリには、キーと、それぞれのキーに対応するフォームの FileField (または ImageField または他の FileField のサブクラス) が格納されています。そのため、上のフォームから送信されたデータには、request.FILES['file'] でアクセスできます。 ただし、request.FILES にデータが格納されるのは、リクエストメソッドが POST で、少なくとも1つのファイルフ

モデルフィールドリファレンス¶ このドキュメントには、Django が提供するフィールドオプション field options とフィールド型 field types を含む、Field のすべての API リファレンスが記載されています。 参考 組み込みフィールドが目的に合わない場合は、 django-localflavor (ドキュメント) を試してみてください。これは、特定の国や文化に役立つさまざまなコードを含んでいます。 さらに、簡単に あなた自身の独自のモデルフィールドを作ることもできます。 注釈 フィールドは django.db.models.fields に定義されていますが、利便性のために django.db.models にインポートされています。標準的な慣例としては、from django.db import models を使用し、フィールドを models.<Foo

このドキュメントについて このドキュメントでは、Web フォームの基本と、それらを Django で扱う方法を紹介しています。より詳しく知りたいときは、フォーム API の特定の領域、 フォーム API 、 フォーム フィールド または フォームとフィールドのバリデーション をご覧ください。 あなたの作ろうとしているウェブサイトやアプリケーションが、単にコンテンツを公開したり訪問者からのインプットを受け付けないサイトでない限り、フォームを理解し利用する必要があります。 Django はフォームの構築を助けるさまざまなツールやライブラリを提供しています。これらを利用することで、サイト訪問者からデータの入力を受け入れ、そのデータを処理したあと、入力に応じたレスポンスを返すことができるようになります。 HTML フォーム¶ HTMLでは、フォームは <form>...</form> 内の要素の集