クイックスタートガイド

PhpStorm は、IntelliJ IDEA プラットフォーム上に構築された PHP 開発者向けの統合開発環境です。

サポートされる言語

PhpStorm を使用すると、PHP 5.3、PHP 5.4、PHP 5.5、PHP 5.6、PHP 7、PHP 7.1、PHP 7.2、PHP 7.3、PHP 7.4、PHP 8.0 でアプリケーションを開発できます。詳細については、サポートされている PHP バージョンを参照してください。さらに、HTML5、CSS、JavaScript、XML を完全にサポートします。これらの言語のサポートは、IDE にバンドルされ、デフォルトで有効になっているプラグインを介して処理されます。他の言語のサポートは、プラグインを介して追加できます。設定 / 環境設定ダイアログ Ctrl+Alt+S で、プラグインに移動して詳細を確認するか、IDE の最初の起動時にセットアップします。

サポートされるプラットフォーム

PhpStorm は、Windows、macOS、Linux で動作するクロスプラットフォーム IDE です。

システム要件

要件	最小	推奨
RAM	2 GB の空き RAM	8 GB の総システム RAM
CPU	最新の CPU	マルチコア CPU。PhpStorm は、さまざまな操作やプロセスのマルチスレッドをサポートしているため、使用できる CPU コアが多くなります。
ディスク容量	2.5 GB およびキャッシュ用にもう 1 GB	5 GB 以上の空き容量がある SSD ドライブ
モニターの解像度	1024x768	1920 × 1080
オペレーティングシステム	以下の公式にリリースされた 64 ビットバージョン: Microsoft Windows 8 以降 macOS 10.13 以降 Gnome、KDE、または Unity DE をサポートする Linux ディストリビューション。プレリリース版はサポートされていません。	最新の 64 ビットバージョンの Windows、macOS、または Linux (たとえば、Debian、Ubuntu、RHEL などです。)

JetBrains ランタイムは IDE（JRE 11 に基づく）にバンドルされているため、PhpStorm を実行するために Java をインストールする必要はありません。

PHP 環境の設定

PhpStorm はスマートな IDE ですが、まず使用している PHP 環境、PHP コンポーネントが格納されている場所、およびそれらの設定方法を知らせる必要があります。

ローカル Web サーバーを使用する場合は、AMP パッケージをインストールする手順に従って環境を準備します。
Docker コンテナーで作業する場合は、PhpStorm での Docker サポートを参照してください。
Vagrant を使用する場合は、PhpStorm での Vagrant サポートを参照してください。
WSL を使用する場合は、PhpStorm での WSL サポートを参照してください。

このクイックスタートガイドでは、Docker 環境で事前設定されたプロジェクトをセットアップします。

始める前に

ご使用のオペレーティングシステム用の Docker をインストールします(英語)。
PhpStorm の設定 / 環境設定ダイアログ Ctrl+Alt+S で、ビルド、実行、デプロイ | Docker に移動し、Docker デーモンへの接続方法を選択します。
お使いのオペレーティングシステムに応じて、次の操作を行います。
- TCP ソケットを選択します。
- エンジン API URL を tcp://localhost:2375 に設定します。
  Windows 用 Docker 設定の一般セクションで、TLS なしで tcp://localhost:2375 上のデーモンを公開を有効にします。
- 証明書フォルダーフィールドは空のままにします。
Docker Toolbox を使用している場合は、代わりに次の設定オプションを使用してください。
- エンジン API URL を https://192.168.99.100:2376 に設定
- 証明書フォルダーを <your_home_directory>\.docker\machine\machines\default に設定します。
- Mac 用 Docker を選択します。
- Unix ソケットを選択します。

ステップ 1: PhpStorm でプロジェクトを開く

PhpStorm ですることはすべて、プロジェクトのコンテキスト内で行われます。これは、コーディング支援、一括リファクタリング、コーディングスタイルの一貫性などの基盤として機能します。

