devoutils/devoutils

Boîte à outils des fonctions usuelles pour Laravel

1.0.0 2025-07-21 16:47 UTC

Requires

• illuminate/support: ^11.45 || ^12.0
• nesbot/carbon: ^3.10

Requires (Dev)

• phpunit/phpunit: ^12.2

MIT

• SOUMAHORO YOUSSOUF

README

DevOutils est un SDK (Software Development Kit) conçu comme une boîte à outils regroupant des fonctions courantes et pratiques pour les développeurs utilisant le framework Laravel.
Il simplifie et standardise certaines tâches fréquentes, notamment la génération de codes de référence, le formatage de dates, et la mise en forme de montants.

🚀 Installation

Installez le package via Composer :

composer require devoutils/devoutils

📦 Structure du SDK

Le SDK est composé de trois classes principales :

1️⃣ CodeGenerator

Permet de générer des codes uniques ou structurés.

🔧 Méthodes :

codenumber(): Génère un code numérique aléatoire.

codeWithPrefix($prefix): Génère un code alphanumérique précédé d’un préfixe personnalisé.

🧪 Exemple d’utilisation :

use DevOutils\CodeGenerator;

$code = CodeGenerator::codenumber();           // Résultat : 00001
$ref  = CodeGenerator::codeWithPrefix('CLIENT',3);  // Résultat : CLI-00001

2️⃣ DateFormater Permet de générer des codes uniques ou structurés.

Permet de formater facilement une date dans plusieurs styles utiles pour l'affichage.

🔧 Méthodes :

fulldate($date): Format complet — Samedi 19 Juillet 2025

shortdate($date): Format abrégé — 19 Juillet 2025

date($date): Format standard — 19/07/2025

formatTime($time, $format): Formate une heure selon un format donné

relative($date): Affiche une date relative — il y a 1 minute

🧪 Exemple d’utilisation :

use DevOutils\DateFormater;

echo DateFormater::fulldate('2025-07-19');
echo DateFormater::shortdate('2025-07-19');
echo DateFormater::date('2025-07-19');
echo DateFormater::formatTime('14:30:00', 'H\hi');
echo DateFormater::relative(now()->subMinutes(5));

3️⃣ MoneyFormater Formate les montants numériques en une représentation lisible avec une devise.

🔧 Méthode :

formatMoney($amount, $currency = 'F CFA'): Retourne un montant formaté avec une séparation des milliers et une devise.

🧪 Exemple d’utilisation :

use DevOutils\MoneyFormater;

echo MoneyFormater::formatMoney(15000);         // 15 000 F CFA
echo MoneyFormater::formatMoney(15000, '€');    // 15 000 €

✅ Prérequis

PHP >= 8.2 Laravel >= 12

📄 Licence

Ce package est distribué sous la licence MIT.

🙌 Contribution

Les contributions sont les bienvenues !

N’hésitez pas à :

Fork le projet

Créer une branche (feature/ma-nouvelle-fonctionnalite)

Soumettre une Pull Request

Ouvrir une Issue pour signaler un bug ou proposer une amélioration

👤 Auteur

Développé avec ❤️ par Youssouf Soumahoro 📧 Contact : [https://github.com/SMH-Software/]