Allestire un ambiente di sviluppo
Prerequisiti
| Strumento | Requisito | Per che cosa |
|---|---|---|
| Client Git | qualsiasi, capace di HTTP Basic | prelevare e restituire il codice sorgente |
| PHP | 8.2 o successivo | verifica della sintassi e prove |
| Composer | aggiornato | installare gli strumenti di verifica |
| Token di accesso | proprio, valido | autenticazione del client Git |
| Permesso di scrittura | sul namespace del repository | restituire le modifiche |
Fino al passo 3 compreso — leggere, clonare, costruire e provare — basta il livello ottenere, che il mount pubblico concede a chiunque. Solo la restituzione richiede di più, e quanto di più sta sotto Inviare una modifica. Se manca, la via passa per Richiedere l'accesso.
Passo 1: creare un token di accesso
Create un token personale e tenetelo pronto: Token di accesso. Per esteso sotto Creare un token di accesso.
Passo 2: clonare il repository
Copiate l'indirizzo di clonazione dalla sezione Dieses Repository beziehen del repository voluto e clonate con esso:
git clone <inserire qui l'indirizzo copiato>
Come password serve il token, il nome utente non viene verificato. Per esteso sotto Clonare un repository.
Passo 3: allestire gli strumenti di verifica
I pacchetti di questa raccolta vengono verificati con due strumenti. Entrambi sono dichiarati come dipendenze di sviluppo e si installano nello spazio di lavoro che porta il composer.json:
composer install
| Chiamata | Che cosa verifica |
|---|---|
composer cs | stile di codifica secondo PSR-12, senza eccezioni alle regole |
composer cbf | corregge i rilievi di stile correggibili automaticamente |
composer stan | analisi statica |
Passo 4: verificare che cosa avete cambiato
Dopo ogni modifica valgono cinque controlli. Sono il collaudo vincolante di questa raccolta:
- Verifica della sintassi su ogni file modificato (
php -l). - Un avvio del wiki.
- Completezza dei testi di interfaccia in tutte e cinque le lingue — tedesco, inglese, italiano, croato, sloveno — inclusa la verifica dei segnaposto.
- Ricostruzione del pacchetto CSS.
- Confronto del registro degli errori prima e dopo la modifica.
Risultato atteso
Una copia di lavoro locale che si lascia clonare, verificare e costruire, e un client Git che si autentica all'endpoint senza chiedere di nuovo la password.
Passi successivi
- Stato delle regole di contribuzione — quali regole di verifica sono dimostrabilmente in vigore e quali non esistono; questa pagina non lo ripete, perché una seconda versione delle stesse indicazioni invecchia indipendentemente dalla prima