シェア:
){kind=small}
マックスはPythonデベロッパー・アドボケイトであり、通信API、機械学習、デベロッパー・エクスペリエンス、ダンスに興味を持つソフトウェア・エンジニアだ！物理学を専攻していたが、現在はオープンソースのプロジェクトに携わり、開発者の生活をより良くするためのものを作っている。
Python 環境変数 (Env Vars)：入門
所要時間：11 分
この記事は2025年8月10日に更新されました。
Python開発者は、APIキーやAPIシークレット、データベース名など、誰にも見られたくないデータを扱うことが多い。
プログラマーがこれらの秘密を保存する方法の1つが環境変数です。この記事では、Pythonで環境変数を使うために必要なことをすべて学びます。Pythonの環境変数の設定方法、取得方法、そしてすべての秘密を安全に保つためのさまざまな方法を紹介します。最後に、Vonage での実際の使用例を紹介します。
読むより見る方が好きですか？このチュートリアルのビデオ版をご覧ください：
環境変数（しばしば "env vars "と呼ばれる）とは、プログラムの外部に保存する変数のことで、プログラムの実行に影響を与えることができる。例えば、APIのキーとシークレットを含む環境変数を設定することができる。あなたのプログラムは、APIに接続する際にこれらの変数を使用するかもしれない。
ソースコードではなく環境に秘密を保存することには、いくつかの利点がある：
セキュリティ:環境変数は、APIキーやパスワードのような機密データを保護するのに役立つ。例えば、あなたのソースコードをダウンロードした人に、あなたが使っているAPIキーにアクセスされたくないかもしれません。
構成管理:環境変数を使えば、コンフィギュレーション設定を簡単に保存・管理できる。
携帯性:コードを変更することなく、アプリケーションを異なる環境に適応させることができる。例えば、コードが異なるオペレーティング・システムで異なる動作をする場合、環境変数を使ってこれを管理することができます。
テストとデバッグ:開発者は、コードを変更する代わりに環境変数を調整することで、テストとデバッグを簡素化できる。
要するに、環境変数によって、プログラムそのものを変更することなく、プログラムの動作を変更することができる。
オペレーティング・システムに環境変数を格納することもできるが、これから取り上げる他の方法の方が、実際のシナリオでは一般的だ。 PythonでRCSイメージメッセージを送信する場合.
作業を始める前に、以下のものが揃っていることを確認してください：
Pythonがマシンにインストールされている
Vonage APIアカウント
Vonageバーチャル番号
のようなテキストエディタ ビジュアルスタジオコード
To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.
Python で環境変数を取得したり設定したりするには、組み込みの 組み込みの osモジュール.
モジュールにアクセスするには osモジュールにアクセスするために、コマンドラインからPythonファイルを作ってみよう：
touch env-testing.py以下のコードをPythonファイルに保存し、このPythonプログラムを実行することで、プログラム内のすべての環境変数を表示することができます：
次に env-testing.pyファイルをテキストエディタで開き、以下のコードを追加する：
import os
os.environ
print(os.environ)Pythonインタプリタは、コマンドラインからこのコードを実行すると、オペレーティングシステムの環境変数をすべて出力するはずです：
python3 env-testing.pyPythonの辞書のように os.environで様々な環境変数にアクセスできます。Pythonで環境変数を取得する2つの方法を紹介します：
import os
os.environ['USER']
os.environ.get('USER')上のPythonコードの最後の2行は同じことをしている。 USERどちらもオペレーティングシステムから環境変数を取得します。しかし、最初の方法を使った場合、Pythonは変数が見つからないと例外を投げます。
グッドプラクティスは os.environ['MY_ENVIRONMENT_VARIABLE']を使うことです。 os.environ.get('MY_ENVIRONMENT_VARIABLE')を使うことです。
を使うこともできる。 os.getenv()の代わりとして os.environ.get().どちらも同じように動作し Noneを返しますが os.getenv()の方がより簡潔です。例えば
import os
api_key = os.getenv("MY_API_KEY")を選ぶか os.getenv()それとも os.environ.get()どちらを選ぶかは、好みと読みやすさによる。
Pythonで環境変数を設定するには、辞書と同じように、環境変数を os.environオブジェクトに追加します。ただし、文字列のみが許可されます。これらはインタープリタが実行されているシェルに直接渡されるからです。
os.environ['USER'] = 'New User'
環境変数を更新するには、まったく同じ方法で上書きすればよい：
os.environ['USER'] = 'Modified User'
環境変数を保存したい理由はさまざまで、保存する方法も異なります。ローカルマシンに設定するだけでよい場合もあれば、アプリケーションを本番環境で動作させる必要がある場合もあります！
以下では、Pythonの環境変数を保存する5つの方法を紹介します：
オペレーティング・システム・ストレージ
ファイルストレージ
クラウドストレージ
ユニバーサル・シークレット・マネージャー・ストレージ
CI/CDシステム・ストレージ
Pythonで環境変数を作りたくないとき、素早く設定したいときがある。幸運なことに、これはコマンドラインから実行できます。ここで紹介する例はUnixライクなシステム（Mac、Linuxなど）で動作します。 Windows環境変数のチュートリアル.
前の例では USERはオペレーティング・システムによって設定された環境変数で、誰があなたのコンピューターを使っているかを表しています。オペレーティング・システムはこの変数を自動的に作成しますが、自分で環境変数を作成することもできます。
コマンドラインを開き、次のように入力すれば、コマンドラインからすべての環境変数を見ることができる（Unix系システムで）：
このenvコマンドは、シェルで利用可能なすべての変数をリストアップする。
ここでは、export変数の構文を使ってコマンドラインに環境変数を作成する方法を説明する：
これは VONAGE_APIという変数を作成し、その値を your_api.このように変数の値を表示することができる：
上のコードを実行すると、出力として your_apiと出力される。
ターミナル／コマンドラインを使って新しい環境変数を作成すると、その環境変数はそのセッションにのみ存在します。ターミナルを閉じると、環境変数はもう存在しません。プログラミングをしていると、環境変数を持続させて、コードを実行するたびに使えるようにしたいことがよくあります。
環境変数を永続化する1つの方法は、envファイルを使うことだ。 .envという名前が付いていることが多い）です。これはキーと値のペアを保存するシンプルなテキストファイルです。
環境変数を保存するために .envファイルを使って環境変数を保存する方法を説明します。
まず、ターミナルを使用して、このチュートリアル用に新しいフォルダを作成し、その中に移動して、次のファイルを作成します。 .envファイルを作成します：
次の行を .envファイルに追加する：
これでPython仮想環境に入ったので、必要なパッケージをインストールできる。
では、このパッケージの dotenvモジュールを使うことができます。 .envファイルからPythonがアクセスできる環境に環境変数をロードします。 osモジュールでアクセスできるようになります。次のような内容のPythonファイルを作成します：
from dotenv import load_dotenv
import os
load_dotenv() # This line brings all environment variables from .env into os.environ
print(os.environ['VONAGE_API'])この load_dotenv関数は環境変数を .envファイルから os.environこの環境変数は、オペレーティング・システムによって設定された他の環境変数と同様に使用することができる。
本番用のソフトウェアを作成する場合、おそらく自分のコンピューターから実行することはないだろう。その代わりに、サーバー上でコードを実行することがほとんどでしょう。
つまり、プロダクションでコードを実行する場所の環境変数を設定したり取得したりする方法を知っておく必要があるということだ。
ここでは、クラウドプロバイダーのリストと、それらを使った環境変数の取り扱いに関する詳細情報を入手できる場所を紹介する：
GitHub Actions、CircleCI、Travis、JenkinsのようなクラウドベースのCI/CDシステムを使っている場合は、それらのシステムに環境変数を保存することもできる。
プロジェクトにGitHubを使用している場合、"Settings "タブに移動し、"Security "の下にある "Secrets and variables "設定でAPIキーなどを設定することで、環境変数をリポジトリの設定に保存することができます。
ここで、オプションをクリックして値を設定すると、新しいリポジトリシークレットを作成できます。これで、GitHub のアクションでシークレットを使えるようになります。
に関する情報はたくさんあります。 GitHub Actions で環境変数を設定するや サークルCI, Travisそして ジェンキンスその他のプロバイダーに関する情報も提供しています。
秘密を .envファイルに保存すると、環境変数が持続するが、いくつかの問題がある。
例えば、あなたが10人のチームにいたとする。全員が自分の秘密を .envファイルでそれぞれの秘密を管理している。その場合、10人全員が自分の .envファイルを更新しなければならない。
あるいは、HerokuからAWSに乗り換えることにしたらどうだろう？その場合、新しいプラットフォームでのシークレットの扱い方を学ばなければならず、余分な作業が必要になる。
このような問題を解決するために、プログラマーの中には を使うプログラマーもいる。.ユニバーサルシークレットマネージャーを使えば、あなたの秘密を一か所に保存することができ、チーム全員がアクセスできるようになる。
ユニバーサル・シークレット・マネージャーを使えば、シークレットはローカル・マシンにもクラウド・プロバイダーにも依存しないので、どこでコードを実行してもシークレットを持ち運ぶことができる。
外部APIのサンプル・プロジェクトやサンプル・コード・スニペットを使っている場合、それを使いやすくするためのツールが、オーナー／メンテナによって提供されていることがある。多くの場合、ツールを最適に設定するために環境変数を使用する必要があります。
Vonage では、Python コードサンプルで環境変数を使用しています。 PythonコードサンプルSMSの送信、電話の発信、認証コードの送信、詐欺スコアのチェック、その他もろもろ。
例えば VonageのNumber Insight APIを使用したいとします。を使って電話番号の情報を取得したいとします。この場合 コードサンプルを使うとよいでしょう。
このサンプルコードを使用するには、まず Vonageアカウントを作成する。(心配しないでください、無料です！）を作成し、APIコールを認証するためのAPIキーとシークレットを取得してください。
次に GitHub リポジトリ.これが完了したら、新しいPython仮想環境を作成し、必要な依存関係をインストールする：
最後に .env.distファイルを .envに変更し、APIキーとシークレットを追加する。 INSIGHT_NUMBERの値を調べたい番号に変更する。これでコードを実行する準備ができた：
入力した電話番号の情報が表示されているはずです。つまり、Pythonファイル自体を編集することなく、VonageのNumber Insight APIを使って環境変数から電話番号を調べたことになります！これは環境変数を使う大きな利点です。
環境変数の取得と設定は、プロダクションソフトウェアを作成する上で不可欠な要素です。このチュートリアルを終えた方は、Python を使って環境変数を取得・設定する方法に慣れていると思います。
また、シークレットを保存するためのさまざまなオプションも理解できただろう。OSを使って一時的にシークレットを設定する、.envファイルに保存する、クラウドに保管する、ユニバーサル・シークレット・マネージャーを使う、などだ。どの方法を使うかは、あなたが取り組んでいるプロジェクトの状況によって異なります。もっと読みたいなら 環境変数で秘密鍵を使うに詳しい。
質問や共有したいことがありますか？Vonageコミュニティ VonageコミュニティSlackまたは 開発者向けニュースレターでフォローしてください。 X（旧Twitter）YouTubeチャンネル YouTubeチャンネルビデオチュートリアルを購読する。 LinkedInのVonage開発者ページ開発者が学び、コミュニティとつながるためのスペースです。つながりを維持し、進捗状況を共有し、最新の開発者向けニュース、ヒント、イベントを把握してください！
さあ、自分のPythonプロジェクトで環境変数を使ってみよう！