Bow Framework Blog

Téléversement de fichiers avec BowPHP

2025-12-07T00:00:00.000Z

Ce billet explique comment intégrer de manière sécurisée le téléversement de fichiers dans une application BowPHP : routes, contrôleurs, emplacement de stockage et diffusion des fichiers téléversés.

Vue d'ensemble

Le téléversement de fichiers est courant mais risqué. Avec BowPHP vous devez :

Enregistrer une route qui reçoit le fichier.
Valider et déplacer le fichier dans un contrôleur.
Stocker les fichiers en dehors du répertoire public (par ex. racine/var/storage).
Servir les fichiers via un contrôleur ou des URL signées pour éviter l'accès direct.

Formulaire HTML (client)

Utilisez multipart/form-data et pointez vers la route BowPHP :

<form action="/upload" method="post" enctype="multipart/form-data">
  <label for="file">Choisir un fichierlabel>
  <input type="file" name="file" id="file" required>
  <button type="submit">Téléverserbutton>
form>

Enregistrer la route (BowPHP)

Ajoutez une route POST qui délègue au contrôleur :

// filepath: /routes/web.php
// ...existing code...
use App\Controllers\UploadController;

$app->post('/upload', [UploadController::class, 'store']);
// ...existing code...

UploadController (BowPHP)

Gestionnaire minimal et sécurisé adapté à BowPHP. Ajustez l'API Request selon votre version ; un fallback vers $_FILES peut être ajouté si nécessaire.

// filepath: /app/controllers/UploadController.php
namespace App\Controllers;

use Bow\Http\Request;
use Bow\Http\Response;
use Bow\Http\UploadedFile;

