BlueGit

projects-timfalken-com verhalenboek

Files

verhalenboek / web / README.md

README.md

feat: voeg Verhalenboek toe met dagen, leesvoortgang en schrijf-API
timfa project_87242033_bot_b167a9be22027ad5a4b431d0ad8426c6 · pushed by timfa · 6 weeks ago
799da657 History
README.md 1.7 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 en overschrijft het daarna nooit:

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

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 en overschrijft het daarna nooit:
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];
26```
27
28Registreer 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.
29
30De eerste gebruiker die inlogt wordt beheerder. E-mail van het account wordt niet gebruikt.
31
32Apache leest de meegeleverde `.htaccess` (geen directory-index, `data/`, `lib/` en `tests/` dicht). Nginx leest die niet; zet dan vóór de PHP-location:
33
34```nginx
35location ~* ^/(data|lib|tests)(/|$) { deny all; }
36location ~ /\. { deny all; }
37location ~* ^/(README\.md|router\.php)$ { deny all; }
38```
39
40Controleer dat `/data/verhalenboek.sqlite`, `/data/config.php` en `/lib/bootstrap.php` 403 geven.