CLI BoxLang
Installer BoxLang et utiliser le flux de travail natif bx-cli pour les dépendances, les serveurs, les migrations, et les tests.
CLI BoxLang
CBGenesis est une application BoxLang. Ses commandes box doivent être fournies par le module natif BoxLang bx-cli. La distribution CommandBox classique basée sur Lucee n'est pas prise en charge pour ce template.
Installation requise
Installez BoxLang avec l'installateur rapide ou BVM, puis installez bx-cli :
/bin/bash -c "$(curl -fsSL https://install.boxlang.io)"
Pour installer avec un runtime Java 21 lorsque Java n'est pas déjà disponible :
curl -fsSL https://install.boxlang.io | bash -s -- --with-jre
curl -fsSL https://install-bvm.boxlang.io | bash
bvm install latest
bvm use latest
Une fois BoxLang disponible, installez le module CLI :
install-bx-module bx-cli
box version
Redémarrez le terminal si box n'est pas trouvé immédiatement après l'installation. N'installez pas l'exécutable CommandBox classique basé sur Lucee en parallèle de ce flux de travail ; cela peut entraîner la sélection du mauvais runtime et des mauvais modules de commande.
Commandes quotidiennes
Exécutez-les depuis la racine du projet. Elles sont toutes exécutées par bx-cli :
| Commande | Objectif |
|---|---|
box install | Installer les dépendances de box.json dans lib/ |
box server start | Démarrer le serveur web BoxLang sur le port 8080 |
box server stop | Arrêter le serveur du projet |
box migrate up | Appliquer les migrations de base de données en attente |
box migrate down | Annuler le dernier lot de migration |
box migrate reset | Annuler toutes les migrations et les réappliquer |
box migrate seed run | Exécuter les données de départ : le rôle Admin, ses 20 permissions, et l'utilisateur administrateur en attente de réinitialisation |
box testbox run | Exécuter la suite TestBox - voir Tests pour le filtrage |
box task run path/to/task.cfc | Exécuter une tâche CommandBox via bx-cli |
box coldbox ai refresh | Synchroniser les directives et skills IA dans .agents/ avec vos modules installés |
box run-script format | Formater le code source BoxLang (app/, tests/specs/, *.bx à la racine) |
box run-script format:check | Vérifier le formatage sans écrire de modifications |
Le frontend utilise Node.js séparément :
npm install
npm run dev
npm run build
npm run lint
npm run lint:scss
Séquence de première exécution
install-bx-module bx-cli
box install
npm install
cp .env.example .env
box migrate up
box migrate seed run
box server start
npm run dev
Le serveur utilise server.json pour sélectionner boxlang@1, la racine web public/, le port 8080, et les modules BoxLang installés au premier démarrage. Voir Démarrage pour la configuration de la base de données et Configuration pour les variables d'environnement.
Dépannage
box: command not found: confirmez que BoxLang est installé, redémarrez le terminal, et assurez-vous que le répertoire de l'installateur est dans lePATH.- Messages du moteur Lucee ou CFML : l'exécutable CommandBox classique est utilisé. Retirez-le du
PATH, réinstallez BoxLang, et exécutezinstall-bx-module bx-cli. - Commandes de projet manquantes : exécutez
box versiondepuis la racine du projet puisbox installafin que les dépendances debox.jsonsoient disponibles. - Erreurs de connexion à la base de données : vérifiez
.env, assurez-vous que la base de données existe, et installez/démarrez le pilote JDBC via la configuration du serveur BoxLang.