PHPackages                             constructionsincongrues/asset-gatherer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. constructionsincongrues/asset-gatherer

ActiveLibrary[Utility & Helpers](/categories/utility)

constructionsincongrues/asset-gatherer
======================================

A PHP package to gather assets based on HTTP request rules and configuration in YAML.

v0.4.0(1y ago)015[2 PRs](https://github.com/constructions-incongrues/asset-gatherer/pulls)MITPHPPHP >=7.4CI passing

Since Nov 2Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/constructions-incongrues/asset-gatherer)[ Packagist](https://packagist.org/packages/constructionsincongrues/asset-gatherer)[ RSS](/packages/constructionsincongrues-asset-gatherer/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (4)Versions (8)Used By (0)

AssetGatherer Documentation
===========================

[](#assetgatherer-documentation)

Le package `AssetGatherer` permet de collecter des ressources (images, CSS, JavaScript, etc.) en fonction de règles définies pour chaque requête HTTP. Ces règles sont configurées dans un fichier YAML. Les ressources sont organisées en groupes appelés *bundles*, qui peuvent regrouper des fichiers de différents types selon les sections de l'application.

Table des Matières
------------------

[](#table-des-matières)

- [Installation](#installation)
- [Configuration](#configuration)
- [Diagrammes C4](#diagrammes-c4)
    - [Diagramme de Contexte](#diagramme-de-contexte)
    - [Diagramme de Conteneur](#diagramme-de-conteneur)
    - [Diagramme de Composant](#diagramme-de-composant)
- [Utilisation avec PSR-7](#utilisation-avec-psr-7)
- [Utilisation avec Répertoire de Base](#utilisation-avec-r%C3%A9pertoire-de-base)
- [Utilisation du Dev Container](#utilisation-du-dev-container)
- [Exécution des Tests](#ex%C3%A9cution-des-tests)

Installation
------------

[](#installation)

1. **Installer le composant YAML de Symfony** pour pouvoir lire les configurations YAML :

    ```
    composer require symfony/yaml
    ```
2. **Installer PHPUnit** pour les tests unitaires :

    ```
    composer require --dev phpunit/phpunit
    ```

Configuration
-------------

[](#configuration)

La configuration du package `AssetGatherer` se fait via un fichier YAML. Chaque *bundle* peut définir des répertoires et types de fichiers spécifiques, ainsi que des règles conditionnelles en fonction de la requête HTTP (URL, headers, paramètres de requête).

### Structure du Fichier YAML

[](#structure-du-fichier-yaml)

```
# config/bundles.yaml
homepage:
  images:
    directories: ["homepage/images"]
    extensions: ["jpg", "png"]
  css:
    directories: ["homepage/css"]
    extensions: ["css"]
  rules:
    pathContains: "/homepage"

dashboard:
  javascript:
    directories: ["dashboard/js"]
    extensions: ["js"]
  rules:
    query:
      admin: "true"
      user:
        regex: "/^user[0-9]+$/"
```

Diagrammes C4
-------------

[](#diagrammes-c4)

### Diagramme de Contexte

[](#diagramme-de-contexte)

 ```
C4Context
    title System Context Diagram for AssetGatherer

    Person(dev, "Développeur", "Un développeur utilisant le package pour gérer des ressources conditionnelles dans une application PHP")

    System_Boundary(assetGatherer, "Package AssetGatherer") {
        Component(assetGathererCore, "AssetGatherer", "Library", "Un package PHP qui permet de collecter des ressources conditionnelles basées sur des règles de requête HTTP")
    }

    System(api, "API HTTP", "API externe", "Reçoit les requêtes HTTP et fournit des informations pour la collecte des ressources")

    Rel(dev, assetGathererCore, "Utilise", "Définit les règles de configuration et interagit avec le package")
    Rel(assetGathererCore, api, "Extrait les informations de requête", "Utilise les paramètres de requête HTTP pour filtrer les ressources")

    UpdateElementStyle(dev, $fontColor="black", $bgColor="#ffcc00")
    UpdateElementStyle(assetGathererCore, $fontColor="black", $bgColor="#6fa8dc")
    UpdateElementStyle(api, $fontColor="black", $bgColor="#93c47d")
```

      Loading ### Diagramme de Conteneur

[](#diagramme-de-conteneur)

 ```
C4Container
    title Container Diagram for AssetGatherer

    Person(dev, "Développeur", "Configure le package et définit les règles")

    System_Boundary(app, "Application PHP") {
        Container(appCode, "Code de l'Application", "PHP", "Application utilisant le package AssetGatherer pour collecter des ressources conditionnelles")
        Container(assetGathererLib, "AssetGatherer", "Library", "Package PHP pour la collecte de ressources conditionnelles")
    }

    Container(configFile, "Configuration YAML", "Fichier", "Fichier de configuration des règles de collection de ressources")

    Rel(dev, configFile, "Définit")
    Rel(appCode, assetGathererLib, "Intègre et utilise")
    Rel(assetGathererLib, configFile, "Charge et utilise")
```

      Loading ### Diagramme de Composant

[](#diagramme-de-composant)

 ```
C4Component
    title Component Diagram for AssetGatherer

    Container_Boundary(assetGathererLib, "AssetGatherer") {
        Component(configLoader, "Configuration Loader", "PHP", "Charge et analyse le fichier de configuration YAML")
        Component(ruleEngine, "Rule Engine", "PHP", "Évalue les règles de collecte basées sur la requête")
        Component(assetCollector, "Asset Collector", "PHP", "Collecte les ressources en fonction des règles évaluées")
    }

    Container(configFile, "Configuration YAML", "Fichier", "Fichier de configuration des règles de collection de ressources")
    Container(httpRequest, "Requête HTTP", "HTTP", "Requête HTTP contenant les informations pour les règles")

    Rel(configLoader, configFile, "Charge la configuration")
    Rel(ruleEngine, configLoader, "Utilise")
    Rel(assetCollector, ruleEngine, "Interroge et utilise")
    Rel(ruleEngine, httpRequest, "Évalue les règles basées sur")
    Rel(assetCollector, httpRequest, "Accède aux informations de la requête")
```

      Loading Utilisation avec Répertoire de Base
-----------------------------------

[](#utilisation-avec-répertoire-de-base)

Le package `AssetGatherer` prend en charge un répertoire de base pour les *bundles*. En définissant un répertoire de base, tous les chemins spécifiés dans la configuration YAML sont interprétés comme étant relatifs à ce répertoire.

### Exemple d’Utilisation avec Répertoire de Base

[](#exemple-dutilisation-avec-répertoire-de-base)

```
use AssetGatherer\AssetGatherer;
use Nyholm\Psr7\ServerRequest;

// Définissez un répertoire de base pour les fichiers d'assets
$baseDirectory = '/var/www/assets';
$assetGatherer = new AssetGatherer($baseDirectory);
$assetGatherer->loadConfiguration('config/bundles.yaml');

// Créez une requête HTTP PSR-7
$request = new ServerRequest('GET', '/homepage', [
    'User-Agent' => 'Chrome',
    'Accept' => 'text/html'
]);

// Collectez les ressources en fonction de la requête
$assetGatherer->gatherAssetsForRequest($request);

// Récupérez et affichez les ressources collectées
$assets = $assetGatherer->getAssets();
print_r($assets);
```

Dans cet exemple :

- **Répertoire de Base** : Le répertoire de base `/var/www/assets` est utilisé pour préfixer tous les chemins des répertoires définis dans `bundles.yaml`.
- **Collecte des Ressources** : Le package cherchera les fichiers dans les répertoires définis dans `bundles.yaml`, relatifs au répertoire de base.

Utilisation avec PSR-7
----------------------

[](#utilisation-avec-psr-7)

Le package `AssetGatherer` utilise maintenant PSR-7 pour représenter les requêtes HTTP. Cela permet d'utiliser n'importe quelle implémentation compatible avec PSR-7, comme `nyholm/psr7` ou `guzzlehttp/psr7`.

### Prérequis

[](#prérequis)

Assurez-vous d'avoir une implémentation PSR-7 installée dans votre projet, par exemple :

```
composer require nyholm/psr7
```

### Création d'une Requête HTTP avec PSR-7

[](#création-dune-requête-http-avec-psr-7)

```
use Nyholm\Psr7\ServerRequest;

$request = new ServerRequest('GET', '/homepage', [
    'User-Agent' => 'Chrome',
    'Accept' => 'text/html'
]);
```

Utilisation du Dev Container
----------------------------

[](#utilisation-du-dev-container)

Le projet inclut une configuration de Dev Container pour un environnement de développement reproductible.

### Avant de commencer

[](#avant-de-commencer)

- **Docker** : Assurez-vous que Docker est installé et en cours d'exécution.
- **Visual Studio Code** : Utilisez l'extension "Remote - Containers".

### Démarrage du Dev Container

[](#démarrage-du-dev-container)

1. **Ouvrez le projet dans Visual Studio Code**.
2. **Ouvrez le Dev Container** : Appuyez sur `F1`, tapez `Remote-Containers: Reopen in Container`, et sélectionnez cette option.

Exécution des Tests
-------------------

[](#exécution-des-tests)

```
vendor/bin/phpunit tests/AssetGathererTest.php
```

---

Cette documentation couvre l'installation, la configuration, l'utilisation, et les tests du package `AssetGatherer`.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance61

Regular maintenance activity

Popularity6

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 87.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

5

Last Release

549d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2e00b6255aab65fbfbc9d9d413d30506e9829d2fe02827d469437fd18074af89?d=identicon)[trivoallan](/maintainers/trivoallan)

---

Top Contributors

[![trivoallan](https://avatars.githubusercontent.com/u/23811?v=4)](https://github.com/trivoallan "trivoallan (28 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (4 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/constructionsincongrues-asset-gatherer/health.svg)

```
[![Health](https://phpackages.com/badges/constructionsincongrues-asset-gatherer/health.svg)](https://phpackages.com/packages/constructionsincongrues-asset-gatherer)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)