このクイックスタートガイドでは、事前構成された環境で docker-compose.yml ファイルがすでに含まれているワークショッププロジェクトを提供します。このプロジェクトは、GitHub の https://github.com/JetBrains/phpstorm-workshop(英語) で入手できます。

PhpStorm で Workshop プロジェクトを開始する

PhpStorm ウェルカム画面で、新規プロジェクトをクリックします。
左側のリストから PhpStorm ワークショッププロジェクトを選択し、場所フィールドにプロジェクトの場所を入力して、作成をクリックします。
エディターで docker-compose.yml を開き、オペレーティングシステムに応じた値で XDEBUG_CONFIG 変数を更新します。これは Web デバッグに必要です。
リモートホストを参照する host.docker.internal 値、つまり Docker が稼動しているマシンを使用します。ホストの内部アドレスに自動的に解決され、コンテナーからホストの内部アドレスに接続されます。
docker-compose.yml ファイルの対応する部分は、次のようになります。
XDEBUG_CONFIG: remote_host=host.docker.internal
リモートホストを参照する host.docker.internal 値、つまり Docker が稼動しているマシンを使用します。ホストの内部アドレスに自動的に解決され、コンテナーからホストの内部アドレスに接続されます。
docker-compose.yml ファイルの対応する部分は、次のようになります。
XDEBUG_CONFIG: remote_host=host.docker.internal
ローカルマシンのホスト名を使用します。それを取得するには、ターミナルで hostname コマンドを実行します。
docker-compose.yml ファイルの対応する部分は、次のようになります。
XDEBUG_CONFIG: remote_host=<local_hostname>
同じ docker-compose.yml ファイルで、オペレーティングシステムに応じて sftp サービスの適切な行のコメントを外します。これはデプロイが正しく機能するために必要です。
エディターガターでをクリックして、必要な Docker コンテナーをすべて開始します。
または、内蔵 PhpStorm ターミナル（Alt+F12）を開いて docker-compose up コマンドを実行してください。

ステップ 2: ユーザーインターフェースを調べる

PhpStorm のメインウィンドウは、いくつかの論理領域に分かれています。

さまざまなコマンドの実行に役立つメニューとツールバー。
プロジェクトをナビゲートするためのナビゲーションバー。
ステータスバーには、PhpStorm 全体、現在のプロジェクト、エディター内のファイル、警告、エラーメッセージに関するさまざまな情報が含まれています。
実際にコードを書くエディター。開いているファイル間を簡単に移動するためのタブがあります。
さまざまな機能を実行する数多くのツールウィンドウ : プロジェクトやファイル構造の探索とナビゲーション、検索とインスペクションの結果の表示、アプリケーションの実行、デバッグ、テスト、インタラクティブコンソールでの作業などを手助けします。

ステップ 3: スマートアシスタンスによるコード

PhpStorm はルーチンを処理し、重要なものに集中できるようにします。多くの PhpStorm コーディング機能を使用して、無駄な時間を無駄にせずにエラーのないアプリケーションを作成できます。基本プロジェクトでは、コード例とガイドラインを使って、多数の PHP ファイルでこれらの機能をインタラクティブに試すことができます。

コード補完

コード補完は、作業中のファイルの種類にかかわらず、非常に時間を節約します。PhpStorm には、基本とスマートの 2 種類のコード補完があります。

基本補完 Ctrl+Space は、現在のコンテキストのコード補完オプションを示し、現在のタイプのメンバーを太字で表示します。

さらにバリエーションを表示するには、Ctrl+Space をもう一度押します。

基本コード補完を試すには、プロジェクトで workshop/02_Editing/01_Completion/1.1_Basic_Completion.php を開き、コメントの指示に従ってください。

スマート補完 Ctrl+Shift+Space は、現在作業中のコンテキストを分析し、その分析に基づいてより正確な提案を提供して、式型に一致するように関数と変数のリストをフィルタリングします。

