PHPackages gponty/entity-to-google-sheets-bundle - 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 & ORM](/categories/database) 4. / 5. gponty/entity-to-google-sheets-bundle ActiveSymfony-bundle[Database & ORM](/categories/database) gponty/entity-to-google-sheets-bundle ===================================== Export Doctrine entities to Google Sheets 1.0.3(1mo ago)0390MITPHPPHP >=8.2 Since Feb 19Pushed 1mo agoCompare [ Source](https://github.com/gponty/entity-to-google-sheets-bundle)[ Packagist](https://packagist.org/packages/gponty/entity-to-google-sheets-bundle)[ RSS](/packages/gponty-entity-to-google-sheets-bundle/feed)WikiDiscussions main Synced 2w ago READMEChangelogDependencies (8)Versions (5)Used By (0) Entity to Google Sheets Bundle ============================== [](#entity-to-google-sheets-bundle) [![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT) Un bundle Symfony puissant et simple pour exporter automatiquement les entités Doctrine vers des feuilles Google Sheets. Fonctionnalités --------------- [](#fonctionnalités) - 📊 **Export des entités Doctrine** : Exporte toutes vos entités Doctrine vers Google Sheets automatiquement - 🔄 **Gestion complète des relations** : Support des relations OneToOne, OneToMany, ManyToOne et ManyToMany - 📑 **Onglets organisés** : Crée automatiquement un onglet par entité avec des informations détaillées - 🗂️ **Feuille d'index** : Génère une feuille d'index avec la liste complète de toutes les entités - 🧹 **Nettoyage automatique** : Efface les données précédentes avant chaque export - 💻 **Interface en ligne de commande** : Commande Symfony simple et intuitive - 🔐 **Authentification Google** : Intégration sécurisée avec l'API Google Sheets Prérequis --------- [](#prérequis) - PHP >= 8.2 - Symfony Framework 7.0 ou 8.0 - Doctrine ORM >= 3.0 - Google API Client >= 2.15 Installation ------------ [](#installation) ### 1. Installer via Composer [](#1-installer-via-composer) ``` composer require gponty/entity-to-google-sheets-bundle ``` ### 2. Enregistrer le bundle [](#2-enregistrer-le-bundle) Si vous n'êtes pas sur une version totalement récente de Symfony, enregistrez le bundle dans `config/bundles.php` : ``` return [ // ... TonVendor\EntityToGoogleSheetsBundle\EntityToGoogleSheetsBundle::class => ['all' => true], ]; ``` ### 3. Configurer les identifiants Google [](#3-configurer-les-identifiants-google) #### Créer un projet Google Cloud [](#créer-un-projet-google-cloud) 1. Allez sur [Google Cloud Console](https://console.cloud.google.com/) 2. Créez un nouveau projet 3. Activez l'API **Google Sheets API** 4. Créez un compte de service 5. Téléchargez le fichier de clés JSON #### Ajouter une variable d'environnement [](#ajouter-une-variable-denvironnement) Dans votre fichier `.env` : ``` GOOGLE_SHEETS_SPREADSHEET_ID=your_spreadsheet_id_here GOOGLE_SHEETS_CREDENTIALS_PATH=%kernel.project_dir%/credentials/google-credentials.json ``` #### Partager le spreadsheet avec le compte de service [](#partager-le-spreadsheet-avec-le-compte-de-service) ⚠️ **Étape importante** : Vous devez donner accès au Google Sheet au compte de service. 1. Ouvrez le fichier `google-credentials.json` que vous avez téléchargé 2. Trouvez le champ `"client_email"`, par exemple : `my-service-account@my-project.iam.gserviceaccount.com` 3. Allez sur votre [Google Sheet](https://sheets.google.com/) 4. Cliquez sur le bouton **"Partager"** en haut à droite 5. Collez l'email du compte de service (`client_email`) 6. Donnez les permissions **"Éditeur"** (Editor) 7. Cliquez sur **"Partager"** Sans cette étape, le bundle ne pourra pas accéder au spreadsheet et l'export échouera avec une erreur d'authentification. Utilisation ----------- [](#utilisation) ### Exécuter l'export [](#exécuter-lexport) ``` php bin/console app:export-entities-to-sheets ``` Cette commande va : 1. Lire toutes les entités Doctrine enregistrées 2. Créer ou mettre à jour les onglets Google Sheets correspondants 3. Remplir chaque onglet avec les informations de l'entité 4. Générer une feuille d'index avec la liste complète ### Exemple de sortie [](#exemple-de-sortie) ``` Export des entités vers Google Sheets ==================================== Lecture des entités Doctrine... 15 entité(s) trouvée(s). Export vers Google Sheets... [████████████████████████] 100% ✓ Export terminé avec succès ! 🎉 ``` Bonnes pratiques ---------------- [](#bonnes-pratiques) ### Lancer la commande à chaque déploiement [](#lancer-la-commande-à-chaque-déploiement) 🎯 **Conseil important** : Il est recommandé de lancer la commande à la fin de chaque déploiement pour s'assurer que votre Google Sheet reste toujours synchronisé avec votre structure de base de données. #### Via un script de déploiement [](#via-un-script-de-déploiement) Ajouter la commande dans votre script de déploiement (par exemple dans `deploy.sh`) : ``` #!/bin/bash # ... autres commandes de déploiement ... # Étapes classiques composer install --no-dev --optimize-autoloader php bin/console doctrine:migrations:migrate --no-interaction php bin/console cache:clear --env=prod # ✨ Export automatique vers Google Sheets php bin/console app:export-entities-to-sheets echo "✓ Déploiement terminé !" ``` #### Via un hook Symfony (post-deploy) [](#via-un-hook-symfony-post-deploy) Si vous utilisez Symfony Flex ou un orchestrateur (Capistrano, Deployer, etc.), intégrez la commande dans votre config : ``` # config/services.yaml (exemple avec Capistrano) deploy: post-deploy: - php bin/console app:export-entities-to-sheets ``` #### Via un job cron (mise à jour périodique) [](#via-un-job-cron-mise-à-jour-périodique) Pour une mise à jour automatique périodique : ``` # Ajouter dans crontab 0 2 * * * cd /path/to/project && php bin/console app:export-entities-to-sheets >> /var/log/sheets-export.log 2>&1 ``` Cela va exécuter l'export chaque nuit à 2h du matin. Attribut `SheetDescription` --------------------------- [](#attribut-sheetdescription) Le bundle fournit un attribut PHP `SheetDescription` qui permet d'ajouter des descriptions personnalisées sur vos entités et leurs propriétés. Ces descriptions seront exportées dans Google Sheets aux côtés des métadonnées techniques. ### Sur une classe d'entité [](#sur-une-classe-dentité) ``` use Gponty\EntityToGoogleSheetsBundle\Attribute\SheetDescription; #[SheetDescription('Représente un utilisateur de la plateforme')] class User { // ... } ``` ### Sur les propriétés [](#sur-les-propriétés) ``` use Doctrine\ORM\Mapping as ORM; use Gponty\EntityToGoogleSheetsBundle\Attribute\SheetDescription; #[ORM\Entity] #[SheetDescription('Représente un utilisateur de la plateforme')] class User { #[ORM\Id] #[ORM\GeneratedValue] #[ORM\Column] #[SheetDescription('Identifiant unique de l\'utilisateur')] private ?int $id = null; #[ORM\Column(length: 180, unique: true)] #[SheetDescription('Adresse email utilisée pour la connexion')] private string $email; #[ORM\Column] #[SheetDescription('Date de création du compte')] private \DateTimeImmutable $createdAt; #[ORM\ManyToOne(targetEntity: Company::class)] #[SheetDescription('Entreprise à laquelle l\'utilisateur est rattaché')] private ?Company $company = null; } ``` L'attribut est optionnel : si aucune description n'est définie, la colonne description sera simplement vide dans le Google Sheet. Structure des données exportées ------------------------------- [](#structure-des-données-exportées) ### Chaque onglet d'entité contient : [](#chaque-onglet-dentité-contient-) ColonneDescription**Nom du champ**Nom de la propriété de l'entité**Colonne DB**Nom de la colonne en base de données**Type**Type de données (string, integer, datetime, etc.)**Nullable**Si le champ peut être nul**Longueur**Longueur maximale du champ (s'applicable)**Unique**Si le champ a une contrainte UNIQUE**ID**Si c'est la clé primaire### Feuille d'index [](#feuille-dindex) Une feuille d'index est créée avec : - Liste de toutes les entités - Tableau correspondant - Nombre de champs par entité - Dates de création et de modification Configuration avancée --------------------- [](#configuration-avancée) ### Services personnalisés [](#services-personnalisés) Le bundle enregistre automatiquement les services suivants : - `entity_to_google_sheets.entity_reader` : Lecteur d'entités Doctrine - `entity_to_google_sheets.sheets_exporter` : Exportateur Google Sheets Vous pouvez les injecter dans vos propres services : ``` use Gponty\EntityToGoogleSheetsBundle\Service\EntityReader; use Gponty\EntityToGoogleSheetsBundle\Service\GoogleSheetsExporter; class MonService { public function __construct( private readonly EntityReader $entityReader, private readonly GoogleSheetsExporter $exporter, ) {} public function faireQuelquechose() { $entities = $this->entityReader->getAllEntities(); $this->exporter->export($entities); } } ``` Gestion des erreurs ------------------- [](#gestion-des-erreurs) En cas d'erreur lors de l'authentification Google ou de l'accès au Spreadsheet : ``` # Vérifiez que le fichier credentials.json existe et est valide # Vérifiez que le SPREADSHEET_ID est correct # Vérifiez que le compte de service a accès au spreadsheet ``` Architecture ------------ [](#architecture) ### Classes principales [](#classes-principales) #### `EntityReader` [](#entityreader) Lit les métadonnées de toutes les entités Doctrine enregistrées et extrait : - Les noms des champs et leurs types - Les colonnes de base de données - Les relations (OneToOne, OneToMany, ManyToOne, ManyToMany) - Les contraintes (nullable, unique, length) #### `GoogleSheetsExporter` [](#googlesheetsexporter) Gère l'interaction avec l'API Google Sheets : - Authentification via le compte de service - Création/suppression d'onglets - Insertion de données formatées - Mise en forme des feuilles #### `ExportEntitiesToSheetsCommand` [](#exportentitiestosheetscommand) Commande Symfony orchestrant le processus complet avec une interface utilisateur conviviale. Support des types de données ---------------------------- [](#support-des-types-de-données) Le bundle supporte les types Doctrine suivants : - **Chaînes** : string, text - **Numériques** : integer, smallint, bigint, decimal, float - **Booléens** : boolean - **Dates** : date, datetime, datetimetz, time - **JSON** : json, json\_array - **Relations** : one\_to\_one, one\_to\_many, many\_to\_one, many\_to\_many Limitations ----------- [](#limitations) - Les données binaires (BLOB) ne sont pas exportées - Les relations circulaires affichent uniquement le nom de la jointure - Google Sheets a une limite d'environ 5 millions de cellules par feuille Performance ----------- [](#performance) Pour les projets avec un grand nombre d'entités : - L'export est optimisé pour minimiser les appels API Google - Les métadonnées sont cachées en mémoire - Le traitement est linéaire par rapport au nombre d'entités Dépannage --------- [](#dépannage) ### L'export échoue avec "Unable to authenticate" [](#lexport-échoue-avec-unable-to-authenticate) - Vérifiez que les identifiants Google sont corrects - Assurez-vous que le compte de service a accès au spreadsheet - Vérifiez que l'API Google Sheets est activée ### Aucune entité n'est trouvée [](#aucune-entité-nest-trouvée) - Vérifiez que vos entités sont correctement mappées avec Doctrine - Assurez-vous que le gestionnaire d'entités Doctrine est fonctionnel ### L'export s'arrête au bout d'un certain temps [](#lexport-sarrête-au-bout-dun-certain-temps) - Ce peut être une limite de l'API Google. Attendez quelques minutes avant de réessayer Licence ------- [](#licence) Ce bundle est sous licence MIT. Voir [LICENSE](LICENSE) pour plus de détails. Contribution ------------ [](#contribution) Les contributions sont les bienvenues ! Pour contribuer : 1. Forkez le repository 2. Créez une branche pour votre feature (`git checkout -b feature/AmazingFeature`) 3. Commitez vos changements (`git commit -m 'Add some AmazingFeature'`) 4. Poussez vers la branche (`git push origin feature/AmazingFeature`) 5. Ouvrez une Pull Request Auteur ------ [](#auteur) Développé par **gponty** Changelog --------- [](#changelog) ### Version 1.0.0 [](#version-100) - ✨ Release initiale - 📊 Support complet de l'export des entités Doctrine - 🔄 Gestion des relations - 📑 Génération automatique d'onglets ### Health Score 43 — FairBetter than 89% of packages Maintenance89 Actively maintained with recent releases Popularity15 Limited adoption so far Community6 Small or concentrated contributor base Maturity50 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~42 days Total 4 Last Release 55d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/34276317?v=4)[Guillaume Ponty](/maintainers/gponty)[@gponty](https://github.com/gponty) --- Top Contributors [![gponty](https://avatars.githubusercontent.com/u/34276317?v=4)](https://github.com/gponty "gponty (7 commits)") ### Embed Badge ![Health badge](/badges/gponty-entity-to-google-sheets-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/gponty-entity-to-google-sheets-bundle/health.svg)](https://phpackages.com/packages/gponty-entity-to-google-sheets-bundle) ``` ### Alternatives [easycorp/easyadmin-bundle Admin generator for Symfony applications 4.3k18.3M430](/packages/easycorp-easyadmin-bundle)[rcsofttech/audit-trail-bundle Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking. 12017.1k](/packages/rcsofttech-audit-trail-bundle)[kimai/kimai Kimai - Time Tracking 4.8k9.4k1](/packages/kimai-kimai)[2lenet/crudit-bundle The easy like Crud'it Bundle. 1617.3k16](/packages/2lenet-crudit-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)