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

このコマンドは、Flaskとその必要なコンパニオンをPyPIから取得し、分離された仮想環境内にきれいに配置します。多くのインストールメッセージが表示された後、実際のコーディングの準備が整います。

いよいよ本番：最初の「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)

ここで、Webブラウザを開き、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!」アプリケーションを構築し、実行することに成功しました。初期セットアップをナビゲートし、基本的なWebレスポンスを作成し、Flaskの便利なCLIとデバッグモードにも触れました。これはしっかりとしたスタートです。

基本的なことがわかったので、HTMLテンプレートのレンダリング方法、フォームでのユーザー入力の処理方法、データベースへの接続方法、またはより大きなFlaskアプリケーションの構造化方法などを探求してみると良いでしょう。Flaskの世界はここから非常にオープンエンドであり、あなたが夢描くどんなデジタル仕掛けでも構築できる十分な余地があります。