smart コード補完を試すには、プロジェクトで workshop/02_Editing/01_Completion/1.3_Type_hinting.php を開き、コメントにある手順に従ってください。

インテンションアクション

PhpStorm は、現在行っていることを監視し、インテンションアクションと呼ばれるスマートな提案を行って、時間を節約します。インテンションアクションを使用すると、正しいコードに自動変更を適用できます（正しくない可能性のあるコードのクイックフィックスを提供するコードインスペクションとは対照的です）。

コードは存在しないファイルを参照していますか？ PhpStorm には問題ありません。 Alt+Enter を押してファイル <ファイル名> を作成しますを選択します:

利用可能なインテンションアクションの完全なリストを表示するには、設定 / 環境設定ダイアログ Ctrl+Alt+S でエディター | インテンションに移動します。

さまざまなインテンションアクションを試すには、プロジェクトで workshop/02_Editing/05_Intentions/5.1_Intentions.php を開き、コメントの指示に従ってください。

ステップ 4: コードをきれいに保つ

PhpStorm はあなたのコードを監視し、正確かつ清潔に保ちます。潜在的なエラーと問題を検出し、クイックフィックスを提案します。

PhpStorm が未使用のコード、無限ループ、非表示の上位スコープ、条件式の代入演算子 =、およびおそらく注意が必要な、その他の多くのものを見つけるたびに、バルブが表示されます。それをクリックするか、Alt+Enter を押して、修正を適用します。

use ステートメントを忘れましたか？

Alt+Enter を押し、クラスのインポートをクリックします:

リストで、インポートするクラスをクリックします。

ps_quick_start_quick_fix_choose_class_to_import_mac.png

PhpStorm は選択されたクラスをインポートし、use ステートメントを追加します。

workshop/03_Inspections/02_Quick_Fixes.php から実際のサンプルを試してみてください。

使用可能なインスペクションの完全なリストを表示するには、設定 / 環境設定ダイアログ Ctrl+Alt+S でエディター | インスペクションに移動します。それらのいくつかを無効にしたり、他のものを有効にしたり、各インスペクションの重大度を調整したりできます。エラーと見なすか警告と見なすかを決定します。

ステップ 5: いくつかのコードを生成する

PhpStorm で利用可能なコード生成オプションを使用すると、コードの記述がはるかに簡単かつ高速になります。コード | 生成メニュー（または単に Alt+Insert）は、コンストラクター、getter/setter、PHPDoc コメントの生成に役立ち、一部のメソッド Ctrl+O/ Ctrl+I のオーバーライド / 実装を提案します。 workshop/02_Editing/06_Generate_code/6.1_Generate_Code.php でより多くのライブ例を試してください。

ライブテンプレートを使用して（コード | ライブテンプレートの挿入を選択するか Ctrl+J を押す）、コード構成全体を生成します。すぐに使用可能なライブテンプレートのリストを表示するには、設定 / 環境設定ダイアログ Ctrl+Alt+S でエディター | ライブテンプレートに移動します。

開発に重要なことが必要な場合は、独自のテンプレートでこのテンプレートセットを拡張します。 workshop/04_Live_Templates/01_Code_Expansion/1.1_Code_Expansion.php と workshop/04_Live_Templates/02_Creating_Live_Templates のライブサンプルを試してみてください。

また、コードを完全な構造で囲むことを検討してください。コード | 囲むを選択するか、Ctrl+Alt+T を押してから、ポップアップメニューから必要なステートメントを選択します。 workshop/04_Live_Templates/03_Surround_Templates/3.1_Simple_template.php でより多くのライブ例を試してください。

ステップ 6: 探索の方法

プロジェクトが大規模な場合や、誰か他の人が書いたコードを使用しなければならない場合は、探しているものをすばやく見つけてコードを掘り下げることが重要です。PhpStorm には、いくつかのコードを探索するためのナビゲーション機能が用意されています。

