PhpStormの使い方｜インストール・日本語化・PHPDoc補完・Xdebug設定と料金【2026.2対応】

PhpStormはJetBrainsが開発するPHP向けの統合開発環境（IDE）です。インストール直後からコード補完、静的解析、デバッガー連携、Git操作が使えますが、機能が多いぶん「最初にどこを設定すればよいか」が分かりにくい製品でもあります。この記事では、2026年10月時点の最新版PhpStorm 2026.2.3を前提に、インストールと日本語化、最初に覚えるショートカット、コード補完とPHPDoc、PHPStan連携、Xdebugでのステップ実行、Laravel対応の順に使い方を整理します。料金とライセンスの選び方も扱います。

まとめ：PhpStorm 2026.2の使い方の要点

• 最新版は2026.2.3（2026年9月17日公開）。2026.2の初版は2026年7月16日公開で、年3回のメジャー更新が続いています。
• インストールはToolbox Appが公式の推奨。動作要件はRAM 8GB（IDEに3GB空き）、ディスク10GB、4コアのCPUです。
• 日本語化は設定だけで済む。日本語の言語パックは同梱済みで、既定で有効になっています。
• 最初に覚えるのは3つ。Shiftを2回押す「どこでも検索」、Ctrl+Shift+Aのアクション検索、Alt+Enterのクイックフィックスです。
• PHPDocは/**とEnterで雛形が出る。@templateやclass-stringを書くと、ジェネリクス相当の型推論が補完に効きます。
• PHPStanとXdebugは標準で連携できる。PHPStanのプラグインは同梱済みで、XdebugはPhpStormがポート9003と9000の両方で待ち受けます。
• 非商用無料ライセンスの対象外。WebStormやRubyMineと違い、PhpStormは2026年8月時点で誰でも申し込める非商用無料ライセンスがありません。個人ライセンスは1年目税込16,566円、試用期間は30日です。

以下、導入から順に手順と判断材料を示します。

PhpStormの位置づけと現行バージョン

PhpStormはPHPを中心に、HTML・CSS・JavaScript・TypeScript、SQL、Docker Composeまで1つのIDEで扱えるのが特徴です。JetBrainsのリリースAPIによると、直近のメジャー版は次のとおりです。

2026.2の主な変更点は、公式ブログによると次の5つです。

• GitHub CopilotがAIチャットのエージェントとして標準で統合された（利用にはCopilotの契約が必要）
• PHPStanやLaravel Pintなどの品質ツールを、入力中・アイドル時・保存時のどれで動かすか選べるようになった
• 関数の引数に#[FileReference]属性を付けると、文字列のパスがナビゲーションとリファクタリングの対象になる
• Laravel専用のツールウィンドウが追加され、Artisanコマンド、ログ、Laravel Cloudのデプロイを扱える
• PER Coding Style 3.0のフォーマッター設定とPHP 8.5のパイプ演算子に対応した

PhpStormの料金と非商用無料ライセンスの対象外

JetBrainsは2024年10月以降、一部のIDEを非商用なら無料で使えるようにしました。ただし、2026年8月13日更新の非商用ライセンスのFAQで対象と明記されているのは、CLion・Rider・RubyMine・RustRover・WebStorm・DataGripの6製品だけです。PhpStormは対象外です。趣味の開発でも、教育ライセンスやオープンソース開発者向けの無償ライセンスなど条件付きの制度に当てはまらなければ、有償ライセンスか試用期間で使うことになります。非商用ライセンスの条件そのものはRubyMineとは？料金と無料になる非商用ライセンスの条件で解説しています。

日本の公式パートナーであるサムライズムのPhpStorm価格表（2026年10月時点）は次のとおりです。

法人の2年目と3年目以降の価格には「2025年1月1日以前にご契約のライセンスのみ継続割引対象」という注記があります。2025年以降に新規で契約した法人は、2年目以降も1年目と同じ額になると見込んでおくのが安全です。個人の継続割引にはこの注記がありません。

ライセンスを選ぶときの線引きは、用途ではなく費用を誰が払うかです。JetBrainsのFAQは、個人ライセンスを業務を含む任意の開発に使ってよいとする一方、会社による購入や費用の払い戻しを認めていません。フリーランスが自腹で買うなら個人ライセンスで足ります。会社の経費で買うなら法人ライセンスが必要です。学生と教員は教育ライセンスで無料になり、JetBrainsの全IDEを含むパックが使えます。

インストール手順と動作要件

PhpStorm 2026.2のハードウェアとOSの要件

PhpStorm 2026.2の公式ヘルプが示す要件は次のとおりです。Javaは同梱のJetBrains Runtimeで動くため、別途インストールする必要はありません。

WSLで動かす場合はWSL 2が必要で、WSLgによるGUI転送には対応していません。Windows側にPhpStormを入れ、WSL上のPHPインタープリターを登録する構成が公式の前提です。

Toolbox Appでの導入

公式が推奨するのはJetBrains Toolbox App経由のインストールです。複数のバージョンを並べて入れたり、更新後に問題が出たとき前の版へ戻したりできます。

1. Toolbox Appのページからインストーラーを入手する（macOSはIntel用とApple Silicon用でディスクイメージが別）。
2. Toolbox Appを起動し、製品一覧からPhpStormの「インストール」を選ぶ。
3. JetBrains Accountでログインすると、所有しているライセンスが自動で有効になる。ライセンスが無ければ30日の試用を選ぶ。
4. 初回起動時に地域（Region）を選び、プロジェクトのフォルダを開く。

Toolbox Appを使わない場合は、公式サイトから.exe、.dmg、.tar.gzを直接ダウンロードして入れることもできます。

日本語化の手順

PhpStormには日本語・中国語・韓国語の言語パックが同梱されており、既定で有効です。表示を切り替えるには、設定（Windows/LinuxはCtrl+Alt+S、macOSはCmd+,）を開き、「Appearance & Behavior｜System Settings｜Language and Region」の「Language」で日本語を選びます。

日本語にならない場合は、「Plugins」の「Installed」タブでJapanese Language Packのチェックが外れていないかを確認してください。以前のバージョンで入れた有志の日本語化ツール（Pleiades）が残っていると表示が混在するため、無効化してから切り替えます。IntelliJ系IDE共通のトラブル対処はIntelliJ IDEAの日本語化｜2024.2以降の設定手順とできない時の対処・英語への戻し方にまとめています。

最初に覚えるショートカットと上書きモードの戻し方

公式ヘルプが挙げる基本ショートカット

公式ヘルプの「最初に覚えるべきショートカット」から、使う頻度の高い8つを抜き出しました。表はWindows/Linuxの既定キーマップです。macOSでは「ヘルプ｜キーボードショートカット PDF」で自分のキーマップの割り当てを確認できます。

キーを覚えきれないうちは、Ctrl+Shift+Aで操作名を打って実行すれば足ります。検索結果には割り当てられたキーも表示されるため、よく使う操作のキーは自然に覚えられます。

上書きモードを挿入モードに戻す方法

文字を打つと右側の文字が消えていく場合は、上書きモードになっています。IntelliJ系IDEの既定キーマップでは、Insertキーが挿入と上書きの切り替え（Toggle Insert/Overwrite）に割り当てられています。もう一度Insertキーを押せば元に戻ります。

Insertキーの無いノートPCやMacのキーボードでは、Ctrl+Shift+A（macOSはCmd+Shift+A）でアクション検索を開き、英語UIなら「Toggle Insert/Overwrite」と入力して実行します。誤って押しやすい場合は、「Keymap」設定でこの操作のキーを外しておくと再発しません。

コード補完とPHPDocによる入力支援

補完の種類と呼び出しキー

PhpStormの補完は、入力中に自動で出るもの以外に、呼び出し方の違う複数の種類があります。

• 基本補完（Ctrl+Space）：現在位置から参照できるクラス名・メソッド名・キーワードを候補に出す。
• 後置補完：式の後ろに.ifのようなテンプレート名を付けてTabを押すと、その式を条件にしたif文に展開される。その位置で使えるテンプレートの一覧はCtrl+Jで出る。
• Full Line補完：ローカルで動く言語モデルが1行単位で続きを提案し、Tabで確定する。PHP用のモデルは同梱済みで、追加ライセンスは不要。コードはネットに送信されない。

Full Line補完はAVX2命令に対応したx64 CPUかARM64 CPUが必要です。対応しない古いCPUでは自動で無効になります。提案が邪魔なら「Editor｜General｜Code Completion｜Inline」で切れます。

PHPDocの雛形を自動生成する手順

クラスやメソッドの直前で/**と入力してEnterを押すと、PhpStormが引数・戻り値・プロパティを解析してPHPDocの雛形を作ります。既存のコードにまとめて付けたい場合は、Alt+Insert（macOSはCmd+N）の「Generate PHPDoc blocks」で対象を選びます。

雛形が出ない場合は、「Editor｜General｜Smart Keys」の「Insert documentation comment stub」が外れていないかを確認してください。PHPDoc内でCtrl+Spaceを押すと、その位置で使えるタグの候補が出ます。書いたPHPDocはCtrl+Qのクイックドキュメントにそのまま表示されます。

@templateとclass-stringによる型推論の補強

PHPには言語としてのジェネリクスがありませんが、PhpStormは2021.2から、PHPStanやPsalmと同じ@template記法を解釈します。リポジトリやコレクションのように「何の型を返すか」が使い方で変わるクラスでは、PHPDocを書くかどうかで補完の精度が大きく変わります。

<?php

/**
 * @template T of object
 */
