dev-fighters/back-utils

mini-framework for Dev Fighters

1.0.5 2025-11-27 14:51 UTC

Requires

• php: >=8.4
• ext-bcmath: *
• ext-ctype: *
• ext-curl: *
• ext-fileinfo: *
• ext-gd: *
• ext-iconv: *
• ext-intl: *
• ext-json: *
• ext-pdo: *
• ext-soap: *
• ext-zlib: *
• api-platform/doctrine-orm: ^4.2
• api-platform/symfony: ^4.2
• beberlei/doctrineextensions: ^1.5
• doctrine/dbal: ^4.0
• doctrine/doctrine-bundle: ^2.7
• doctrine/doctrine-fixtures-bundle: ^4.0
• doctrine/doctrine-migrations-bundle: ^3.0
• doctrine/orm: ^3.0
• lexik/jwt-authentication-bundle: ^3.1
• nelmio/cors-bundle: ^2.6
• phpoffice/phpspreadsheet: ^5.2
• symfony/asset: 7.3.*
• symfony/console: 7.3.*
• symfony/dotenv: 7.3.*
• symfony/expression-language: 7.3.*
• symfony/framework-bundle: 7.3.*
• symfony/google-mailer: 7.3.*
• symfony/http-client: 7.3.*
• symfony/intl: 7.3.*
• symfony/mailer: 7.3.*
• symfony/mailgun-mailer: 7.3.*
• symfony/messenger: 7.3.*
• symfony/mime: 7.3.*
• symfony/property-access: 7.3.*
• symfony/property-info: 7.3.*
• symfony/runtime: 7.3.*
• symfony/security-bundle: 7.3.*
• symfony/serializer: 7.3.*
• symfony/twig-bundle: 7.3.*
• symfony/validator: 7.3.*
• symfony/yaml: 7.3.*
• twig/extra-bundle: ^3.22
• twig/intl-extra: ^3.22

LGPL-3.0

• Dev Fighters

README

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

REQUIREMENTS

• Requires PHP >= 8.4
• Symfony 7.3
• Required PHP Extensions:
  • bcmath, ctype, curl, fileinfo, gd, iconv, intl, json, soap, zlib, pdo

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

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

Configuration

Environment Variables

Add the following variables to your .env file:

• MAILER_DSN=[STRING] # e.g., smtp://user:[e-mail]:port
• MAILER_SENDER_EMAIL=[STRING] # Sender email e.g., [e-mail]
• 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

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

config/packages/doctrine.yaml

doctrine:
    orm:
        entity_managers:
            default:
                mappings:
                    DevFightersUtils:
                        type: attribute
                        dir: '%kernel.project_dir%/vendor/dev-fighters/back-utils/src/Domain/Entity'
                        prefix: 'DevFighters\Utils\Domain\Entity'
                        alias: DevFightersUtils
            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

Load Sample Data

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

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

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

Docker Support

If you're developing this library locally with Docker:

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

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

• Convention GIT
• Convention DEV
• Convention Data Fixtures

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

Dev Fighters

For more information or support, please contact the Dev Fighters team.