一般的なデプロイの問題のトラブルシューティング

デプロイが遅いか、失敗する

デプロイは、特にプロジェクトまたはデプロイサーバーに多くのディレクトリとファイルが含まれている場合、リソースを大量に消費する操作になる可能性があります。 設定 ダイアログ (Ctrl+Alt+S) で、 ビルド、実行、デプロイ に移動し、デプロイを高速化できる次の構成オプションを調べます。

• 不要なディレクトリをデプロイから除外します（たとえば、images）。 これは デプロイ: 除外されたパスタブ ページから行うことができます。

• オプションページで、 最新のファイルを上書きする をクリアして、アップロードする必要がないファイルのアップロードをスキップします。

• サーバーによっては、アドバンスト FTP 設定でのアクティブ転送モードとパッシブ転送モードの切り替えが役立ちます。 これは、サーバーの デプロイ: 接続タブで パッシブモード を切り替えることで実行できます。

ファイル転送が応答しなくなる

これは、PhpStorm が IPv6(英語) を介して IPv4(英語) ホストを解決しようとした場合に発生する可能性があります。 デフォルトでは、PhpStorm は受信 IPv4 接続のみを listen します。 IPv6 が無効になっていることを確認するには、PhpStorm JVM オプションを確認します。

ダウンロード / アップロードアクションは利用できません

マッピングがないため、ダウンロード/アップロードアクションを利用できない場合があります。 ダウンロードするファイルまたはフォルダーがどのマッピングにも設定されていない場合、PhpStorm はそれをダウンロードしません。 マッピングは 3. プロジェクトフォルダーをサーバーフォルダーと URL パスにマップする で説明されているように設定できます。

一部のアクションでは、 設定 ダイアログの デプロイ ページでデフォルトのデプロイサーバーを選択する必要があります。

一部のフォルダーはデプロイされません

デプロイされていないフォルダーの一般的な原因は、明示的に除外されている場合です。 これを解決するには、 リモートホストツールウィンドウ で指定のフォルダーを右クリックし、コンテキストメニューから パスを除外対象から除去 を選択します。 これが完了すると、フォルダーがデプロイされます。

これは、 設定 ダイアログ (Ctrl+Alt+S) の デプロイ ページからも設定できます。 サーバーの 除外対象パス タブを開き、除外されたパスを削除します。 ソースフォルダーとターゲットフォルダーの両方をチェックする必要があることに注意してください。 オプションページの 項目を名前で除外 で、フォルダーを名前で除外することもできます。

プロジェクト間でのデプロイ構成の共有

デプロイサーバーは IDE レベルで設定されます。すべてのプロジェクトで利用でき、プロジェクト間で共有できます。

プロジェクト間で共有されるのは、名前と (デプロイ: 接続タブ タブで指定された) 接続詳細のみです。マッピングと除外パスはプロジェクト固有であり、個別に設定する必要があります。 この方法を使用すると、接続詳細を一度だけ入力すればよく、接続詳細を共有しながら、マッピングと除外パスをプロジェクトごとに設定できます。 プロジェクトが同じデプロイサーバーを共有し、同じ接続設定を使用する場合に便利です。 プロジェクト間で接続設定が異なる場合は、プロジェクトごとに個別に設定する必要があります。

必要に応じて、 デプロイ: 接続タブの このプロジェクトでのみ表示する チェックボックスを選択することにより、単一のプロジェクトでサーバーが表示されるように設定できます。

IDE 設定ではマッピングを設定できません

デフォルトの新しいプロジェクト設定は、新しいプロジェクトのデフォルト設定を構成するために使用され、現在開いているプロジェクトには影響しません。 現在のプロジェクトの設定を構成するには、 設定 ダイアログ Ctrl+Alt+S を使用します。

同じフォルダー内のサブフォルダーに異なるデプロイ設定を指定できますか？ ローカルフォルダーを複数の場所にデプロイできますか？

フォルダーをアップロードしてマッピングを構成するときは、次の点に注意してください。

• 特定のフォルダーのマッピングをデプロイサーバー上の異なるパスに指定できます。 これは、サーバーの デプロイ: マッピングタブ で設定できます。

• 特定のフォルダーとファイルをアップロード / ダウンロードから除外することができます。 これは、サーバーの デプロイ: 除外されたパスタブ で設定できます。

• 同じフォルダー（または複数のサブフォルダー）を異なるサイトに一度にアップロードすることはできません。 個別のデプロイ構成を作成し、各サイトに 1 つずつアップロードする必要があります。

これが必要な場合は、 デプロイ先と同期 ... コマンドを使用して、アップロードごとに使用可能なデプロイサーバーから選択できます。

マイサーバーに配置して同期メニュー項目にキーボードショートカットを割り当てることができません

