Cover of the book Symfony 5: The Fast Track

Symfony 5: The Fast Track is the best book to learn modern Symfony development, from zero to production. +300 pages showcasing Symfony with Docker, APIs, queues & async tasks, Webpack, SPAs, etc.

  1. Home
  2. Documentation
  3. Symfony CMF
  4. Configuration Reference

Configuration Reference

1.3 version
Maintained
1.3 current 1.3 current
Unmaintained
1.2
edit this page

Configuration Reference

Note

To focus our efforts onto a manageable number of packages, this package is currently not maintained. Security fixes and submitted bug fixes will still be released, but no new features should be expected. This bundle might have outdated documentation, there is no support from the CMF team and you should not expect bugs to be fixed.

If you want to help co-maintaining this package, tell us in a GitHub issue or in #symfony_cmf of the Symfony devs slack.

The MediaBundle can be configured under the cmf_media key in your application configuration. When using XML, you can use the http://cmf.symfony.com/schema/dic/media namespace.

Configuration

persistence

phpcr

This defines the persistence driver. The default configuration of persistence is the following configuration:

  • YAML
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
    cmf_media:
    persistence:
        phpcr:
            enabled:         false
            manager_name:    ~
            media_basepath:  /cms/media
            media_class:     Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Media
            file_class:      Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\File
            directory_class: Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Directory
            image_class:     Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Image
            event_listeners:
                stream_rewind:    true
                image_dimensions: true
                imagine_cache:    auto
  • XML
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
    <?xml version="1.0" charset="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services">

    <config xmlns="http://cmf.symfony.com/schema/dic/media">
        <persistence>
            <phpcr
                enabled="false"
                manager-name="null"
                media-basepath="/cms/media"
                media-class="Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Media"
                file-class="Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\File"
                directory-class="Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Directory"
                image-class="Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Image"
            >
                <event-listeners
                    stream-rewind="true"
                    image-dimensions="true"
                    imagine-cache="auto"
                />
            </phpcr>
        </persistence>
    </config>

</container>
  • PHP
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
    $container->loadFromExtension('cmf_media', array(
    'persistence' => array(
        'phpcr' => array(
            'enabled'         => false,
            'manager_name'    => null,
            'media_basepath'  => '/cms/media',
            'media_class'     => 'Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Media',
            'file_class'      => 'Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\File',
            'directory_class' => 'Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Directory',
            'image_class'     => 'Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Image',
            'event_listeners' => array(
                'stream_rewind'    => true,
                'image_dimensions' => true,
                'imagine_cache'    => 'auto',
            ),
        ),
    ),
));
enabled

type: boolean default: false

If true, PHPCR is enabled in the service container.

If the CoreBundle is registered, this will default to the value of cmf_core.persistence.phpcr.enabled.

PHPCR can be enabled by multiple ways such as:

  • YAML
    1
2
3
4
5
6
    phpcr: ~ # use default configuration
# or
phpcr: true # straight way
# or
phpcr:
    manager: ... # or any other option under 'phpcr'
  • XML
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
    <persistence>
    <!-- use default configuration -->
    <phpcr />

    <!-- or setting it the straight way -->
    <phpcr>true</phpcr>

    <!-- or setting an option under 'phpcr' -->
    <phpcr manager="..." />
</persistence>
  • PHP
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
    $container->loadFromExtension(..., array( // bundle configuration key, e.g. cmf_menu
    // ...
    'persistence' => array(
        'phpcr' => null, // use default configuration
        // or
        'phpcr' => true, // straight way
        // or
        'phpcr' => array(
            'manager' => '...', // or any other option under 'phpcr'
        ),
    ),
));
media_basepath

type: string default: /cms/media

The basepath for CMS media documents in the PHPCR tree.

If the CoreBundle is registered, this will default to the value of %cmf_core.persistence.phpcr.basepath%/media.

manager_name

type: string default: null

The name of the Doctrine Manager to use. null tells the manager registry to retrieve the default manager.

If the CoreBundle is registered, this will default to the value of cmf_core.persistence.phpcr.manager_name.

media_class

type: string default: 'Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Media'

The class for media objects. Be they cloud hosted or local files.

file_class

