BlueGit

projects-timfalken-com verhalenboek

Files

verhalenboek / web / README.md

README.md

feat: toon API-sleutels opnieuw en leg authenticatie uit
timfa project_87242033_bot_b167a9be22027ad5a4b431d0ad8426c6 · pushed by timfa · 6 weeks ago
16b40fa3 History
README.md 1.9 KiB Download Raw

Verhalenboek

PHP 8.2+ met SQLite en gewone JavaScript. Zet de document root op deze map web/. Productie heeft geen Composer, Node of build nodig.

De volledige uitleg, inclusief de API en de stappen voor auth.timfalken.com, staat in de README in de repository. Dit bestand gaat niet mee naar de server.

Lokaal

php -S 127.0.0.1:8080 -t web web/router.php

http://127.0.0.1:8080 logt automatisch in als test_user_1 (beheerder). Dat gebeurt alleen bij een loopback-adres én een localhost-host. Op een publiek domein niet.

Productie

PHP 8.2+, PDO SQLite, cURL, mbstring en een schrijfbare data/. De database is data/verhalenboek.sqlite. Het eerste verzoek maakt data/config.php als het er nog niet is. Een bestaand bestand blijft staan; ontbreekt key_secret, dan vult de app alleen die waarde aan. Die versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen.

<?php
return [
    'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
    'client_id' => 'projects.timfalken.com',
    'client_secret' => 'het-geheim-uit-admin',
    'key_secret' => 'blijft-de-gegenereerde-waarde',
];

Registreer op https://auth.timfalken.com/admin het callback-pad /verhaaltjesboek/callback.php voor het domein projects.timfalken.com. Het geheim hoort alleen in dit serverbestand (of in VERHALENBOEK_CLIENT_SECRET). Deploy uploadt data/ niet en verwijdert het ook niet.

De eerste gebruiker die inlogt wordt beheerder. E-mail van het account wordt niet gebruikt.

Apache leest de meegeleverde .htaccess (geen directory-index, data/, lib/ en tests/ dicht). Nginx leest die niet; zet dan vóór de PHP-location:

location ~* ^/(data|lib|tests)(/|$) { deny all; }
location ~ /\. { deny all; }
location ~* ^/(README\.md|router\.php)$ { deny all; }

Controleer dat /data/verhalenboek.sqlite, /data/config.php en /lib/bootstrap.php 403 geven.

Source
1# Verhalenboek
2
3PHP 8.2+ met SQLite en gewone JavaScript. Zet de document root op deze map `web/`. Productie heeft geen Composer, Node of build nodig.
4
5De volledige uitleg, inclusief de API en de stappen voor auth.timfalken.com, staat in de [README in de repository](../README.md). Dit bestand gaat niet mee naar de server.
6
7## Lokaal
8
9```sh
10php -S 127.0.0.1:8080 -t web web/router.php
11```
12
13http://127.0.0.1:8080 logt automatisch in als `test_user_1` (beheerder). Dat gebeurt alleen bij een loopback-adres én een localhost-host. Op een publiek domein niet.
14
15## Productie
16
17PHP 8.2+, PDO SQLite, cURL, mbstring en een schrijfbare `data/`. De database is `data/verhalenboek.sqlite`. Het eerste verzoek maakt `data/config.php` als het er nog niet is. Een bestaand bestand blijft staan; ontbreekt `key_secret`, dan vult de app alleen die waarde aan. Die versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen.
18
19```php
20<?php
21return [
22 'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
23 'client_id' => 'projects.timfalken.com',
24 'client_secret' => 'het-geheim-uit-admin',
25 'key_secret' => 'blijft-de-gegenereerde-waarde',
26];
27```
28
29Registreer op https://auth.timfalken.com/admin het callback-pad `/verhaaltjesboek/callback.php` voor het domein `projects.timfalken.com`. Het geheim hoort alleen in dit serverbestand (of in `VERHALENBOEK_CLIENT_SECRET`). Deploy uploadt `data/` niet en verwijdert het ook niet.
30
31De eerste gebruiker die inlogt wordt beheerder. E-mail van het account wordt niet gebruikt.
32
33Apache leest de meegeleverde `.htaccess` (geen directory-index, `data/`, `lib/` en `tests/` dicht). Nginx leest die niet; zet dan vóór de PHP-location:
34
35```nginx
36location ~* ^/(data|lib|tests)(/|$) { deny all; }
37location ~ /\. { deny all; }
38location ~* ^/(README\.md|router\.php)$ { deny all; }
39```
40
41Controleer dat `/data/verhalenboek.sqlite`, `/data/config.php` en `/lib/bootstrap.php` 403 geven.