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

FacturaScripts est une solution ERP (Gestion des Ressources de l’Entreprise) et CRM (Gestion de la Relation Client) open source, puissante et flexible, parfaitement adaptée aux PME et aux travailleurs indépendants. Grâce à ServBay, un environnement de développement web local performant sous macOS, vous pouvez créer, tester et exécuter facilement un projet FacturaScripts sans configurations complexes.

Ce guide vous accompagne pas à pas dans l’installation et la configuration complète de FacturaScripts localement avec ServBay.

Présentation de FacturaScripts

FacturaScripts est un logiciel ERP et CRM open source développé sur PHP et le framework Bootstrap. Il vise à aider les entreprises à gérer leurs processus métier essentiels, notamment :

• Émission et gestion des factures
• Comptabilité
• Gestion des stocks
• Gestion des clients et fournisseurs
• Gestion de projet
• Et de nombreuses autres fonctionnalités via des modules et plugins...

En tant que projet open source dynamique, FacturaScripts bénéficie d’une forte communauté et permet d’étendre ou personnaliser ses fonctionnalités via des plugins pour répondre à des besoins métiers variés.

Principales caractéristiques et avantages de FacturaScripts

• Open Source et gratuit : Aucun coût de licence ; utilisation, modification et distribution libres.
• Fonctionnalités complètes : Répond à la plupart des besoins quotidiens des PME avec une solution tout-en-un.
• Interface intuitive : Une prise en main rapide grâce à une interface claire et ergonomique.
• Extensible : Large écosystème de plugins et une API ouverte pour l’ajout de fonctionnalités ou l’intégration à d’autres services.
• Accessible multiplateforme : Basé sur le web, fonctionne depuis tout appareil disposant d’un navigateur moderne.
• Communauté active : Profitez d’un support international par la communauté d’utilisateurs et de développeurs.
• Support multilingue : Interface disponible en plusieurs langues pour s’adapter aux utilisateurs du monde entier.

Pourquoi utiliser ServBay pour exécuter FacturaScripts ?

ServBay est un environnement de développement web local conçu pour les développeurs. Il propose tous les composants nécessaires pour faire fonctionner des applications PHP comme FacturaScripts : serveur Apache ou Nginx, multiples versions de PHP, bases de données MySQL/MariaDB/PostgreSQL, Redis, etc., le tout administré via une interface graphique intuitive.

Les atouts et étapes clés pour utiliser ServBay avec FacturaScripts sont :

• Environnement intégré : Tous les composants nécessaires (serveur web, PHP, base de données) sont préinstallés et configurés, éliminant la complexité d’installer chaque logiciel séparément.
• Gestion des versions PHP : Passage simple d’une version PHP à l’autre pour s’assurer de la compatibilité avec FacturaScripts.
• Gestion de bases de données : Outils comme phpMyAdmin ou Adminer intégrés pour créer et administrer aisément la base de données et les utilisateurs pour FacturaScripts.
• Création simplifiée de sites : Génération rapide d'un site local avec la configuration du domaine, du répertoire racine, du serveur web et de la version PHP via l’UI ServBay.
• Gestion automatique du fichier Hosts : ServBay s’occupe de la configuration du fichier hosts local afin que vous puissiez accéder à votre projet avec un nom de domaine personnalisé, comme facturascripts.servbay.demo.
• Support SSL : Configuration simple de SSL/HTTPS grâce à une autorité utilisateur intégrée ou un service ACME public, pour simuler l’environnement de production.

Résumé des étapes de mise en œuvre de FacturaScripts avec ServBay :

1. Télécharger le code source de FacturaScripts.
2. Créer un dossier de projet dans le répertoire racine de sites de ServBay.
3. Créer la base de données MySQL et l’utilisateur nécessaires pour FacturaScripts.
4. Configurer le serveur web (Apache ou Nginx) de ServBay pour pointer vers le dossier du projet.
5. Vérifier et activer les extensions PHP requises.
6. Accéder au domaine local dans le navigateur et suivre l’assistant d’installation de FacturaScripts.

Prérequis

Avant de commencer, assurez-vous d’avoir :

