Szybki Start
1. Pobierz starter pack
git clone https://github.com/veridock/apk.git
2. Uruchom za pomocą jednej komendy
# Windows
run.bat
# Linux/Mac
./run.sh
3. Otwórz w przeglądarce
Aplikacja automatycznie otworzy się pod adresem: http://localhost:8097
📁 Struktura projektu
calculator.svg - Interaktywny kalkulator
pdf.php.svg - Konwerter PDF
router.php - Główny router
.env - Konfiguracja aplikacji
Obsługiwane Platformy
🪟 Windows
Opcja 1: Użyj XAMPP
# Zainstaluj XAMPP ze strony apachefriends.org
# Skopiuj pliki do C:\xampp\htdocs\svg-php
# Uruchom Apache z panelu XAMPP
Opcja 2: PHP Built-in Server
# Pobierz PHP ze strony windows.php.net
cd C:\path\to\project
php -S localhost:8097 router.php
🐧 Linux
# Ubuntu/Debian
sudo apt update
sudo apt install php php-cli php-gd imagemagick
# Uruchom
php -S localhost:8097 router.php
🍎 macOS
# Instalacja przez Homebrew
brew install php imagemagick
# Uruchom
php -S localhost:8097 router.php
☁️ Cloud/VPS
Nginx configuration:
server {
listen 80;
server_name your-domain.com;
root /var/www/svg-php;
location ~ \.svg$ {
fastcgi_pass unix:/var/run/php/php8.0-fpm.sock;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root/router.php;
}
}
Docker Deployment
docker-compose.yml
version: '3.8'
services:
svg-php-app:
build: .
ports:
- "8097:80"
volumes:
- ./:/var/www/html
environment:
- APP_TITLE=SVG+PHP Calculator
- APP_VERSION=1.0.0
Dockerfile
FROM php:8.0-apache
# Install dependencies
RUN apt-get update && apt-get install -y \
imagemagick \
libmagickwand-dev \
ghostscript \
&& pecl install imagick \
&& docker-php-ext-enable imagick
# Enable Apache modules
RUN a2enmod rewrite
# Copy application
COPY . /var/www/html/
# Configure Apache
RUN echo '<Directory /var/www/html>\n\
Options Indexes FollowSymLinks\n\
AllowOverride All\n\
Require all granted\n\
</Directory>' > /etc/apache2/conf-available/svg-php.conf
RUN a2enconf svg-php
EXPOSE 80
Uruchomienie
# Build i uruchom
docker-compose up -d
# Sprawdź status
docker-compose ps
# Logi
docker-compose logs -f
Web Launcher
🚀 Uruchom aplikację online
Podgląd aplikacji
Po uruchomieniu aplikacja pojawi się tutaj:
Główne Funkcje
🎨 Frontend + Backend
Jeden plik SVG zawiera całą aplikację - interfejs i logikę PHP
⚡ Bez kompilacji
Edytuj i odświeżaj - zmiany widoczne natychmiast
📱 Responsywność
SVG automatycznie skaluje się do każdego ekranu
🔧 Konfiguracja
Plik .env dla łatwej personalizacji
🌐 PWA Ready
Możliwość instalacji jako aplikacja
🚀 Lekkie
Minimalne wymagania - tylko PHP
Przykładowe zastosowania
- ✅ Interaktywne dashboardy
- ✅ Narzędzia administracyjne
- ✅ Wizualizacje danych
- ✅ Prototypy aplikacji
- ✅ Narzędzia deweloperskie
- ✅ Aplikacje edukacyjne
Wsparcie dla zmiennych
Router automatycznie zastępuje placeholdery w plikach SVG:
{APP_TITLE} → Tytuł aplikacji
{APP_VERSION} → Wersja
{CURRENT_TIME} → Aktualny czas
{USER_NAME} → Nazwa użytkownika
{PHP_VERSION} → Wersja PHP