Download the PHP package finller/laravel-aws-mediaconvert without Composer

Bring AWS MediaConvert to Laravel

This package provides an easy way to interact with AWS MediaConvert. It provides usefull presets for HLS, MP4 optimization and thumbnail.

The package is greatly inspired by the work of meemalabs and their similar package https://github.com/meemalabs/laravel-media-converter !

Installation

You can install the package via composer:

You can publish the config file with:

This is the contents of the published config file:

Usage

In the most basic way, this package provides a service which is a wrap around the aws sdk. So you can simply create a MediaConvert job by calling createJob like that.

But we also provid usefull HLS and MP4 presets that are optimized for the web. Here is a more advanced usage:

Convert any video to an optimized MP4:

Convert any video to an optimized Apple HLS set of files:

Perform multiple Conversion in 1 job:

Tracks MediaConvert jobs with webhooks

1. Register the webhook route in your app.

You can simply use our prebuilt Webhook controller

In your web, api or any route file of yours, register the prebuilt route with the following macro. You can use any url

If you have put your route in a place where the VerifyCsrfToken is attached, you will have to add an exception just like that:

2. Create an SNS Topic

Go to https://console.aws.amazon.com/sns/v3/home (don't forget to select the right region for you).

On the right navigation bar, select "Topics" and click the "Create topic" button on your right. For the Type, choose "Standard" and give a name to your Topic juste like "MediaConvertJobUpdate" and click "Create topic"

Now, click "Create subscription" and select HTTPS for the "Protocol". Then enter the webhook route you have chosen like https://app.example/aws/webhooks/media-convert and confirm creation.

By default, AWS will have sent a post request to URL you defined in your "Subscription" setup. This package automatically handles the "confirmation" part. In case there is an issue and it is not confirmed yet, please click on the "Request confirmation" button.

3. Create an AWS CloudWatch rule

1. Go to https://console.aws.amazon.com/cloudwatch/home (don't forget to select the right region for you).
2. Open Events > Rule from the left navigation bar.
3. Click Create Rule. In the Event Source panel select the "Event pattern" radio and "Events by Services" (it should be the default value) In "Service Name", choose "MediaConvert" et keep "All Events" for Event Type.

Your Event pattern preview should be

If you need to listen to only a specific queue for example, you can do it like that:

In the Target panel (on the right), click "Add Target" and select "SNS Topic". Then select the previously created SNS Topic.

That's all, this package will dispatch Laravel events for you to listen. But if you need more specific behavior, you can create your own controller by extending AwsMediaConvertWebhookController for example.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Quentin Gabriele
• All Contributors

License

The MIT License (MIT). Please see License File for more information.