こんにちは！開発環境アーキテクトの先輩です。
毎日のPHP開発、お疲れ様です。
ローカル環境でコードを書き、それを確認するためにわざわざFTPクライアント（FileZillaなど）を起動し、ファイルをドラッグ＆ドロップしてアップロードする……。そんな「手動デプロイ」の作業に、疲れていませんか？
ファイルが1つや2つならまだしも、修正を重ねるうちに「あれ、どのファイルをアップロードしたっけ？」と混乱し、本番環境や検証サーバーのファイルを上書きミスして冷や汗をかいた経験、きっと一度や二度ではないはずです。
今回は、PHP開発における最強の統合開発環境（IDE）であるPhpStormの「Deployment（デプロイメント）」機能を徹底解説します。これをマスターすれば、「コードを書く ➔ ショートカットキーを叩く ➔ 自動でリモートサーバーへ反映される」という、夢のようなワンクリック同期・デプロイ環境が手に入ります。
手作業によるデプロイの苦行から解放され、純粋にコーディングだけに集中できる最高の開発フローを一緒に作っていきましょう！
—
1. なぜ「PhpStormのデプロイ機能」を使うべきなのか？
世の中には優れたFTPクライアントソフトがたくさんあります。しかし、あえてPhpStormの内部機能を使うべき理由は、「エディタとファイル転送のコンテキストが完全に一体化するから」です。
外部のFTPツールを使っている場合、次のような無駄なコンテキストスイッチ（思考の分断）が発生します。
1. PhpStormでコードを書く
2. ファイルを保存する
3. FTPクライアントを開く
4. 該当ファイルを探してアップロードする
PhpStormのDeployment機能を使えば、ファイルを保存した瞬間にバックグラウンドで自動アップロードさせたり、キーボードショートカット一発でリモートサーバーへ転送したりできます。さらに、「ローカルとリモートの差分比較（Diff）」がIDE内でシームレスに行えるため、「サーバー側で誰かが直接書き換えてしまったコードで上書きしてしまう事故」を完璧に防ぐことができます。
中〜小規模の案件や、WordPressなどのCMSを用いた構築案件において、この機動力は圧倒的な武器になります。
—
2. 基礎セットアップ：SFTP/FTPサーバーとの接続を確立する
それでは、実際にPhpStormにリモートサーバーの情報を登録し、接続を確立していきましょう。
ステップ1：Deployment設定画面を開く
PhpStormの上部メニューから、以下のパスをたどります。
- macOSの場合: `PhpStorm` > `Settings` (または `Preferences`) > `Build, Execution, Deployment` > `Deployment`
- Windowsの場合: `File` > `Settings` > `Build, Execution, Deployment` > `Deployment`
ステップ2：サーバー接続の新規追加
設定ウィンドウが開いたら、左上の 「＋（プラスマーク）」 をクリックします。
1. Server name: 任意の名前を入力します（例: `stg-server` や `client-site-ftp` など分かりやすい名前）。
2. Type: 接続方式を選びます。セキュリティの観点から、平文でパスワードが流れるFTPではなく、可能な限り `SFTP`（SSH File Transfer Protocol） を選択することを強く推奨します。
ステップ3：接続情報の入力（Connectionタブ）
接続タイプを選んだら、右側のパネルで詳細な接続情報を入力します。
- Host: サーバーのIPアドレスまたはドメイン名（例: `192.168.1.50` や `example.com`）
- Port: SFTPであれば通常 `22`
- User name: サーバーのSSHユーザー名（例: `ubuntu` や `root` など）
- Authentication: 認証方式を選びます。「Password」または「Key pair (OpenSSH)」が選べます。安全なSSH秘密鍵認証（Key pair）を推奨しますが、まずは分かりやすいPasswordでも構いません。
- Root path: リモートサーバー上の公開ディレクトリへの絶対パスを指定します（例: `/var/www/html`）。
> 💡 先輩のアドバイス：パスの自動検出ボタンを活用しよう
> 「Root path」の欄の右側にある [Auto] ボタンをクリックすると、SSH接続が正常に確立されていれば、リモートサーバー上のホームディレクトリからの相対パスや絶対パスを自動的に検出してくれます。パスの指定ミスを防ぐために必ず使いましょう。
—
3. 「Mappings（マッピング）」タブの極意：ここが最重要！
接続設定ができたら、もう一つ重要なタブがあります。それが 「Mappings」タブ です。ここでは、「自分のPCのどのフォルダが、サーバーのどのフォルダに対応しているか」をPhpStormに教え込みます。
ここを正しく設定しないと、「意図しない階層にファイルがアップロードされてサイトが真っ白になった！」という大事故につながるので、慎重に設定しましょう。
- Local path: あなたのPC内にある、このプロジェクトのルートディレクトリへのパス（通常は自動入力されます）。
- Deployment path: `Root path` から相対的に見て、どのフォルダにプロジェクトを置くかを指定します。もしRoot pathに `/var/www/html` を指定しているなら、この項目は単に `/`（または空欄）で大丈夫です。
- Web path: ブラウザからアクセスした際のURL（例: `http://example.com/`）。設定しておくと、PhpStormから直接ブラウザでプレビューを開けるようになります。
—
4. 事故を防ぐ！「Excluded（除外設定）」の美学
デプロイにおいて最もやってはいけないこと。それは、「ローカルのGit管理ファイル（`.git`）や環境設定ファイル（`.env`）を本番サーバーにアップロードしてしまうこと」です。
これを防ぐために、Deployment設定の 「Excluded」タブ を必ず設定しましょう。
「Add Exclusion（除外の追加）」ボタンを押し、以下のファイルやフォルダをサーバーへ送らないリストに追加します。
- `.git/` （バージョン管理の履歴データ。サーバーには絶対不要です）
- `.env` または `.env.local` （データベースのパスワードや秘密鍵が書かれた環境変数ファイル。外に漏れたら大惨事です）
- `composer.lock` や `node_modules/` （※プロジェクトの運用方針によりますが、ローカルでビルドしてデプロイする場合や、サーバー側で直接Composerを叩く場合は除外を検討します）
あらかじめここに除外設定をしておくだけで、うっかり機密情報をリモートに晒してしまうヒューマンエラーを物理的にシャットアウトできます。これぞプロの技です。
—
5. 爆速で開発するための「自動アップロード」と「ワンクリック同期」
設定が完了したら、実際にコードをデプロイしてみましょう。
方法A：保存時に自動でアップロードさせる（Automatic Upload）
「ファイルを保存したら、思考する間もなくサーバー側も更新されていてほしい！」という方は、次の設定を有効にしてください。
1. 上部メニューの `Tools` > `Deployment` > `Automatic Upload (always)` にチェックを入れます。
2. これで、Ctrl + S (Cmd + S) でファイルを保存した瞬間、PhpStormがバックグラウンドでそのファイルをサーバーへ自動転送してくれます。
(※ 画面右下のイベントログに「Uploaded 1 file」と表示されるのを確認してみてください。感動的ですよ！)
方法B：安心のワンクリック・手動アップロード
自動アップロードは便利ですが、本番環境など「意図したタイミングで一気に反映させたい」という場合は、手動アップロードが安全です。
- 特定のファイルをアップロード: プロジェクトツリーでファイルを選択し、右クリック ➔ `Deployment` ➔ `Upload to [サーバー名]`（またはショートカットキーを割り当てることも可能です）。
- フォルダ全体を同期: プロジェクトフォルダ全体を右クリックし、サーバーの状態と見比べることも可能です。
—
6. サーバーとローカルの「差分比較（Diff）」で修正迷子をなくす
複数人で開発していたり、検証用にサーバー側を直接ちょっと直してしまったりしたとき、「ローカルとサーバー、どっちのコードが最新だっけ？」と迷うことがありますよね。
PhpStormのDeployment機能なら、一目でそれが分かります。
1. プロジェクトツリーのファイルまたはフォルダを右クリックし、`Deployment` > `Sync with Deployed to [サーバー名]` を選択します。
2. IDEの下部に、ローカルのファイル群とサーバー上のファイル群の差分比較ウィンドウ（Diffビューア）が立ち上がります。
ここでは、次のような視覚的な操作が可能です。
- どちらのファイルが新しいか（タイムスタンプと内容）が色分けで表示される。
- サーバー側にしかない不要なファイルを削除したり、ローカルの修正をサーバーへ一方通行でプッシュ（またはその逆）したりできる。
黒い画面を開いてわざわざ `rsync` や `diff` コマンドのオプションを思い出さなくても、エディタ上で直感的に視覚確認しながらマージ作業が行えるのは、本当にストレスフリーです。
—
まとめ：今日からあなたの開発速度は2倍になる
今回は、PhpStormのDeployment機能を使ったSFTP/FTPサーバーへのシームレスなデプロイ環境の構築法を解説しました。
- SFTP接続によるセキュアなリモート連携
- MappingsとExcluded設定による、事故を防ぐための堅牢な守り
- 自動アップロードによる、コーディングからテストへの爆速なフィードバックループ
- 差分比較（Sync）による、ファイルのコンフリクト防止
これらの設定は、一度組んでしまえば今後のすべての開発プロジェクトであなたを支える強力な基盤となります。「ファイルをアップロードする」という泥臭い作業から解放され、よりクリエイティブなロジックの構築に集中できるようになりますよ。
これを機に、あなたのPhpStormを「最強のデプロイメントマシン」へと進化させてみてください。毎日のコーディングが、きっと劇的に楽しく、軽快になりますよ！