Python 웹 애플리케이션: WSGI 기본

이 기사는 원래 MaNong.com – Xiao Hao에서 번역되었습니다. 재인쇄를 위해서는 기사 끝 부분의 재인쇄 요구 사항을 읽어보시기 바랍니다. 유료 기부 계획에 참여하신 것을 환영합니다!

Django, Flask, Bottle 및 기타 모든 Python 웹 프레임워크의 기본은 웹 서버 게이트웨이 인터페이스, 즉 줄여서 WSGI입니다. WSGI는 Python의 서블릿과 Java의 관계입니다. 이는 다양한 웹 서버와 애플리케이션 프레임워크가 공통 API를 기반으로 상호 작용할 수 있도록 하는 웹 서버의 공통 사양입니다. 그러나 대부분의 경우 Python 버전은 구현이 매우 간단합니다.

WSGI는 PEP 3333 프로토콜에 정의되어 있습니다. 이 기사를 읽은 후 더 자세히 알아보려면 먼저 소개 부분을 읽어 보시기 바랍니다.

이 기사에서는 애플리케이션 개발자의 관점에서 WSGI 지침을 소개하고 WSGI를 통해 직접 애플리케이션을 개발하는 방법을 보여줍니다(기다리실 수 있는 경우).

첫 번째 WSGI 애플리케이션

가장 기본적인 Python 웹 애플리케이션은 다음과 같습니다.

def app(environ, start_fn):
    start_fn('200 OK', [('Content-Type', 'text/plain')])
    return ["Hello World!\n"]

그렇습니다! 전체 파일. 이름을 app.py로 지정하고 WSGI 컴파일 가능한 서버에서 실행하면 200 응답 상태 코드와 함께 Hello World를 받게 됩니다. 이를 수행하려면 gunicorn을 사용하고 pip(pip install gunicorn)를 통해 gunicorn app:app을 설치하고 실행할 수 있습니다. 이 명령은 gunicorn에게 애플리케이션 모듈의 애플리케이션 변수에서 호출 가능한 WSGI를 가져오도록 지시합니다.

지금 정말 신났어요. 단 세 줄의 코드로 애플리케이션을 실행할 수 있습니까? 그것은 어떤 의미에서 로그인임에 틀림없습니다(mod_php가 작동 중이므로 PHP는 제외). 나는 당신이 지금 그것에 대해 더 알고 싶어할 것이라고 확신합니다.

그렇다면 WSGI 애플리케이션에서 가장 중요한 부분은 무엇일까요?

• WSGI 애플리케이션은 __call__ 메소드가 있는 함수, 클래스 또는 클래스 인스턴스와 같은 Python 호출 가능 애플리케이션입니다.

• 호출 가능 애플리케이션 필수 데이터가 포함된 Python 사전인 environ과 자체 호출 가능한 start_fn이라는 두 가지 인수를 허용해야 합니다.

• 애플리케이션은 두 개의 매개변수, 즉 상태 코드(문자열)와 두 튜플의 헤더로 표시되는 목록을 사용하여 start_fn을 호출할 수 있어야 합니다.

• 애플리케이션은 반환 본문, 즉 스트리밍 부분에 바이트가 포함된 편리한 반복 가능 객체를 반환합니다. 예를 들어 각각은 "Hello, World!" 문자열 목록만 포함합니다. (app이 클래스인 경우 __iter__ 메서드로 수행할 수 있습니다)

예를 들어 다음 두 예는 첫 번째 예와 동일합니다.

class app(object):

    def __init__(self, environ, start_fn):
        self.environ = environ
        self.start_fn = start_fn

    def __iter__(self):
        self.start_fn('200 OK', [('Content-Type', 'text/plain')])
        yield "Hello World!\n"

rrree

이러한 것들을 무엇에 사용할 수 있는지 생각하기 시작했을 수도 있지만 가장 관련성이 높은 것은 미들웨어를 작성하는 것입니다.

활성화

미들웨어는 WSGI 애플리케이션의 기능을 확장하는 편리한 방법입니다. 호출 가능한 객체만 제공하면 되므로 이를 다른 함수에 래핑할 수 있습니다.

예를 들어 environ의 콘텐츠를 감지한다고 가정해 보겠습니다. 이를 달성하기 위해 다음과 같이 미들웨어를 쉽게 만들 수 있습니다.

class Application(object):
    def __call__(self, environ, start_fn):
        start_fn('200 OK', [('Content-Type', 'text/plain')])
        yield "Hello World!\n"

app = Application()

여기서 log_environ은 environ 매개변수에서 원본을 지연시키는 함수를 반환하는 함수입니다. 콜백 전의 이 매개변수입니다.

