# CS Vagt Portal: backend i PHP

Samme backend som `../backend/` (Node), men i PHP, så den kan køre på et **almindeligt webhotel med PHP og MySQL**, uden Node. Appen og hjemmesiden kalder bare en adresse og kan ikke se forskel.

- PHP 8.1 eller nyere med `pdo_mysql`, `curl`, `openssl` og `mbstring`. MySQL 8 eller MariaDB 10.5+.
- Ingen Composer og ingen biblioteker: filerne kan lægges direkte på hotellet.
- Skrivebeskyttet som standard. Skrivning kun til testregnskabet og kun hvis du slår det til. Alt logges i en revisionslog, der ikke kan rettes bagefter.

## Samme opførsel som Node-udgaven

Node-udgaven er referencen, og de to udgaver testes med de **samme** tests (`../backend/test/routes.test.ts`):
`bash test/kor-faelles-tests.sh` starter PHP-udgaven mod en MariaDB og en falsk Uniconta og kører testene mod den. CI kører det ved hver pull request. Derudover har PHP-udgaven egne tests (`php test/run.php`: krypto, revisionslog, tokens, skrivesikring og samtidighed).

Der findes ingen automatisk oversættelse fra Node til PHP. Skal en funktion ændres, ændres den i begge udgaver, og de fælles tests fanger, hvis de bliver uens. Migrationerne (`migrations/`) skal være ens, og CI tjekker det.

> Kør kun én af udgaverne mod den samme database ad gangen. Hash-kæden i revisionsloggen er ikke byte-for-byte ens mellem dem. Adgangskoder virker på tværs.

## Sådan lægges den på et webhotel (fx OVH)

1. **Database.** Opret en MySQL-database i hotellets kontrolpanel. Notér værtsnavn, databasenavn, bruger og kode.
2. **Filerne.** Enten via Git-integration på grenen `backend-php-deploy` (den bygges automatisk, se `../docs/13-automatisk-udrulning.md`), eller ved at uploade mappen `backend-php/` (uden `test/`).
3. **Webmappen.** Peg et (under)domæne, fx `api.dit-domæne.dk`, på mappen **`public/`**. Resten (`src/`, `config.json`, `secrets/`) må ikke kunne ses på nettet. SSL skal være slået til.
4. **config.json.** Kopiér `config.json.example` til `config.json` i mappen over `public/`, og udfyld `databaseUrl` (`mysql://bruger:kode@vært:3306/database`), `tilladteOrigins` (hjemmesidens adresse, fx `https://csdemo.intserver.com`), `uniconta.baseUrl` og `uniconta.testCompanyId`. Filen er ikke i repoet.
5. **Krypteringsnøglen** (til de gemte Uniconta-logins): lav 32 tilfældige bytes i base64 på din egen maskine (`php -r 'echo base64_encode(random_bytes(32));'`), læg dem i filen `secrets/credentials.key` på serveren, og gem en kopi et sikkert sted. Mistes nøglen, skal Uniconta-logins indtastes igen. Nøglen må aldrig stå i repoet eller i `config.json`.
6. **Første systembruger uden SSH.** Kør `php bin/hash-password.php` på din egen maskine, og læg brugernavn, e-mail, navn og den **hash**, du får, i `firstSystemUser` i `config.json`. Brugeren oprettes ved første kald, når databasen er tom. Fjern blokken bagefter. (Har du SSH, kan du i stedet bruge `php bin/opret-bruger.php`.)
7. **Tabellerne** oprettes automatisk ved første kald (`autoMigrate`). Med SSH kan du køre `php bin/migrate.php`.
8. **Prøv.** Åbn `https://api.dit-domæne.dk/health`. Du skal se `{"ok":true,...}`.
9. **Peg appen på den.** Sæt GitHub-variablerne `EXPO_PUBLIC_DATA_MODE=api` og `EXPO_PUBLIC_API_URL=https://api.dit-domæne.dk`, og kør "Opdater demo-websitet".

Hvis login virker, men alt andet giver "Du skal logge ind": hotellet sender ikke `Authorization`-headeren videre til PHP. `public/.htaccess` forsøger at rette det; spørg ellers hotellet, om `AllowOverride` er slået til for mappen.

## Kommandolinje (kræver SSH, eller kør lokalt)

```
php bin/migrate.php                                  # opretter/opdaterer tabellerne
php bin/opret-bruger.php --brugernavn anders --email a@firma.dk --navn "Anders" --system
php bin/hash-password.php                            # hash til firstSystemUser
php bin/uniconta-test.php                            # login og liste over regnskaber (find testregnskabets id)
php bin/uniconta-test.php --regnskab <id>            # den fulde læsetest
```

Skrivetesten og alle sikkerhedsregler er beskrevet i `../docs/uniconta-test.md`; de gælder uændret.

## Hvad der er forskelligt fra Node-udgaven

- PHP har ingen hukommelse mellem forespørgsler. Uniconta-sessionerne (tokens, krypteret) ligger derfor i databasen, og en lås i databasen (`GET_LOCK`) sørger for, at kun ét kald ad gangen bruger den samme session.
- Begrænsningen mod gætning af adgangskoder ligger i databasen (`login_failures`).
- Standard for `nodeEnv` er `production` (den skjulte testrute er slået fra), medmindre du sætter det andet.