• Téléchargé, installé et lancé ServBay sur votre macOS. Obtenez la dernière version sur le site officiel de ServBay.
• Démarré les principaux composants : serveur web (Apache ou Nginx selon votre choix), PHP (version désirée) et la base de données MySQL ou MariaDB dans l’interface ServBay.
• De solides notions de base en développement web et gestion de bases de données.

Créer un projet FacturaScripts (à partir du package Zip)

Il s’agit de la méthode la plus simple et la plus répandue pour installer FacturaScripts localement.

1. Téléchargez FacturaScripts :

   • Rendez-vous sur la page de téléchargement officielle de FacturaScripts https://facturascripts.com/descargar.
   • Repérez le dernier package stable en .zip et téléchargez-le sur votre Mac.

2. Créez le dossier du projet :

   • Dans le Finder, accédez au dossier racine gérant les sites locaux de ServBay. Par défaut, le chemin recommandé est /Applications/ServBay/www/.
   • Créez un nouveau dossier pour le projet FacturaScripts, par exemple : facturascripts_project.
   • Exemple de chemin complet : /Applications/ServBay/www/facturascripts_project

3. Décompressez les fichiers :

   • Double-cliquez sur l’archive .zip de FacturaScripts pour l’extraire.
   • Copiez ou déplacez tous les fichiers et dossiers extraits (par exemple : index.php, Core, Dinamic, Plugins…) dans le dossier /Applications/ServBay/www/facturascripts_project que vous venez de créer.

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

FacturaScripts requiert une base de données pour stocker données métiers, utilisateurs et configurations. Utilisez l’instance MySQL ou MariaDB administrée par ServBay : les deux sont entièrement supportées.

1. Vérifiez le fonctionnement de la base de données :

   • Ouvrez l’application ServBay.
   • Dans le menu de gauche, allez dans “Packages” puis “MySQL” ou “MariaDB” (selon votre préférence).
   • Assurez-vous que votre base sélectionnée soit démarrée. Sinon, cliquez sur l’interrupteur pour la lancer.

2. Créez la base de données et un utilisateur :

   • Utilisez l’outil intégré d’administration de bases de données (phpMyAdmin, souvent inclus avec MySQL/MariaDB) ou l’accès terminal fourni par ServBay pour créer la base et l’utilisateur. Pour les débutants, phpMyAdmin est recommandé.
   • Avec phpMyAdmin (recommandé) :
     • Dans l’interface ServBay, repérez la section “Base de données”. Cliquez sur l’icône phpMyAdmin à droite de l’instance souhaitée. La page de connexion s’ouvre dans votre navigateur.
     • Connectez-vous avec l’utilisateur root et le mot de passe défini à l’installation de ServBay. En cas d’oubli, la réinitialisation du mot de passe root est possible via les paramètres de ServBay pour la base concernée.
     • Une fois connecté, cliquez sur l’onglet “Bases de données” en haut.
     • Dans le champ “Créer une base de données”, saisissez le nom (ex. facturascripts_servbay_db). Privilégiez la clarté et évitez les conflits.
     • Choisissez l’encodage utf8mb4_general_ci ou utf8mb4_unicode_ci pour un support optimal des caractères et emojis.
     • Cliquez sur “Créer”.
     • Créer un utilisateur dédié (fortement recommandé) : Pour la sécurité, créez un nouvel utilisateur spécifique pour FacturaScripts :
       • Retournez à la page d’accueil puis cliquez sur “Comptes utilisateurs” en haut.
       • Cliquez sur “Ajouter un utilisateur”.
       • Entrez un nom d’utilisateur (par ex. facturascripts_servbay_user), choisissez localhost ou 127.0.0.1 comme hôte.
       • Définissez un mot de passe robuste et conservez-le soigneusement.
       • Plus bas, cochez “Créer une base de données portant son nom…” ou attribuez les privilèges nécessaires à la base créée un peu plus haut (facturascripts_servbay_db). Cochez “Tous les privilèges” (ALL PRIVILEGES).
       • Validez avec le bouton d’exécution en bas de page.

