CLI di BoxLang
Installa BoxLang e usa il workflow nativo bx-cli di BoxLang per dipendenze, server, migrazioni e test.
In questa pagina
CLI di BoxLang
CBGenesis è un'applicazione BoxLang. I suoi comandi box devono essere forniti dal modulo nativo bx-cli di BoxLang. La normale distribuzione CommandBox basata su Lucee non è supportata per questo template.
Installazione richiesta
Installa BoxLang con l'installer rapido oppure BVM, quindi installa bx-cli:
/bin/bash -c "$(curl -fsSL https://install.boxlang.io)"
Per installare con un runtime Java 21 quando Java non è già disponibile:
curl -fsSL https://install.boxlang.io | bash -s -- --with-jre
curl -fsSL https://install-bvm.boxlang.io | bash
bvm install latest
bvm use latest
Dopo che BoxLang è disponibile, installa il modulo CLI:
install-bx-module bx-cli
box version
Riavvia il terminale se box non viene trovato subito dopo l'installazione. Non installare l'eseguibile standard CommandBox basato su Lucee insieme a questo workflow; può causare la selezione del runtime e dei moduli di comando sbagliati.
Comandi quotidiani
Esegui questi dalla root del progetto. Sono tutti eseguiti da bx-cli:
| Comando | Scopo |
|---|---|
box install | Installa le dipendenze di box.json in lib/ |
box server start | Avvia il server web BoxLang sulla porta 8080 |
box server stop | Ferma il server del progetto |
box migrate up | Applica le migrazioni del database in sospeso |
box migrate down | Annulla l'ultimo batch di migrazioni |
box migrate reset | Annulla tutte le migrazioni e le riapplica |
box migrate seed run | Esegue i dati seed: il ruolo Admin, i suoi 20 permessi e l'utente admin reset-pending |
box testbox run | Esegue la suite TestBox - vedi Testing per il filtraggio |
box task run path/to/task.cfc | Esegue un task di CommandBox tramite bx-cli |
box coldbox ai refresh | Sincronizza le linee guida e le skill AI in .agents/ con i tuoi moduli installati |
box run-script format | Formatta il sorgente BoxLang (app/, tests/specs/, *.bx nella root) |
box run-script format:check | Verifica la formattazione senza scrivere modifiche |
Il frontend usa Node.js separatamente:
npm install
npm run dev
npm run build
npm run lint
npm run lint:scss
Sequenza di prima esecuzione
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
Il server usa server.json per selezionare boxlang@1, la webroot public/, la porta 8080 e i moduli BoxLang installati al primo avvio. Vedi Per iniziare per la configurazione del database e Configurazione per le variabili d'ambiente.
Risoluzione dei problemi
box: command not found: conferma che BoxLang sia installato, riavvia il terminale e assicurati che la directory dell'installer sia nelPATH.- Messaggi del motore Lucee o CFML: si sta usando il normale eseguibile CommandBox. Rimuovilo dal
PATH, reinstalla BoxLang ed eseguiinstall-bx-module bx-cli. - Comandi di progetto mancanti: esegui
box versiondalla root del progetto e poibox installin modo che le dipendenze inbox.jsonsiano disponibili. - Errori di connessione al database: verifica
.env, assicurati che il database esista e installa/avvia il driver JDBC tramite la configurazione del server BoxLang.