final class Repository
{
    /** @var list<T> */
    private array $items = [];

    /**
     * @param class-string<T> $class
     */
    public function __construct(private string $class)
    {
    }

    /**
     * @param T $item
     */
    public function add(object $item): void
    {
        if (!$item instanceof $this->class) {
            throw new InvalidArgumentException('型が違います');
        }
        $this->items[] = $item;
    }

    /**
     * @return T|null
     */
    public function first(): ?object
    {
        return $this->items[0] ?? null;
    }
}

final class User
{
    public function __construct(public string $name)
    {
    }
}

$users = new Repository(User::class);
$users->add(new User('sato'));
echo $users->first()?->name, PHP_EOL;

このコードをPHP 8.5.8で実行するとsatoと出力されます。PHPStan 2.2.16のレベル9で型を出力させると、$usersはRepository<User>、$users->first()はUser|nullと推論されました。戻り値の型宣言は?objectのままでも、first()の後に->を打った時点でUserのプロパティが補完候補に出る、というのがPHPDocを書く効果です。

PHPStan・PHP_CodeSnifferとの連携

PhpStorm自身のインスペクションに加えて、PHPStan、Psalm、PHP_CodeSniffer、PHP CS Fixer、Laravel Pintの結果をエディター上に表示できます。PHPStanの連携プラグインは同梱済みで、既定で有効です。ComposerでPHPStanをプロジェクトに入れると、PhpStormがvendor/binの実行ファイルを自動で見つけて登録します。

