prolix/file-system-bundle

Symfony Kitpages FileSystem Bundle. Abstraction layer for files (local, S3)

Thursday, July 13, 2017
by kuldippujara
Repository
2 Watchers
0 Stars
43 Installations

PHP
0 Dependents
0 Suggesters
4 Forks
0 Open issues
16 Versions
10 % Grown

The README.md

KitpagesFileSystemBundle

This is a Symfony2 bundle that provides a filesystem abstraction layer. Basicaly this does the same as the gaufrette library from KnpLabs, but it manages much more efficiently big files. We can manage a 2GB file with a memory limit of 128Mo for the PHP process. We never transfert the entire content in a $content variable., _(*1)

With this bundle you can save your files on different filesystems (S3, Local filesystem, FTP,...), _(*2)

Some elements of the configuration system are based on the code of the KnpGaufretteBundle., _(*3)

Versions

2019-01-23 : v4.0.0, _(*4)

[new] upgrade to Symfony 2.8, 3.x, 4.x
[doc] best doc for tests

2018-05-16 : v3.2.1, _(*5)

[fix] url of the file in the flysystem system for swift
[fix] fix pb when the file doesn't exist in flysystem adapter
[fix] fix mime type problem in flysystem adapter

2018-05-15 : v3.2.0, _(*6)

[new] integration with flysystem

Lot of doc is missing here..., _(*7)

2012-05-24 : v1.0.0 * first stable release, _(*8)

Actual state

This bundle is stable. The adapters are :, _(*9)

Local adapter : file system of the server
S3 adapter : for Amazon Web Service AWS S3
FTP adapter : for FTP access
FlySystem adapater : for a link to flysystem

Installation

You need to add the following lines in your deps :, _(*10)

Using Composer, just $ composer require kitpages/file-system-bundle package or:, _(*11)

``` javascript { "require": { "kitpages/file-system-bundle": "dev-master" } }, _(*12)


Only if you use AmazonS3
``` javascript
{
  "require": {
    amazonwebservices/aws-sdk-for-php: ~1.5
  }
}

Only if you use Flysystem ``` javascript { "require": { "league/flysystem": "^1.0", "oneup/flysystem-bundle": "^1.14", } }, _(*13)

AppKernel.php

```php
$bundles = array(
    ...
    new Kitpages\FileSystemBundle\KitpagesFileSystemBundle(),
);

// AWS SDK needs a special autoloader, _(*14)

require_once __DIR__.'/../vendor/aws-sdk/sdk.class.php';

Configuration example

The following configuration defines 3 filesystems :, _(*15)

kitpagesFile : a local filesystem
kitpagesAmazon : a filesystem on Amazon S3
kitpagesFlysystem : another filesystem abstraction

Let's see the configuration in config.yml, _(*16)

kitpages_file_system:
    file_system_list:
        kitpagesFile:
            local:
                directory_public: %kernel.root_dir%/../web
                directory_private: %kernel.root_dir%
                base_url: %base_url%
        kitpagesAmazon:
            amazon_s3:
                bucket_name: %kitpagesFile_amazons3_bucketname%
                key: %kitpagesFile_amazons3_key%
                secret_key: %kitpagesFile_amazons3_secretkey%
        kitpagesFlysystem:
            flysystem:
                flysystem_adapter: oneup_flysystem.your_filesystem
                file_uri_prefix: https://your.custom.url/4687311687643/FRA/

Usage example

// use AdapterFile at the beginning of the file
use Kitpages\FileSystemBundle\Model\AdapterFile;

// get the adapter
$localAdapter = $this->get("kitpages_file_system.file_system.kitpagesFile");
$s3Adapter = $this->get("kitpages_file_system.file_system.kitpagesAmazon");

// private files (without direct public URL)
$adapter->copyTempToAdapter("/my_physical_dir/foo.txt", new AdapterFile("bar/foo.txt") );
$adapter->copyAdapterToTemp(new AdapterFile("bar/foo.txt"), "/my_physical_dir/foo.txt" );

// public files (with a direct URL given by the adapter)
$adapter->copyTempToAdapter("/my_physical_dir/foo.txt", new AdapterFile("bar/foo.txt", true) );
$url = $adapter->getFileLocation(new AdapterFile("bar/foo.txt", true));

// some functions of the adapter :
$adapterFile = new AdapterFile("bar/foo.txt");
$adapter->copyTempToAdapter("/my_physical_dir/foo.txt", $adapterFile );
$content = $adapter->getFileContent($adapterFile);
$adapter->sendFileToBrowser($adapterFile);
if ($adapter->isFile($adapterFile) ) {
    // if file exists in the adapter
}

Run the tests

cd Tests/app/web
php -S localhost:8888

The Versions

13/07 2017

dev-master

9999999-dev https://github.com/kitpages/KitpagesFileSystemBundle

Symfony Kitpages FileSystem Bundle. Abstraction layer for files (local, S3)

symfony-bundle file-system-bundle

Symfony Kitpages FileSystem Bundle. Abstraction layer for files (local, S3)

prolix/file-system-bundle

The README.md

KitpagesFileSystemBundle

Versions

Actual state

Installation

Configuration example

Usage example

Run the tests

The Versions

dev-master

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v3.1.3

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v3.1.2

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v3.1.1

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v3.1.0

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v3.0.0

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

2.1.x-dev

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v2.1.0

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v2.1.0RC1

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v2.1.0BETA5

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v2.1.0BETA4

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v2.1.0BETA3

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v2.1.0BETA2

The Requires

The Development Requires

by Philippe Le Van

by Sebastien Lefebvre

v2.1.0BETA1

The Requires

The Development Requires