基本的な検索

プロジェクトで特定のシンボルが使用されている場所を見つけるために、PhpStorm は使用箇所の検索 Alt+F7 を介したフルスケール検索を提案しています。

また、現在のファイル Ctrl+F のみ、またはディレクトリ内、任意のスコープ内、またはプロジェクト Ctrl+Shift+F 全体で検索することもできます。

基本検索を試すには、プロジェクトで workshop/01_Navigation/05_Find_usages/5.2_Find_Usages.php または workshop/01_Navigation/05_Find_usages/5.1_Highlight_Usages_in_File.php を開き、コメントの指示に従ってください。

インポートや呼び出しの階層を使ってファイル構造を見ているだけで多くのことを知ることができ、強力なナビゲーション操作の助けを借りてコードをナビゲートすることができます。

どこでも検索を使用すると、クラス、ファイル、シンボル、メニューアクションを一度に検索し、それらにナビゲートすることができます。どこでも検索を起動するには、PhpStorm ウィンドウの右上隅にある虫めがねアイコンをクリックするか、Shift を 2 回押します。検索パターンを指定しない場合、PhpStorm は最新のファイルのリストを表示します。ここで、関連する項目に移動することができます。
特定のものを検索するには、検索パターンを入力します。シンボルの他に、どこでも検索はアクションを見つけることができます:
どこでも検索モードでは、PhpStorm は CamelHumps を受け入れて、真ん中のマッチを認識します。
どこでも検索を使用するさまざまな方法を試すには、プロジェクトで workshop/01_Navigation/01_Navigate_to_something_you_know/1.6_Search_everywhere.md を開き、指示に従います。
もちろん、クラス、Ctrl+N、ファイル、Ctrl+Shift+N、またはシンボル Ctrl+Alt+Shift+N への名前によるナビゲーションも自由自在です。どこでも検索を参照してください。
宣言に移動（Ctrl+B、Ctrl+Click）は、特定のシンボルが最初に宣言された場所に移動します。このタイプのナビゲーションは、別のクラスやコメントからでも、ソースコードの任意の場所から機能します。宣言に移動をナビゲートするには、プロジェクトで workshop/01_Navigation/02_Navigate_to_Declaration/2.1_Go_to_declaration.php を開き、コメントの指示に従います。
実装に移動 Ctrl+Alt+B は、特定のクラスの実装を提供します。複数の実装がある場合、PhpStorm はそれらをリストに表示し、関連するものを選択してナビゲートすることができます。実装に移動をナビゲートするには、プロジェクトで workshop/01_Navigation/04_Navigate_class_hierarchies/4.1_Go_to_Implementation.php を開き、コメントの指示に従ってください。

タイムラインをナビゲートする

PhpStorm は、ローカル履歴でソースコードに加えた変更、リファクタリングの結果などを自動的に追跡します。従来のバージョン管理システムとは異なり、ローカル履歴は常に有効になっています。ファイルまたはフォルダーに対して表示するには、メインメニューからファイル | ローカル履歴 | 履歴の表示を選択します。ここでは、変更を確認したり、元に戻したり（）、パッチを作成したり（）できます。

ローカル履歴を自分で試してみるには、プロジェクトで workshop/09_Version_Control/07_Local_History.php を開き、コメントの指示に従ってください。

ステップ 7: アプリケーションをデバッグする

アプリケーションは、意図されているものとまったく同じですか？そうでない場合は、問題の原因を突き止めるためにデバッグを行う必要があります。幸いにも、私たちのサンプルプロジェクトにはすでに Xdebug がインストールされ、設定されています。

PHP インタープリターを設定する

プロジェクトでは、Docker 環境にはすでに PHP インタープリターが含まれています。PhpStorm には、その場所を伝えるだけで済みます。