3. Notez les informations de connexion : Lors de l’installation de FacturaScripts, ces informations vous seront demandées :

   • Nom de la base de données (ex. facturascripts_servbay_db)
   • Nom d’utilisateur (ex. facturascripts_servbay_user)
   • Mot de passe créé pour l’utilisateur
   • Hôte de la base (en général localhost ou 127.0.0.1)
   • Port (par défaut 3306, vérifiez dans ServBay le port réellement utilisé par votre instance MySQL/MariaDB)

Configuration du serveur web (Apache ou Nginx)

Vous devez à présent indiquer à ServBay comment servir les fichiers de votre projet FacturaScripts via le serveur web de votre choix. Apache et Nginx sont tous deux entièrement supportés.

1. Lancez le serveur web :

   • Dans l’interface “Packages” de ServBay, vérifiez que votre serveur web préféré (Apache ou Nginx) est bien démarré.

2. Ajoutez un nouveau site web :

   • Allez dans le menu “Sites” de ServBay.
   • Cliquez sur le bouton “+” au-dessus de la liste des sites pour créer une nouvelle configuration.
   • Précisez les paramètres suivants dans la fenêtre qui s’affiche :
     • Nom : Donnez un nom clair, ex. : FacturaScripts Demo Site.
     • Domaine : Saisissez le domaine local voulu, idéalement avec le suffixe .servbay.demo, ex. : facturascripts.servbay.demo.
     • Type de site : Sélectionnez PHP puisque FacturaScripts est une application PHP.
     • Répertoire racine : Cliquez sur “Parcourir” et sélectionnez le dossier du projet (/Applications/ServBay/www/facturascripts_project).
       Note : Certains frameworks requièrent de pointer vers un sous-dossier (comme public ou web), mais pour FacturaScripts le dossier racine du projet suffit généralement. Consultez la documentation officielle si besoin.
     • Version de PHP : Choisissez une version compatible (souvent PHP 8.1, 8.2 ou ultérieure – consultez la documentation FacturaScripts pour la version recommandée). ServBay vous permet de sélectionner et de changer facilement de version.
     • Paramètres avancés : Les valeurs par défaut conviennent dans la majorité des cas. ServBay facilite également la configuration SSL/HTTPS (certificats CA ServBay ou ACME), CORS, etc., selon vos besoins.

3. Sauvegardez et mettez à jour Hosts :

   • Après avoir complété la configuration, cliquez sur “Ajouter” ou “Sauvegarder”.
   • ServBay crée automatiquement le virtual host (Apache) ou le bloc serveur (Nginx) approprié, et demande des droits administrateur afin d’éditer le fichier hosts système. Cela permet d’associer votre domaine local (facturascripts.servbay.demo) à 127.0.0.1, accessible depuis votre navigateur sans manipuler le fichier hosts manuellement.

4. Vérifiez/activez les extensions PHP nécessaires :

   • FacturaScripts requiert l’activation de certaines extensions PHP : pdo_mysql, gd (graphismes), intl (internationalisation), zip (compression), xml, curl (requêtes HTTP), etc. De nombreuses extensions sont actives par défaut dans ServBay, mais vérifiez lors de l’installation ou en cas de message d’erreur.
   • Pour activer une extension PHP dans ServBay :
     • Dans le menu “Langages” de ServBay, sélectionnez “PHP”.
     • Sélectionnez la version utilisée par le site facturascripts.servbay.demo (ex. PHP 8.2).
     • Cliquez sur l’onglet “Extensions”.
     • Parcourez la liste, cochez l’extension manquante (ex. : opcache) et validez.
     • Cliquez en bas sur “Appliquer” ou “Sauvegarder”. Certaines modifications requièrent un redémarrage du service PHP correspondant : redémarrez-le depuis ServBay via le bouton dédié.

Exemple de configuration de site sur ServBay

Accéder au site et finaliser l’installation de FacturaScripts

Votre environnement ServBay est maintenant prêt à exécuter FacturaScripts, et vous pouvez débuter l’installation via l’assistant en ligne.

1. Ouvrez votre navigateur : Lancez Chrome, Firefox, Safari ou un autre navigateur de votre choix.

