PhpStorm 2018.1ヘルプ

クイック・スタート・ガイド

本セクション:

始める前に

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

PhpStormはどの言語をサポートしていますか？

PhpStormを使用すると、PHPバージョン5.3 / 5.4 / 5.5 / 5.6 / 7.0 / 7.1でアプリケーションを開発できます。さらに、HTML（HTML5を含む）、CSS、JavaScript、およびXMLを完全にサポートしています。これらの言語はプラグインを介してIDEにバンドルされており、デフォルトでオンになっています。その他の言語のサポートは、プラグイン（WindowsおよびLinuxの場合は設定 | 外観および振る舞い | プラグイン 、macOSの場合はPhpStorm | 環境設定 | 外観および振る舞い | プラグイン）を使用して追加したり、最初のIDEの起動時に設定することができます。

PhpStormを実行できるプラットフォームは何ですか？

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

PhpStormを開始するためのシステム要件は何ですか？

PhpStormを実行するには、最低1 GB RAM（2 GB RAM推奨）、最低1024 x 768の画面解像度が必要で、次のシステム要件に適合する必要があります。

WindowsmacOSLinux
Microsoft Windows 10/8/7 / Vista / 2003 / XP（64ビットを含む）macOS 10.5以上（10.10を含む） 64ビットmacOSのみがサポートされています。OS Linux 64ビット
KDE、GNOMEまたはUnity DEデスクトップ

JRE 1.8はすべてのプラットフォーム用のディストリビューションにバンドルされています。つまり、PhpStormを実行するためには、マシンにJavaをインストールする必要はありません。

PhpStormのインストールとセットアップのPhpStormの要件の詳細を確認してください。

PHP環境の設定

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

ローカルWebサーバーで作業する場合は、次のチュートリアルを使用して環境を準備します。

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

このクイック・スタート・ガイドでは、Vagrant インスタンスで事前設定されたプロジェクトを設定します: 始める前に：

  1. 公式サイトからOracle VirtualBox(英語)とVagrant(英語)をダウンロードしてインストールしてください。
  2. Vagrantページ（Windows / Linuxではファイル | 設定 | ツール | Vagrant、 macOSではPhpStorm | 環境設定 | ツール | Vagrant）で Vagrant 実行ファイルへのパスを指定してください。
詳細はPhpStormで Vagrant を使い始める(英語)を参照してください。

手順 1: PhpStormでプロジェクトを開く

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

このクイック・スタート・ガイドでは、既に Vagrantfileを含む事前設定のワークショッププロジェクトを提供しています。このプロジェクトはGZHubのhttps://github.com/JetBrains/phpstorm-workshop(英語)で利用可能です。

PhpStormでこのプロジェクトを開き、Vagrant環境を設定するには：

  1. ようこそ画面で、バージョン管理からチェック・アウトをクリックし、リストからGitHubを選択します。
  2. 開いているリポジトリーのクローンダイアログボックスで、 https://github.com/JetBrains/phpstorm-workshop をGit リポジトリー URLフィールドに入力し、プロジェクトの親ディレクトリーを選択します。 PhpStormは自動的にプロジェクトフォルダを作成し、提案された名前がディレクトリー名フィールドに表示されます。
  3. プロジェクトがクローンされた後、PhpStormはそれを開くことを提案します。プロジェクトを開き、メインメニューでツール | Vagrant | Vagrant アップを選択します。

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

ps_quick_start_welcome_screen_mac.png

手順 2: ユーザーインターフェースを調べる

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

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

手順 3: スマートアシスタンスによるコード

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

コード補完

コード補完は、作業しているファイルのタイプに関係なく、素晴らしい時間を節約します。 PhpStormにはコード補完の2種類があります：基本とスマートです。

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

ps_quick_start_basic_completion_mac.png
より多くのバリアントを表示するには、もう一度 Ctrl+Space を押します。

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

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

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

PhpStormはあなたが現在やっていることを見守り、より多くの時間を節約するために、インテンション・アクションと呼ばれるスマートな提案を行います。 インテンションアクションを使用すると、正しいのコードに自動変更を適用できます（間違っているかもしれないコードのクイックフィックスを提供するコードインスペクションとは対照的に）。

コードは存在しないファイルを参照していますか？

ps_quick_start_intention_action_1_1_mac.png
PhpStormの問題ではありません。 Alt+Enter を押してファイル<ファイル名>を作成します。を選択してください：インテンション（WindowsおよびLinuxではファイル設定 | エディター | インテンション、macOSではPhpStorm | 環境設定 | エディター | インテンション）で利用可能なインテンションアクションの全リストを参照してください。

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

手順 4: コードをきれいに保つ

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

