静的ビューファイルのデプロイメント戦略

静的ビューファイルをデプロイする場合、3 つの方法から 1 つを選択できます。 それぞれに、様々なユースケースに最適なデプロイメント結果が得られます。

次の節では、実装の詳細と各戦略の機能について説明します。

標準戦略

標準戦略を使用すると、すべてのパッケージのすべての静的ビューファイルがデプロイされます。つまり、\Magento\Framework\App\View\Asset\Publisher によって処理されます。

詳しくは、 静的ビューファイルのデプロイを参照してください。

迅速な戦略

クイック戦略は、次のアクションを実行します。

このアプローチにより、多くのファイルが複製されますが、複数のロケールで必要なデプロイメント時間が最小限に抑えられます。

コンパクト戦略

コンパクト戦略では、類似のファイルをサブディレクトリに保存することで、ファイルの重複 base 回避します。

最も最適化された結果を得るために、類似性を保つための 3 つの範囲（領域、テーマ、ロケール）が割り当てられます。 これらのスコープのすべての組み合わせに対して、base のサブディレクトリが作成されます。

ファイルは、次のパターンに従ってこれらのサブディレクトリにデプロイされます。

デプロイされたファイルのマッピング

コンパクト戦略で使用されるデプロイメントへのアプローチとは、ファイルが基本テーマおよびロケールから継承されることを意味します。 これらの継承リレーションは、領域、テーマ、およびロケールの組み合わせごとにマップ ファイルに格納されます。 PHP と JS には別個のマップファイルがあります。

map.php ファイルは、Magento\Framework\View\Asset\Repository が正しい URL を作成するために使用します。

requirejs-map.js は、RequireJS の baseUrlResolver プラグインで使用されます。

map.php の例：

return [
    'Magento_Checkout::cvv.png' => [
        'area' => 'frontend',
        'theme' => 'Magento/luma',
        'locale' => 'en_US',
    ],
    '...' => [
        'area' => '...',
        'theme' => '...',
        'locale' => '...'
    ]
];

requirejs-map.js の例：

require.config({
    "config": {
       "baseUrlInterceptor": {
            "jquery.js": "../../../../base/Magento/base/en_US/"
        }
    }
});

拡張機能開発者向けのヒント

静的ビューファイルへの URL を作成するには、\Magento\Framework\View\Asset\Repository::createAsset() を使用します。

静的ファイルが見つからず、ページのレンダリング中に表示されない問題を回避するために、URL 連結を使用しないでください。