簡短說明

什麼是 Channels?

Channels extends Django to add a new layer that allows two important features:

  • WebSocket handling, in a way very similar to normal views

  • 背景測試，像其它的Django一樣在相同伺服器執行

這也允許其它物件，但你要從這些物件開始

How?

這將Django分成2種運行類型:

  • 一個處理HTTP 和 WebSockets

  • One that runs views, websocket handlers and background tasks (consumers)

They communicate via a protocol called ASGI, which is similar to WSGI but runs over a network and allows for more protocol types.

Channels does not introduce asyncio, gevent, or any other async code to your Django code; all of your business logic runs synchronously in a worker process or thread.

我必須改變我使用Django的方法？

No, all the new stuff is entirely optional. If you want it, however, you’ll change from running Django under a WSGI server, to running:

  • An ASGI server, probably Daphne
  • Django worker servers, using manage.py runworker
  • Something to route ASGI requests over, like Redis.

Even when you’re running on Channels, it routes all HTTP requests to the Django view system by default, so it works like before.

Channels還給會給我什麼？

其他特徵包括：

  • Easy HTTP long-poll support for thousands of clients at once
  • Full session and auth support for WebSockets

  • 自動用戶登入主要應用於WebSockets的網站cookies

  • Built-in primitives for mass triggering of events (chat, live blogs, etc.)
  • Zero-downtime deployment with browsers paused while new workers spin up
  • Optional low-level HTTP control on a per-URL basis
  • Extendability to other protocols or event sources (e.g. WebRTC, raw UDP, SMS)

這可以縮放嗎？

Yes, you can run any number of protocol servers (ones that serve HTTP and WebSockets) and worker servers (ones that run your Django code) to fit your use case.

The ASGI spec allows a number of different channel layers to be plugged in between these two components, with different performance characteristics, and it’s designed to allow both easy sharding as well as the ability to run separate clusters with their own protocol and worker servers.

為什麼它不使用我的喜好排序訊息？

Channels is deliberately designed to prefer low latency (goal is a few milliseconds) and high throughput over guaranteed delivery, which doesn’t match some message queue designs.

Some features, like guaranteed ordering of messages, are opt-in as they incur a performance hit, but make it more message queue like.

Do I need to worry about making all my code async-friendly?

No, all your code runs synchronously without any sockets or event loops to block. You can use async code within a Django view or channel consumer if you like - for example, to fetch lots of URLs in parallel - but it doesn’t affect the overall deployed site.

What version of Django does it work with?

You can install Channels as a library for Django >= 1.8. It has a few extra dependencies, but these will all be installed if you use pip.

Official project

Channels is not in the Django core as initially planned, but it’s an official Django project since September 2016. More information about Channels being adopted as an official project are available on the Django blog.