ImageFlux

パスパラメータについて詳しく知りたい

対象プラン

ImageFlux

本ページでは、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が適用されます。

本ページでは、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が適用されます。

お問い合わせ

上記をご確認いただいても問題が
解決しなかった場合、
下記リンク先よりお問い合わせください。

お問い合わせはこちら