設定 / 環境設定ダイアログ Ctrl+Alt+S で、言語 & フレームワーク | PHP に移動します。
開いている PHP ページで、CLI インタープリターリストから PHP 7.1 と Xdebug を選択します。

ブレークポイントの設定

デバッグは、プログラムの実行が一時停止されるブレークポイントを配置することから始まります。これにより、プログラムデータを調べることができます。ブレークポイントを表示する行のガターをクリックするだけです。

自分でブレークポイントを操作するには、プロジェクトで workshop/06_Debugging/03_Breakpoints.php を開き、コメントの指示に従ってください。

デバッグを開始する

プロジェクトツールウィンドウで、workshop/06_Debugging/03_Breakpoints.php を選択し、コンテキストメニューからデバッグ | 03_Breakpoints.php を選択します。

PhpStorm はデバッグセッションを開始し、一時停止したプログラムをステップ実行し、変数値を表示したり、式を評価したりすることができるデバッグツールウィンドウを開きます。 workshop/06_Debugging/05_Debug_Tool_Window.php から実際のサンプルを試してみてください。

代替のデバッグシナリオについてはゼロコンフィギュレーションデバッグを参照してください。

ステップ 8: コードをテストする

PhpStorm は、最も一般的な PHP テストフレームワーク（PHPUnit、Behat、PHPSpec、Codeception など）と統合されています。

テストを書く

テストするクラスに移動して Ctrl+Shift+T を押します。ポップアップリストから新規テストの作成を選択します。

開いたダイアログで、すべてのフィールドに入力されているため、OK をクリックするだけです。PhpStorm はテストクラス <class_to_test>Test を生成してエディターで開きます。必要に応じてテストを書きます。

PhpStorm コーディングアシスタンスでテストを書くには、workshop/08_Testing/01_Writing_Tests.php を開き、コメントの指示に従ってください。

テストを起動する

テストでファイルをエディターで開くか、プロジェクトツールウィンドウでクリックして <class_to_test> テストを実行するを選択します。これにより、PhpStorm が自動的に生成した PHPUnit 実行構成が起動します。Behat、PHPSpec、または Codeception タイプの実行構成（実行 | 実行構成の編集）を作成し、それをツールバーのリストから選択して、をクリックすることもできます。PhpStorm は実行ツールウィンドウのテストランナータブの結果を示しています。

ステップ 9: ソースコードをバージョン管理下に置く

ソースコードをバージョン管理下に置いている場合は、PhpStorm が多くの一般的なバージョン管理システム（Git（または GitHub）、Mercurial、Perforce、Subversion）と統合されていることを知って喜ぶでしょう。特定の VCS に固有の資格情報と設定を指定するには、設定 / 環境設定ダイアログ Ctrl+Alt+S でバージョン管理に移動します。

Git メニューはあなたにどんなコマンドが利用可能かについての手がかりを与えるでしょう。例: Git ポップアップビュー（Git | Git ログを表示するまたは Alt+9 ）から、行った変更を確認したり、コミットしたり、変更リストを作成したりできます。

ステップ 10: 以上です ! 開発を楽しみましょう !

PhpStorm の基本的な機能の概要を紹介していただければ幸いです。開発者の生活をより簡単で楽しくするための重要な機能がたくさんあり、ソースコードはより洗練されたものになります。最初のいくつかのステップを今すぐ行い、ちょうどいいタイミングだと感じたら深く掘り下げてみてください。PhpStorm を楽しみましょう !

ご不明な点がございましたら、PhpStorm ディスカッションフォーラム、Twitter(英語)、ブログ(英語)にアクセスしてください。ニュース、アップデート、役立つヒントやコツを見つけることができます。また、問題が発生した場合は、サポートチーム）または PhpStorm 問題追跡(英語)システムに遠慮なく報告してください。

最終更新日: 2021 年 2 月 18 日

PhpStorm 2020.3 ヘルプ