PhpStorm 2018.3ヘルプ

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

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

サポートされる言語

PhpStormを使用すると、PHPバージョン5.3 / 5.4 / 5.5 / 5.6 / 7.0 / 7.1 / 7.2 / 7.3でアプリケーションを開発できます。さらに、HTML5、CSS、JavaScript、およびXMLを完全にサポートしています。これらの言語は、プラグインを介してIDEにバンドルされており、デフォルトで有効になっています。プラグインを使用して他の言語のサポートを追加することができます(設定/環境設定ダイアログ(Ctrl+Alt+S)でプラグイン にアクセスして詳細を調べるか、最初のIDE起動時に設定してください)。

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

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

PhpStormシステム要件

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

32-bit or 64-bit versions of Microsoft Windows 10, 8, 7 (SP1), or Vista (SP2)
macOS 10.8.3 or later (only 64-bit systems are supported)
OS Linux(32ビットJDKはバンドルされていないため、64ビットシステムを推奨します)。KDE、Gnome、またはUnityデスクトップ環境を推奨します。

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

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

PHP環境の設定

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

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

始める前に

  1. ご使用のオペレーティング・システム用のDockerをインストールする(英語)

  2. PhpStormでは、設定/環境設定ダイアログ(Ctrl+Alt+S)を開きます。

  3. ビルド、実行、デプロイ | Dockerに移動し、Dockerデーモンへの接続方法を選択します。

    お使いのオペレーティングシステムに応じて、次の操作を行います。

    • TCP ソケットを選択します。

    • エンジン API URLtcp://localhost:2375に設定します。

    • 証明書フォルダーフィールドは空のままにします。

    • Mac用Dockerを選択します。

    • Unixソケットを選択します。

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

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

In this クイック・スタート・ガイド , we provide a workshop project that already contains a docker-compose.yml file with the pre-configured environment. The project is available on GitHub at https://github.com/JetBrains/phpstorm-workshop(英語) .

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

  1. PhpStormようこそ画面で、新規プロジェクトの作成をクリックします。

    ps_workshop_materials_welcome_screen.png
  2. 左側のリストからPhpStorm ワークショップ・プロジェクトを選択し、ロケーションフィールドにプロジェクトの場所を入力して、作成をクリックします。

    ps_workshop_materials_create_workshop_project_from_new_project_dialog.png
  3. エディタで 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>
  4. 同じ docker-compose.yml ファイルで、オペレーティングシステムに応じて、 sftp サービスの適切な行のコメントを外します。これは、デプロイが正常に動作するために必要です。

  5. エディタガターで Start services button をクリックして、必要なDockerコンテナをすべて開始します。

    Start containers button

    または、内蔵PhpStorm端子(Alt+F12)を開いて docker-compose up コマンドを実行してください。

ようこそ画面から見ることができるように、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ファイルでこれらの機能をインタラクティブに試すことができます。

コード補完

コード補完 is a great time-saver regardless of the type of the file you’re working with. There are two types of code completion in PhpStorm: basic and smart.

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

ps_quick_start_basic_completion_mac.png
より多くのバリアントを表示するには、もう一度 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 keeps an eye on what you are currently doing and makes smart suggestions, called intention actions, to save more of your time. Intention actions let you apply automatic changes to the code that is 正しい (in contrast to code inspections that provide quick-fixes for code that 間違っているかもしれない ).

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

ps_quick_start_intention_action_1_1_mac.png

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

さまざまなインテンション・アクションを試すには、プロジェクトで 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から実際のサンプルを試してみてください。

To view the full list of available inspections, in the 設定/環境設定 dialog ( Ctrl+Alt+S ) go to エディター | インスペクション . You can disable some of them, or enable others, plus you can adjust the severity of each inspection. You decide whether it should be considered an error or just a warning.

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

Writing code can be a lot easier and faster with the code generation options available in PhpStorm. コード | 生成 menu (or just Alt+Insert ) will help you with generating constructors, getters/setters, PHPDoc comments as well as suggest overriding/implementing some methods ( Ctrl+O / Ctrl+I ). Try more live examples in workshop/02_Editing/06_Generate_code/6.1_Generate_Code.php

ps_quick_start_generate_code_mac.png

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

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

Also, consider surrounding your code with complete constructs. Choose コード | 囲む or press Ctrl+Alt+T , then choose the required statement from the pop-up menu. Try more live examples in workshop/04_Live_Templates/03_Surround_Templates/3.1_Simple_template.php

ps_quick_start_surround_with_dialog_mac.png

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

When your project is big, or when you have to work with the code written by someone else, it’s vital to be able to quickly find what you are looking for and dig into the code. This is why PhpStorm comes with a set of navigation features that will help you find your way through code.

基本的な検索

プロジェクトで特定のシンボルが使われている場所を見つけるために、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+BCtrl+Click 、macOSの場合は ⌘+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 を開き、コメントの指示に従います。

    ps_quick_start_go_to_implementation_mac.png

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

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

ps_quick_start_local_history_mac.png

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

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

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

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

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

  1. 設定/環境設定ダイアログ(Ctrl+Alt+S)で、言語とフレームワーク | PHPに移動します。

  2. 開いているPHPページで、CLI インタープリターリストからPHP 7.1とXdebugを選択します。

ブレークポイントの設定

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

ps_quick_start_set_breakpoints_mac.png

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

デバッグを開始する

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

ps_quick_start_guide_start_debugging_session_mac.png

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

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

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

PhpStormは、最も一般的なPHPテストフレームワーク(PHPUnitBehatPHPSpecCodeceptionなど)と統合されています。

テストを書く

テストするクラスに移動し、 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の実行コンフィギュレーションを起動します。タイプBehatPHPSpec、またはCodeceptionの実行コンフィギュレーション(実行 | 構成の編集)を作成し、ツールバーのドロップダウンリストから選択し、 Run buttonをクリックすることもできます。PhpStormは、実行ツール・ウィンドウテストランナータブで結果を示します。

ps_quick_start_behat.png

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

If you are keeping your source code under version control, you will be glad to know that PhpStorm integrates with many popular version control systems: Git (or GitHub), Mercurial, Perforce, TFS, Subversion and CVS. To specify credentials and any settings specific to a particular VCS, in the 設定/環境設定 dialog ( Ctrl+Alt+S ) go to バージョン管理 .

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

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

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

With any questions please visit our PhpStormディスカッションフォーラム(英語) , ツイッター(英語) , and ブログ(英語) , where you can find news, updates, and useful tips and tricks. Also, don't hesitate to report any problems to our support team) or the PhpStorm 課題トラッカー(英語) .

最終更新日: 2018年12月14日