画像の保存先と配信方法
画像ファイルは SQLite データベースとは別に保存します. app.assets.public_dir は公開可能な派生画像の保存先, app.assets.private_dir はオリジナル画像とフルサイズ画像の保存先です. 既定値はそれぞれ assets/public と assets/private で, 相対パスはアプリケーションホームを基準に解決されます.
画像の種類
- オリジナル画像はアップロードされたバイト列を保持し, 非公開領域に保存します.
- フルサイズ画像はオリジナルの画素寸法を保った派生画像で, 非公開領域に保存します.
- サムネイル, 表示用画像, OGP 画像は公開サイトや管理画面で使用する派生画像です.
- アバターは正方形の公開用画像を生成します.
作品の表示用画像は最大辺の設定に応じて複数生成されます. 既定値は512, 768, 1024, 1536, 2048ピクセルです. 元画像が設定値より小さい場合は拡大しません. 正方形画像の既定サイズは作品とアバターのどちらも128ピクセルです.
配信方法
app.assets.delivery.method は cgi または direct です. 既定の cgi では CGI 経由で画像を配信します. direct では公開画像を Web サーバから直接配信します. 直接配信を使う場合は public_dir を公開 URL に対応付け, public_uri にその URL パスを設定します.
[app.assets.delivery]
method = "direct"
public_uri = "/media/"
公開用ディレクトリを Apache の Alias で割り当てる場合の例です. 実際のパスと Web サーバ設定は運用環境に合わせてください.
Alias /media/ "/srv/uranep/assets/public/"
<Directory "/srv/uranep/assets/public">
Require all granted
Options -Indexes
</Directory>
private_dir やその親の assets ディレクトリ全体を Web 公開しないでください. オリジナル画像とフルサイズ画像は常に非公開領域に保存されます.
ダウンロード
app.assets.download は公開サイトで作品画像をダウンロードできるかを設定します. 値は none, original, full, display です. display は表示用画像だけを提供し, original と full は非公開領域のファイルを CGI 経由で提供します. 未公開作品とアバターはダウンロードできません. この設定の変更後はサイトを再生成してください.
変更時の注意
画像サイズや JPEG 品質などの設定を変えても, 既存画像は自動で作り直されません. 画像生成を実行した後にサイトも再生成してください. 保存先の変更も既存ファイルを移動しません. 既存ファイルの移動は, 対応するデータベース参照と公開 URL を確認して運用者が計画してください.
公開範囲の変更や配信エラーがある場合は, トラブルシューティングも参照してください.