Manuel kurulum — QueryProxy

QueryProxy’yi doğrudan bir sunucuda mı çalıştırmak istiyorsunuz? Standart bir Laravel uygulamasıdır.

Gereksinimler

Proxy’leyeceğiniz veritabanlarının PDO sürücüleriyle birlikte PHP ≥ 8.3 (pdo_pgsql, pdo_mysql, pdo_sqlite; SQL Server hedefleri için pdo_sqlsrv)
Composer
Node.js 20+ (yalnızca frontend varlıklarını derlemek için)

Adımlar

git clone https://github.com/QueryProxy/QueryProxy.git
cd QueryProxy

composer install
cp .env.example .env
php artisan key:generate

touch database/database.sqlite
php artisan migrate            # demo takım için --seed ekleyin

npm install && npm run build

Ardından üç süreci çalıştırın:

php artisan serve                                              # web portalı
php artisan queue:work --queue=queries,default --timeout=310   # işçi
php artisan schedule:work                                      # zamanlayıcı

Kuyruk işçisi opsiyonel değildir. Onaylanan sorgular asla bir web isteği içinde değil, işçide çalışır. İşçi çalışmıyorsa talepler onaylanır ve sonsuza dek kuyrukta bekler. Üretimde işçiyi bir süreç yöneticisiyle (systemd, Supervisor) ayakta tutun ve --timeout değerini QUERYPROXY_EXECUTION_TIMEOUT’un biraz üzerinde ayarlayın.

Üretim notları

Uygulamayı TLS’li gerçek bir web sunucusunun / reverse proxy’nin (nginx, Caddy) arkasında sunun; php artisan serve yalnızca deneme içindir.
SQLite yetmediğinde DB_* değişkenlerini MySQL veya PostgreSQL’e yönlendirin — bkz. Yapılandırma.
Zamanlayıcı, sonuç saklama temizliğini yürütür; schedule:work ile ya da her dakika php artisan schedule:run çağıran bir cron girdisiyle çalıştırın.
Dağıtımda yapılandırmayı önbelleğe alın: php artisan config:cache && php artisan route:cache.