netbull/media-bundle

Media bundle

v6.4.14 2024-11-06 08:38 UTC

Requires

• php: 8.*
• ext-curl: *
• aws/aws-sdk-php: 3.*
• imagine/imagine: 1.*
• knplabs/doctrine-behaviors: ^2.0
• knplabs/gaufrette: 0.9.*
• symfony/form: 6.4.*
• symfony/http-client: 6.4.*
• symfony/mime: 6.4.*
• symfony/process: 6.4.*

AGPL-3.0-or-later

• Aleksandar Dimitrov

• netbull media symfony bundle

README

Mod of SonataMediaBundle

Installation

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

$ composer require netbull/media-bundle

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

$ composer require netbull/media-bundle

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = array(
            // ...

            new NetBull\MediaBundle\NetBullMediaBundle(),
        );

        // ...
    }

    // ...
}

Step 3: Configure the Bundle

Example configuration file app/config/netbull_media.yml

parameters:
    quality: 80
    formats:
        tiny: { width: 41, quality: '%quality%' }
        thumb:   { width: 223, quality: '%quality%' }
        normal:   { width: 590, quality: '%quality%' }
        big:   { width: 1280, quality: '%quality%' }

    download:
        strategy: media.security.public_strategy
        mode: http

    default_context:
        download: '%download%'
        providers:
            - media.provider.image
        formats: '%formats%'

netbull_media:
    default_context: 'default'

    providers:
        image:
            service:    media.provider.image
            resizer:    media.resizer.square
            filesystem: media.filesystem.s3
            cdn:        media.cdn.server

        file:
            service:    media.provider.file
            resizer:    false
            filesystem: media.filesystem.s3
            cdn:        media.cdn.server
            thumbnail:  media.thumbnail.format
            allowed_extensions: ['pdf', 'txt', 'rtf', 'doc', 'docx', 'xls', 'xlsx', 'ppt', 'pttx', 'odt', 'odg', 'odp', 'ods', 'odc', 'odf', 'odb', 'csv', 'xml', 'html']
            allowed_mime_types: ['application/pdf', 'application/x-pdf', 'application/rtf', 'text/html', 'text/rtf', 'text/plain']
    cdn:
        server:
            paths:
                - 'YOUR_CDN_DOMAIN'

    filesystem:
        s3:
          defaults: 
            region: eu-central-1 /or other aws zone/
                version: latest
                credentials:
                    key: AWS KEY
                    secret: AWS SECRET
          options:
            bucket: 'AWS BUCKET NAME'
            cache_control:  max-age=604800
            meta:
                Cache-Control: max-age=604800

    contexts:
        default: '%default_context%'