How to Use PHP Profiler Tools to Provide Estimates of CO2 Consumption of PHP Applications Using the Package PHP Eco-Profiler: High-Precision Carbon Footprint Auditor: Measure the carbon footprint of applications

Recommend this page to a friend!

Download

Info

Example

Files

Install with Composer

Download

Reputation

Support forum

Blog

Links

Last Updated		Ratings				Unique User Downloads		Download Rankings
2026-01-24 (29 days ago)		Not yet rated by the users				Total: Not yet counted		Not yet ranked

Version		License		PHP version		Categories
`php-eco-profiler` 1.0		MIT/X Consortium ...		8.1		Performance and optimization, PHP 8

Description

Author

zinsou A.A.E.Mo�se

This package can measure the carbon footprint of applications.

It can start measuring the time of the start of a part of a code of a PHP application.

When that part of the code and the execution, the package can measure the CO2 impact using proxy classes that provide estimates of the use of different machine resources and provider classes that perform calculations considering the CPU architecture and the time that the application part took to execute.

Currently the package provides proxy classes to provide measures of the CO2 impact of:

- MySQL database clusters

The package returns an array with several measures. It can also export to a file in CSV or JSON format.

Innovation Award

January 2026
Nominee
Vote

A PHP application that runs on one or more server computers consume energy. The energy consumed by these computers has an impact in terms of CO2 emissions.

This package can estimate measures of energy consumed by computers that run the code of PHP applications. This way it can provide estimates of the PHP applications in terms of CO2 impact.

Manuel Lemos

zinsou A.A.E.Mo�se

Performance

Level

Name:	zinsou A.A.E.Mo�se is available for providing paid consulting. Contact zinsou A.A.E.Mo�se .
Classes:	51 packages by zinsou A.A.E.Mo�se
Country:	Benin
Age:	36
All time rank:	676	1 in Benin
Week rank:	22	1 in Benin

Level 5

Innovation award

Nominee: 24x

Winner: 2x

Instructions

Please check this example script to learn how to measure the CO2 consumption of a PHP script.

Example


<?php



require_once __DIR__ . '/vendor/autoload.php';



use GreenCode\EcoProfiler;

use GreenCode\ConfigLoader;

use GreenCode\Providers\StaticProvider;

use GreenCode\Exporters\JsonExporter;

use GreenCode\Exporters\MemoryExporter;



// 1. Chargement de la configuration (incluant les nouveaux seuils de Rating)

$settings   = ConfigLoader::load('settings');

$carbonData = ConfigLoader::load('carbon_data');



// 2. Initialisation du fournisseur (Intensit� carbone moyenne par pays)

$provider = new StaticProvider($carbonData['averages']);



/**

 * SC�NARIO A : Mode Stateless (Cloud-Native / API)

 * Id�al pour renvoyer le score directement dans une r�ponse JSON sans toucher au disque.

 */

$profilerStateless = new EcoProfiler(

    $provider, 

    $settings, 

    new MemoryExporter() // Z�ro �criture disque

);



$profilerStateless->start();



// --- Simulation d'une logique m�tier efficiente ---

usleep(5000); 

// ---------------------------------------------------



// On arr�te et on r�cup�re le rapport directement dans une variable

$apiReport = $profilerStateless->stop('FR', [

    'mysql_query' => 2, 

    'redis_get'    => 10

]);



echo "=== MODE STATELESS (API) ===<br>";

echo "Note Carbone : " . $apiReport['ecology']['rating'] . "<br>";

echo "Impact Total : " . $apiReport['ecology']['total_co2'] . " gCO2e<br><br>";





/**

 * SC�NARIO B : Mode Audit (Enregistrement de rapport)

 * Id�al pour g�n�rer un historique de performance environnementale.

 */

$profilerAudit = new EcoProfiler(

    $provider, 

    $settings, 

    new JsonExporter() // Enregistre dans /reports/ d�fini dans settings.php

);



$profilerAudit->start();



// --- Simulation d'un processus plus lourd ---

for($i=0; $i<100000; $i++) { $x = sqrt($i); }

// --------------------------------------------



$auditReport = $profilerAudit->stop('DE', [

    'external_api_call' => 1

]);



echo "=== MODE AUDIT (FILE) ===<br>";

echo "Rapport g�n�r� avec succ�s dans : " . ($settings['export_path'] ?? 'dossier par d�faut') . "<br>";

echo "Statut de l'export : " . $auditReport['meta']['export_log'] . "<br>";



// 3. Exemple de v�rification du Green SLA (Budget Carbone)

if ($auditReport['ecology']['budget_exceeded']) {

    echo "?? ALERTE : Le budget carbone configur� dans settings.php a �t� d�pass� !";

}

Details

? PHP Eco-Profiler : Le Manifeste

> "On ne peut pas optimiser ce que l'on ne mesure pas." > Le d�veloppeur PHP moderne est le garant de l'efficience �nerg�tique du web. PHP Eco-Profiler est une biblioth�que d'ing�nierie durable con�ue pour passer d'un web de l'abondance � un web de la pertinence.

? Pourquoi ce projet existe ?

La performance n'est plus seulement une question de millisecondes, c'est une question de milligrammes de $CO_{2}$.

PHP Eco-Profiler r�introduit la r�alit� physique du mat�riel dans l'abstraction du code en calculant l'impact carbone r�el de vos scripts. Il permet de r�concilier les imp�ratifs de production avec les limites plan�taires.

