PHPackages                             forxer/fontawesome-migrator - 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. [Database &amp; ORM](/categories/database)
4. /
5. forxer/fontawesome-migrator

ActiveLibrary[Database &amp; ORM](/categories/database)

forxer/fontawesome-migrator
===========================

Package Laravel pour automatiser la migration de Font Awesome 5 vers Font Awesome 6 (Free et Pro)

2.1.1(9mo ago)1169MITPHPPHP ^8.4CI failing

Since Jul 25Pushed 9mo agoCompare

[ Source](https://github.com/forxer/fontawesome-migrator)[ Packagist](https://packagist.org/packages/forxer/fontawesome-migrator)[ RSS](/packages/forxer-fontawesome-migrator/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (10)Versions (14)Used By (0)

Font Awesome Migrator pour Laravel
==================================

[](#font-awesome-migrator-pour-laravel)

⚠️ **Disclaimer**
-----------------

[](#️-disclaimer)

Ce code a été largement généré avec Claude Code (claude.ai/code) à des fins d'apprentissage et pédagogiques. Bien que fonctionnel, **je n'ai pas entièrement confiance en l'IA** - j'ai dû corriger de nombreuses erreurs et imprécisions tout au long du développement. Utilisez ce package avec prudence et testez soigneusement avant usage en production.

Prérequis
---------

[](#prérequis)

- PHP 8.4+
- Laravel 12.0+

Fonctionnalités
---------------

[](#fonctionnalités)

### 🎯 Migration multi-versions des icônes

[](#-migration-multi-versions-des-icônes)

- ✅ **Migration progressive automatique** : Détection intelligente et exécution séquence complète (ex: 4→5→6 en un clic)
- ✅ **Architecture multi-versions** : FA4 → FA5 → FA6 → FA7 avec MigrationVersionManager
- ✅ **Mappings complets officiels** : 270 (4→5) + 310 (5→6) + 13 (6→7) icônes
- ✅ **Détection automatique** de la version source dans votre code
- ✅ **Support complet Pro** (Light, Duotone, Thin, Sharp) avec fallbacks Free
- ✅ **Configuration JSON** : Mappings externalisés avec ConfigurationLoader et cache
- ✅ **Mappers spécialisés** : FontAwesome4To5Mapper, FontAwesome5To6Mapper, FontAwesome6To7Mapper
- ✅ **Interface web interactive** avec sélecteur de versions temps réel
- ✅ **Mapping intelligent** des icônes renommées et dépréciées avec fallbacks

### 🎨 Migration des assets

[](#-migration-des-assets)

- ✅ **CDN URLs** : Migration automatique des liens CDN (toutes versions)
- ✅ **Package managers** : NPM, Yarn, pnpm (package.json avec extension .json)
- ✅ **Build tools** : webpack.mix.js avec support des fichiers JS individuels
- ✅ **Imports JavaScript** : ES6 imports, CommonJS require, dynamic imports
- ✅ **Feuilles de style** : CSS, SCSS, SASS (@import, URLs)
- ✅ **Support Pro &amp; Free** : Détection automatique selon la licence
- ✅ **Composants Vue/React** : Migration complète des templates et scripts

### 🛠️ Interface et outils avancés

[](#️-interface-et-outils-avancés)

- ✅ **Configurateur multi-versions** : Interface web `/tests` avec sélecteur interactif FA4→5→6→7
- ✅ **Validation dynamique** : Vérification des migrations supportées en temps réel
- ✅ **Aperçu de compatibilité** : Breaking changes et recommandations par migration
- ✅ **Interface web complète** : Dashboard, rapports, migrations avec navigation moderne
- ✅ **Documentation centralisée** : Documentation simplifiée et intégrée
- ✅ **Architecture JSON** : Configuration externalisée avec ConfigurationLoader et fallbacks
- ✅ **Mode dry-run** : Prévisualisation des changements avant application
- ✅ **Rapports détaillés** : HTML interactifs et JSON avec métadonnées complètes
- ✅ **Traçabilité complète** : Origine CLI/Web, migrations avec short IDs
- ✅ **Design system Bootstrap 5** : Interface moderne, responsive et accessible

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

[](#installation)

```
composer require forxer/fontawesome-migrator --dev
```

Le package sera automatiquement enregistré grâce à la découverte automatique de Laravel.

Une interface sera alors consultable à l'adresse `/fontawesome-migrator`

### 🚀 Installation interactive (recommandée)

[](#-installation-interactive-recommandée)

```
php artisan fontawesome:install
```

Cette commande interactive vous guide à travers :

- **Configuration personnalisée** : Licence (Free/Pro), chemins de scan, options
- **Instructions** : Prochaines étapes et commandes utiles
- **Configuration optimisée** : Seules les valeurs modifiées sont sauvegardées

#### Note pour les membres de [AXN-Informatique](https://github.com/AXN-Informatique)

[](#note-pour-les-membres-de-axn-informatique)

La plupart des applications à ce jour (10/09/2025) utilisent webpack via laravel-mix.

Il est donc nécessaire si le projet s'y prète d'ajouter le fichier `package.json` aux fichiers qui doivent êtres scannés.

### Installation manuelle

[](#installation-manuelle)

Si vous préférez configurer manuellement :

```
php artisan vendor:publish --tag=fontawesome-migrator-config
```

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

[](#configuration)

### 🎯 Configuration optimisée

[](#-configuration-optimisée)

Le package utilise un système de configuration intelligent : **seules les valeurs que vous modifiez sont sauvegardées** dans `config/fontawesome-migrator.php`. Cela simplifie la maintenance et les mises à jour.

**Exemple de fichier généré après installation interactive :**

```