PhpStormは、使用されていないコード、無限ループ、隠された上部スコープ、条件式の代入演算子 = 、およびおそらくあなたの注意を必要とする多くのものを見つけるたびに、電球を見るでしょう。それをクリックするか、 Alt+Enterを押して修正を適用します。

useの声明を忘れましたか？

ps_quick_start_inspection_mac.png
Alt+Enter を押し、クラスのインポートをクリックします：
ps_quick_start_import_class_popup_mac.png
リストで、インポートするクラスをクリックします。
ps_quick_start_quick_fix_choose_class_to_import_mac.png
PhpStormは、選択したクラスをインポートし、useステートメントを追加します。
ps_quick_start_quick_fix_class_imported_use_added.png
workshop/03_Inspections/02_Quick_Fixes.phpから実際のサンプルを試してみてください。

インスペクションページ（WindowsおよびLinuxでは設定 | エディター | インスペクション、macOSではPhpStorm | 環境設定 | エディター | インスペクション）で利用可能なインスペクションの全リストを参照してください。それらのいくつかを無効にしたり、他のものを有効にしたり、各インスペクションの重大度を調整することができます。それをエラーとみなすべきか、それとも単に警告すべきかを決定します。

手順 5: いくつかのコードを生成する

PhpStormで利用可能なコード生成オプションを使用すると、コードを書くのがずっと簡単で高速になります: コード | 生成メニュー（または単に Alt+Insert）は、コンストラクタ、ゲッター/セッター、PHPDocコメントの生成、およびいくつかのメソッド（Ctrl+O / Ctrl+I）のオーバーライド/実装を提案するのに役立ちます：

ps_quick_start_generate_code_mac.png
workshop/02_Editing/06_Generate_code/6.1_Generate_Code.phpから実際のサンプルを試してみてください。

ライブ・テンプレート（コード | ライブ・テンプレートの挿入を選択するか Ctrl+Jを押す）を使用して、コード構造全体を生成します。利用可能なライブテンプレートのリストは、ライブ・テンプレートページ（WindowsおよびLinuxではファイル | 設定 | エディター | ライブ・テンプレート、macOSではPhpStorm | 環境設定 | エディター | ライブ・テンプレート）で表示されます。開発に特に重要なことが必要な場合は、このテンプレートセットを独自のテンプレートで拡張してください。
workshop/04_Live_Templates/01_Code_Expansion/1.1_Code_Expansion.php と workshop/04_Live_Templates/02_Creating_Live_Templatesのライブサンプルを試してみてください。

また、周囲コードを完全な構造で検討してください。 コード | 囲むを選択するか、 Ctrl+Alt+Tを押してから、ポップアップリストから必要な文を選択します。

ps_quick_start_surround_with_dialog_mac.png
workshop/04_Live_Templates/03_Surround_Templates/3.1_Simple_template.phpから実際のサンプルを試してみてください。

ステップ6: 方法を見つける

プロジェクトが大規模な場合や、他の人が作成したコードを使用する必要がある場合は、探しているものをすばやく見つけてコードを掘り起こすことが不可欠です。このため、PhpStormには、どんなに複雑なコードであっても、どのようなコードでも自分の道を見つけるのに役立つ一連のナビゲーション機能が付属しています。

基本的な検索

プロジェクトで特定のシンボルが使われている場所を見つけるために、PhpStormは使用箇所の検索（Alt+F7）を使って本格的な検索を提案しています：

ps_quick_start_find_usages_mac.png
また、現在のファイル（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ウィンドウの右上隅にある魔法のガラスアイコン search_everywhere をクリックするか、 Shift を2回押します。検索パターンを指定しない場合、PhpStormは最新のファイルの一覧を表示し、関連する項目に移動することができます。
    ps_quick_start_search_everywhere_1.png
    特定のものを検索するには、検索パターンを入力します: シンボルの他に、どこでも検索はアクションを見つけることができます：
    ps_quick_start_search_everywhere_specify_pattern_mac.png
    どこでも検索モードでは、PhpStormはキャメルハンプを受け入れて、真ん中のマッチを認識します。

    どこでも検索を使用するさまざまな方法を試すには、プロジェクトで workshop/01_Navigation/01_Navigate_to_something_you_know/1.6_Search_everywhere.md を開き、指示に従います。

    もちろん、クラス（Ctrl+N）、ファイル（Ctrl+Shift+N）、またはシンボル（Ctrl+Shift+Alt+N）の名前でナビゲートすることもできます。クラス、ファイル、または名前によるシンボルへの移動を参照してください。

  • 宣言に移動（WindowsおよびLinuxの場合はCtrl+B、 Ctrl+Click 、macOSの場合は ⌘+Click ）は、特定のシンボルが最初に宣言された場所に移動します。このタイプのナビゲーションは、ソースコードの任意の場所から、別のクラスまたはコメントからでも機能します。

    宣言に移動をナビゲートするには、プロジェクトで workshop/01_Navigation/02_Navigate_to_Declaration/2.1_Go_to_declaration.php を開き、コメントの指示に従います。

  • 実装に移動（Ctrl+Alt+B）は、特定のクラスの実装にあなたをもたらします。いくつかの実装がある場合、PhpStormはそれらを関連するものを選択できるリストに表示します。
    ps_quick_start_go_to_implementation_mac.png

    実装に移動をナビゲートするには、プロジェクトで workshop/01_Navigation/04_Navigate_class_hieracrhies/4.1_Go_to_Implementation.php を開き、コメントの指示に従います。

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

