クイックスタートガイド
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 ビットバージョン:
プレリリース版はサポートされていません。 | 最新の 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 デーモンへの接続方法を選択します。
お使いのオペレーティングシステムに応じて、次の操作を行います。
TCP ソケットを選択します。
エンジン API URL を 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 には、ベーシックと type-matching の 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 を押し、クラスのインポートをクリックします:
リストで、インポートするクラスをクリックします。
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 ページに移動します。
CLI インタープリターリストから PHP 7.1 と Xdebug を選択してください。
ブレークポイントの設定
デバッグは、プログラムの実行が一時停止されるブレークポイントを配置することから始まります。これにより、プログラムデータを調べることができます。ブレークポイントを表示する行のガターをクリックするだけです。
自分でブレークポイントを操作するには、プロジェクトで workshop/06_Debugging/03_Breakpoints.php を開き、コメントの指示に従ってください。
デバッグを開始する
プロジェクトツールウィンドウで、workshop/06_Debugging/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 ポップアップビュー（または Alt+9 ）から、行った変更を確認したり、コミットしたり、変更リストを作成したりできます。
ステップ 10: 以上です ! 開発を楽しみましょう !
PhpStorm の基本的な機能の概要を紹介していただければ幸いです。開発者の生活をより簡単で楽しくするための重要な機能がたくさんあり、ソースコードはより洗練されたものになります。最初のいくつかのステップを今すぐ行い、ちょうどいいタイミングだと感じたら深く掘り下げてみてください。PhpStorm を楽しみましょう !
ご不明な点がございましたら、PhpStorm ディスカッションフォーラム、Twitter(英語)、ブログ(英語)にアクセスしてください。ニュース、アップデート、役立つヒントやコツを見つけることができます。また、問題が発生した場合は、サポートチーム）または PhpStorm 課題追跡(英語)システムに遠慮なく報告してください。
関連ページ：
PhpStorm のライセンス購入と登録 | PhpStorm
PhpStorm は最大 30 日間評価できます。その後、ライセンスを購入して登録し、引き続き製品を使用してください。次のいずれかを実行してライセンスダイアログを開きます。メインメニューからを選択します、ウェルカム画面で、をクリックします。、PhpStorm またはライセンスが必要なプラグインの登録方法を選択します。JB アカウント JetBrains アカウントを使用して登録します。JetBrains アカウントに二要素認証を使用している場合は、メインの JetBrains アカウントパスワード...
入門 | PhpStorm
PhpStorm に関する最も重要な情報源は、このオンラインヘルプです。PhpStorm からアクセスするには、次のいずれかを実行します。メインメニューからを選択します。キーボードのを押します。ダイアログまたはツールウィンドウでクリックします。オンラインヘルプを表示するためにインターネットにアクセスできない場合は、PhpStorm ヘルププラグインを使用できます。PhpStorm ヘルププラグインは、オフラインで使用するための内蔵 Web サーバーを介してヘルプページを提供します。サポートに...
AMP パッケージをインストールする | PhpStorm
AMP パッケージはオペレーティングシステム固有のものです。最も一般的なものは次のとおりです。macOS 用の MAMP。インストール手順は、使用しているオペレーティングシステムによって異なります。インストール手順に従ってください。AMP パッケージをインストールして構成する目的の AMP パッケージをダウンロードしてインストールします。AMP コントロールペインを使用してコンポーネントを起動します。Web サーバーが起動しない場合は、ポート競合が発生する可能性があります。デフォルトでは、Apac...
Docker | PhpStorm
Docker を使用すると、開発者は、本番環境と同じ環境でコードをテストするために、コンテナー内にアプリケーションをデプロイできます。PhpStorm は、Docker プラグインを使用して Docker サポートを提供します。プラグインはバンドルされており、デフォルトで有効になっています。Docker プラグインは PhpStorm にバンドルされており、デフォルトでアクティブ化されています。プラグインが無効になっている場合は、プラグインの管理の説明に従って、設定 / 環境設定 | プラグインページ...
Vagrant: 再現可能な開発環境の使用 | PhpStorm
Vagrant は、仮想マシンのライフサイクルを管理するために使用されるコマンドラインユーティリティです。PhpStorm は、Vagrant との完全な統合を提供し、Vagrant 仮想環境の構成、仮想マシンの動作の制御、およびプロジェクト内からの Vagrant コマンドの実行を可能にします。Vagrant を使用する場合、次の定義が満たされます。Vagrantfile: Vagrant 環境を定義し、仮想ボックスのすべての構成を格納し、仮想マシンの操作方法を Vagrant に指示するメイン...
WSL | PhpStorm
WSL（WSL 2）- Windows Subsystem for Linux - Windows 10 で Linux バイナリ実行可能ファイルをネイティブに実行するための互換性レイヤーです。現在、Ubuntu、OpenSUSE、SLES などのいくつかの Linux ディストリビューションをサポートしています。WSL を設定する Microsoft ストアから WSL ディストリビューション（Ubuntu など）をダウンロードしてインストールします。このステップでは、必ず最新の「Fall Cre...