Flask 헬로 월드 튜토리얼

Flask를 시작하기 전에 시스템에 Python 3.7 이상 및 pip가 잘 설치되어 있는지 확인하십시오. 터미널에서 간단히 확인하면 됩니다:

python --version

Python 3.x.x와 같은 결과가 표시되지 않으면 python.org에서 설치를 진행하면 됩니다.

자, 무엇이든 설치하기 전에 가상 환경을 설정하는 것이 좋습니다. 프로젝트를 위한 깨끗하고 격리된 작업 공간이라고 생각하면 됩니다. 다른 프로젝트와 도구나 종속성이 섞이지 않도록 깔끔하게 관리할 수 있습니다. 이해되시죠?

먼저 프로젝트 디렉토리로 이동하여 새 가상 환경을 만듭니다:

python -m venv .venv

그런 다음 해당 환경을 활성화하십시오. 명령은 운영 체제에 따라 약간 다릅니다:

# macOS/Linux에서
source .venv/bin/activate

# Windows에서 (명령 프롬프트 사용, PowerShell은 ".\.venv\Scripts\Activate.ps1"을 선호할 수 있습니다)
.venv\Scripts\activate

터미널 프롬프트 시작 부분에 (.venv)가 표시되면 활성화된 것입니다. 이제 본론으로 넘어갑시다!

가상 환경이 작동되면 Flask를 설치할 차례입니다. 매우 간단합니다:

pip install Flask

이 명령은 PyPI에서 Flask와 필요한 모든 동반자를 가져와 격리된 가상 환경에 깔끔하게 배치합니다. 설치 메시지가 많이 표시된 후에는 실제 코딩을 할 준비가 된 것입니다.

이제 본론으로 들어가서 "Hello, World!" 애플리케이션 자체를 만들어 보겠습니다. 프로젝트 디렉토리에서 app.py라는 새 파일을 만들고 다음 코드를 붙여넣으십시오:

from flask import Flask

# Flask 애플리케이션 인스턴스 생성
app = Flask(__name__)

# 홈 페이지("/")에 대한 라우트 정의
@app.route('/')
def hello_world():
    # 홈 페이지에 액세스할 때 호출되는 함수
    return 'Hello, World!'

# 스크립트가 직접 실행될 때만 앱이 실행되도록 보장
if __name__ == '__main__':
    app.run(debug=True)
                                

이 간결한 스니펫은 첫 번째 Flask 앱의 핵심입니다. 많지는 않지만, 씨앗 하나처럼 전체 숲의 기능을 할 수 있는 잠재력을 가지고 있습니다.

이 코드를 조금 더 자세히 살펴볼까요? 각 줄은 중요한 역할을 합니다. 먼저:

from flask import Flask
app = Flask(__name__)

• from flask import Flask: 이 줄은 `flask` 라이브러리에서 `Flask` 클래스—가장 중요한 것—을 가져오는 진입점입니다.
• app = Flask(__name__): 여기서 `Flask` 클래스의 인스턴스를 생성하고 있습니다. `__name__` 인수는 Flask에게 템플릿이나 정적 파일과 같은 리소스를 어디에서 찾아야 할지 알려주며, 애플리케이션이 단일 파일 이상으로 확장될 때 특히 유용합니다. Flask의 프로젝트 GPS라고 생각하면 됩니다.

이 `app` 객체는 중앙 제어판이며, 애플리케이션을 구성하고, 라우트를 정의하는 등 많은 작업을 할 때 사용하게 됩니다.

다음으로, 사용자가 특정 URL에 방문했을 때 Flask가 무엇을 보여줄지 결정하는 방법을 살펴보겠습니다:

@app.route('/')
def hello_world():
    return 'Hello, World!'

• @app.route('/'): 이것은 Python의 데코레이터입니다. 이 데코레이터는 그 바로 아래에 있는 `hello_world` 함수가 애플리케이션의 루트 URL (`/`)로 이동하는 사람이 있을 때마다 실행되어야 함을 Flask에 알립니다. 이것을 올바른 목적지로 트래픽을 안내하는 표지판이라고 생각하면 됩니다.
• def hello_world():: 이것은 일반 Python 함수이지만, Flask에서는 "뷰 함수"라고 부릅니다. 이 함수는 단순히 문자열 'Hello, World!'를 반환합니다. 브라우저가 루트 URL을 요청하면 Flask는 이 함수를 호출하고 반환 값을 받아 응답으로 다시 보냅니다.

