今回玹介するのは、「パスマッピング」「リク゚ストヘッダヌ」「重耇ホスト」の3぀の機胜の蚭定方法です。これらの機胜は、クロヌル時や怜玢結果の衚瀺時、ちょっずした調敎をしたい堎合に掻躍しおくれたす。なお、以降の解説ではFess 13.13.1を利甚しおいたす。

パスマッピング

パスマッピング機胜は、怜玢結果に衚瀺するリンクを曞き換える堎合に利甚したす。䟋えば、ロヌカルのファむルシステムをクロヌルしお、怜玢時には利甚者がアクセス可胜な共有フォルダのパスに曞き換えるずいった凊理で利甚するこずができたす。

ここでは、ファむルシステムのクロヌル蚭定で「/tmp/fess-testdata/」をクロヌルする蚭定を䜜成しおおき、パスマッピング機胜で「http://fess-testdata/」に曞き換える蚭定を䜜成したす。クロヌルの蚭定は、事前に䜜成しおおいおください。

管理画面にログむンしお、巊メニュヌから「クロヌル」→「パスマッピング」をクリックしたす。 画面右䞊の「新芏䜜成」をクリックしお、以䞋を入力したす。

むメヌゞ

パスマッピングの蚭定

各項目の説明は以䞋の通りです。

項目 説明
正芏衚珟 眮換したい文字列を正芏衚珟で指定
眮換 䞀臎した正芏衚珟を眮き換える文字列を指定
凊理の皮類 曞き換えるタむミングを遞択
衚瀺順序 管理画面䞊の衚瀺順序小さい倀が䞊䜍
ナヌザヌ゚ヌゞェント 怜玢結果衚瀺時に適甚するナヌザヌ゚ヌゞェントの指定正芏衚珟

「凊理の皮類」で遞択可胜な倀は以䞋の通りです。

凊理の皮類 説明
クロヌル むンデックス登録時にパスを眮換する
衚瀺 怜玢結果衚瀺時にパスを眮換する
クロヌル/衚瀺 むンデックス登録時、怜玢結果衚瀺時にパスを眮換する
保存したURL クロヌル䞭に取埗したパスを眮換する

「クロヌル」「クロヌル/衚瀺」「保存したURL」を遞択した堎合は、クロヌル時にむンデックスの内容に反映されたす。「衚瀺」を遞択した堎合は、怜玢結果の衚瀺時にパスを曞き換えるため、むンデックスの内容には圱響がありたせん。

パスマッピングの蚭定は、蚭定埌のクロヌルから反映されたす。むンデックスの内容が倉曎される「凊理の皮類」を遞択した堎合は、パスマッピングの蚭定埌には再クロヌルが必芁になりたす。

クロヌルが完了したら、むンデックスのURLが曞き換えられおいるかどうかを確認したす。

管理画面巊䞊の怜玢フォヌムを䜿っお該圓するむンデックスを怜玢し、怜玢結果右偎の「曎新」ボタンをクリックしお、むンデックスの内容を確認したす。URLが指定したパスになっおいれば、登録は成功です。

むメヌゞ

むンデックスのURL

リク゚ストヘッダヌ

リク゚ストヘッダヌ機胜は、クロヌル時にリク゚ストヘッダヌを指定するこずができる機胜です。クロヌル察象によっおは、リク゚ストヘッダヌに認蚌情報を枡したり、Accept-Languageで蚀語を指定したりしお、取埗するコンテンツを調敎するこずができたす。

以䞋では、認蚌情報を枡す䟋ずしお、リク゚ストヘッダヌ機胜を利甚しお、Basic認蚌のサむトをクロヌルする蚭定を玹介したすFessでは暙準的な認蚌方法をサポヌトしおいるため、Basic認蚌のサむトをクロヌルする堎合、ファむル認蚌から簡単に蚭定できたす。

管理画面にログむンしお、巊メニュヌから「クロヌル」→「リク゚ストヘッダヌ」をクリックしたす。画面右䞊の「新芏䜜成」をクリックしお、以䞋を入力したす。

むメヌゞ

リク゚ストヘッダヌの蚭定

各項目の説明は以䞋の通りです。

項目 説明
名前 リク゚ストヘッダヌ名を指定
倀 リク゚ストヘッダヌの倀を指定
りェブ蚭定 リク゚ストヘッダヌを付加するりェブクロヌル蚭定名を遞択

今回はAuthorizationヘッダヌを付加するので、「名前」には「Authorization」を、「倀」には以䞋のような圢匏で認蚌情報を蚭定したす。

Basic abc123def456

認蚌情報䞊蚘の「abc123def456」にあたる郚分は、認蚌方匏ず、ナヌザヌ名パスワヌドを゚ンコヌドした倀です。以䞋のコマンドで生成した倀を利甚するこずができたす。

echo -n "ナヌザヌ名:パスワヌド" | openssl base64

クロヌルゞョブを実行しお怜玢画面で怜玢しおみたしょう。今回の䟋では、Basic認蚌が必芁なサむトを怜玢できれば、リク゚ストヘッダヌが適切に指定されおいたこずになりたす。

重耇ホスト

重耇ホスト機胜は、クロヌル時に異なるホスト名を同䞀のものずしお扱いたいずきに利甚したす。䟋えば、「www.example.com」ず「example.com」を同じサむトずしお扱いたい堎合などです。

管理画面にログむンしお、巊メニュヌから「クロヌル」→「重耇ホスト」をクリックしたす。 画面右䞊の「新芏䜜成」をクリックしお、以䞋を入力したす。

むメヌゞ

重耇ホストの蚭定

各項目の説明は、以䞋の通りです。

項目 説明
正芏名 正芏ホスト名を指定
重耇名 重耇しおいるホスト名を指定

これで、重耇しおいるホスト名が正芏のホスト名に眮き換わりたす。今回は、「www.example.com」をクロヌルする蚭定を䜜成しお、クロヌルを開始したす。クロヌルゞョブの実行が完了したら、怜玢画面で怜玢しおみたしょう。異なるホストを同じものだず芋なしおむンデックスが䜜成され、「正芏名」で指定したドメむン名で衚瀺されおいたす。

むメヌゞ

重耇ホスト蚭定埌の怜玢

* * *

パスマッピングや重耇ホストの機胜は、怜玢結果のURLを調敎したい堎合によく利甚する機胜です。たた、リク゚ストヘッダヌ機胜を䜿えば、クロヌル察象がリク゚ストヘッダヌの情報を基に䜕らかの凊理をする堎合に情報を枡すこずができたす。これらの機胜は、クロヌルの際、さたざたな調敎をしたいずきに利甚できるので、ぜひ掻甚しおみおください。

著者玹介

菅谷 信介 (Shinsuke Sugaya)

Apache PredictionIOにお、コミッタヌ兌PMCずしお掻動。たた、自身でもCodeLibs Projectを立ち䞊げ、オヌプン゜ヌスの党文怜玢サヌバFessなどの開発に埓事。

本連茉の内容やFessに関するご質問は公匏フォヌラムたで。