Créer et exécuter un projet FacturaScripts

FacturaScripts est une solution ERP et CRM open source puissante et flexible, idéale pour les petites et moyennes entreprises ainsi que les freelances. Grâce à l'environnement de développement local pratique fourni par ServBay, vous pouvez facilement créer, tester et exécuter des projets FacturaScripts sur votre système local macOS.

Ce guide vous conduira à travers le processus complet d'installation et de configuration de FacturaScripts en utilisant ServBay.

Qu'est-ce que FacturaScripts ?

FacturaScripts est un logiciel open source de planification des ressources d'entreprise (ERP) et de gestion de la relation client (CRM), développé sur les frameworks PHP et Bootstrap. Il est conçu pour aider les entreprises à gérer leurs processus métier essentiels, y compris :

• Émission et gestion des factures
• Comptabilité
• Contrôle des stocks
• Gestion des clients et des fournisseurs
• Gestion de projets
• Et bien plus encore...

En tant que projet open source, il bénéficie d'un soutien communautaire actif et permet aux utilisateurs d'étendre et de personnaliser ses fonctionnalités via des plugins.

Principales caractéristiques et avantages de FacturaScripts

• Open source et gratuit : Pas de frais de licence élevés, utilisation et modification libres.
• Fonctionnalités complètes : Couvre la plupart des fonctionnalités essentielles requises pour le fonctionnement quotidien des petites et moyennes entreprises.
• Facile à utiliser : L'interface est relativement intuitive, avec une courbe d'apprentissage douce.
• Hautement extensible : Dispose d'un riche marché de plugins, permettant d'ajouter facilement de nouvelles fonctionnalités ou de s'intégrer à d'autres services.
• Multiplateforme : Basé sur le web, accessible sur tout appareil prenant en charge des navigateurs modernes.
• Communauté active : Obtenez de l'aide de la communauté en cas de problème.
• Support multilingue : Supporte plusieurs langues, facilitant son utilisation pour les utilisateurs de différentes régions.

Créer et exécuter un projet FacturaScripts avec ServBay

ServBay fournit un environnement local idéal pour exécuter des applications PHP comme FacturaScripts. Il intègre Nginx/Apache, plusieurs versions de PHP, MySQL/MariaDB/PostgreSQL et d'autres services courants, tout en offrant une interface graphique pour la gestion.

Les principales étapes pour exécuter FacturaScripts avec ServBay comprennent :

1. Télécharger le code source de FacturaScripts.
2. Créer un dossier de projet dans le répertoire géré par ServBay.
3. Créer la base de données MySQL et l'utilisateur nécessaires pour FacturaScripts.
4. Configurer le serveur web Apache via ServBay pour pointer vers le répertoire du projet.
5. Accéder via un navigateur et finaliser l'assistant d'installation de FacturaScripts.

