フレンドリーURLの競合チェック
Liferay DXP 2026.Q3+
サーバー管理パネルには、インスタンスのフレンドリー URL の競合をスキャンする フレンドリー URL タブが含まれています。 /web フラグメントを公開フレンドリー URL から削除する前に、 layout.friendly.url.public.servlet.mapping.enabled portal プロパティを false に設定してチェックを実行します。
/web フラグメントは、公開サイトの URL とページの URL を区別するため、これを削除すると、以前は曖昧ではなかったフレンドリー URL が露呈する可能性があります。 このチェックは競合を報告し、それらを優先的に解決できるようにします。
-
コントロール パネル → システム → サーバー管理に移動し、 フレンドリー URL タブをクリックします。
-
をクリックしてチェックを実行 します。 最初の実行後、ボタンのラベルが もう一度チェックを実行 に変わります。
-
結果を確認する：
-
競合が存在しない場合は、成功メッセージが表示されます:
競合は見つかりませんでした。 一般ユーザー向けのURLマッピングは安全に無効にできます。プロパティをfalseに設定できます。 -
競合が存在する場合、検出された番号を示す警告メッセージが表示され、その後に競合の一覧表が表示されます。 プロパティを
falseに設定する前に、すべての競合を解決してください。
-
問題のない結果が出たとしても、すべての紛争が排除されるわけではない。 デフォルト以外のサイト間のクロスサイト競合および自己競合は評価されないため、複数のサイトを持つインスタンスでは、それらを手動で確認してください。
紛争表の読み方
各行は、1つのフレンドリーURLの競合を表しています。
| 列 | Description |
|---|---|
| パス | 矛盾するフレンドリーURL。 |
| 主題 | 競合するオブジェクトの種類とタイトル（例：ページ）。 |
| タイプ | 紛争の種類。 下記のリストをご覧ください。 |
| 競合する | 該当する場合、関係する他のサイトの名称。 それ以外の場合はダッシュ。 |
「タイプ」列には、次の3種類の競合のうちの1つが表示されます。
-
クロスサイト: デフォルトサイトページのフレンドリー URL が、別のサイトのトップレベルのフレンドリー URL と一致します。
/webを削除すると、2 つの URL は同一になります。 -
予約済みキーワード: フレンドリー URL は、
sites.friendly.url.keywordsポータル プロパティの予約済みシステム パスのいずれかと一致します。たとえば、web、group、またはdocumentsなどです。*で終わるエントリはプレフィックスで一致するため、/api-docsというフレンドリー URL はapi*キーワードと競合します。 -
自身: デフォルトサイトページのフレンドリーURLは、そのサイトのトップレベルのフレンドリーURLと一致します。
/webを削除すると、URL がサイトを指すのか、そのページを指すのかが曖昧になります。
予約済みキーワードの競合は、各サイトのフレンドリーURLとデフォルトサイトのページ全体でチェックされます。 クロスサイト競合と自己競合は、デフォルトサイトのページに対してのみチェックされます。
Gogo Shell からチェックを実行する
また、 Gogo シェル から friendlyURL:checkPublicMappingConflicts コマンドを使用してこのチェックを実行することもできます。 引数を指定しない場合、このコマンドはシステム内のすべての会社（インスタンス）をチェックします。 単一のインスタンスをチェックするには、 companyId 引数を渡します。