type: string default: 'Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\File'

The class for objects representing a file.

directory_class

type: string default: 'Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Directory'

The class for objects representing directories.

image_class

type: string default: 'Symfony\Cmf\Bundle\MediaBundle\Doctrine\Phpcr\Image'

The class for image objects. This just adds methods to get the native image dimensions, but implicitly also tells applications that this object is suitable to view with an <img> HTML tag.

event_listeners.stream_rewind

type: boolean default: true

Whether to enable the stream rewinding listener that will make sure that all streams are rewound before flushing. This makes sure all data is saved even if the stream was read before saving.

event_listeners.image_dimension

type: boolean default: true

Whether to enable the image dimension listener that will update image dimensions on any Image documents before saving.

event_listeners.imagine_cache

type: enum type: enum valid values: true|false|auto default: auto

Whether to enable the imagine cache invalidator listener. This listener invalidates the cache for the imagine filters configured in imagine_filters and extra_filter.

If set to auto, the filter is activated if the LiipImagineBundle is present. On true it is always activated, leading to an error should the imagine bundle not be configured, and on false it is never activated.

upload_file_role

type: string default: ROLE_CAN_UPLOAD_FILE

The role used to protect the default upload action of the file and image controller of the MediaBundle.

upload_file_helper_service_id

type: string default: null

The service id to override the default service the alias cmf_media.upload_file_helper points to.

upload_image_helper_service_id

type: string default: null

The service id to override the default service the alias cmf_media.upload_image_helper points to.

use_jms_serializer

type: enum valid values: true|false|auto default: auto

If true, the serializer handler for images is activated. If set to auto, this is activated only if the JMSSerializerBundle is present.

The serializer handler adds an url to the serialized representation of an image object.

use_elfinder

type: enum valid values: true|false|auto default: auto

If true, the elfinder adapter is activated and cmf_media.default_browser is set. If set to auto, this is activated only if the FMElfinderBundle is present.

use_imagine

type: enum valid values: true|false|auto default: auto

If true, imagine related parameters are set. If set to auto, this is activated only if the LiipImagineBundle is present.

If enabled and if phpcr is enabled, the imagine data loader and cache invalidation listener are activated.

The LiipImagineBundle is able to provide scaled images. Otherwise images are always provided in the original resolution (and scaling might happen in the browser through the img width and height attributes).

imagine_filters

  • YAML
    1
2
3
4
    cmf_media:
    imagine_filters:
        upload_thumbnail:   image_upload_thumbnail
        elfinder_thumbnail: elfinder_thumbnail
  • XML
    1
2
3
4
5
6
    <config xmlns="http://cmf.symfony.com/schema/dic/media">
    <imagine-filter
        upload_thumbnail="image_upload_thumbnail"
        elfinder_thumbnail="elfinder_thumbnail"
    />
</config>
  • PHP
    1
2
3
4
5
6
    $container->loadFromExtension('cmf_media', array(
    'imagine_filters'     => array(
        'upload_thumbnail'   => 'image_upload_thumbnail',
        'elfinder_thumbnail' => 'elfinder_thumbnail',
    ),
));

upload_thumbnail

type: string default: image_upload_thumbnail

The imagine filter to be used as thumbnail for uploaded images.

elfinder_thumbnail

type: string default: elfinder_thumbnail

The imagine filter to be used for elfinder thumbnails.

extra_filters

prototype: array

This is a list of filters that should be invalidated when images are uploaded. (a LiipImagineBundle shortcoming that we can’t just invalidate a file in all caches in one go)

  • YAML
    1
2
3
4
    cmf_media:
    extra_filters:
        - imagine_filter_name1
        - imagine_filter_name2
  • XML
    1
2
3
4
    <config xmlns="http://cmf.symfony.com/schema/dic/media">
    <extra-filter>imagine_filter_name1</extra-filter>
    <extra-filter>imagine_filter_name2</extra-filter>
</config>
  • PHP
    1
2
3
4
5
6
    $container->loadFromExtension('cmf_media', array(
    'extra_filters'      => array(
        'imagine_filter_name1',
        'imagine_filter_name2',
    ),
));

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.