はてなブックマーク

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

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

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): retu

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

Serializing Django objects¶ Django’s serialization framework provides a mechanism for “translating” Django models into other formats. Usually these other formats will be text-based and used for sending Django data over a wire, but it’s possible for a serializer to handle any format (text-based or not). See also If you just want to get some data from your tables into a serialized form, you could us

コンテンツ Django ドキュメント目次 索引、用語集、表 移動 次へ: Django ドキュメント 目次 総合索引 Pythonモジュール索引 現在の場所: Django 5.1 ドキュメント Django ドキュメント目次 助けを求める FAQ FAQ では、よくある質問とそれに対する答えが読めます。 目次, モジュールの目次, or 目次 特定の情報を見つけたい場合に便利です。 django-users mailing list django-users メーリングリストのアーカイブから情報を検索したり、新しい質問を投稿できます。 #django IRC channel #django IRC チャンネルで質問したり、過去になされた回答を読むために IRC ログを検索できます。 Django Discord Server Join the Django Discord Commun

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

Writing your first Django app, part 1¶ Let’s learn by example. Throughout this tutorial, we’ll walk you through the creation of a basic poll application. It’ll consist of two parts: A public site that lets people view polls and vote in them. An admin site that lets you add, change, and delete polls. We’ll assume you have Django installed already. You can tell Django is installed and which version

autoescape¶ 自動エスケープ機能を制御します。このタグは引数に on または off を取り、ブロック内の自動エスケープの有効・無効を決定します。ブロックの最後は endautoescape タグで閉じるようにします。 使用例： 自動エスケープがオンの場合、すべての変数由来の値を出力前に HTML エスケープします (他のフィルタはエスケープの前に適用されます)。この動作は、変数に escape フィルタを手動で適用した場合と同じです。 ただ一つの例外は、すでにエスケープに関して "safe" としてマークされている変数です。変数は、その変数に値を代入するコードによって safe フィルタや escape フィルタを適用されることで、 "safe" とマークされる可能性があります。 自動エスケープが無効であるスコープ内では、 escape を含むフィルタを連結すると、以下のような

コンテンツ Django を使う 移動 前へ: Writing your first contribution for Django 次へ: Django のインストール方法 目次 総合索引 Pythonモジュール索引 現在の場所: Django 5.1 ドキュメント Django を使う 助けを求める FAQ FAQ では、よくある質問とそれに対する答えが読めます。 目次, モジュールの目次, or 目次 特定の情報を見つけたい場合に便利です。 django-users mailing list django-users メーリングリストのアーカイブから情報を検索したり、新しい質問を投稿できます。 #django IRC channel #django IRC チャンネルで質問したり、過去になされた回答を読むために IRC ログを検索できます。 Django Discord Server

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

コンテンツ さぁ始めましょう 移動 前へ: Django ドキュメント 次へ: Django の概要 目次 総合索引 Pythonモジュール索引 現在の場所: Django 5.1 ドキュメント さぁ始めましょう 助けを求める FAQ FAQ では、よくある質問とそれに対する答えが読めます。 目次, モジュールの目次, or 目次 特定の情報を見つけたい場合に便利です。 django-users mailing list django-users メーリングリストのアーカイブから情報を検索したり、新しい質問を投稿できます。 #django IRC channel #django IRC チャンネルで質問したり、過去になされた回答を読むために IRC ログを検索できます。 Django Discord Server Join the Django Discord Community. Off

高度なチュートリアル: 再利用可能アプリの書き方¶ この高度なチュートリアルは、チュートリアル その8 が終わったところから始まります。Web投票アプリケーションを、新しいプロジェクトで再利用でき、他の人に共有できる独立した Python のパッケージへと変えていきましょう。 直近のチュートリアル 1 - 7 が終わっていないなら、一目通すことをおすすめします。例で作ったプロジェクトが以下の説明でも使われるからです。 再利用性の問題¶ 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

QuerySet API リファレンス¶ このドキュメントでは、QuerySet API の詳細を説明しています。モデル と データベースクエリ ガイドにある説明を前提としていますので、このドキュメントを読む前にこの 2 つを読んでおいた方がよいでしょう。 このリファレンスでは、 データベースクエリガイド で提供された Blogモデルの例 を使用します。 QuerySet が評価されるタイミング¶ 内部的には、 QuerySet は実際にデータベースにアクセスすることなく、構築、フィルタリング、スライス、受け渡しを行うことができます。クエリセットを評価するための操作が行われない限り、実際のデータベースへのアクセスは発生しません。 あなたは次のような方法で QuerySet を評価することができます: イテレーション。 QuerySet はイテラブルで、初めてイテレートした時にデータベースの

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

はじめての Django アプリ作成、その 2¶ このチュートリアルは チュートリアルその 1 の続きです。ここでは、データベースをセットアップして、最初のモデルを作成し、そして Django が自動的に生成してくれる管理サイトについて、簡単なイントロダクションをします。 Database の設定¶ それでは、 mysite/settings.py を開いてください。これは、 Django の設定を表現するモジュールレベルの変数を持つ通常の Python モジュールです。 By default, the DATABASES configuration uses SQLite. If you're new to databases, or you're just interested in trying Django, this is the easiest choice. SQLite i

複数のデータベース¶ ここでは、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 のような、’安全で

モデルフィールドリファレンス¶ このドキュメントには、Django が提供する field options と field types を含む、Field の全ての API リファレンスが記載されています。 参考 If the built-in fields don't do the trick, you can try django-localflavor (documentation), which contains assorted pieces of code that are useful for particular countries and cultures. さらに、簡単に あなた自身の独自のモデルフィールドを作ることもできます。 注釈 Fields are defined in django.db.models.fields, but for convenience t