2. Rendez-vous à l’adresse configurée : Dans la barre d’adresse, entrez le domaine local défini précédemment, ex. : http://facturascripts.servbay.demo. Si vous avez mis en place un certificat SSL via ServBay, essayez également en https://facturascripts.servbay.demo, puis appuyez sur la touche Entrée.

3. Assistant d’installation FacturaScripts :

   • Si le site, la configuration des hosts et les services Apache/Nginx et PHP sont opérationnels, vous verrez la page de bienvenue ou l’assistant d’installation de FacturaScripts.
   • Choix de la langue : Sélectionnez la langue d’interface souhaitée.
   • Vérification du système : L’assistant contrôle automatiquement la version PHP, les extensions, les permissions sur les dossiers, etc. Si tout est bien configuré, vous obtiendrez des voyants verts. Un indicateur rouge ou jaune ? Vérifiez manuellement la version PHP, les extensions activées, ou les permissions sur le dossier projet (/Applications/ServBay/www/facturascripts_project), qui doit être accessible en écriture par l’utilisateur du serveur web.
   • Configuration de la base de données : Saisissez les informations notées précédemment :
     • Type de base : MySQL.
     • Hôte : localhost ou 127.0.0.1.
     • Port : 3306 (ou celui indiqué dans ServBay).
     • Nom de la base : facturascripts_servbay_db.
     • Utilisateur : facturascripts_servbay_user.
     • Mot de passe : celui créé précédemment.
     • Préfixe des tables : Laissez fs_ ou personnalisez-le.
   • Compte administrateur : Définissez l’identifiant, le mot de passe et l’email du compte administrateur pour l’interface d’administration de FacturaScripts. Choisissez un mot de passe sécurisé et n’oubliez pas ces informations !
   • Lancement de l’installation : Vérifiez toutes les informations, puis lancez l’installation. FacturaScripts va créer les tables nécessaires dans la base, configurer l’application et écrire les fichiers de configuration.

4. Après l’installation :

   • Si l’installation réussit, FacturaScripts vous demandera peut-être de supprimer le dossier install du projet pour des raisons de sécurité. Suivez cette indication.
   • Vous pouvez maintenant accéder à votre page de connexion sur http://facturascripts.servbay.demo (ou son équivalent HTTPS) et vous connecter avec le compte administrateur créé. Profitez de toutes les fonctionnalités de FacturaScripts !

FAQ (Foire Aux Questions)

• Q : L’assistant FacturaScripts affiche un manque d’extension PHP, que faire ?
  • R : Ouvrez ServBay, allez dans “Langages” > “PHP”, sélectionnez la version du site et cliquez sur “Extensions”. Activez celle(s) manquante(s) (ex. opcache), cliquez sur “Appliquer” puis redémarrez le service PHP si besoin.
• Q : J’obtiens un message “Forbidden” ou une page blanche sur facturascripts.servbay.demo ?
  • R : Contrôlez d’abord que le serveur web (Apache/Nginx) et PHP tournent bien. Vérifiez que le répertoire racine pointe bien vers le dossier du projet (/Applications/ServBay/www/facturascripts_project). Si la page est blanche, consultez les logs d’erreur Apache/Nginx ou PHP via l’interface ServBay. En cas de “Forbidden”, contrôlez les droits d’accès des fichiers et assurez-vous que l’utilisateur du serveur web est autorisé à lire et écrire dans les dossiers (comme Dinamic).
• Q : L’assistant FacturaScripts n’arrive pas à se connecter à la base de données ?
  • R : Vérifiez que MySQL/MariaDB tourne bien sur le bon port (3306 normalement). Contrôlez les informations entrées (hôte, port, base, utilisateur, mot de passe) et qu'elles correspondent à celles créées dans ServBay.

Conclusion

Grâce à ServBay, installer et exécuter FacturaScripts localement sur macOS est rapide et intuitif. Tous les prérequis (serveur web, PHP, base de données) sont fournis dans un environnement graphique convivial, ce qui simplifie grandement les configurations. Suivez simplement les étapes de ce guide pour tirer profit d’une instance locale de FacturaScripts pour le développement ou les tests : concentrez-vous sur les fonctionnalités et la gestion métier de votre projet. ServBay vous apporte toute la souplesse et la sérénité nécessaires pour booster votre productivité en développement local.