VS CodeでPHP開発を加速させるPHP Intelephenseの導入・設定から活用法まで解説

2026年5月6日2026年5月8日

開発ツール

Modern PHP開発において、エディタの選択肢は多岐にわたりますが、Microsoftが提供するVisual Studio Code（VS Code）は、その軽量さと拡張性の高さから圧倒的なシェアを誇っています。

しかし、VS Code単体ではPHPの高度なコード補完や静的解析機能は十分とは言えません。

そこで欠かせないのがPHP Intelephenseです。

この拡張機能は、PHP開発におけるコード補完、定義へのジャンプ、エラーチェックなどの機能を劇的に向上させ、IDE（統合開発環境）であるPHPStormに匹敵する開発体験を提供します。

本記事では、PHP Intelephenseの導入から、開発効率を最大化するための設定、そして現場で役立つ活用法までを詳しく解説します。

目次 [ close ]

PHP Intelephenseとは何か

PHP Intelephenseは、Benbecke氏によって開発されているVS Code向けのPHP言語サーバです。

PHPのソースコードを解析し、開発者がコードを記述する際の強力な補助機能を提供します。

VS Codeには標準で「PHP Language Features」という拡張機能が組み込まれていますが、Intelephenseはそれを遥かに凌駕する解析精度とパフォーマンスを持っています。

具体的には、高速なインデックス作成、複雑な型推論、そしてPHP 8系以降の最新構文への迅速な対応が特徴です。

主な機能の概要

PHP Intelephenseを導入することで、以下のような機能が利用可能になります。

高度なコード補完：変数、関数、クラス名、メソッドなどの自動補完。
定義への移動：関数やクラスが定義されている箇所へ瞬時にジャンプ。
シンボル検索：プロジェクト内のクラスやメソッドを高速に検索。
静的解析：コードを書いている最中に、構文エラーや未定義の変数を指摘。
コード整形：PSR-12などの規格に基づいた自動フォーマット。

これらの機能により、タイピングミスの削減だけでなく、プロジェクト全体の構造を把握しやすくなり、開発スピードと品質が向上します。

PHP Intelephenseのインストール手順

それでは、実際にPHP IntelephenseをVS Codeに導入する手順を見ていきましょう。

拡張機能のインストール

VS Codeを起動し、左側のサイドバーにある「拡張機能」アイコンをクリックします（ショートカット：Ctrl+Shift+X または Cmd+Shift+X）。
検索バーに intelephense と入力します。
作者が「Benbecke」であることを確認し、「インストール」ボタンをクリックします。

組み込みPHP拡張機能の無効化

PHP Intelephenseの機能を最大限に活かし、動作の競合を防ぐために、VS Code標準のPHP機能を無効化することが強く推奨されます。

拡張機能の検索バーに @builtin php と入力します。
「PHP Language Features」という項目が表示されるので、右下の設定アイコン（歯車）をクリックし、「無効にする（ワークスペース）」または「無効にする」を選択します。

これを忘れると、コード補完が重複して表示されたり、エラーチェックが二重に行われたりして、動作が重くなる原因となります。

最適なパフォーマンスのための基本設定

インストールが完了したら、自分好みの開発環境に合わせた設定を行いましょう。

VS Codeの設定（settings.json）を編集することで、挙動を細かく制御できます。

基本的な設定例

以下は、PHP Intelephenseを快適に利用するための標準的な設定例です。

JSON

{
    "php.suggest.basic": false,
    "intelephense.completion.fullyQualifyGlobalConstantsAndFunctions": true,
    "intelephense.phpVersion": "8.3.0",
    "intelephense.files.maxSize": 5000000,
    "intelephense.format.enable": true
}

設定項目の詳細

各設定項目の意味を解説します。

php.suggest.basic: falseに設定することで、VS Code標準の簡易的な補完を無効化し、Intelephenseの高度な補完のみを利用するようにします。
intelephense.phpVersion: 使用しているPHPのバージョンを指定します。これにより、そのバージョンで使用可能な構文や関数に基づいた解析が行われます。
intelephense.files.maxSize: 解析対象とするファイルの最大サイズ（バイト）です。大規模なプロジェクトで大きな生成ファイルがある場合などに調整します。

開発を効率化する便利な活用法

PHP Intelephenseの真価は、日々のコーディングにおける細かな操作で発揮されます。

定義へのジャンプと参照元の確認

大規模なコードベースを読み解く際、ある関数がどこで定義されているか、あるいはどこで使用されているかを知ることは非常に重要です。

定義へ移動: 関数名やクラス名の上で F12 キーを押すと、その定義場所へジャンプします。
参照元を表示: Shift+F12 キーを押すと、そのシンボルがプロジェクト内のどこで使用されているかを一覧表示します。

インデックスの更新

プロジェクトに新しいライブラリを追加したり、ファイル構成を大幅に変更したりした場合、稀に補完が正しく機能しなくなることがあります。

その際は、コマンドパレット（Ctrl+Shift+P）を開き、以下のコマンドを実行してください。

Intelephense: Index workspace

これにより、プロジェクト内のすべてのファイルが再スキャンされ、最新の状態に更新されます。