composer require --dev phpstan/phpstan

実行ファイルが登録されても、エディター上に結果を出すには検査の有効化が必要です。設定の「Editor｜Inspections」で「PHP｜Quality Tools」を開き、「PHPStan validation」にチェックを入れます。解析レベルや設定ファイル（phpstan.neon）の指定は「PHP｜Quality Tools｜PHPStan」で行います。

PHPStanの指摘はPhpStorm内蔵の警告と同じ見た目でハイライトされ、Problemsツールウィンドウではphpstanの接頭辞で区別されます。2026.2からは、「PHP｜Quality Tools｜（ツール名）」の「Run mode」で、入力中・アイドル時・保存時のどのタイミングで実行するかを選べます。入力中の解析でエディターが重くなる原因がPHPStanの実行にある場合は、保存時に寄せると入力中の解析負荷を減らせます。

PHPStanのルールとレベルの考え方はコードを実行せずにバグを検出するPHPStanの基本的な仕組みと役割、Laravelの整形ルールはLaravel Pintとは｜プリセット選定とCI差分チェック運用の判断基準で扱っています。Rust製の高速な解析ツールMagoはPhpStormの公式プラグインがまだ無く、エディター連携ではPHPStanのほうが手間がかかりません。

Xdebugでのステップ実行の設定