? Les 3 Piliers de l'Innovation (Innovation Awards 2026)

1. Conscience Mat�rielle (Hardware-Awareness)

D�tection automatique de l'architecture CPU (ARM vs x86) pour ajuster les courbes de consommation. Le moteur valorise les infrastructures sobres (type AWS Graviton) et les gains d'efficience du moteur Zend sous PHP 8.4+.

2. Vision Holistique (Eco-Proxying)

Ne mesurez plus seulement votre code local. Mesurez l'ensemble de votre �cosyst�me gr�ce au ProxyRegistry qui comptabilise l'impact des d�pendances tierces (SQL, API externes, Cloud storage) via un syst�me de fallback intelligent.

3. Architecture Stateless & Cloud-Native

Con�u pour le cloud moderne, l'outil fonctionne en mode In-Memory. Il ne n�cessite aucune �criture disque, le rendant nativement compatible avec AWS Lambda, Google Cloud Functions et les environnements Docker en lecture seule.

? Utilisation & Ing�nierie

Installation

composer require manuwhat/php-eco-profiler```


Exemple API Stateless (Sans stockage fichier)

use GreenCode\EcoProfiler; use GreenCode\Exporters\MemoryExporter;

// Configuration Stateless pour Cloud Functions / API $profiler = new EcoProfiler($provider, $settings, new MemoryExporter()); $profiler->start();

// ... Logique m�tier ...

$report = $profiler->stop('FR', ['mysql_query' => 5]);

// R�ponse directe en JSON (Z�ro Latence I/O) header('Content-Type: application/json'); echo json_encode($report, JSON_PRETTY_PRINT);`

? Architecture & Extensibilit�

Le projet adopte le Strategy Pattern, rendant chaque composant interchangeable :

Providers : Sources d'intensit� carbone (Statique ou API temps r�el).

Proxies : Connecteurs pour services tiers (DB, Cloud, Mail).

Exporters : Formats de sortie (JSON, CSV, ou Memory-only).

? Qualit� Industrielle

Le projet int�gre une suite de tests PHPUnit rigoureuse et une int�gration continue via GitHub Actions, garantissant la pr�cision des mod�les de conversion Joules/Carbone sur toutes les versions de PHP support�es.


./vendor/bin/phpunit tests```


##?Gouvernance Carbone :

Notation Dynamique : Ne soyez pas limit� par des standards pr�-�tablis. Configurez vos propres seuils de notation (A+ � E) directement dans vos fichiers de param�tres pour les aligner sur vos objectifs RSE sp�cifiques.


##? Vision 
PHP Eco-Profiler transforme chaque ex�cution de script en une donn�e environnementale auditable. Il apporte une r�ponse technique concr�te aux r�gulations RSE europ�ennes (CSRD) et positionne PHP comme un leader de la Green-Tech.

"Le code le plus �cologique est celui que l'on optimise avec conscience." D�velopp� avec passion par manuwhat

Files (28)

File	Role	Description
`.github` (1 directory)
`config` (3 files)
`src` (2 files, 3 directories)
`tests` (3 files)
`arborescence.txt`	Doc.	Documentation
`composer.json`	Data	Auxiliary data
`DOCUMENTATION.md`	Doc.	Documentation
`example.php`	Example	Example script
`example_api.php`	Example	Example script
`INSTALL.md`	Example	Example script
`LICENSE`	Lic.	License text
`phpunit.xml`	Data	Auxiliary data
`readme.md`	Doc.	Documentation
`SUMMARY.md`	Doc.	Summary

Files (28)

.github

File	Role	Description
`workflows` (1 file)

Files (28)

.github

workflows

File	Role	Description
`tests.yml`	Data	Auxiliary data

Files (28)

config

File	Role	Description
`carbon_data.php`	Conf.	Configuration script
`eco_proxy.php`	Aux.	Configuration script
`settings.php`	Aux.	Configuration script

Files (28)

src

File	Role	Description
`Exporters` (4 files)
`Providers` (2 files)
`Proxy` (3 files)
`ConfigLoader.php`	Class	Class source
`EcoProfiler.php`	Class	Class source

Files (28)

src

Exporters

File	Role	Description
`CsvExporter.php`	Class	Class source
`ExporterInterface.php`	Class	Class source
`JsonExporter.php`	Class	Class source
`MemoryExporter.php`	Class	Class source

Files (28)

src

Providers

File	Role	Description
`CarbonProviderInterface.php`	Class	Class source
`StaticProvider.php`	Class	Class source

Files (28)

src

Proxy

File	Role	Description
`DatabaseProxy.php`	Class	Class source
`ProxyRegistry.php`	Class	Class source
`ProxyServiceInterface.php`	Class	Class source

Files (28)

tests

File	Role	Description
`EcoProfilerTest.php`	Class	Class source
`ProxyRegistryTest.php`	Class	Class source
`RatingSystemTest.php`	Class	Class source

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.

Install with Composer

	php-eco-profiler-2026-01-24.zip 23KB
	php-eco-profiler-2026-01-24.tar.gz 15KB
	Install with Composer

Version Control

Unique User Downloads

100%

Total:	0
This week:	0

Applications that use this package

No pages of applications that use this class were specified.

If you know an application of this package, send a message to the author to add a link here.

About us

Advertise on this site

For more information send a message to info at phpclasses dot org.