esbuild-plugin-php-manifest

This Plugin will generate a PHP File that contains a Class with a static Associative Array with the key being the Input File and the value being the Output.

This Plugin was inspired by webpack-php-manifest

Example Output

1// generated PHP Manifest
2<?php
3  class EsbuildPluginPhpManifest {
4    static $files = [
5        "test.js" => "out/test-2XYBNIBO.js"
6      ];
7  };

That File can then be used to include the generated assets. I'd advise to use a hash for cache busting purposes.

Sample Usage inside a PHP File

1<?php require_once __DIR__ . "/manifest.php"; ?>
2<script src="<?= EsbuildPluginPhpManifest::$files["test.js"] ?>"></script>

Install

1npm install -D esbuild esbuild-plugin-php-manifest

Usage

1const esbuild = require('esbuild');
2const phpManifestPlugin = require('esbuild-plugin-php-manifest');
3
4esbuild.build({
5  entryPoints: ['test.js'],
6  bundle: true,
7  metafile: true, // this is needed to the plugin can generate the manifest
8  outdir: './out/',
9  plugins: [
10    phpManifestPlugin({
11      pathPHPManifest: 'manifest.php',
12    }),
13  ],
14});

Plugin Options

The following Plugin Options are available

options.pathPHPManifest

string | undefined Optional Path for the generated PHP Manifest File

options.hash

string | boolean | undefined

If true or undefined it will use the hash provided by esbuild. false will not use a hash and if passed a string it will append the string to the file name.

options.rewriteManifest

Optional function that has the signature rewriteManifest(key: string, value: string): [string, string].

So it gets passed the key (the original file name) and the value (the output) and it should return a tuple [newKey: string, newOuput: string].

options.namePHPManifestClass

Optional Class Name for the generated PHP File, defaults to EsbuildPluginPhpManifest