PhpStormのデバッグはXdebugとの連携が基本です。まずPHPのバージョンに合うXdebugをインストールし、PhpStormに登録したPHPインタープリターが読むphp.ini（「PHP」設定のCLI Interpreterの画面で場所を確認できます）を開きます。次の例は、PHPとPhpStormが同じマシンで動き、Xdebugの拡張が既定の場所に入っている構成の設定です。拡張ファイルを別の場所に置いた場合はzend_extensionにフルパスを書きます。Xdebug 3の既定ポートは9003で、Xdebug 2の9000から変わりました。

[xdebug]
zend_extension=xdebug
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=trigger

PhpStorm側の「PHP｜Debug」のDebug portは、既定で9003,9000になっており、両方のポートで同時に待ち受けます。ポート番号を合わせ忘れて接続できない事故は、この既定値のおかげで起きにくくなっています。

実行構成を作らずに始める「ゼロ設定デバッグ」の流れは次のとおりです。

1. php --versionの出力にXdebugが含まれることを確認する。PhpStormの「Validate」機能でも設定を検証できる。
2. ツールバーかステータスバーの「Start Listen PHP Debug Connections」ボタンをオンにする。
3. 止めたい行の左端（ガター）をクリックしてブレークポイントを置く。
4. ブラウザーの拡張機能などでデバッグセッションを開始し、ページを開く。

ブレークポイントで止まった後は、F8でステップオーバー、F7でステップイン、Shift+F8でステップアウトです。Dockerコンテナ内のPHPをデバッグするときのclient_hostの設定やパスマッピングは、Xdebugとは？PHPデバッグの使い方・インストール・php.ini設定・VSCode連携【3.5.3対応】で詳しく説明しています。

Laravel開発での使い方

PhpStormは標準の状態でも、Bladeテンプレートの補完、Eloquentやルーティングの補完、Artisanコマンドの実行、Pestテストの実行に対応しています。これらのLaravel支援は、もともと有償だったLaravel Ideaプラグインが担っています。Laravel Ideaは2025年7月30日にPhpStormユーザー向けに無償化され、PhpStorm 2025.3からはIDEに同梱されたため、2026.2では追加のインストールが要りません。設定は「Languages & Frameworks｜Laravel Idea」で変更します。

2026.2で追加されたLaravelツールウィンドウでは、Dashboardタブからプロジェクト情報とArtisanコマンド、Errorsタブからローカルのログやエラー、Laravel Cloudタブからデプロイと環境変数を扱えます。テストをPestで書く場合はPestPHPとは？PHPUnitとの違いと導入手順｜Pest 5の新機能まで実測で解説も参考になります。

AI機能の範囲と追加費用

PhpStormのAI機能は、追加費用なしで使える部分と、AIクレジットを消費する部分に分かれます。

• Full Line補完：ローカル実行で、ライセンスに含まれる。
• AI Free：サムライズムの価格表では、販売しているPhpStormの各ライセンス区分に無料で付き、30日ごとに3 AIクレジットが付与される。
• AI Pro・AI Ultimate：個人向けの追加契約で、価格はAI Proが税込15,180円、AI Ultimateが税込45,980円。30日ごとにAI Proは10クレジット、AI Ultimateは35クレジットが付与される。
• GitHub Copilot：2026.2から標準のエージェントとして使えるが、Copilotの契約が別に必要。

Claude CodeやCodexのようにターミナルで動くエージェントを使う場合も、2026.2からは新しいセッションの開始時にPhpStormのMCPサーバーを設定するよう通知が出ます。設定するとエージェントがIDEの解析結果を参照できます。Claude CodeやCodexに設定済みのエージェントスキルは、PhpStormのスキル管理画面へ取り込めます。

