#  Template di pubblicazione sito dinamico in PHP

> Dominio di output  
> ```nomerepository-nomeutente.web.francescomancuso.it```
>
> In futuro si potrà personalizzare

## Descrizione

Ogni repository, pubblica o privata, permette di effettuare il deploy del proprio sito web. Per farlo, è necessario seguire 3 semplici passaggi.

Il funzionamento è quasi identico alle "GitHub Actions", le quali permettono di creare una pipeline di sviluppo CI/CD. Qui la pipeline CI/CD è stata implementata da zero, con personalizzazioni.

## Come fare?

1. Usare come template questa repository

2. Caricare la root del sito web con ```index.php``` o ```index.html``` dentro la cartella radice ```/```. Puoi anche specificare una cartella diversa dal file di configurazione.

3. Sarà presente insieme ai file della repository la cartelle ```/.gitea/workflows/deploy.yaml```. Questo rappresenta il file di configurazione per avviare il deploy. Di base è già configurato per pubblicare il sito web, ma puoi personalizzare dentro alcuni parametri:

```yaml
name: Deploy
on: [push]

jobs:
  trigger:
    runs-on: ubuntu-latest
    steps:
      - name: Build & Deploy
        env:
          REPO_NAME: ${{ gitea.event.repository.name }}
          REPO_OWNER: ${{ gitea.repository_owner }}
          # Imposta la cartella che conterrà la root del sito!
          # Default "/"
          # Con nome "nome_cartella"
          ROOT_DIR: "/"
          # Cosa stai andando a pubblicare?
          # - pages       sito web statico
          # - dynamic     sito web dinamico con PHP
          TYPE: "dynamic"
          JOB_TOKEN: ${{ gitea.token }}
        run: |
          curl -f -s -S -X -v POST http://gitea-webhook:9000/hooks/trigger-deploy \
          -H "Content-Type: application/json" \
          -d "{
            \"repository\": { \"name\": \"$REPO_NAME\" },
            \"owner\": { \"username\": \"$REPO_OWNER\" },
            \"root\": \"$ROOT_DIR\",
            \"type\": \"$TYPE\",
            \"token\": \"$JOB_TOKEN\"
          }"
```

Puoi infatti cambiare la root del sito web per il deploy, modificando la variabile ```ROOT_DIR```, e puoi anche cambiare il tipo di deploy per la repository, modificando la variabile ```TYPE```.

## Uso del Database (beta)

Puoi collegare un DB con dati permanenti al tuo sito web in PHP. Per attivare il modulo, crea il file ```use_db.txt``` nella cartella radice. Ecco come leggere le variabili del DB e collegarti.

```php
<?php
// Questi valori vengono letti automaticamente
$host = getenv('DB_HOST'); // Sarà "local_db"
$db   = getenv('DB_NAME'); // Sarà "nomerepository-nomeutente"
$user = getenv('DB_USER'); // Uguale al nome DB
$pass = getenv('DB_PASS'); // Password generata casualmente ad ogni deploy
$charset = 'utf8mb4';

$dsn = "mysql:host=$host;dbname=$db;charset=$charset";

try {
     $pdo = new PDO($dsn, $user, $pass);
     echo "Connessione al database riuscita!";
} catch (\PDOException $e) {
     throw new \PDOException($e->getMessage(), (int)$e->getCode());
}
?>
```

Se necessario puoi popolare il DB utilizzando un file SQL, accedendo al link [phpmyadmin.vps.francescomancuso.it](https://phpmyadmin.vps.francescomancuso.it/) oppure effettuando un caricamento tramite PHP al primo avvio dell'applicazione.

## Dati permanenti (beta)

Se il sito web richiede di salvare dati permanenti (es. upload) che non possono essere scritti nel DB, puoi caricarli attraverso PHP nella cartella ```/var/www/data``` del container. Ecco un esempio:

```php
<?php
// index.php

// Salire di un livello per trovare la cartella data
$file_path = '/var/www/data/mio_file.txt'; 
// oppure in modo relativo:
$file_path = __DIR__ . '/../data/mio_file.txt';

file_put_contents($file_path, "Dati salvati nella cartella permanente!");
?>
```