💿 Stockage

Introduction

info

Bow Framework intègre un système de gestion de fichiers permettant de manipuler des fichiers avec une grande simplicité.

Configuration

Le fichier de configuration du système de gestion de fichiers se trouve dans config/resource.php.

Fonctionnement

Vous avez la possibilité d'utiliser les services ou travailler dans votre disque local. Les méthodes statiques local et service permettent respectivement de manipuler le système de disque et les services de stockage actuellement ftp et s3.

Système de fichiers local

Pour gérer votre système de fichiers local avec Bow Framework, vous allez utiliser la méthode statique local.

Explication du concept

Nous appelerons les différents dossiers spécifiés disk.

Considérons la configuration suivante :

'disk' =>[
  'mount' => 'storage',
  'path' => [
    'storage' => __DIR__.'/../var/app',
    'public' => __DIR__.'/../public',
  ]
];

Remarque

Vous pouvez spécifier autant de disques que vous voulez.

La classe Storage expose la méthode statique local qui permet la manipulation de fichiers. La valeur passée à local doit être un nom de disque valide spécifié dans la liste des path.

use Bow\Storage\Storage;

Storage::local("public");
// Ou
Storage::local();

Information

Si la méthode local est appelée sans paramètre, elle utilisera par défaut la valeur de la clé mount.

Vous pouvez aussi utiliser le helper app_storage() qui fonctionne exactement de la même manière :

app_storage('public');
// Ou
app_storage()->get('app.js');

Les services S3 et FTP

Pour utiliser un système de stockage externe, cela se fait via la méthode service. Cette méthode vous permet de sélectionner le type de stockage externe que vous voulez utiliser. Vous trouverez la configuration nécessaire des services dans le fichier de configuration, section services du fichier config/resource.php.

Exemple avec le service ftp :

$service = Storage::service('ftp');
$service->get('app.js');

Manipulation des fichiers

Cette section décrit les différentes méthodes disponibles pour la manipulation de fichiers et leur utilisation.

Supposons que nous avons le fichier app.txt dans le disque public :

// contenu du fichier app.txt
Hello, world

Important

Notez que ces méthodes (sauf la méthode get) retournent respectivement true ou false en cas de succès ou d'échec.

Récupérer le contenu d'un fichier

La méthode get sert à récupérer le contenu d'un fichier. Elle prend comme paramètre le nom du fichier.

$local_storage = app_storage('public');
$content = $local_storage->get("app.txt");

// Avec un service
$service = Storage::service('ftp');
$content = $service->get("app.txt");

echo $content;
// => Hello, world

Compatibilité

service et local utilisent la même interface de manipulation. Ce qui veut dire que les méthodes disponibles pour local existent aussi pour service.

Ajouter/Modifier le contenu d'un fichier

La méthode put permet d'ajouter ou de modifier le contenu d'un fichier :

$local_storage = app_storage('public');
$content = 'console.log("Hello, world")';

$local_storage->put('app.js', $content );

Ajouter du contenu au début ou à la fin d'un fichier

Les méthodes preprend et append vous permettent d'ajouter respectivement du contenu au début ou à la fin d'un fichier :

$local_storage = app_storage('public');

$local_storage->prepend('app.txt', 'Contenu ajouté au début');
$local_storage->append('app.txt', 'Contenu ajouté à la fin');

Supprimer un fichier

La méthode delete permet de supprimer un fichier.

$local_storage = app_storage('public');

$local_storage->delete('app.js');

Copier un fichier

$local_storage = app_storage('public');

$local_storage->copy('app.txt', 'sous-dossier/app.txt');

Créer un dossier

Vous pouvez créer un nouveau dossier à l'aide de la méthode makeDirectory:

Prototype

$local_storage = app_storage('public');

$local_storage->makeDirectory($dirname, $mode = 0777, $recursive = false);

Paramètre	Type
path	String - le dossier à créer
mode	Int - Le mode du dossier par défaut 777
recursive	Boolean - Permet de créer récursivement

$local_storage = app_storage('public');

$local_storage->makeDirectory('dossier');

Remarque

Notez que vous pouvez changer le mode du dossier et choisir de le créer de manière récursive.

$local_storage->makeDirectory('chemin/vers/un/dossier', 777, true);

Vérifier si un fichier existe

$local_storage = app_storage('public');

if ($local_storage->exists('app.txt')) {
  echo $local_storage->get('app.txt');
}

Vérifier si le paramètre est un fichier

$local_storage = app_storage('public');

if ($local_storage->isFile('app.txt')) {
  echo "C'est un fichier";
}

Vérifier si le paramètre est un dossier

$local_storage = app_storage('public');

if ($local_storage->isDirectory('nom_du_dossier')) {
  echo "C'est un dossier";
}

Obtenir le chemin absolu d'un fichier ou dossier

$local_storage = app_storage('public');

$path = $local_storage->path('app.txt');

echo $path;
// => /chemin/absolu/vers/le/fichier/app.txt

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.