本ページでは、ImageFlux におけるパスパラメータの役割や解釈ルールについて説明します。
基本ルール
ImageFlux はリクエスト URL を先頭から順に解析し、
/c
/c!
パスパラメータ(Base Prefix)
変換パラメータ(例:
w=400)
を判定します。
URL パスの先頭が上記のいずれかに一致する場合、その部分を ImageFlux 用の情報として解釈します。
上記のいずれにも一致しない場合は、その時点からオリジンへのリクエストパスとして扱います。
例
/c!/w=400/example.jpg
→ /c! とw=400は ImageFlux 用の情報として解釈され、example.jpg はオリジンへのリクエストパスとして扱われます。
パスパラメータについて
パスパラメータは、特定のURLパスに対して変換パラメータやオリジンへのリクエストパスをあらかじめ定義できる機能です。
例えば、/small/というパスに「幅200pxに縮小する」といった変換設定を登録しておくことで、URLごとに変換パラメータを記述しなくても、決まった変換結果を配信できます。
パスパラメータを利用すると、変換パラメータをURLに記述する代わりに、ImageFlux側であらかじめ定義できます。
これにより、URLをシンプルにできるほか、変換内容をImageFlux側で一元管理できるため、アプリケーション側の修正を行わずに変換設定を変更できます。
設定項目
パスパラメータは、以下の組み合わせで構成されます。詳細は、ドキュメントも参照ください。
| Base Prefix | パラメータを指定するパスのプレフィックス オリジンにリクエストする際、マッチしたプレフィックスは取り除かれます。 |
|---|---|
| Target Prefix | オリジンから取得する際に利用するパスのプレフィックス |
| Parameter | 指定する変換パラメータ 「URLによるパラメータの上書き・変更を許可しない」にチェックをいれるとURLへの変換パラメータ指定を抑止します。 |
オリジン設定画面でオリジンごとに追加できます。また、パスパラメータは複数設定することができます。
例1:Target Prefix なし
| Base Prefix | small |
|---|---|
| Target Prefix | なし |
| Parameter | w=700,a=0,u=0,q=80 |
上記の場合、https://p1-XXXXXXXX.imageflux.jp/small/example.jpgは
内部的に https://p1-XXXXXXXX.imageflux.jp/w=700,a=0,u=0,q=80/example.jpgのリクエストと同等の変換設定として解釈されます。
example.jpg がオリジンサーバーへのリクエストパスとして使用されます。
例2: Target Prefix あり
| Base Prefix | small |
|---|---|
| Target Prefix | images |
| Parameter | w=700,a=0,u=0,q=80 |
上記の場合、https://p1-XXXXXXXX.imageflux.jp/small/example.jpgは
内部的に https://p1-XXXXXXXX.imageflux.jp/w=700,a=0,u=0,q=80/images/example.jpgのリクエストと同等の変換設定として解釈されます。
images/example.jpgがオリジンサーバーへのリクエストパスとして使用されます。
個別パラメータの優先
パスラメータで以下が設定されている場合、
| Base Prefix | small |
|---|---|
| Target Prefix | 設定なし |
| Parameter | w=300,a=0,u=1,f=webp |
https://p1-XXXXXXXX.imageflux.jp/w=700,a=0,u=0,q=80/small/example.jpg
へアクセスすると、URL上の変換パラメータが優先されます。
結果としてhttps://p1-XXXXXXXX.imageflux.jp/w=700,a=0,u=0,q=80,f=webpとして解釈されます。
※上記は「URLによるパラメータの上書き・変更を許可しない」が無効な場合の例です。
オリジン画像パスが変換パラメータと同じ形式の場合
オリジン側に/w=100/image.jpgのような ImageFlux の変換パラメータ形式と同様のパスが存在する場合、
先頭のw=100が変換パラメータとして解釈される可能性があります。
このようなパスを変換パラメータとして解釈させず、そのままオリジンコンテンツを取得したい場合は、専用のパスパラメータを用意することで実現可能です。
| Base Prefix | through (*例) |
|---|---|
| Target Prefix | 設定なし |
| Parameter | 設定なし |
上記の場合、https://p1-XXXXXXXX.imageflux.jp/through/w=100/image.jpgへリクエストすると、ImageFlux は through をパスパラメータとして解釈し、
オリジンサーバー上のw=100/image.jpgを取得します。
その結果、/w=100/image.jpgを変換パラメータとして解釈することなく、オリジンコンテンツをそのまま返却できます。
パスパラメータの適用ルール
複数のパスパラメータが設定されている場合、ImageFlux は URL パスに対して最長一致 (Longest Prefix Match)となる Base Prefix を適用します。
例:以下のパスパラメータが設定されている場合
パスパラメータ1
| Base Prefix | small |
|---|---|
| Parameters | w=300 |
パスパラメータ2
| Base Prefix | small/webp |
|---|---|
| Parameters | f=webp |
https://p1-XXXXXXXX.imageflux.jp/small/webp/example.jpgに対しては、/small/webp/が最長一致となるため、f=webpが適用されます。
Base Prefixが未設定の場合
Base Prefix を未設定(空文字)としたパスパラメータは、URL が他の Base Prefix に一致しない場合にフォールバックし適用されます。
例:以下のパスパラメータが設定されている場合
パスパラメータ1
| Base Prefix | (未設定) |
|---|---|
| Parameters | q=80 |
パスパラメータ2
| Base Prefix | small |
|---|---|
| Parameters | w=300 |
この場合、https://p1-XXXXXXXX.imageflux.jp/images/example.jpgに対しては、q=80が適用されます。
一方でhttps://p1-XXXXXXXX.imageflux.jp/small/example.jpgに対してはw=300が適用されます。
URLで変換パラメータを指定した場合
Base Prefix 未設定のパスパラメータは、URLで変換パラメータを指定した場合にも適用されます。
例
| Base Prefix | (未設定) |
|---|---|
| Parameters | q=80 |
https://p1-XXXXXXXX.imageflux.jp/w=700/example.jpgの場合、パラメータ w=700,q=80が適用されます。