freshheads/webpack-bundle

A Symfony bundle to create paths to webpack assets in your Twig templates.

3.0.0 2024-03-01 14:13 UTC

Requires

• php: >=8.1
• freshheads/webpack-stats: ^2.0
• symfony/asset: ^6.4 | ^7.0
• symfony/config: ^6.4 | ^7.0
• symfony/dependency-injection: ^6.4 | ^7.0
• symfony/event-dispatcher: ^6.4 | ^7.0
• symfony/http-kernel: ^6.4 | ^7.0
• symfony/twig-bundle: ^6.4 | ^7.0
• symfony/yaml: ^6.4 | ^7.0
• twig/twig: ^3.0

Requires (Dev)

• symfony/phpunit-bridge: ^6.4 | ^7.0

MIT

• Joris van de Sande

README

A Symfony bundle to create paths to webpack assets in your Twig templates. This bundle uses the webpack statistics file to find the newest assets for a given webpack entry.

Installation

Install with composer:

composer require freshheads/webpack-bundle

Register the bundle

// config/bundles.php
return [
    // ...
    FH\Bundle\WebpackBundle\FHWebpackBundle::class => [ 'all' => true ]
];

Configuration

All configuration options, with default values:

fh_webpack:
    stats_filename: stats.json
    # web/document root, assets will be referenced from this path
    web_dir: '%kernel.project_dir%/public'

Usage

Link webpack files

<link rel="stylesheet" href="{{ webpack_asset('assets/frontend/build', 'app', 'css') }}" />
<script type="text/javascript" src="{{ webpack_asset('assets/frontend/build', 'app', 'js') }}"></script>

Dump the contents of a webpack file

<style type="text/css">
    {{ webpack_asset_contents('assets/frontend/build', 'email', 'css')|raw }}
</style>

Requirements

This library works with PHP version 8.1 and up.