BlueGit

projects-timfalken-com microchess

Files

microchess / web / lib / bootstrap.php

bootstrap.php

bootstrap.php 19.7 KiB Download Raw
1<?php
2declare(strict_types=1);
3require_once __DIR__.'/Chess.php';
4require_once __DIR__.'/MoveFeedback.php';
5ini_set('display_errors','0');
6ini_set('log_errors','1');
7ini_set('error_log',dirname(__DIR__).'/data/php-errors.log');
8header('X-Content-Type-Options: nosniff');
9header('Referrer-Policy: same-origin');
10header("Content-Security-Policy: default-src 'self'; img-src 'self'; style-src 'self'; script-src 'self'; connect-src 'self'; frame-ancestors 'none'; base-uri 'self'; form-action 'self'");
11header('Cache-Control: no-store');
12
13function db(): PDO {
14 static $db;
15 if ($db) return $db;
16 $db=new PDO('sqlite:'.dirname(__DIR__).'/data/microchess.sqlite',null,null,[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION,PDO::ATTR_DEFAULT_FETCH_MODE=>PDO::FETCH_ASSOC]);
17 $db->exec('PRAGMA journal_mode=WAL; PRAGMA foreign_keys=ON; PRAGMA busy_timeout=5000;');
18 $db->exec('CREATE TABLE IF NOT EXISTS users (id TEXT PRIMARY KEY, name TEXT NOT NULL);
19 CREATE TABLE IF NOT EXISTS user_avatars (user_id TEXT PRIMARY KEY REFERENCES users(id), avatar TEXT NOT NULL);
20 CREATE TABLE IF NOT EXISTS sessions (id TEXT PRIMARY KEY, payload TEXT NOT NULL, expires INTEGER NOT NULL);
21 CREATE TABLE IF NOT EXISTS friends (a TEXT NOT NULL REFERENCES users(id), b TEXT NOT NULL REFERENCES users(id), PRIMARY KEY(a,b), CHECK(a<b));
22 CREATE TABLE IF NOT EXISTS friend_requests (a TEXT NOT NULL REFERENCES users(id), b TEXT NOT NULL REFERENCES users(id), sender TEXT NOT NULL REFERENCES users(id), created INTEGER NOT NULL, PRIMARY KEY(a,b), CHECK(a<b), CHECK(sender=a OR sender=b));
23 CREATE TABLE IF NOT EXISTS links (token TEXT PRIMARY KEY, owner TEXT NOT NULL REFERENCES users(id), kind TEXT NOT NULL, expires INTEGER NOT NULL, used INTEGER NOT NULL DEFAULT 0);
24 CREATE TABLE IF NOT EXISTS games (id INTEGER PRIMARY KEY AUTOINCREMENT, a TEXT NOT NULL REFERENCES users(id), b TEXT NOT NULL REFERENCES users(id), status TEXT NOT NULL, white TEXT, state TEXT, winner TEXT, reason TEXT, exit_a INTEGER DEFAULT 0, exit_b INTEGER DEFAULT 0, rematch_a INTEGER DEFAULT 0, rematch_b INTEGER DEFAULT 0, draw_offer TEXT, version INTEGER DEFAULT 0, created INTEGER NOT NULL);
25 CREATE TABLE IF NOT EXISTS results (id INTEGER PRIMARY KEY AUTOINCREMENT, game_id INTEGER NOT NULL REFERENCES games(id), a TEXT NOT NULL, b TEXT NOT NULL, winner TEXT, reason TEXT NOT NULL, state TEXT NOT NULL, ended INTEGER NOT NULL);
26 CREATE INDEX IF NOT EXISTS games_a ON games(a); CREATE INDEX IF NOT EXISTS games_b ON games(b);');
27 $columns=$db->query('PRAGMA table_info(games)')->fetchAll(PDO::FETCH_COLUMN,1);
28 if (!in_array('activity_at',$columns,true)) {
29 $db->exec('BEGIN IMMEDIATE');
30 try {
31 if (!in_array('activity_at',$db->query('PRAGMA table_info(games)')->fetchAll(PDO::FETCH_COLUMN,1),true)) {
32 $db->exec('ALTER TABLE games ADD COLUMN activity_at INTEGER');
33 $db->exec("UPDATE games SET activity_at=CAST(strftime('%s','now') AS INTEGER) WHERE activity_at IS NULL");
34 }
35 $db->exec('COMMIT');
36 } catch (Throwable $e) { $db->exec('ROLLBACK');throw $e; }
37 }
38 // Replace legacy triggers once, including databases already migrated on newer SQLite.
39 $legacy=$db->query("SELECT sql FROM sqlite_master WHERE type='trigger' AND name IN ('games_activity_insert','games_activity_update')")->fetchAll(PDO::FETCH_COLUMN);
40 if (array_filter($legacy,static fn(string $sql): bool => stripos($sql,'unixepoch(')!==false)) {
41 $db->exec('BEGIN IMMEDIATE');
42 try {
43 $db->exec('DROP TRIGGER IF EXISTS games_activity_insert; DROP TRIGGER IF EXISTS games_activity_update;');
44 activityTriggers($db);
45 $db->exec('COMMIT');
46 } catch (Throwable $e) { $db->exec('ROLLBACK');throw $e; }
47 } else {
48 activityTriggers($db);
49 }
50 // Assign existing accounts once as well as newly created accounts.
51 foreach ($db->query('SELECT id FROM users WHERE id NOT IN (SELECT user_id FROM user_avatars)')->fetchAll(PDO::FETCH_COLUMN) as $id) {
52 $avatars=avatarCatalog();
53 $q=$db->prepare('INSERT OR IGNORE INTO user_avatars(user_id,avatar) VALUES(?,?)');
54 $q->execute([$id,$avatars[random_int(0,count($avatars)-1)]['id']]);
55 }
56 $db->exec('CREATE TABLE IF NOT EXISTS ratings (user_id TEXT PRIMARY KEY REFERENCES users(id), rating INTEGER NOT NULL DEFAULT 1200, played INTEGER NOT NULL DEFAULT 0);
57 CREATE TABLE IF NOT EXISTS rating_changes (result_id INTEGER PRIMARY KEY REFERENCES results(id), a_before INTEGER NOT NULL, b_before INTEGER NOT NULL, delta INTEGER NOT NULL);
58 CREATE TABLE IF NOT EXISTS matchmaking (user_id TEXT PRIMARY KEY REFERENCES users(id), joined INTEGER NOT NULL);
59 CREATE TABLE IF NOT EXISTS matchmaking_clock (id INTEGER PRIMARY KEY CHECK(id=1), checked INTEGER NOT NULL);
60 INSERT OR IGNORE INTO matchmaking_clock VALUES(1,0);');
61 $db->exec('CREATE TABLE IF NOT EXISTS replays (result_id INTEGER PRIMARY KEY REFERENCES results(id), white TEXT NOT NULL, moves BLOB NOT NULL);
62 CREATE INDEX IF NOT EXISTS results_ended ON results(ended);
63 CREATE TABLE IF NOT EXISTS replay_links (result_id INTEGER PRIMARY KEY REFERENCES replays(result_id), token TEXT NOT NULL UNIQUE);');
64 if (!in_array('turn_order',$db->query('PRAGMA table_info(games)')->fetchAll(PDO::FETCH_COLUMN,1),true)) {
65 $db->exec('BEGIN IMMEDIATE');
66 try {
67 if (!in_array('turn_order',$db->query('PRAGMA table_info(games)')->fetchAll(PDO::FETCH_COLUMN,1),true)) {
68 $db->exec('ALTER TABLE games ADD COLUMN turn_order INTEGER NOT NULL DEFAULT 0');
69 $db->exec('UPDATE games SET turn_order=id');
70 }
71 $db->exec('COMMIT');
72 } catch (Throwable $e) {$db->exec('ROLLBACK');throw $e;}
73 }
74 $db->exec("CREATE TRIGGER IF NOT EXISTS games_turn_insert AFTER INSERT ON games BEGIN UPDATE games SET turn_order=(SELECT COALESCE(MAX(turn_order),0)+1 FROM games) WHERE id=NEW.id; END;
75 CREATE TRIGGER IF NOT EXISTS games_turn_update AFTER UPDATE OF state ON games WHEN NEW.state IS NOT OLD.state BEGIN UPDATE games SET turn_order=(SELECT COALESCE(MAX(turn_order),0)+1 FROM games) WHERE id=NEW.id; END;");
76 $q=$db->query("SELECT r.id,r.state,g.white FROM results r JOIN games g ON g.id=r.game_id WHERE r.state=g.state AND g.status='ended' AND NOT EXISTS (SELECT 1 FROM replays p WHERE p.result_id=r.id)");
77 foreach ($q->fetchAll() as $r) {
78 $position=json_decode($r['state'],true);
79 if (!empty($position['history'])) {
80 try {saveReplay((int)$r['id'],$r['white'],$position);} catch (PDOException $e) {if ($e->getCode()!=='23000') throw $e;}
81 }
82 }
83 return $db;
84}
85function activityTriggers(PDO $db): void {
86 $db->exec("CREATE TRIGGER IF NOT EXISTS games_activity_insert AFTER INSERT ON games BEGIN UPDATE games SET activity_at=CAST(strftime('%s','now') AS INTEGER) WHERE id=NEW.id; END;
87 CREATE TRIGGER IF NOT EXISTS games_activity_update AFTER UPDATE OF version ON games BEGIN UPDATE games SET activity_at=CAST(strftime('%s','now') AS INTEGER) WHERE id=NEW.id; END;");
88}
89function query(string $sql,array $args=[]): PDOStatement { $s=db()->prepare($sql);$s->execute($args);return $s; }
90function profile(string $id): array {
91 return query('SELECT u.*,a.avatar,COALESCE(r.rating,1200) AS rating,COALESCE(r.played,0) AS ratedGames FROM users u LEFT JOIN user_avatars a ON a.user_id=u.id LEFT JOIN ratings r ON r.user_id=u.id WHERE u.id=?',[$id])->fetch();
92}
93function avatarCatalog(): array {
94 static $avatars;
95 return $avatars ??= json_decode(file_get_contents(dirname(__DIR__).'/assets/avatars/catalog.json'),true,512,JSON_THROW_ON_ERROR);
96}
97final class DatabaseSessions implements SessionHandlerInterface {
98 public function open(string $path,string $name): bool {return true;}
99 public function close(): bool {return true;}
100 public function read(string $id): string|false {return query('SELECT payload FROM sessions WHERE id=? AND expires>?',[$id,time()])->fetchColumn()?:'';}
101 public function write(string $id,string $data): bool {query('INSERT OR REPLACE INTO sessions VALUES(?,?,?)',[$id,$data,time()+86400]);return true;}
102 public function destroy(string $id): bool {query('DELETE FROM sessions WHERE id=?',[$id]);return true;}
103 public function gc(int $max_lifetime): int|false {return query('DELETE FROM sessions WHERE expires<?',[time()])->rowCount();}
104}
105function localDev(): bool {
106 $host=parse_url('http://'.($_SERVER['HTTP_HOST']??''),PHP_URL_HOST);
107 return is_string($host) && in_array(strtolower($host),['localhost','127.0.0.1','[::1]'],true) && in_array($_SERVER['REMOTE_ADDR']??'', ['127.0.0.1','::1'],true);
108}
109function config(): array {
110 static $c;
111 if ($c !== null) return $c;
112 $path=dirname(__DIR__).'/data/config.php';
113 $lock=fopen(dirname(__DIR__).'/data/config.lock','c');
114 if ($lock===false) throw new RuntimeException('The data directory must be writable to initialize configuration.');
115 try {
116 if (!flock($lock,LOCK_EX)) throw new RuntimeException('Unable to lock configuration.');
117 if (!file_exists($path)) {
118 $template="<?php\n// Fill in these values on this server. Empty fields use environment variables.\nreturn [\n 'base_url' => '',\n 'client_id' => '',\n 'client_secret' => '',\n];\n";
119 if (file_put_contents($path,$template)!==strlen($template)) throw new RuntimeException('Unable to create data/config.php.');
120 }
121 $values=require $path;
122 if (!is_array($values)) throw new RuntimeException('data/config.php must return an array.');
123 } finally {
124 flock($lock,LOCK_UN);
125 fclose($lock);
126 }
127 foreach (['base_url'=>'MICROCHESS_BASE_URL','client_id'=>'MICROCHESS_CLIENT_ID','client_secret'=>'MICROCHESS_CLIENT_SECRET'] as $key=>$env) {
128 if (($values[$key]??'')==='') $values[$key]=getenv($env)?:'';
129 }
130 return $c=$values;
131}
132function baseUrl(): string {
133 if (localDev()) return 'http://'.$_SERVER['HTTP_HOST'].rtrim(dirname($_SERVER['SCRIPT_NAME']),'/');
134 $base=rtrim(config()['base_url'],'/');
135 if (!str_starts_with($base,'https://')) throw new RuntimeException("Set 'base_url' in data/config.php to this application's production HTTPS URL, or set MICROCHESS_BASE_URL. The data directory is excluded from deployment; update this file on the production server separately.");
136 return $base;
137}
138function authRequest(string $path,?array $form=null,?string $token=null): array {
139 $ch=curl_init('https://auth.timfalken.com'.$path);
140 $headers=['Accept: application/json','User-Agent: Microchess/1.0'];
141 if ($token) $headers[]='Authorization: Bearer '.$token;
142 curl_setopt_array($ch,[CURLOPT_RETURNTRANSFER=>true,CURLOPT_TIMEOUT=>15,CURLOPT_HTTPHEADER=>$headers]);
143 if ($form!==null) curl_setopt_array($ch,[CURLOPT_POST=>true,CURLOPT_POSTFIELDS=>http_build_query($form)]);
144 $body=curl_exec($ch); $status=curl_getinfo($ch,CURLINFO_RESPONSE_CODE);
145 $data=is_string($body)?json_decode($body,true):null;
146 if ($status!==200 || !is_array($data)) throw new RuntimeException('Authentication service unavailable or session expired. Please sign in again.');
147 return $data;
148}
149function loginUser(string $id,string $name): void {
150 query('INSERT INTO users VALUES(?,?) ON CONFLICT(id) DO UPDATE SET name=excluded.name',[$id,$name]);
151 $avatars=avatarCatalog();
152 query('INSERT OR IGNORE INTO user_avatars(user_id,avatar) VALUES(?,?)',[$id,$avatars[random_int(0,count($avatars)-1)]['id']]);
153 session_regenerate_id(true); $_SESSION['user']=$id; $_SESSION['csrf']=bin2hex(random_bytes(24));
154}
155// Generate the editable configuration on the first page request, including localhost.
156config();
157session_name('microchess_session');
158ini_set('session.use_strict_mode','1');
159$sessionLifetime=86400;
160$sessionPath=rtrim(dirname($_SERVER['SCRIPT_NAME']),'/').'/';
161$sessionSecure=!localDev();
162session_set_cookie_params(['lifetime'=>$sessionLifetime,'path'=>$sessionPath,'secure'=>$sessionSecure,'httponly'=>true,'samesite'=>'Lax']);
163session_set_save_handler(new DatabaseSessions(),true);
164session_start();
165// Refresh browser cookie expiry on each request so activity slides the 24h lifetime.
166if (session_status()===PHP_SESSION_ACTIVE && session_id()!=='') {
167 setcookie(session_name(),session_id(),[
168 'expires'=>time()+$sessionLifetime,
169 'path'=>$sessionPath,
170 'secure'=>$sessionSecure,
171 'httponly'=>true,
172 'samesite'=>'Lax',
173 ]);
174}
175if (localDev() && !in_array($_SESSION['user']??'', ['local:test_user_1','local:test_user_2'],true)) {
176 unset($_SESSION['token'],$_SESSION['expires'],$_SESSION['validated']);
177 loginUser('local:test_user_1','test_user_1');
178}
179function user(): string {
180 if (!isset($_SESSION['user'])) fail('Please sign in.',401);
181 if (!localDev() && (($_SESSION['expires']??0)<time())) {unset($_SESSION['user']);fail('Your session expired. Please sign in again.',401);}
182 return $_SESSION['user'];
183}
184function fail(string $message,int $status=400): never {http_response_code($status);header('Content-Type: application/json');echo json_encode(['error'=>$message]);exit;}
185function jsonOut(mixed $data): never {header('Content-Type: application/json');echo json_encode($data,JSON_THROW_ON_ERROR);exit;}
186function pair(string $a,string $b): array { $p=[$a,$b];sort($p,SORT_STRING);return $p; }
187function rivalry(string $u,string $other): array {
188 $r=query('SELECT COUNT(*) AS total,COALESCE(SUM(winner=?),0) AS wins,COALESCE(SUM(winner IS NULL),0) AS ties FROM results WHERE (a=? AND b=?) OR (a=? AND b=?)',[$u,$u,$other,$other,$u])->fetch();
189 return ['wins'=>(int)$r['wins'],'losses'=>(int)$r['total']-(int)$r['wins']-(int)$r['ties'],'ties'=>(int)$r['ties']];
190}
191function befriend(string $a,string $b): void {
192 $p=pair($a,$b);
193 query('INSERT OR IGNORE INTO friends VALUES(?,?)',$p);
194 query('DELETE FROM friend_requests WHERE a=? AND b=?',$p);
195}
196// Two bytes per ply: source square, destination square and resulting piece (promotion included).
197// Only the initial board is stored in full; no repeated position snapshots.
198function saveReplay(int $result,string $white,array $s): void {
199 $history=$s['history'];
200 $packed=substr($history[0],0,21);
201 $pieces='.prnbqkPRNBQK';
202 for ($i=1;$i<count($history);$i++) {
203 $before=$history[$i-1];$after=$history[$i];$from=0;$to=0;
204 for ($j=0;$j<20;$j++) if ($before[$j]!==$after[$j]) {
205 if ($after[$j]==='.') $from=$j; else $to=$j;
206 }
207 $packed.=pack('n',($from*20+$to)*13+strpos($pieces,$after[$to]));
208 }
209 $q=db()->prepare('INSERT INTO replays VALUES(?,?,?)');
210 $q->bindValue(1,$result);$q->bindValue(2,$white);$q->bindValue(3,$packed,PDO::PARAM_LOB);$q->execute();
211 query("UPDATE results SET state='{}' WHERE id=?",[$result]);
212}
213function replayLink(int $id): string {
214 query('INSERT OR IGNORE INTO replay_links(result_id,token) VALUES(?,?)',[$id,bin2hex(random_bytes(24))]);
215 return query('SELECT token FROM replay_links WHERE result_id=?',[$id])->fetchColumn();
216}
217function replayPlayers(array $r): array {
218 $black=$r['white']===$r['a']?$r['b']:$r['a'];
219 return ['whiteName'=>profile($r['white'])['name'],'blackName'=>profile($black)['name']];
220}
221function replayPositions(string $packed): array {
222 $board=str_split(substr($packed,0,20));$turn=$packed[20];
223 $positions=[['board'=>$board,'turn'=>$turn,'ply'=>0,'last'=>null]];
224 for ($i=21;$i<strlen($packed);$i+=2) {
225 $code=unpack('n',substr($packed,$i,2))[1];$piece='.prnbqkPRNBQK'[$code%13];
226 $squares=intdiv($code,13);$from=intdiv($squares,20);$to=$squares%20;
227 $board[$from]='.';$board[$to]=$piece;$turn=$turn==='w'?'b':'w';
228 $positions[]=['board'=>$board,'turn'=>$turn,'ply'=>count($positions),'last'=>['from'=>$from,'to'=>$to]];
229 }
230 return $positions;
231}
232function finishGame(array $g,?string $winner,string $reason,array $s): void {
233 $final=$s;$final['history']=[];
234 $finished=query("UPDATE games SET status='ended',winner=?,reason=?,state=?,draw_offer=NULL,version=version+1 WHERE id=? AND status='active' AND version=?",[$winner,$reason,json_encode($final),$g['id'],$g['version']]);
235 if ($finished->rowCount()!==1) throw new DomainException('The game has changed. Please try again.');
236 query('INSERT INTO results(game_id,a,b,winner,reason,state,ended) VALUES(?,?,?,?,?,?,?)',[$g['id'],$g['a'],$g['b'],$winner,$reason,json_encode($s),time()]);
237 $result=(int)db()->lastInsertId();
238 saveReplay($result,$g['white'],$s);
239 $a=(int)profile($g['a'])['rating'];$b=(int)profile($g['b'])['rating'];
240 $score=$winner===null?0.5:($winner===$g['a']?1:0);
241 $delta=(int)round(32*($score-1/(1+10**(($b-$a)/400))));
242 query('INSERT INTO rating_changes VALUES(?,?,?,?)',[$result,$a,$b,$delta]);
243 foreach ([[$g['a'],$a+$delta],[$g['b'],$b-$delta]] as [$id,$rating]) {
244 query('INSERT INTO ratings(user_id,rating,played) VALUES(?,?,1) ON CONFLICT(user_id) DO UPDATE SET rating=excluded.rating,played=ratings.played+1',[$id,$rating]);
245 }
246}
247// Called inside BEGIN IMMEDIATE: selecting pairs and consuming entries is atomic.
248function matchPlayers(bool $force=false): void {
249 $now=time();
250 if (!$force && (int)query('SELECT checked FROM matchmaking_clock WHERE id=1')->fetchColumn()>$now-60) return;
251 query('UPDATE matchmaking_clock SET checked=? WHERE id=1',[$now]);
252 $pool=query('SELECT m.*,COALESCE(r.rating,1200) AS rating FROM matchmaking m LEFT JOIN ratings r ON r.user_id=m.user_id WHERE m.joined>? ORDER BY m.joined,m.user_id',[$now-86400])->fetchAll();
253 $used=[];
254 foreach ($pool as $a) {
255 if (isset($used[$a['user_id']])) continue;
256 $best=null;$distance=PHP_INT_MAX;
257 foreach ($pool as $b) {
258 if ($a['user_id']===$b['user_id'] || isset($used[$b['user_id']])) continue;
259 $gap=abs($a['rating']-$b['rating']);
260 $limit=min(500,100+50*intdiv(max(0,$now-$a['joined']),60),100+50*intdiv(max(0,$now-$b['joined']),60));
261 if ($gap<=$limit && $gap<$distance) {$best=$b;$distance=$gap;}
262 }
263 if ($best===null) continue;
264 startGame($a['user_id'],$best['user_id']);
265 query('DELETE FROM matchmaking WHERE user_id IN (?,?)',[$a['user_id'],$best['user_id']]);
266 $used[$a['user_id']]=$used[$best['user_id']]=true;
267 }
268}
269function startGame(string $a,string $b): int {
270 query("INSERT INTO games(a,b,status,white,state,created) VALUES(?,?,'active',?,?,?)",[$a,$b,random_int(0,1)?$a:$b,json_encode(Chess::initial()),time()]);
271 return (int)db()->lastInsertId();
272}
273function gameView(array $g,string $u): array {
274 $other=$g['a']===$u?$g['b']:$g['a'];$side=$g['a']===$u?'a':'b';$opSide=$side==='a'?'b':'a';
275 $opponent=profile($other);
276 $s=$g['state']?json_decode($g['state'],true):null;
277 $color=$g['white']===$u?'w':'b';
278 return ['id'=>(int)$g['id'],'turnOrder'=>(int)$g['turn_order'],'replayId'=>$g['status']==='ended'?(int)query('SELECT MAX(result_id) FROM replays JOIN results ON results.id=replays.result_id WHERE game_id=?',[$g['id']])->fetchColumn():null,'opponentId'=>$other,'rivalry'=>rivalry($u,$other),'opponent'=>$opponent['name'],'opponentAvatar'=>$opponent['avatar'],'opponentRating'=>(int)$opponent['rating'], 'status'=>$g['status'],'incoming'=>$g['b']===$u,'color'=>$color,
279 'inactiveDays'=>max(0,(int)floor((time()-($g['activity_at']??time()))/86400)),
280 'outcome'=>$g['winner']===null?'draw':($g['winner']===$u?'win':'loss'),
281 'state'=>$s,'yourTurn'=>$g['status']==='active' && $s['turn']===$color,'legal'=>$g['status']==='active' && $s['turn']===$color?Chess::legal($s):[],
282 'check'=>$s?Chess::check($s):false,'winner'=>$g['winner']?query('SELECT name FROM users WHERE id=?',[$g['winner']])->fetchColumn():null,'reason'=>$g['reason'],
283 'canRematch'=>!$g['exit_'.$opSide],'rematch'=>!!$g['rematch_'.$side],'opponentRematch'=>!!$g['rematch_'.$opSide], 'drawOffer'=>$g['draw_offer']?($g['draw_offer']===$u?'you':'opponent'):null,
284 'claimable'=>$s?Chess::claimable($s):false,'version'=>(int)$g['version']];
285}