Créer un projet FacturaScripts (à partir d'un package zip téléchargé)

C'est l'une des méthodes d'installation locale les plus courantes.

1. Télécharger FacturaScripts :

   • Visitez le site officiel de FacturaScripts (https://facturascripts.com/).
   • Allez dans la zone de téléchargement et trouvez la dernière version stable du package .zip pour le télécharger.

2. Créer un répertoire de projet :

   • Ouvrez Finder, naviguez jusqu'au répertoire où ServBay stocke les fichiers de site. Par défaut, il est recommandé de le placer dans /Applications/ServBay/www/.
   • Créez un nouveau dossier dans ce répertoire pour stocker le projet FacturaScripts, par exemple, nommez-le facturascripts_project.
   • Exemple de chemin complet : /Applications/ServBay/www/facturascripts_project

3. Décompresser les fichiers :

   • Décompressez le fichier .zip de FacturaScripts téléchargé dans le dossier facturascripts_project que vous venez de créer.
   • La décompression devrait aboutir à la présence de fichiers et dossiers dans facturascripts_project, tels que index.php, config.php (éventuellement créé après l'installation), Core, Dinamic, Plugins, etc.

Configuration initiale (configuration de la base de données MySQL, etc.)

FacturaScripts nécessite une base de données pour stocker toutes les données. Nous utiliserons le service MySQL géré par ServBay.

1. Assurez-vous que le service MySQL fonctionne :

   • Ouvrez l'application ServBay.
   • Dans le menu de gauche, sélectionnez « Services » - « MySQL ».
   • Assurez-vous que le service MySQL (ou MariaDB) est démarré. S'il n'est pas démarré, cliquez sur le bouton de commutation à côté pour l'activer.

2. Créer une base de données :

   • Vous pouvez créer la base de données en utilisant l'outil de gestion de base de données intégré de ServBay (comme phpMyAdmin) ou par ligne de commande.
   • Utilisation de phpMyAdmin (recommandé) :
     • Dans l'interface de ServBay, trouvez « Bases de données » - « MySQL », puis cliquez sur phpMyAdmin en haut à droite.
     • Connectez-vous à phpMyAdmin (généralement avec l'utilisateur root et le mot de passe que vous avez configuré dans ServBay).
     • Cliquez sur l'onglet « Bases de données ».
     • Dans le champ « Créer une base de données », saisissez le nom de la base de données, par exemple facturascripts_db.
     • Sélectionnez le bon jeu de caractères, recommandé utf8mb4_general_ci ou utf8mb4_unicode_ci.
     • Cliquez sur « Créer ».
   • Créer un utilisateur de base de données (facultatif mais recommandé) : Pour des raisons de sécurité, il est conseillé de créer un utilisateur de base de données dédié pour FacturaScripts, plutôt que d'utiliser l'utilisateur root.
     • Dans phpMyAdmin, retournez à la page d'accueil, cliquez sur l'onglet « Comptes d'utilisateur ».
     • Cliquez sur « Ajouter un compte d'utilisateur ».
     • Saisissez un nom d'utilisateur (par exemple facturascripts_user).
     • Sélectionnez localhost comme nom d'hôte.
     • Générez ou saisissez un mot de passe fort et veuillez le noter.
     • Cochez « Créer une base de données nommée après l'utilisateur et accordez tous les privilèges » ou allez manuellement à la section « Bases de données » pour accorder à ce nouvel utilisateur tous les privilèges sur la base de données facturascripts_db (ALL PRIVILEGES).
     • Cliquez sur « Exécuter » en bas de la page.

3. Notez les informations de la base de données : Conservez à l'esprit les informations suivantes que vous avez créées :

   • Nom de la base de données (facturascripts_db)
   • Nom d'utilisateur de la base de données (facturascripts_user)
   • Mot de passe de l'utilisateur de la base de données (le mot de passe que vous avez défini)
   • Hôte de la base de données (généralement localhost ou 127.0.0.1)
   • Port de la base de données (MySQL utilise par défaut le port 3306, que vous pouvez vérifier dans la liste des services de ServBay)

Ces informations seront utilisées lors de l'installation de FacturaScripts.

Configurer le serveur web (basé sur Apache)

Nous devons maintenant dire à ServBay comment servir notre projet FacturaScripts via le service Apache.

1. Assurez-vous que le service Apache fonctionne :

   • Dans l'interface « Services » de ServBay, assurez-vous que le service Apache est démarré.

2. Ajouter un hôte :

   • Dans le menu de gauche de ServBay, sélectionnez « Sites ».
   • Cliquez sur le bouton « + » à droite.
   • Dans la fenêtre de configuration qui s'ouvre, renseignez les informations suivantes :
     • Nom : Donnez un nom descriptif à cette configuration d'hôte, par exemple Démo FacturaScripts.
     • Nom de domaine : Saisissez le nom de domaine que vous souhaitez utiliser pour accéder au site FacturaScripts local. Pour les besoins de cet exemple, nous utilisons facturascripts.demo.
     • Type de site : Sélectionnez PHP, indiquant qu'il s'agit d'un site dynamique PHP.
     • Répertoire racine : Cliquez sur le bouton « Parcourir » ou « Choisir », et naviguez pour sélectionner le répertoire où vous avez précédemment créé et extrait les fichiers de FacturaScripts (/Applications/ServBay/www/facturascripts_project).
     • Serveur web : Sélectionnez Apache ainsi que la version d'Apache que vous souhaitez utiliser.
     • Version de PHP : Choisissez une version de PHP qui soit compatible avec votre version de FacturaScripts téléchargée (consultez les exigences système de FacturaScripts, les versions récentes et stables comme PHP 8.1 ou 8.2 étant généralement recommandées).
     • Autres paramètres : Laissez les paramètres par défaut, sauf si vous avez des besoins spécifiques.

3. Enregistrer la configuration :

   • Cliquez sur le bouton « Ajouter ».
   • ServBay configurera automatiquement les hôtes virtuels Apache et peut vous demander les droits d'administrateur pour modifier le fichier hosts du système afin de diriger facturascripts.demo vers l'IP locale (127.0.0.1). Veuillez autoriser cette opération.

4. Vérifier les extensions PHP :

   • FacturaScripts peut nécessiter des extensions PHP spécifiques pour fonctionner correctement (comme pdo_mysql, gd, intl, zip, etc.).
   • Dans ServBay, vous pouvez gérer les extensions PHP installées. Généralement, les extensions par défaut fournies avec ServBay sont suffisantes, mais si le processus d'installation indique des extensions manquantes, vous pouvez les activer dans la partie configuration PHP de ServBay.

Accéder au site

Maintenant, tout est prêt pour commencer le processus d'installation en ligne de FacturaScripts.

1. Ouvrez votre navigateur : Ouvrez votre navigateur web habituel (comme Chrome, Firefox, Safari).

2. Entrez l'adresse : Dans la barre d'adresse, tapez https://facturascripts.demo et appuyez sur Entrée.

3. Assistant d'installation de FacturaScripts :

   • Si tout est correctement configuré, vous devriez voir l'interface d'installation de FacturaScripts.
   • Sélection de la langue : Choisissez la langue que vous souhaitez utiliser.
   • Vérification du système : L'assistant d'installation vérifiera votre environnement serveur (version PHP, extensions requises, permissions de répertoire, etc.) pour s'assurer qu'il répond aux exigences. Si ServBay est correctement configuré, tout devrait être coché en vert ici. Si des problèmes apparaissent, vérifiez la configuration PHP ou les permissions des fichiers dans ServBay comme indiqué.
   • Configuration de la base de données : C'est une étape clé. Vous devez entrer les informations de la base de données que vous avez précédemment créées et notées :
     • Type de base de données : Sélectionnez MySQL.
     • Hôte : localhost ou 127.0.0.1.
     • Port : 3306 (ou le port MySQL que vous voyez dans ServBay).
     • Nom de la base de données : facturascripts_db.
     • Nom d'utilisateur : facturascripts_user.
     • Mot de passe : Le mot de passe que vous avez défini pour facturascripts_user.
     • Préfixe des tables : Vous pouvez conserver la valeur par défaut fs_.
   • Compte administrateur : Configurez le nom d'utilisateur, le mot de passe et l'email de l'administrateur de FacturaScripts. Assurez-vous de bien noter ces informations, car elles seront vos identifiants pour vous connecter à l'interface d'administration.
   • Installation : Cliquez sur le bouton d'installation, FacturaScripts créera les tables de la base de données et écrira le fichier de configuration.

4. Installation terminée :

   • Une fois l'installation réussie, il vous sera généralement demandé de supprimer le répertoire install (s'il existe et si cela est suggéré, pour des raisons de sécurité).
   • Vous devriez maintenant pouvoir accéder à votre page de connexion FacturaScripts via http://facturascripts.demo. Connectez-vous avec le compte administrateur que vous venez de configurer, et commencez à explorer et utiliser FacturaScripts !

---

Félicitations ! Vous avez réussi à créer et exécuter un projet FacturaScripts dans un environnement local macOS en utilisant ServBay. ServBay simplifie la configuration et la gestion de l'environnement serveur local, vous permettant de vous concentrer davantage sur le développement et l'utilisation de FacturaScripts.