PHP Reporting Library For MYSQL

Moteur de rapports intelligents - Édition communautaire

Smart Report Engine est un framework de reporting PHP convivial qui permet la création sans effort de rapports professionnels par programmation au sein de vos projets.

Commencer

1- Vous avez la possibilité de cloner l'édition communautaire de Smart Report Engine ou de la télécharger directement depuis cette page de téléchargement.

2- Après le téléchargement, extrayez le dossier compressé pour révéler la structure de SmartReportEngine. Le contenu ressemblera à quelque chose de similaire à ce qui suit :

├── SmartReportingEngine/
├── sre_config/
   └── config.php
├── sre_reports/
├── db/
  └── example.sql
├── examples/
└── sre_bootstrap.php

3- Pour lancer votre premier projet sur votre serveur, vous devez importer un exemple de base de données MySQL. Ce processus vous permettra de démarrer en douceur avec Smart Report Engine.

• Dans le package téléchargé de Smart Report Engine, localisez le fichier « /db/example.sql » dans le répertoire « db ». Ce fichier SQL contient les commandes nécessaires pour créer et remplir une seule table MySQL nommée « éléments »
• Sélectionnez la base de données MySQL pour la première configuration de votre projet. Vous pouvez opter pour une base de données existante ou en créer une nouvelle spécifiquement pour ce projet.
• Importez le fichier "example.sql" dans la base de données MySQL de votre choix. Cela créera la table « éléments » et la remplira avec les données initiales.

4- Configurer la chaîne de connexion à la base de données

• Accédez au répertoire « sre_config » dans le package Smart Report Engine Community Edition. Vous y trouverez le fichier "config.php". Veuillez ouvrir ce fichier en utilisant l'éditeur de texte de votre choix.
• Dans le fichier "config.php", vous trouverez une section dédiée à la configuration de la base de données. Mettez à jour la chaîne de connexion avec les détails appropriés de la base de données MySQL dans laquelle vous avez importé l'exemple de fichier SQL lors de la 3ème étape. Assurez-vous de fournir le nom d'hôte, le nom de base de données, le nom d'utilisateur et le mot de passe corrects dans leurs champs respectifs.

5- Enregistrez les modifications dans le fichier "config.php".

6- Dans le répertoire "/examples" de Community Edition, vous trouverez trois exemples utiles pour vous aider à démarrer avec Smart Report Engine. Pour exécuter l’un de ces exemples, accédez simplement à leurs URL depuis votre navigateur Web. Cela vous permettra de visualiser le rapport généré en fonction du code de chaque exemple.

7- Si vous préférez créer les exemples de projets à partir de zéro, veuillez passer à l'étape 8 du processus d'installation.

REMARQUE : quel que soit votre choix, les sections de présentation du code fourniront des explications sur le code dans chaque exemple.

8- Pour commencer à écrire votre premier projet, vous aurez besoin d'un nouveau script PHP. Pour les besoins de ce didacticiel, vous pouvez ajouter le script au répertoire racine de l'édition communautaire, à côté du fichier "sre_bootstrap.php". Si vous avez téléchargé manuellement l'édition communautaire (sans utiliser Composer), vous devrez exiger le fichier de chargement automatique « sre_bootstrap.php » dans votre code, comme démontré dans l'exemple ci-dessous. Si votre code est placé à des emplacements différents pour d'autres projets, assurez-vous d'ajuster le chemin d'accès à ce fichier de chargement automatique en conséquence. Veuillez suivre ces étapes pour démarrer votre projet :

• Créez un nouveau script PHP pour votre projet.
• Vous pouvez éventuellement placer le script dans le répertoire racine de l'édition communautaire (même niveau que "sre_bootstrap.php") pour les besoins de ce didacticiel.
• Dans votre premier nouveau projet, essayez d’écrire le code PHP simple suivant. Cela devrait fonctionner sans aucun problème.

use SRE E ngine C ustomEngine ;
use SRE E ngine R eportOptions ;

require_once " sre_bootstrap.php " ;

try {

   $report = new ReportOptions ();
   $report - > select_tables( " items " )
           - > set_grouping( " country " )
           - > set_title( " Items Per country " )
           ->select_all_fields ();
   $engine = new CustomEngine( $report ) ;
   $report_path = $engine->create_report ();
   if ( $report_path ) {
      // The user will be redirected to the URL of the generated report. All generated reports are stored as subdirectories under /sre_reports.
      header( " location: " . $report_path ) ;
      exit ();
   }
} catch (Exception $e ) {
   echo $e->getMessage ();
}

Générer ce rapport

Procédure pas à pas du code : comprendre l'exemple

