PHPackages                             dev-fighters/back-utils - 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. [Framework](/categories/framework)
4. /
5. dev-fighters/back-utils

ActiveLibrary[Framework](/categories/framework)

dev-fighters/back-utils
=======================

mini-framework for Dev Fighters

1.3.0(2mo ago)0123↓50%LGPL-3.0PHPPHP &gt;=8.4

Since Oct 20Pushed 2mo agoCompare

[ Source](https://github.com/DevFighters/back-utils)[ Packagist](https://packagist.org/packages/dev-fighters/back-utils)[ RSS](/packages/dev-fighters-back-utils/feed)WikiDiscussions production Synced 1mo ago

READMEChangelogDependencies (39)Versions (33)Used By (0)

DEV FIGHTERS - Back Utils
=========================

[](#dev-fighters---back-utils)

A mini-framework library providing utilities for Dev Fighters Symfony applications, including mailer services, data integrity checks, and standardized application entities.

REQUIREMENTS
------------

[](#requirements)

- Requires PHP &gt;= 8.4
- Symfony 7.3
- Required PHP Extensions:
    - bcmath, ctype, curl, fileinfo, gd, iconv, intl, json, soap, zlib, pdo

Features
--------

[](#features)

- **Mailer Service**: Integrated email sending with test mode support
- **Data Integrity Checker**: Validate database and application data consistency
- **Standard App Entities**: Pre-configured entities for countries, currencies, languages, timezones, and administrative areas
- **PDF Generator**: Generate PDFs from Twig templates with DomPDF (stream or download)
- **API Platform Integration**: Built-in support for API Platform 4.2
- **JWT Authentication**: Integrated with Lexik JWT Authentication Bundle
- **Doctrine Fixtures**: Sample data loading capabilities
- **Excel Support**: PHPSpreadsheet integration for spreadsheet operations

INSTALLATION
------------

[](#installation)

- Install with composer: composer require dev-fighters/back-utils

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

[](#configuration)

### Environment Variables

[](#environment-variables)

Add the following variables to your `.env` file:

- MAILER\_DSN=\[STRING\] # e.g., smtp://user::port
- MAILER\_SENDER\_EMAIL=\[STRING\] # Sender email e.g.,
- MAILER\_SENDER\_NAME=\[STRING\] # Sender name e.g., "Dev Fighters"
- MAILER\_TEST\_ACTIVATE=\[BOOLEAN\] # TRUE = MODE TEST ACTIVATED \[DEFAULT : TRUE\] Set to false in production
- MAILER\_TEST\_RECIPIENT=\[STRING\] # Surpassed recipient. All emails redirected here when test mode is active

**Note**: When `MAILER_TEST_ACTIVATE=true`, all outgoing emails will be redirected to `MAILER_TEST_RECIPIENT` instead of the intended recipients. This is useful for development and testing.

### config/services.yaml

[](#configservicesyaml)

```
services :
    DevFighters\Utils\:
        resource: '../vendor/dev-fighters/back-utils/src/'
        autowire: true
        autoconfigure: true

```

### config/packages/doctrine.yaml

[](#configpackagesdoctrineyaml)

```
doctrine:
    orm:
        entity_managers:
            dql:
                string_functions:
                    replace: DoctrineExtensions\Query\Mysql\Replace
                    MONTH: DoctrineExtensions\Query\Mysql\Month
                    YEAR: DoctrineExtensions\Query\Mysql\Year
                    ROUND: DoctrineExtensions\Query\Mysql\Round
                    GROUP_CONCAT: DoctrineExtensions\Query\Mysql\GroupConcat
                numeric_functions:
                    RAND: DoctrineExtensions\Query\Mysql\Rand

```

Usage
-----

[](#usage)

### Load Sample Data

[](#load-sample-data)

- `php bin/console doctrine:fixtures:load --append --group=init`

### Check Data Integrity

[](#check-data-integrity)

Run the integrity checker to validate your database and application data:

- `php bin/console back-utils:check`

This comand performs the following checks:

- App Countries (validates against `AppCountryEnum`)
- App Country Administrative Areas (validates against `AppCountryAdministrativeAreaEnum`)
- App Currencies (validates against `AppCurrencyEnum`)
- App Languages (validates against `AppLanguageEnum`)
- App Timezones (validates against `AppTimezoneEnum`)

### Available Entities

[](#available-entities)

The library provides the following standard entities:

- `AppCountry` - Country definitions
- `AppCountryAdministrativeArea` - Administrative divisions (states, provinces, etc.)
- `AppCurrency` - Currency definitions
- `AppLanguage` - Language definitions
- `AppTimezone` - Timezone configurations

Development
-----------

[](#development)

### Docker Support

[](#docker-support)

If you're developing this library locally with Docker:

`cd .docker && docker compose up -d --build`

Dependencies
------------

[](#dependencies)

Key dependencies include:

- API Platform 4.2
- Doctrine ORM 3.0
- Symfony 7.3 components
- Lexik JWT Authentication Bundle
- PHPSpreadsheet 5.2

For the complete list, see composer.json.

Documentation
-------------

[](#documentation)

- [Convention GIT](./docs/CONVENTIONS_GIT_NAMING.md)
- [Convention DEV](./docs/CONVENTIONS_DEV.md)
- [Convention Data Fixtures](./docs/DATA_FIXTURES.md)

License
-------

[](#license)

**Proprietary** - This software is the exclusive property of Dev Fighters. All rights reserved.

Unauthorized copying, distribution, modification, or use of this software, via any medium, is strictly prohibited without explicit written permission from Dev Fighters.

Authors
-------

[](#authors)

### Dev Fighters

[](#dev-fighters)

For more information or support, please contact the [Dev Fighters](https://dev-fighters.fr/) team.

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance83

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 94.1% 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 ~4 days

Total

31

Last Release

88d ago

Major Versions

0.1.3 → 1.0.02025-11-15

### Community

Maintainers

![](https://www.gravatar.com/avatar/7c005ee26d37b4f0612d419159d1eea4d889c0517baeff9390dbbe31b6fe2acf?d=identicon)[df-romain-francois](/maintainers/df-romain-francois)

---

Top Contributors

[![df-romain-francois](https://avatars.githubusercontent.com/u/136347231?v=4)](https://github.com/df-romain-francois "df-romain-francois (32 commits)")[![KevTsiory](https://avatars.githubusercontent.com/u/213403141?v=4)](https://github.com/KevTsiory "KevTsiory (2 commits)")

###  Code Quality

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/dev-fighters-back-utils/health.svg)

```
[![Health](https://phpackages.com/badges/dev-fighters-back-utils/health.svg)](https://phpackages.com/packages/dev-fighters-back-utils)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[kimai/kimai

Kimai - Time Tracking

4.6k7.4k1](/packages/kimai-kimai)[shopware/platform

The Shopware e-commerce core

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

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)

PHPackages © 2026

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