Download the PHP package socloz/knp-gaufrette-bundle without Composer
On this page you can find all versions of the php package socloz/knp-gaufrette-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download socloz/knp-gaufrette-bundle
More information about socloz/knp-gaufrette-bundle
Files in socloz/knp-gaufrette-bundle
Package knp-gaufrette-bundle
Short Description Allows to easily use the Gaufrette library in a Symfony project
License MIT
Homepage http://knplabs.com
Informations about the package knp-gaufrette-bundle
Gaufrette Bundle
Provides a Gaufrette integration for your Symfony projects.
About Gaufrette
Gaufrette is a PHP 5.3+ library providing a filesystem abstraction layer. This abstraction layer permits you to develop your applications without the need to know where all their medias will be stored and how.
Documentation is available the official page of Gaufrette.
Installation
Prerequisites
As this bundle is an integration for Symfony of the Gaufrette library, it requires you to first install Gaufrette in a Symfony project.
Download the bundle
You can download an archive of the bundle and unpack it in the vendor/bundles/Knp/Bundle/GaufretteBundle
directory of your application.
Standard Edition Style
If you are using the deps
file to manage your project's dependencies,
you must add the following lines to it:
[gaufrette]
git=http://github.com/KnpLabs/Gaufrette.git
[KnpGaufretteBundle]
git=http://github.com/KnpLabs/KnpGaufretteBundle.git
target=/bundles/Knp/Bundle/GaufretteBundle
Composer Style
Bundle can be installed using composer by add to require composer.json
part "knplabs/knp-gaufrette-bundle": "dev-master"
line.
Git Submodule Style
If you are versioning your project with git, you had better to embed it as a submodule:
$ git submodule add https://github.com/KnpLabs/KnpGaufretteBundle.git vendor/bundles/Knp/Bundle/GaufretteBundle
Add the namespace in the autoloader
You must register both Gaufrette and the KnpGaufretteBundle in your autoloader: (You do not have to do that if you are using composer autoload system.)
Register the bundle
You must register the bundle in your kernel:
Configuration
The Gaufrette bundle allows you to declare your filesystems as services without having to reach into the famous "Service Container". Indeed, you can do it with the configuration!
The configuration of the Gaufrette bundle is divided into two parts: the adapters
and the filesystems
.
Configuring the Adapters
The defined adapters are usable to create the filesystems.
Configuring the Filesystems
Each defined filesystem must have an adapter
with the key of an adapter as value.
The filesystem defined above with result in a service with id gaufrette.bar_filesystem
.
The alias
parameter permits to also defines an alias for it.
The filesystem map
You can access to all declared filesystems through the map service.
In the previous exemple, we declared a bar
filesystem:
Returns the instance of Gaufrette\Filesystem
for bar
.
Adapters Reference
Local Adapter
A simple local filesystem based adapter.
Parameters
directory
The directory of the filesystem (required)create
Whether to create the directory if it does not exist (default true)
Example
Safe Local Adapter (safe_local)
Almost as simple as the local adapter, but it encodes key to avoid having to deal with the directories structure.
Parameters
directory
The directory of the filesystem (required)create
Whether to create the directory if it does not exist (default true)
Example
Service (service)
Allows you to use a user defined adapter service.
Parameters
id
The id of the service (required)
Example
In Memory (in_memory)
Adapter for test purposes, it stores files in an internal array.
Parameters
files
An array of files (optional)
The files
is an array of files where each file is a sub-array having the content
, checksum
and mtime
optional keys.
Example
GridFS (gridfs)
Adapter that allows you to use a MongoDB GridFS for storing files.
Parameters
mongogridfs_id
The id of the service that provides MongoGridFS object instance for adapter (required)
Example
In your AcmeTestBundle, add following service definitions:
Note that it is possible to prepare MongoGridFS service anyway you like. This is just one way to do it.
MogileFS (mogilefs)
Adapter that allows you to use MogileFS for storing files.
Parameters
domain
MogileFS domainhosts
Available trackers
Example
Ftp
Adapter for FTP.
Parameters
directory
The directory of the filesystem (required)host
FTP host (required)username
FTP username (default null)password
FTP password (default null)port
FTP port (default 21)passive
FTP passive mode (default false)create
Whether to create the directory if it does not exist (default false)mode
FTP transfer mode (defaut FTP_ASCII)
Example
Sftp
Adapter for SFTP (SSH-FTP).
Parameters
sftp_id
The id of the service that provides SFTP access.- `directory The distant directory (default null)*.
create
Whether to create the directory if it does not exist (default false).
Example
In your AcmeTestBundle, add following service definitions:
Apc
Adapter for APC.
A non-persistent adapter, use it in the dev environment, in demo sites, ...
Parameters
prefix
The prefix to this filesystem (APC 'namespace', it is recommended that this end in a dot '.') (required)ttl
Time to live (default 0)
Example
Open Cloud (opencloud)
Adapter for OpenCloud (Rackspace)
Parameters
object_store_id
: the id of the object store servicecontainer_name
: the name of the container to usecreate_container
: iftrue
will create the container in case it's needed (defaultfalse
)detect_content_type
: iftrue
will detect the content type for each file (defaulttrue
)
Defining services
To use the OpenCloud adapter you should provide a valid ObjectStore
instance. You can retrieve an instance through the
OpenCloud\OpenStack
or OpenCloud\Rackspace
instances. We can provide a comprehensive configuration through the Symfony
DiC configuration.
Define OpenStack/Rackspace service
Generic OpenStack:
HPCloud:
The username and password are your login credentials, not the api key. Your tenantName is your Project Name on the api keys page.
Rackspace:
Define ObjectStore service
HPCloud:
Rackspace:
Example
Finally you can define your adapter in configuration:
Cache
Adapter which allow to cache other adapters
Parameters
source
The source adapter that must be cached (required)cache
The adapter used to cache the source (required)ttl
Time to live (default 0)serializer
The adapter used to cache serializations (default null)
Example
Stream Wrapper
You can register filesystems with a specified domain.
And use as a stream wrapper anywhere in your code like :
gaufrette://domain/file.txt
Parameters
protocol
The protocol name likegaufrette://…
(default gaufrette)filesystem
An array that contains files systems that you want to register with the possibility to set the key of the array as the domain likegaufrette://mydomain/…
(default all filesystems)
Example 1
The protocol is gaufrette and all filesystems will be saved
Example 2
We define the protocol as data and all filesystem will be saved
Example 3
We define the protocol as data and define which filesystem will be used
Example 4
We define the protocol as data and define which filesystem will be used with the domain aliasing