PhpStorm 2020.3 ヘルプ

クイックスタートガイド

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 です。

システム要件

要件 最小 推奨
RAM2 GB の空き RAM8 GB の総システム RAM
ディスク容量 2.5 GB およびキャッシュ用にもう 1 GB5 GB 以上の空き容量がある SSD ドライブ
モニターの解像度 1024x7681920 × 1080
オペレーティングシステム

以下の公式にリリースされた 64 ビットバージョン：

  • Microsoft Windows 8 以降

  • macOS 10.13 以降

  • Gnome、KDE、または UnityDE をサポートする Linux ディストリビューション。

プレリリース版はサポートされていません。

 最新の 64 ビットバージョンの Windows、macOS、または Linux (たとえば、Debian、Ubuntu、RHEL などです。)

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

PHP 環境の設定

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

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

始める前に

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

  2. PhpStorm の設定 / 環境設定ダイアログ Ctrl+Alt+S で、ビルド、実行、デプロイ | Docker に移動し、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 プロジェクトを開始する

  1. PhpStorm ウェルカム画面で、新規プロジェクトをクリックします。

    ps_quick_start_welcome_screen_mac.png

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

    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 コマンドを実行してください。

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

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

PhpStorm user interface overview

  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 は、現在作業中のコンテキストを分析し、その分析に基づいてより正確な提案を提供して、式型に一致するように関数と変数のリストをフィルタリングします。

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

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

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

コードは存在しないファイルを参照していますか？ 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 を押して修正を適用します。

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

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 から実際のサンプルを試してみてください。

使用可能なインスペクションの完全なリストを表示するには、設定 / 環境設定ダイアログ 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 でより多くのライブ例を試してください。

ps_quick_start_generate_code_mac.png

ライブテンプレートを使用して （コード | ライブテンプレート挿入を選択するか 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 でより多くのライブ例を試してください。

ps_quick_start_surround_with_dialog_mac.png

ステップ 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 は 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 を開き、コメントの指示に従ってください。

    ps_quick_start_go_to_implementation_mac.png
ps_quick_start_local_history_mac.png

ステップ 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 を選択し、コンテキストメニューからデバッグ | 03_Breakpoints.php を選択します。

ps_quick_start_guide_start_debugging_session_mac.png

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

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

ステップ 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 buttonをクリックすることもできます。PhpStorm は実行ツールウィンドウのテストランナータブの結果を示しています。

Test runner tab.png

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

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

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

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

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

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

入門 PhpStorm ワークショップ資料

関連ページ：

PhpStorm のライセンス購入と登録

PhpStorm は最大 30 日間評価できます。その後、ライセンスを購入して登録する必要があります。早期アクセスプログラムの一部である PhpStorm のプレリリースビルドは登録を必要とせず、30 日間のライセンスで提供されます。次のいずれかを実行してライセンスダイアログを開きます。メインメニュ...

入門

PhpStorm のユーザーインターフェースはデフォルトでは英語です。日本語化する場合は、日本語言語パックのインストールを参照してください。PhpStorm に関する最も重要な情報源は、このオンラインヘルプです。PhpStorm からアクセスするには、次のいずれかを実行します。メインメニューからを選...

AMP パッケージをインストールする

AMP パッケージはオペレーティングシステム固有のものです。最も一般的なものは次のとおりです。Windows 用のXAMPP。使用されている Linux ディストリビューションと互換性のある LAMP パッケージ。macOS 用のMAMP。バージョン 1.7.1 以降を使用することをお勧めします。イ...

Docker

Dockerを使用すると、開発者はアプリケーションをコンテナー内にデプロイして、実稼働と同じ環境でコードをテストできます。PhpStorm は、Dockerプラグインを使用して Docker サポートを提供します。プラグインはバンドルされ、デフォルトで有効になっています。Dockerプラグインは P...

Vagrant: 再現可能な開発環境の使用

Vagrantは、仮想マシンのライフサイクルを管理するために使用されるコマンドラインユーティリティです。PhpStorm は、Vagrant との完全な統合を提供し、Vagrant 仮想環境の構成、仮想マシンの動作の制御、およびプロジェクト内からの Vagrant コマンドの実行を可能にします。Va...

PhpStorm ワークショップ資料

PhpStorm ワークショップ資料では、PhpStorm の多くの機能と生産性向上ツールについて説明します。PhpStorm のすべての可能なオプションと機能を網羅しているわけではありません。代わりに、PHP 開発者としての日常のワークフローを強化するための実践的な演習を多数提供します。以下にワー...