クレジットの消費ルールとCopilotとの違いはJetBrains AI Assistantとは？料金・AIクレジット・使い方とGitHub Copilotとの違いで比較しています。

VS Codeで足りる場面とPhpStormを選ぶ条件

PhpStormは有償なので、VS Codeと拡張機能で足りるなら無理に導入する必要はありません。判断の目安は次のとおりです。

VS Codeで足りるのは、WordPressのテーマ修正や小さなスクリプトのように、ファイル数が少なく型情報をたどる場面が少ないプロジェクトです。PHP以外の言語の作業が中心で、PHPはときどき触る程度という人にも、継続的なライセンス費用を払う理由は薄くなります。公式の動作要件はRAM 8GBのうちIDE用に3GBの空きを求めているので、8GBのPCではDockerやブラウザを動かした状態で3GBが空くかを先に確認しておくと安心です。

PhpStormを選ぶべきなのは、LaravelやSymfonyの中規模以上のプロジェクトで、クラスをまたいだリネームや使用箇所の検索を日常的に行う場合です。PHPDocの@templateを含む型推論、PHPStanとの統合、Xdebugの待ち受け、データベースクライアントがIDEに統合されているため、拡張機能の組み合わせを自分で選んで保守する手間が減ります。PHPStanの検査の有効化やXdebugのphp.ini設定は、PhpStormでも別途必要です。30日の試用期間中に、実際のプロジェクトでリファクタリングとデバッグを一度ずつ試すと、差が分かりやすくなります。

PHPそのものの将来性やLaravelのサポート期限を含めて技術選定する場合は、Laravelの将来性を2026年のデータで判断する｜サポート期限・求人単価・AI対応も判断材料になります。

よくある質問

PhpStormとは何ですか？

JetBrainsが開発するPHP向けの統合開発環境です。PHPに加えてHTML、CSS、JavaScript、TypeScript、SQLを扱え、コード補完、静的解析、Xdebugによるデバッグ、Git操作を1つのアプリで行えます。2026年10月時点の最新版は2026.2.3です。

PhpStormの料金はいくらですか？

サムライズムの価格表では、個人ライセンスが1年目税込16,566円、2年目税込13,200円、3年目以降税込9,845円です。法人のレギュラーは1年目43,700円です。30日間の試用期間があり、学生と教員は教育ライセンスで無料になります。

PhpStormは無料で使えますか？

誰でも申し込める非商用無料ライセンスの対象には入っていません。WebStormやRubyMineには非商用なら無料のライセンスがありますが、2026年8月更新のJetBrainsのFAQではPhpStormは対象外です。無料で使えるのは、30日の試用期間、学生・教員向けの教育ライセンス、審査を通った非商用オープンソースプロジェクトの開発者向けライセンスなど、条件付きの制度に限られます。

PhpStormが日本語にならないのはなぜですか？

言語パックは同梱されていますが、「Language and Region」の設定で日本語を選ぶまでは英語のままです。選んでも変わらない場合は、PluginsでJapanese Language Packが無効になっていないか、旧来の日本語化ツールが残っていないかを確認してください。

PhpStormでPHPDocを自動生成するには？

クラスやメソッドの直前で/**と入力してEnterを押すと雛形が作られます。複数の要素にまとめて付けるときは、Alt+Insert（macOSはCmd+N）から「Generate PHPDoc blocks」を選びます。

関連記事

• Xdebugとは？PHPデバッグの使い方・インストール・php.ini設定・VSCode連携【3.5.3対応】
• コードを実行せずにバグを検出するPHPStanの基本的な仕組みと役割
• JetBrains AI Assistantとは？料金・AIクレジット・使い方とGitHub Copilotとの違い
• IntelliJ IDEAの日本語化｜2024.2以降の設定手順とできない時の対処・英語への戻し方
• RubyMineとは？料金と無料になる非商用ライセンスの条件