はじめに

Python案件に入ることになった。

PHPエンジニアとして数年やってきたけど、Pythonはほぼ未経験。

とりあえず環境構築からやってみたので、詰まったところを中心にメモしておく。同じようにPHPからPythonに移る人の参考になれば。

環境構築 — まずpyenvを入れた

PHPだとphpenvやbrewで複数バージョン管理するのが定番だけど、Pythonも同じようにバージョン管理ツールがある。

よく名前が挙がるのが pyenv。phpenvとほぼ同じ概念なので、ここは比較的すんなり入れた。

# Homebrewで入れる（Mac）
brew install pyenv

# .zshrcに追記
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

# バージョン確認
pyenv install --list | grep "3\."

# 最新安定版を入れる
pyenv install 3.12.3

# グローバルに設定
pyenv global 3.12.3

python --version
# Python 3.12.3

ここまでは問題なかった。

最初の壁 — venvって何？

PHPだとcomposerが依存関係をvendor/に突っ込んでくれる。プロジェクトごとにcomposer.jsonがあれば管理できる。

Pythonもpipでパッケージを入れるんだけど、何も考えずにpip installするとグローバルに入る。

# これをやると全プロジェクトに影響する（最初やらかした）
pip install requests

PHPのcomposerはデフォルトでプロジェクトローカルに入るのに、pipはそうじゃないのか……と最初混乱した。

そこで出てくるのが venv（仮想環境）。

# プロジェクトルートで
python -m venv .venv

# 仮想環境を有効化（Mac/Linux）
source .venv/bin/activate

# Windowsの場合
.venv\Scripts\activate

# 有効化されるとプロンプトが変わる
# (.venv) $

有効化した状態でpip installすれば、.venv/の中だけにパッケージが入る。

pip install requests

# プロジェクトの依存を記録（composer.jsonのrequireに相当）
pip freeze > requirements.txt

# requirements.txt
certifi==2026.4.9
charset-normalizer==3.3.2
idna==3.7
requests==2.31.0
urllib3==2.2.1

他の環境に再現するときは：

pip install -r requirements.txt

composerとpipの対応関係

整理するとこんな感じ。

PHP（composer）	Python（pip + venv）
`composer.json`	`requirements.txt`
`vendor/`	`.venv/`
`composer install`	`pip install -r requirements.txt`
`composer require foo`	`pip install foo`
`composer.lock`	`requirements.txt`（freezeで固定）

厳密にはrequirements.txtはlockファイルではないので、再現性をちゃんと担保したいなら Poetry を使うのが今どきの流儀らしい。とりあえず今はpip + venvで覚えることにした。

もう一つの壁 — python2とpython3問題

インターネットで調べると古い記事だとpython2のコードが出てくる。

# python2
print "Hello"

# python3
print("Hello")

pythonコマンドがpython2を指している環境も残っているので、python3やpython --versionで確認する習慣をつけた。pyenvで3系を入れていれば基本大丈夫だけど、一応。

`.venv`をGitignoreに追加するのを忘れない

地味に大事。

# .gitignore
.venv/
__pycache__/
*.pyc
.env

__pycache__はPythonが自動生成するキャッシュフォルダ。PHPだとあまり意識しないけど、Pythonだと普通に出てくる。これもignoreしておく。

使ったエディタ

VS Codeに Pylance と Ruff を入れた。

Pylance — 型チェック・補完。PHPIntelliSenseの感覚で使える
Ruff — リンター＋フォーマッター。めちゃくちゃ速い。PHPのPHP CS Fixerに相当

// settings.json
{
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.formatOnSave": true
  }
}

今回やったことまとめ

pyenvでPythonのバージョン管理
venvでプロジェクトごとに仮想環境を作る
pipで依存パッケージを管理、requirements.txtに記録する
VS Code + Pylance + Ruffで開発環境を整えた

環境構築だけで結構な分量になってしまったが、ここを曖昧にすると後でパッケージ関連のトラブルで詰まるので丁寧にやってよかったと思う。

次は変数・型・スコープあたりのPHPとの違いを整理していく予定。