Vanilla

Komplett distributionsguide för Vanilla på NStrim

Översikt

Vanilla PHP är ett rent PHP-projekt utan något ramverk. Det ger en ren utgångspunkt för enklare projekt, så att du har full kontroll över din kodstruktur med HTML, CSS, JavaScript och PHP.

Innan du börjar
Se till att din dashboard är öppen – du kommer att behöva Git-uppgifterna som visas där. Den här mallen innehåller PHP med MySQL/PDO-stöd via Apache.

Kom igång

1

Skapa repository från mall

Gå till fliken Tools & Deployment i din dashboard. Klicka på knappen "New Repository", välj Vanilla PHP-mallen från rullgardinsmenyn, ange ett repository-namn och en subdomän och klicka sedan på "Create Repository".

2

Klona ditt repository

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>
3

Konfigurera databas (valfritt)

Om du använder MySQL hämtar du dina databasuppgifter från phpMyAdmin (länk i dashboarden) och uppdaterar dina PHP-filer:

$host = 'your-host';
$dbname = 'your-database';
$username = 'your-username';
$password = 'your-password';
4

Börja utveckla

Redigera HTML-, CSS-, JavaScript- och PHP-filer direkt. Inget byggsteg behövs!

5

Pusha dina ändringar

git add .
git commit -m "Initial setup"
git push origin main
Varje push till Git distribuerar din applikation automatiskt. Kontrollera din Module Work URL i dashboarden för att se din live-sajt.

Lokal utveckling med Docker

Om du inte har PHP installerat lokalt kan du använda Docker för att köra en lokal PHP-server. Projektet innehåller en Dockerfile med PHP 8.2 och Apache.

Vad är Docker?
Docker skapar isolerade "containrar" med all programvara du behöver (PHP, Apache, MySQL-tillägg) utan att installera dem på din dator. Tänk på det som en lättviktig virtuell maskin.

Förutsättningar

Installera Docker Desktop för ditt operativsystem (Windows, Mac eller Linux).

Köra med Docker

# Build and run the container
docker build -t my-php-app .
docker run -p 8080:80 -v $(pwd):/var/www/html my-php-app

# Or use a quick one-liner for development
docker run --rm -p 8080:80 -v $(pwd):/var/www/html php:8.2-apache

Öppna http://localhost:8080 i din webbläsare.

Obs
Docker är valfritt för lokal utveckling. NStrim-plattformen hanterar distribution automatiskt – du behöver bara Docker om du vill köra PHP lokalt utan att installera det.

Projektstruktur

Förstå var filerna finns:

├── index.php             # Huvudingångspunkt
├── css/
│   └── style.css         # Stilmallar
├── js/
│   └── script.js         # JavaScript-filer
├── includes/
│   ├── config.php        # Databaskonfiguration
│   ├── header.php        # Återanvändbar header
│   └── footer.php        # Återanvändbar footer
├── images/               # Bildtillgångar
├── Dockerfile            # Docker-byggkonfiguration
└── README.md             # Projektdokumentation

Vanliga uppgifter

Databasanslutning med PDO

Skapa en återanvändbar databasanslutning:

<?php
$host = 'localhost';
$dbname = 'database_name';
$username = 'username';
$password = 'password';

try {
    $pdo = new PDO("mysql:host=$host;dbname=$dbname", $username, $password);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch(PDOException $e) {
    die("Connection failed: " . $e->getMessage());
}
?>

Söka i databasen

Använd prepared statements för säkra frågor:

<?php
// SELECT query
$stmt = $pdo->prepare("SELECT * FROM users WHERE id = ?");
$stmt->execute([$userId]);
$user = $stmt->fetch(PDO::FETCH_ASSOC);

// INSERT query
$stmt = $pdo->prepare("INSERT INTO users (name, email) VALUES (?, ?)");
$stmt->execute([$name, $email]);
?>

Inkludera filer

Återanvänd kod på flera sidor:

<?php
include 'includes/header.php';
// Your page content here
include 'includes/footer.php';
?>

Hantera formulärdata

Bearbeta POST-förfrågningar säkert:

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $name = htmlspecialchars($_POST['name'] ?? '');
    $email = filter_var($_POST['email'] ?? '', FILTER_SANITIZE_EMAIL);

    // Process the data...
}
?>

Viktiga tekniker

PHP 8.2

Server-side scripting med moderna PHP-funktioner och MySQL/PDO-stöd.

HTML5

Strukturera dina webbsidor med semantiska HTML-element.

CSS3

Styla dina sidor med moderna CSS-funktioner som Flexbox och Grid.

JavaScript

Lägg till interaktivitet med ren JavaScript – inga bibliotek behövs.

Felsökning

Database connection failed

Orsak: Felaktiga databasuppgifter eller databasen är inte tillgänglig.

Lösning: Kontrollera dina inloggningsuppgifter i phpMyAdmin (länk i dashboarden). Säkerställ att host, databasnamn, användarnamn och lösenord är korrekta.

PHP errors not showing

Orsak: Felrapportering är avstängd.

Lösning: Lägg till överst i din PHP-fil: ini_set('display_errors', 1); error_reporting(E_ALL);

Blank white page

Orsak: Allvarligt PHP-fel med felrapportering avstängd.

Lösning: Aktivera felrapportering (se ovan) eller kontrollera serverloggarna. Vanliga orsaker: syntaxfel, saknade filer eller odefinierade funktioner.

CSS/JS not loading

Orsak: Felaktiga filsökvägar.

Lösning: Använd relativa sökvägar från din HTML-fil: href="css/style.css" eller absoluta sökvägar: href="/css/style.css"

Form data not received

Orsak: Felaktig formulärmetod eller action.

Lösning: Säkerställ att ditt formulär har method="POST" och rätt action-attribut som pekar på din PHP-fil.

Distributionsflöde

Varje gång du pushar kod till Git distribueras din applikation automatiskt:

Kodändring git push Distribuera till Apache Live!

Din distribuerade applikations-URL följer detta format: 

https://<your-subdomain>-<repo-name>.<session-domain>

Exempel: https://student01-module-a.demo.nstrim.app

För mer information, besök PHP-dokumentationen och MDN Web Docs.