キーボードショートカットを <サーバー名> にデプロイされたものと同期 コマンドに直接割り当てることはできません。汎用の デプロイ先と同期 ... コマンドにのみ割り当てることができ、その後、サーバーの一覧を含むポップアップメニューが表示されます。 詳細については、「Web サーバーに接続する 」を参照してください。

特定のデプロイサーバーにキーボードショートカットを割り当てる場合は、マクロを記録して代わりにショートカットを割り当てることができます。

PhpStorm を使用してデータベースをデプロイするにはどうすればよいですか？

PhpStorm を使用してデータベースをデプロイするには、いくつかの方法があります。

• 統合データベースツールを利用して、必要な DDL および SQL ステートメントを手動で実行します。

• Phing を操作して DBDeploy タスクを設定します(英語)。

アップロードが行われる前に、ファイル上でスクリプトや実行ファイルを実行できますか？

CSS の縮小 、イメージの最適化、 IonCube(英語) を使用した PHP ファイルのエンコードなどは、アップロードが行われる前に実行する必要のあるアクションです。 これを行うための最良のアプローチは、アップロードの開始時ではなく、PhpStorm の File Watchers を使用して、ファイルが変更されたときに実行することです。 デプロイサーバーにアップロードするときが来たら、代わりに処理済みファイルをアップロードします。

これが機能するには、 オプションページで 外部変更をスキップする チェックボックスをオフにする必要があることに注意してください。

ファイルが自動的にアップロードされないことがある

デフォルトでは、PhpStorm はいくつかの外部プロセス（VCS、transpiler など）によってファイルが変更された場合にそれらのファイルをアップロードします。 ファイルがアップロードされていない場合は、 オプションページの 変更されたファイルのデフォルトサーバーへの自動アップロード が 常に実行 に設定され、 外部変更をスキップする チェックボックスがオフになっていることを確認してください。

デプロイ前またはデプロイ後のアクションを実行できますか？

実行/デバッグ構成を使用すると可能です。 ダミーの実行/デバッグ構成、または最後のステップにする実行/デバッグ構成を作成し、 Before launch の下に必要なステップを追加できます。

代わりに、複雑な一連の手順を実行するには、Phing またはその他のビルドシステムを使用することをお勧めします。

FTP の問題: 無効な子孫ファイル名 "http:"

デプロイサーバーが構成されている場合、またはプロジェクト設定で 接続のテスト ボタンを使用している場合、 無効な子孫ファイル名 "http:" エラーが表示されます。 名前にコロン : が含まれるすべてのファイル名は無効とみなされます。

これは、プロジェクト内に http: という名前を含むファイルが存在する場合に発生する可能性があります。 PhpStorm が FTP 接続に使用するライブラリ（Apache Commons VFS）は、そのようなファイルを含むフォルダーの内容を読み取ることができないため、操作が失敗します。 唯一の解決策は、 http: という名前を含むファイルをプロジェクトから削除することです。

PhpStorm はサーバーに接続しているようですが、ファイルを一覧表示したり、アップロードを実行したりできません

これは、デプロイサーバーがいわゆるパッシブ FTP 接続を必要とするためです。 このモードを設定するには、選択したサーバーの デプロイ: 接続タブの パッシブモード チェックボックスを選択します。

Git checkout を使用してブランチを変更するときのファイルのデプロイ

Git checkout を使用してブランチを切り替えるときにファイルをデプロイするには、いくつかの方法があります。

• 1 つの方法は、ファイルと外部の変更を常にアップロードするようにデプロイを設定することです。 これを行うには、 オプションページで 変更されたファイルのデフォルトサーバーへの自動アップロード を 常に実行 に設定し、 外部変更をスキップする チェックボックスをオフにします。 ブランチを切り替えると、すべてのファイルがサーバーにアップロードされます。

• git-ftp(英語) を使用してください。 最小のアップロードを実行し、ファイルとディレクトリの削除をミラーリングすることもできます。

PhpStorm は FTPS サーバーとの接続を確立できません

FTPS サーバーが TLS1.0 /TLS 1.1 を使用するように構成されている場合、PhpStorm はそれに接続できず、次のエラーメッセージが表示されます。

これは、PhpStorm が TLS 1.2 以降を使用したサーバーへの接続をサポートしているためです。 これらのプロトコルは 非推奨とされ、安全でないと見なされるため、TLS 1.0 および TLS 1.1 の使用はサポートされていません。

回避策として、PhpStorm JVM オプションを調整することにより、TLS 1.0 /TLS1.1 サポートを有効にすることができます。 古いプロトコルを使用すると、環境にセキュリティリスクが発生する可能性があり、発生する可能性があり、最後の手段と見なされることに注意してください。