You are browsing the documentation for version 3.1 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get the updated information.
See our Release Process documentation for more information on the currently supported and upcoming releases.
OroGridFsConfigBundle provides configuration enhancements for Oro applications to enable usage of GridFS as the filesystem.
The bundle enables developers to set MongoDB GridFS parameters in the application configuration YAML files which automatically enables and configures GridFS filesystem as storage for Gaufrette storages.
To install OroGridFsConfigBundle:
Install mongodb in any preferred way.
Require the package via composer.
composer require oro/gridfs-config
GridFS Gaufrette Adapter Configuration
The bundle supports two ways to configure gaufrette adapers:
- The usual way that requires the configuration of KnpGaufretteBundle.
- A simplified way where you can reconfigure the already configured adapter to GridFS with the parameters.yml file.
Adapters Configuration With KnpGaufretteBundle
To use the Oro GridFS gaufrette adapter, use the
oro_gridfs adapter type. To configure a new or reconfigure the
existing adapter, add the configuration in the app.yml file of a bundle or in the common config.yml file that will add
configuration to the KnpGaufretteBundle configuration:
knp_gaufrette: adapters: attachments: #the adapter name oro_gridfs: mongodb_gridfs_dsn: 'mongodb://127.0.0.1:27017/attachment'
As you can see from the example, the configuration of
oro_gridfs adapter has the
mongodb_gridfs_dsn parameter with the
configuration of Mongo db dsn string. The format of this string the following:
- protocol is mongodb
- username username that has an access to the MongoDB database
- password is the user’s password
- host is the hostname or IP address of the MongoDB server
- database is the MongoDB database name should be used as GridGS storage
Adapters Configuration With Parameters.yml
To simplify the configuration of the already existing Gaugrette adapters, the
parameters.yml file can be used.
To reconfigure an adapter, add the parameter with the name mongodb_gridfs_dsn_[adapter_name], where
adapter_name is the
name of an existing adapter and the Mongo db dsn string is the value of the parameter:
The following example shows the reconfiguration of the attachment adapter:
To get the list of configured Gaufrette adapters, use the debug:config command:
bin/console debug:config knp_gaufrette adapters
Configuration For Cluster Mongodb Gridfs Setup
If you have installed MongoDB cluster, it can be used as the GridFS frorage as well.
In this case, the dsn configuratoin string has the following format: [protocol]://[user]:[password]@[host1]:[port],[host2]:[port]/[database]