PhpStormは、ローカル・ヒストリーのソースコードの変更、リファクタリングの結果などを自動的に追跡します。従来のバージョンコントロールシステムとは異なり、ローカル・ヒストリーは常に有効です。ファイルまたはフォルダを表示するには、メインメニューでVCS | ローカル・ヒストリー | ヒストリーの表示を選択します。変更内容を確認したり、元に戻したり（rollback.png）、パッチ（iconCreatePatch.png）を作成することができます。

ps_quick_start_local_history_mac.png

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

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

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

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

プロジェクトでは、Vagrantボックスには既にPHPインタプリタが含まれています。PhpStormにどこにあるのかを伝えるだけです。

  1. PHPページ（WindowsおよびLinuxでは設定 | 言語とフレームワーク | PHP、macOSではPhpStorm | 環境設定 | 言語とフレームワーク | PHP）を開き、CLI インタープリターフィールドの横にある browseButton をクリックします。
  2. 開いているCLIインタープリターダイアログで、左側のペインで add をクリックし、リストからDocker、Vagrant、VM、リモートから...を選択します。
  3. 開いているPHP リモートインタプリタの設定ダイアログで、Vagrantを選択します。 PhpStormはPHPインタプリタを検出し、検出されたインタプリタとXdebugのバージョンが表示されるCLI インタープリターダイアログに戻ります。それだけです.[OK]をクリックしてください。

ブレークポイントの設定

デバッグは、プログラムの実行を中断するブレークポイントを配置することから始まり、プログラムデータを探索することができます: ブレークポイントを表示させたい行の左のガターをクリックするだけです：

ps_quick_start_set_breakpoints_mac.png

ブレークポイントを自分で演奏するには、プロジェクトで workshop/06_Debugging/03_Breakpoints.php を開き、コメントの指示に従います。

デバッグを開始する

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

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

代替のデバッグシナリオについては、Xdebugによるゼロ設定デバッグ(英語)も参照してください。

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

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

テストを書く

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

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

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

テストを起動する

エディタでテストファイルを開くか、プロジェクトツールウィンドウでファイルをクリックし、<class_to_test>テストを実行するを選択します。 PhpStormが自動生成したPHPUnitの実行コンフィギュレーションを起動します。タイプBehat、PHPSpec、またはCodeceptionの実行コンフィギュレーション（実行 | 構成の編集）を作成し、ツールバーのドロップダウンリストから選択し、 run.pngをクリックすることもできます。 PhpStormは、実行ツール・ウィンドウのテストランナータブで結果を示します。

ps_quick_start_behat.png

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

ソースコードをバージョン管理下に置いておけば、PhpStormが多くの人気バージョン管理システム：Git（またはGitHub）、Mercurial、Perforce、TFS、SubversionおよびCVSと統合されていることを知ることができます。資格情報と特定のVCS固有の設定を指定するには、バージョン管理（WindowsおよびLinuxの場合は設定 | バージョン管理、macOSの場合はPhpStorm | 環境設定 | バージョン管理）にアクセスしてください。

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

ステップ 10: 以上です!先に進んで楽しみながら開発してください!

PhpStormの重要な機能の概要を簡単に紹介していただければ幸いです。開発者の生活をより簡単で楽しくし、ソースコードをきれいにする重要な機能はたくさんあります。これらの最初のいくつかのステップを今すぐ行い、次に時間が正しいと感じると深く掘り下げてください。 PhpStormをお楽しみください!

ご不明な点がございましたら、PhpStormディスカッションフォーラム(英語)、ツイッター(英語)、ブログ(英語)をご覧ください。ニュース、アップデート、便利なヒントをご覧いただけます。また、支援チームまたはPhpStorm 課題トラッカー(英語)に何か問題を報告することを躊躇しないでください。

最終変更日: 2018年6月1日
PhpStormのインストールとセットアップPhpStormワークショップ資料