型推論の活用

Intelephenseは、PHPDocを利用した型推論に非常に長けています。

複雑なオブジェクトの配列などを扱う際、以下のようにPHPDocを記述することで、ループ内でも正確な補完を受けることができます。

PHP

/** @var User[] $users */
$users = $userRepository->findAll();

foreach ($users as $user) {
    // $user-> と入力した時点で、Userクラスのメソッドが補完されます
    echo $user->getName();
}

このように、適切な型情報の付与は、自分だけでなくチームメンバーの開発効率を向上させることにつながります。

高度な設定とカスタマイズ

さらに踏み込んだ設定を行うことで、特定のフレームワークや開発環境に最適化することが可能です。

外部スタブの追加

標準では含まれていない拡張モジュール（例えば、特定のPHP拡張や独自のライブラリ）の関数が「Undefined」として警告される場合があります。

その場合、intelephense.stubs 設定に使用するスタブを追加します。

スタブ名	用途
`apache`	Apache関連の関数
`bcmath`	任意精度演算
`imagick`	画像処理
`redis`	Redis操作
`wordpress`	WordPress独自の関数

設定例（settings.json）:

JSON

"intelephense.stubs": [
    "apache",
    "bcmath",
    "bz2",
    "calendar",
    "core",
    "curl",
    "date",
    "dom",
    "ds",
    "exif",
    "fileinfo",
    "filter",
    "ftp",
    "gd",
    "gettext",
    "gmp",
    "hash",
    "iconv",
    "imagick",
    "imap",
    "intl",
    "json",
    "ldap",
    "libxml",
    "mbstring",
    "mcrypt",
    "memcache",
    "memcached",
    "mysqli",
    "mysqlnd",
    "openssl",
    "pcntl",
    "pcre",
    "PDO",
    "pdo_mysql",
    "pdo_pgsql",
    "pdo_sqlite",
    "pgsql",
    "Phar",
    "posix",
    "pspell",
    "readline",
    "recode",
    "redis",
    "Reflection",
    "session",
    "shmop",
    "SimpleXML",
    "snmp",
    "soap",
    "sockets",
    "sodium",
    "SPL",
    "sqlite3",
    "standard",
    "superglobals",
    "sysvmsg",
    "sysvsem",
    "sysvshm",
    "tidy",
    "tokenizer",
    "xml",
    "xmlreader",
    "xmlrpc",
    "xmlwriter",
    "xsl",
    "Zend OPcache",
    "zip",
    "zlib"
]

このように、必要なスタブを明示的に指定することで、未定義エラーの誤検知を防ぐことができます。

プレミアム版（Premium）で解放される機能

PHP Intelephenseは基本無料で利用できますが、有料のライセンスキーを購入することで、さらに高度な機能が利用可能になります。

プレミアム版の主なメリット

名前変更（Rename）機能: F2 キーを使用して、プロジェクト全体の変数名やクラス名を一括で安全に変更できます。
メソッドの実装（Implement Methods）: インターフェースを実装する際に、必要なメソッドの雛形を自動生成します。
未使用シンボルの検出: 使用されていない変数やインポート（use文）を特定し、コードをクリーンに保つのに役立ちます。
重複コードの検出: プロジェクト内の類似したコードブロックを見つけ出し、リファクタリングを促します。

数千円程度の買い切りライセンスであるため、プロのPHPエンジニアとして活動するのであれば、投資対効果が非常に高い選択肢と言えます。

よくあるトラブルと解決策

導入時や運用時によく遭遇する問題とその対処法についてまとめました。

補完が遅い、または効かない

プロジェクトの規模が非常に大きい場合、インデックス作成に時間がかかることがあります。

解決策: VS Codeの右下に表示される進捗バーを確認してください。インデックス作成中の場合は完了を待ちます。
除外設定の確認: intelephense.files.exclude 設定を確認し、解析不要なディレクトリ（一時フォルダや巨大なログディレクトリなど）が含まれているか確認します。

未定義のクラス（Undefined Class）エラーが出る

Composerでインストールしたライブラリが正しく認識されていない場合があります。

解決策: vendor ディレクトリがVS Codeのワークスペースに含まれていることを確認してください。また、intelephense.environment.includePaths に外部ライブラリのパスを追加することも有効です。

メモリ不足によるクラッシュ

大規模なプロジェクトでは、PHP Intelephenseが使用するメモリが不足することがあります。

解決策: VS Codeの設定で intelephense.runtime を指定し、メモリ上限を増やした状態で実行するように調整することを検討してください（通常はデフォルトで問題ありませんが、極端にファイル数が多い場合に有効です）。

フレームワーク別の最適化：Laravelの場合

Laravel開発でPHP Intelephenseを使用する場合、そのままでは一部の「マジックメソッド」や「ファサード」が未定義として扱われてしまいます。

これを解消するためには、以下の手順を推奨します。

ide-helperの導入

Laravelプロジェクトにおいて、コード補完を完璧にするためには barryvdh/laravel-ide-helper の導入が事実上の標準となっています。

Composerでパッケージをインストールします。

Shell

composer require --dev barryvdh/laravel-ide-helper

ヘルパーファイルを生成します。