이런 방식으로 미들웨어를 작성하면 미들웨어와 프로세서가 서로 알 필요도 신경 쓸 필요도 없다는 장점이 있습니다. 예를 들어 Flask 애플리케이션은 WSGI 애플리케이션이기 때문에 log_environ을 Flask 애플리케이션에 쉽게 바인딩할 수 있습니다.

다른 유용한 미들웨어 디자인:

import pprint

def handler(environ, start_fn):
    start_fn('200 OK', [('Content-Type', 'text/plain')])
    return ["Hello World!\n"]

def log_environ(handler):
    def _inner(environ, start_fn):
        pprint.pprint(environ)
        return handler(environ, start_fn)
    return _inner

app = log_environ(handler)

파일이 큰 피라미드 기반을 가지지 않으려면 reduce를 사용하여 여러 미들웨어에 적용할 수 있습니다. .

import pprint

def handle_error(handler):
    def _inner(environ, start_fn):
        try:
            return handler(environ, start_fn)
        except Exception as e:
            print e  # Log error
            start_fn('500 Server Error', [('Content-Type', 'text/plain')])
            return ['500 Server Error']
    return _inner

def wrap_query_params(handler):
    def _inner(environ, start_fn):
        qs = environ.get('QUERY_STRING')
        environ['QUERY_PARAMS'] = urlparse.parse_qs(qs)
        return handler(environ, start_fn)
    return _inner

start_fn 매개변수의 장점을 활용하면 응답 본문을 장식하는 미들웨어도 작성할 수 있습니다. 아래는 출력 결과를 반전시키기 위해 콘텐츠 유형 헤더가 text/plain인 미들웨어입니다.

# Applied from bottom to top on the way in, then top to bottom on the way out
MIDDLEWARES = [wrap_query_params,
               log_environ,
               handle_error]

app = reduce(lambda h, m: m(h), MIDDLEWARES, handler)

start_fn과 응답 본문이 분리되어 있어 약간 혼란스럽기는 하지만 여전히 완벽하게 작동합니다.

또한 WSGI 사양을 엄격하게 준수하려면 응답 본문에서 close 메서드를 확인하고 존재하는 경우 호출해야 합니다. WSGI 애플리케이션이 핸들러를 호출하는 반복 가능한 객체 대신 write 함수를 반환할 수 있으며, 미들웨어가 이전 애플리케이션을 지원하도록 하려면 이를 처리해야 할 수도 있습니다.

기본 WSGI를 조금만 사용해 보면 Python에 왜 많은 웹 프레임워크가 있는지 이해하기 시작합니다. WSGI를 사용하면 처음부터 무언가를 구축하는 것이 매우 쉽습니다. 예를 들어, 다음과 같은 라우팅 문제를 고려할 수 있습니다.

def reverser(handler):

    # A reverse function
    rev = lambda it: it[::-1]

    def _inner(environ, start_fn):
        do_reverse = []  # Must be a reference type such as a list

        # Override start_fn to check the content type and set a flag
        def start_reverser(status, headers):
            for name, value in headers:
                if (name.lower() == 'content-type'
                        and value.lower() == 'text/plain'):
                    do_reverse.append(True)
                    break

            # Remember to call `start_fn`
            start_fn(status, headers)

        response = handler(environ, start_reverser)

        try:
            if do_reverse:
                return list(rev(map(rev, response)))

            return response
        finally:
            if hasattr(response, 'close'):
                response.close()
    return _inner

다음 리소스 수집의 유연성이 마음에 들면 WSGI를 직접 사용하여 휠을 만드는 것이 매우 편리합니다.

• 템플릿 라이브러리: 원하는 템플릿(예: Jinja2, Pystashe)을 넣고 프로세서에서 렌더링된 템플릿을 반환하세요!

• Routes 또는 Werkzeug의 라우팅과 같은 라우팅 관련 도움을 받으려면 라이브러리를 사용하세요. 실제로 WSGI를 쉽게 사용하고 싶다면 Werkzeug를 살펴보세요.

• Flask 또는 유사한 데이터베이스 마이그레이션 라이브러리를 사용하세요.

물론, 비전문적인 애플리케이션의 경우 프레임워크를 사용하면 이와 같은 일부 특수한 예도 합리적으로 해결할 수 있습니다.

서버는요?

WSGI 애플리케이션을 제공하는 방법에는 여러 가지가 있습니다. 우리는 꽤 좋은 선택인 Gunicorn에 대해 이미 논의했습니다. uWSGI는 또 다른 좋은 선택입니다. 하지만 이러한 정적 항목을 제공하기 전에 nginx와 같은 항목을 설정해야 하며 고정된 시작 노드가 있어야 합니다.

위 내용은 Python 웹 애플리케이션: WSGI 기본의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!