クイックスタートガイド

サポートされる言語

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 でアプリケーションを開発できます。さらに、HTML5、CSS、JavaScript、および XML を完全にサポートしています。これらの言語のサポートは、IDE にバンドルされ、デフォルトで有効になっているプラグインを介して処理されます。他の言語のサポートは、プラグインを介して追加できます。設定 / 環境設定ダイアログ Ctrl+Alt+S で、プラグインに移動して詳細を確認するか、最初の IDE 起動時に設定します。

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

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

システム要件

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

PHP 環境の設定

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

• ローカル Web サーバーを使用する場合は、AMP パッケージをインストールする手順に従って環境を準備します。

• Docker コンテナーで作業する場合は、PhpStorm での Docker サポートを参照してください。

• Vagrant を使用する場合は、PhpStorm での Vagrant サポートを参照してください。

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

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

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

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

ようこそ画面から見ることができるように、PhpStorm でプロジェクトを開始するための他のオプションがあります。

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

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

1. メニューとツールバーは、さまざまなコマンドの実行に役立ちます。

2. プロジェクトをナビゲートするためのナビゲーションバー。

3. ステータスバーには、PhpStorm 全体、現在のプロジェクト、エディター内のファイル、警告、およびエラーメッセージに関するさまざまな情報が含まれています。

4. 実際にコードを書くエディター。開いているファイル間を簡単に移動するためのタブがあります。

5. さまざまな機能を実行する数多くのツールウィンドウ：プロジェクトやファイル構造の探索とナビゲーション、検索とインスペクションの結果の表示、アプリケーションの実行、デバッグ、テスト、インタラクティブコンソールでの作業などを手助けします。

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

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

コード補完

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

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

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

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

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

スマートコード補完を試すには、プロジェクトで 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 を押して修正を適用します。

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

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

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

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

アプリケーションは、意図されているものとまったく同じですか？そうでない場合は、問題の原因を突き止めるためにデバッグを行う必要があります。幸いにも、私たちのサンプルプロジェクトには既に 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> テストを生成してエディターで開きます。必要に応じてテストを書きます。

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 をバージョン管理に移動します。

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

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

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

ご不明な点がございましたら、PhpStorm ディスカッションフォーラム(英語)、twitter(英語)、ブログ(英語)にアクセスしてください。ニュース、更新、役立つヒントやコツを見つけることができます。また、サポートチームや PhpStorm の課題トラッカー(英語)に課題を報告することをためらわないでください。