Le code donné montre un exemple de base d'utilisation efficace de Smart Report Engine. Parcourons le code étape par étape pour comprendre son fonctionnement :

• Espaces de noms : le code donné utilise deux espaces de noms, "SREEngineCustomEngine" et "SREEngineReportOptions". Ces espaces de noms aident à organiser et à accéder à des parties spécifiques du code.
• Nécessitant « sre_bootstrap.php » : si vous avez téléchargé manuellement l'édition communautaire (sans utiliser Composer), vous devez ajouter un fichier spécial appelé « sre_bootstrap.php » à votre code.
• Création de l'objet ReportOptions : Le code initialise un objet de la classe "ReportOptions". Cet objet est chargé de définir les options nécessaires à votre rapport. Vous pouvez personnaliser diverses options, en gardant à l'esprit que certaines fonctionnalités sont exclusives à l'édition commerciale.
• Passage de l'objet ReportOptions à CustomEngine : Une fois que vous avez défini vos options de rapport, vous transmettez l'objet "ReportOptions" au constructeur de la classe "CustomEngine". Cette classe gère la création de votre rapport en fonction des options fournies.
• Appel de la fonction CreateReport : Pour générer votre rapport, vous appelez la fonction "CreateReport" à l'aide de l'objet "CustomEngine". Cette fonction traite les options définies et génère le rapport. Une fois la création réussie, il renvoie l'URL du rapport. Tous les rapports générés à l'aide de Smart Report Engine seront automatiquement enregistrés dans le répertoire "sre_reports".

Liens importants

• Plus d'exemples
• Comparaison détaillée des licences Pour vous aider à mieux comprendre les distinctions entre les éditions communautaires et commerciales, nous avons fourni un aperçu concis sur cette page. Il met en évidence les principales différences de fonctionnalités et de cas d'utilisation pour chaque version.
• Dépannage de Smart Report Engine L'objectif de cette section de la documentation est de guider les utilisateurs à travers les points de contrôle essentiels à prendre en compte lorsqu'ils rencontrent des problèmes lors du processus de génération de rapports avec Smart Report Engine. De plus, nous explorerons la fonctionnalité de journalisation de Smart Report Engine, qui aide à résoudre les problèmes potentiels pouvant survenir dans les rapports générés.
• Documentation de Smart Report Engine Dans cette section, vous découvrirez une documentation complète et des exemples pour chaque classe, méthode et constante intégrées de Smart Report Engine.
• Quoi de neuf Cette section englobera les dernières fonctionnalités introduites dans Smart Report Engine.
• Page d'accueil du moteur de rapports intelligent
• Contactez-nous

Licence édition communautaire

L'édition communautaire vous permet de :

• Expérimentez avec Smart Report Engine (fonctionnalités non Premium uniquement).
• Utilisez librement Smart Report Engine pour un usage personnel.
• Intégrez librement Smart Report Engine dans des projets open source gratuits tant que vous respectez nos revendications en matière de droits d'auteur.

L'édition communautaire vous interdit de :

• Accéder aux fonctionnalités Premium.
• Intégration de Smart Report Engine dans des projets commerciaux ou SaaS.
• Suppression de la revendication « Propulsé par » des rapports générés par l'édition communautaire de Smart Report Maker.

REMARQUE : En utilisant l'une de nos éditions commerciales, vous avez accès à toutes les fonctionnalités premium, ainsi qu'à la suppression de toutes les restrictions communautaires mentionnées ci-dessus.

Moteur de rapports intelligent Pro

Smart Report Engine Pro est une version avancée de Smart Report Engine, donnant accès à toutes ses fonctionnalités premium. Au prix de seulement 64 $ pour une licence d'équipe, l'édition Pro offre de nombreux avantages, notamment :

• Accès complet à toutes les fonctionnalités Premium.
• Peut être utilisé dans des projets SaaS et commerciaux.
• Intégration sans effort avec tout système de connexion basé sur une session existant.
• Absence d'une attribution "Propulsé par" dans le pied de page des rapports générés.
• Une année gratuite de mises à niveau gratuites.
• Une réduction de 70 % sur les futurs frais de mise à niveau (après la période de mise à niveau gratuite).
• Support client prioritaire.
• La possibilité de déployer Smart Report Engine sur un nombre illimité de serveurs ou de projets.
• La licence d'équipe permet une utilisation par jusqu'à 7 développeurs, tandis que la licence d'entreprise autorise un nombre illimité de développeurs au sein de l'organisation.
• Gratuité (sans frais supplémentaires) lorsque vous avez livré Smart Report Engine avec votre produit commercial.

Auteur

Webuccino Créateur de produits faciles à utiliser depuis 2007