간단한 춤과 같습니다: 요청이 들어오면 Flask는 이를 라우트와 일치시키고, 해당 뷰 함수를 실행하고, 결과를 다시 보냅니다. 간단하고 우아하며, 모든 Flask 앱의 기초입니다.

좋습니다. 코드를 작성했고, 무대가 준비되었습니다. 이제 직접 실행해 볼 차례입니다! 가상 환경이 활성화된 상태에서 `app.py`와 같은 디렉토리로 돌아가 터미널에서 다음을 실행하십시오:

python app.py

Flask의 개발 서버가 시작되었음을 나타내는 다음과 유사한 출력이 표시될 것입니다:

 * Serving Flask app 'app'
 * Debug mode: on
 * Running on http://127.0.0.1:5000 (Press CTRL+C to quit)

이제 웹 브라우저를 열고 http://127.0.0.1:5000으로 이동하십시오. 간단하지만 심오한 메시지 "Hello, World!"가 표시될 것입니다.

`python app.py`도 작동하지만, Flask는 개발을 위한 더 강력한 명령줄 인터페이스(CLI)를 제공합니다. 코드에 `app.run()`을 추가할 필요 없이 자동 다시 로딩 및 디버거와 같은 편리한 기능을 제공합니다.

먼저 Flask에게 애플리케이션이 어디에 있는지 알려주기 위해 환경 변수를 설정해야 합니다. 그런 다음 `flask` 명령을 사용하여 실행합니다:

# macOS/Linux에서
export FLASK_APP=app.py
flask run

# Windows에서 (명령 프롬프트)
set FLASK_APP=app.py
flask run

# Windows에서 (PowerShell)
$env:FLASK_APP="app.py"
flask run

이전과 유사한 출력이 표시되며 애플리케이션은 동일한 주소에서 액세스할 수 있습니다. `flask run` 명령은 Flask로 개발할 때 종종 선호되는 방식이며, 마치 잘 닦인 자동차의 핸들처럼 더 많은 제어권을 제공합니다.

개발 중에는 변경 사항이 있을 때 애플리케이션이 자동으로 새로고침되고, 문제가 발생했을 때 유용한 오류 메시지를 제공하기를 원할 것입니다. 이때 디버그 모드가 유용합니다.

Flask CLI로 이를 활성화하려면 `flask run`을 실행하기 전에 다른 환경 변수를 설정하십시오:

# macOS/Linux에서
export FLASK_ENV=development
flask run

# Windows에서 (명령 프롬프트)
set FLASK_ENV=development
flask run

# Windows에서 (PowerShell)
$env:FLASK_ENV="development"
flask run

`FLASK_ENV=development` 변수는 디버거와 리로더를 활성화할 뿐만 아니라 다른 개발별 구성을 설정합니다. 마치 스위치를 켜서 앱을 더 이야기하고 자가 수정 모드로 전환하는 것과 같습니다. 아직 구축 중일 때는 매우 유용합니다.

잘하셨습니다! 첫 번째 Flask "Hello, World!" 애플리케이션을 성공적으로 구축하고 실행했습니다. 초기 설정을 탐색하고, 기본 웹 응답을 만들고, Flask의 편리한 CLI와 디버그 모드까지 맛보았습니다. 탄탄한 시작입니다.

이제 기본 사항을 익혔으니 HTML 템플릿을 렌더링하는 방법, 폼을 통해 사용자 입력을 처리하는 방법, 데이터베이스에 연결하는 방법, 또는 대규모 Flask 애플리케이션을 구조화하는 방법을 탐색해 볼 수 있습니다. Flask의 세계는 여기서부터 상당히 열려 있으며, 꿈꿀 수 있는 모든 디지털 장치를 구축할 수 있는 충분한 공간을 제공합니다.