class UploadController
{
  public function store(Request $request): Response
  {
    if (!$request->hasFile('file')) {
      return response('Aucun fichier fourni', 400);
    }

    /** @var UploadedFile $file */
    $file = $request->file('file');

    if (!$file->isUploaded()) {
      return response('Erreur lors du téléversement', 400);
    }

    // Limites
    $maxBytes = 5 * 1024 * 1024; // 5 MB
    if ($file->getFilesize() > $maxBytes) {
      return response('Fichier trop volumineux', 400);
    }

    // Validation du MIME (utiliser finfo sur le fichier temporaire si disponible)
    $allowed = [
      'image/png'       => 'png',
      'image/jpeg'      => 'jpg',
      'application/pdf' => 'pdf',
    ];

    $mime = $file->getTypeMime();

    if (!isset($allowed[$mime])) {
      return response('Type de fichier invalide', 400);
    }

    $extension = $file->getExtension();

    // Stocker en dehors du dossier public - utiliser le répertoire var/storage du projet
    $uploadsDirectory = storage_path('uploads'); // projet_root/var/storage
    if (!is_dir($uploadsDirectory)) {
      mkdir($uploadsDirectory, 0750, true);
    }

    $filename = bin2hex(random_bytes(16)) . '.' . $extension;

    // Déplacer le fichier via l'API UploadedFile
    $result = $file->moveTo($uploadsDirectory, $filename);

    // Vérifier la réussite du déplacement (moveTo peut renvoyer void/true/chemin/objet selon implémentation)
    $dest = rtrim($uploadsDirectory, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $filename;
    if (is_string($result) && is_file($result)) {
      $dest = $result;
    }

    if (!is_file($dest)) {
      return response('Échec du déplacement du fichier', 500);
    }

    chmod($dest, 0640);

    // Retourner une référence sûre (ne pas exposer le chemin complet). Envisagez une URL signée ou un ID.
    return response()->json([
      'status' => 'ok',
      'file'   => $filename,
    ]);
  }
}

Diffusion des fichiers téléversés (via contrôleur, sécurisé)

Servez les fichiers via BowPHP pour pouvoir appliquer authentification et en-têtes au lieu d'exposer le dossier de stockage.

// filepath: /app/controllers/FileServeController.php
namespace App\Controllers;

use Bow\Http\Request;
use Bow\Http\Response;

class FileServeController
{
  public function show(Request $request, $filename): Response
  {
    $uploadsDirectory = storage_path('uploads'); // projet_root/var/storage
    $file = $uploadsDirectory . DIRECTORY_SEPARATOR . basename($filename);

    if (!is_file($file)) {
      return response('Introuvable', 404);
    }

    // Optionnel : vérifier permissions, propriété ou authentification ici.

    // Envoyer le fichier avec les en-têtes appropriés
    return response()->download($file, null, [
      'Content-Type' => mime_content_type($file),
      'Content-Length' => filesize($file),
      'Content-Disposition' => 'attachment; filename="' . basename($file) . '"',
    ]);
  }
}

Enregistrez la route GET pour la diffusion (appliquez le middleware d'authentification et de limitation de débit si nécessaire) :

// filepath: /routes/web.php
// ...existing code...
$app->get('/uploads/{filename}', [\App\Controllers\FileServeController::class, 'show'])
  ->middleware(['auth']); // appliquez le middleware d'authentification/limitation si nécessaire
// ...existing code...

Configuration BowPHP & notes sur le stockage

Conservez les uploads sous project_root/var/storage (hors dossier public).
Si vous utilisez config/storage.php ou config/filesystems.php, déclarez un disque local pointant vers var/storage.
Pour les gros fichiers, envisagez les uploads en morceaux (chunked) et le streaming pour éviter des pics mémoire.
Utilisez des URL signées ou un contrôleur pour accorder un accès temporaire au lieu de liens directs.

Notes de déploiement

Assurez-vous que project_root/var/storage existe dans chaque environnement avec le bon propriétaire et permissions.
Synchronisez les limites php.ini avec celles définies dans l'application.
Envisagez de migrer les uploads vers un stockage objet (S3) pour la scalabilité ; servez via URL signées.

Lectures complémentaires

PHP manual: Handling file uploads
OWASP: File Upload Cheat Sheet
BowPHP docs: routing, controllers, and response helpers

Il manque quelque chose ?

Si vous rencontrez des problèmes avec la documentation ou si vous avez des suggestions pour améliorer la documentation ou le projet en général, veuillez déposer une issue pour nous, ou envoyer un tweet mentionnant le compte Twitter @bowframework ou sur directement sur le github.

Créer une application de To Do List avec BowPHP

2025-01-18T00:00:00.000Z

Créer une application de To Do List avec BowPHP, un framework PHP léger, est une excellente idée. Voici un plan détaillé pour y parvenir :

Étape 1 : Installation de BowPHP

Installer BowPHP :

Assurez-vous que Composer est installé sur votre machine, puis utilisez la commande suivante pour installer BowPHP :

composer create-project bowphp/app todolist

Cela créera une nouvelle application BowPHP nommée todolist.

Configurer votre application :

Modifiez le fichier .env.json pour configurer la connexion à la base de données (par exemple MySQL).

.env.json
{
  "DB_DEFAULT": "mysql",
  "DB_HOSTNAME": "127.0.0.1",
  "DB_USERNAME": "username",
  "DB_PASSWORD": "password",
  "DB_DBNAME": "todolist_db",
  "DB_PORT": 3306
}

Étape 2 : Configurer la base de données

Créer la base de données :

Exécutez cette commande MySQL pour créer une base de données :

CREATE DATABASE todolist_db;

Créer une table pour les tâches :

Pour ajouter une nous table, vous pouvez le faire avec la commande suivante:

php bow add:migration create-tasks-table

Vous allez avoir un nouveau fichier dans le dossier database/migrations.

database/migrations/Version1000000000CreateTasksTable.php

use Bow\Database\Migration\Migration;
use Bow\Database\Migration\SQLGenerator as Table;

class Version1000000000CreateTasksTable extends Migration
{
  /**
   * Run the migrations.
   *
   * @return void
  */
  public function up()
  {
    $this->create('tasks', function (Table $table) {
      $table->addPrimary('id');
      $table->addString('title');
      $table->addBoolean('completed', ['default' => false]);
      $table->addTimestamps();
    });
  }

  /**
   * Reverse the migrations.
   *
   * @return void
   */
  public function rollback()
  {
    $this->dropIfExists('tasks');
  }
}

Ensuite, exécutez la migration :

php bow migrate

Étape 3 : Créer le modèle et le contrôleur

Créer un modèle Task :

Ajouter un modèle de base de donnée

php bow add:model Task

Vous verrez le fichier app/Models/Task.php dans votre projet.

app/Models/Task.php
namespace App\Models;

use Bow\Database\Barry\Model;

class Task extends Model
{
  //
}

Créer un contrôleur TaskController :

app/Controllers/TaskController.php
namespace App\Controllers;

use App\Models\Task;
use Bow\Http\Request;

class TaskController
{
  public function index()
  {
    $tasks = Task::all();

    return view('tasks.index', compact('tasks'));
  }

  public function store(Request $request)
  {
    // Validation des données
    $request->validate([
      'title' => 'required|min:3|max:255'
    ]);

    Task::create([
      'title' => $request->get('title'),
      'completed' => false
    ]);

    return redirect('/')->withFlash('success', 'Tâche ajoutée avec succès !');
  }

  public function update(int $id)
  {
    $task = Task::find($id);
    
    if (!$task) {
      return redirect('/')->withFlash('error', 'Tâche introuvable.');
    }
    
    $task->update(['completed' => !$task->completed]);

    return redirect('/')->withFlash('success', 'Tâche mise à jour !');
  }

  public function destroy(Request $request, int $id)
  {
    $task = Task::find($id);
    
    if (!$task) {
      return redirect('/')->withFlash('error', 'Tâche introuvable.');
    }
    
    $task->delete();

    return redirect('/')->withFlash('success', 'Tâche supprimée !');
  }
}

Étape 4 : Configurer les routes

Dans le fichier routes/app.php, ajoutez les routes suivantes :

use App\Controllers\TaskController;

$app->get('/', [TaskController::class, 'index']);
$app->post('/tasks', [TaskController::class, 'store']);
$app->put('/tasks/{id}', [TaskController::class, 'update']);
$app->delete('/tasks/{id}', [TaskController::class, 'destroy']);

Note sur les méthodes HTTP

Bow Framework gère automatiquement la méthode spoofing via le champ _method dans les formulaires. Cela permet d'utiliser PUT et DELETE même si HTML ne supporte nativement que GET et POST.

Étape 5 : Créer les vues

Créer le fichier de template templates/tasks.tintin.php et ajoutez-y le contenu suivant.

templates/tasks.tintin.php
<!DOCTYPE html>
<html lang="fr">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Todo List - BowPHP</title>
  <style>
    * { margin: 0; padding: 0; box-sizing: border-box; }
    body { 
      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
      min-height: 100vh;
      padding: 2rem;
    }
    .container { 
      max-width: 600px; 
      margin: 0 auto; 
      background: white;
      border-radius: 12px;
      padding: 2rem;
      box-shadow: 0 20px 60px rgba(0,0,0,0.3);
    }
    h1 { 
      color: #333; 
      margin-bottom: 2rem;
      text-align: center;
    }
    .add-form { 
      display: flex; 
      gap: 0.5rem; 
      margin-bottom: 2rem;
    }
    input[type="text"] { 
      flex: 1; 
      padding: 0.75rem; 
      border: 2px solid #e0e0e0;
      border-radius: 8px;
      font-size: 1rem;
    }
    input[type="text"]:focus { 
      outline: none; 
      border-color: #667eea;
    }
    button { 
      padding: 0.75rem 1.5rem; 
      background: #667eea;
      color: white;
      border: none;
      border-radius: 8px;
      cursor: pointer;
      font-size: 1rem;
      transition: background 0.3s;
    }
    button:hover { background: #5568d3; }
    .task-list { list-style: none; }
    .task-item { 
      display: flex; 
      align-items: center; 
      padding: 1rem;
      margin-bottom: 0.5rem;
      background: #f8f9fa;
      border-radius: 8px;
      gap: 0.75rem;
    }
    .task-item.completed { 
      opacity: 0.6;
      text-decoration: line-through;
    }
    .task-title { flex: 1; }
    .btn-icon { 
      padding: 0.5rem; 
      background: transparent;
      border: none;
      cursor: pointer;
      font-size: 1.25rem;
    }
    .flash-message {
      padding: 1rem;
      margin-bottom: 1rem;
      border-radius: 8px;
      font-weight: 500;
    }
    .flash-success {
      background: #d4edda;
      color: #155724;
      border: 1px solid #c3e6cb;
    }
    .flash-error {
      background: #f8d7da;
      color: #721c24;
      border: 1px solid #f5c6cb;
    }
  </style>
</head>
<body>
  <div class="container">
    <h1>📝 Ma Todo List</h1>
    
    #if(flash()->has('success'))
      <div class="flash-message flash-success">
        {{ flash()->get('success') }}
      </div>
    #endif
    
    #if(flash()->has('error'))
      <div class="flash-message flash-error">
        {{ flash()->get('error') }}
      </div>
    #endif

    <form method="POST" action="/tasks" class="add-form">
      {{ csrf_field() }}
      <input type="text" name="title" placeholder="Ajouter une nouvelle tâche..." required>
      <button type="submit">Ajouter</button>
    </form>

    <ul class="task-list">
      #foreach ($tasks as $task)
        <li class="task-item {{ $task->completed ? 'completed' : '' }}">
          <form method="POST" action="/tasks/{{ $task->id }}" style="display: inline;">
            {{ csrf_field() }}
            <input type="hidden" name="_method" value="PUT">
            <button type="submit" class="btn-icon">
              {{ $task->completed ? '✅' : '⬜' }}
            </button>
          </form>
          <span class="task-title">{{ $task->title }}</span>
          <form method="POST" action="/tasks/{{ $task->id }}" style="display: inline;">
            {{ csrf_field() }}
            <input type="hidden" name="_method" value="DELETE">
            <button type="submit" class="btn-icon" onclick="return confirm('Supprimer cette tâche ?')">❌</button>
          </form>
        </li>
      #endforeach
    </ul>
    
    #if(count($tasks) === 0)
      <p style="text-align: center; color: #999; padding: 2rem;">Aucune tâche. Ajoutez-en une ci-dessus !</p>
    #endif
  </div>
</body>
</html>

Sécurité CSRF

Notez l'utilisation de {{ csrf_field() }} dans tous les formulaires. C'est une protection CSRF intégrée dans Bow Framework qui empêche les attaques de type Cross-Site Request Forgery.

Étape 6 : Lancer l'application

Démarrez le serveur BowPHP :

php bow run:server

Accédez à votre application sur http://localhost:5000.

Étape 7 : Améliorations possibles

Voici quelques idées pour améliorer votre application :

Filtrage des tâches : Ajouter des filtres pour voir les tâches complétées/incomplètes
Date d'échéance : Ajouter une colonne due_date pour gérer les dates limites
Catégories : Créer un système de catégories ou tags pour organiser les tâches
Authentification : Implémenter un système de connexion pour que chaque utilisateur ait ses propres tâches
API REST : Transformer l'application en API pour une utilisation avec un frontend JavaScript (React, Vue.js)
Recherche : Ajouter une barre de recherche pour filtrer les tâches
Priorités : Ajouter des niveaux de priorité (haute, moyenne, basse)

Déploiement

Pour déployer votre application en production :

# 1. Optimiser l'autoloader
composer dump-autoload --optimize

# 2. Configurer l'environnement de production dans .env.json
{
    "APP_ENV": "production",
    "APP_DEBUG": false,
    // ... autres configs
}

# 3. Configurer votre serveur web (Apache/Nginx)
# Le point d'entrée doit pointer vers public/index.php

Sécurité en Production

Désactivez le mode debug (APP_DEBUG=false)
Utilisez des mots de passe forts pour la base de données
Configurez HTTPS sur votre serveur
Gardez Bow Framework et ses dépendances à jour
Validez toujours les entrées utilisateur

Bow Framework Blog

Téléversement de fichiers avec BowPHP

Vue d'ensemble​

Formulaire HTML (client)​

Enregistrer la route (BowPHP)​

UploadController (BowPHP)​

Diffusion des fichiers téléversés (via contrôleur, sécurisé)​

Configuration BowPHP & notes sur le stockage​

Notes de déploiement​

Lectures complémentaires​

Il manque quelque chose ?

Créer une application de To Do List avec BowPHP

Étape 1 : Installation de BowPHP​

Étape 2 : Configurer la base de données​

Étape 3 : Créer le modèle et le contrôleur​

Étape 4 : Configurer les routes​

Étape 5 : Créer les vues​

Étape 6 : Lancer l'application​

Étape 7 : Améliorations possibles​

Déploiement​

Ressources utiles​

Il manque quelque chose ?

Vue d'ensemble

Formulaire HTML (client)

Enregistrer la route (BowPHP)

UploadController (BowPHP)

Diffusion des fichiers téléversés (via contrôleur, sécurisé)

Configuration BowPHP & notes sur le stockage

Notes de déploiement

Lectures complémentaires

Étape 1 : Installation de BowPHP

Étape 2 : Configurer la base de données

Étape 3 : Créer le modèle et le contrôleur

Étape 4 : Configurer les routes

Étape 5 : Créer les vues

Étape 6 : Lancer l'application

Étape 7 : Améliorations possibles

Déploiement

Ressources utiles