Investigate & Document installation on Heroku

[cschneid]

It's important that we can support Heroku deploys of our agent fully, which includes this native extension.

It seems probable that adding "ext-scoutapm": "*" to composer.json will "just work", but we need to try it, and then document it here and in Scout's docs.

[lchachurski]

There is a predefined list of extensions that can be enabled through composer.json https://devcenter.heroku.com/articles/php-support#extensions

I think the only way at the moment would be to build a custom buildpack for heroku, more here

heroku/heroku-buildpack-php#235 (comment)
https://github.com/heroku/heroku-buildpack-php/blob/master/support/build/README.md

[asgrim]

Indeed; I've just verified it doesn't work out the box:

WARNING: A requested extension is not available

and

composer.json/composer.lock requires ext-scoutapm * -> no matching package found.

[asgrim]

Here's me thinking "there must be a better way".... heroku/heroku-buildpack-php#377

[asgrim]

I prepared a branch to heroku-buildpack-php to add support for scoutapm - probably makes sense to wait for PHP 7.4 to be out though, and also to ensure we resolve our issue with spans.

(ref: https://github.com/heroku/heroku-buildpack-php/compare/master...asgrim:add-scoutapm-ext?expand=1)

[lchachurski]

Thanks for the effort, let me know once it's open so we can organize another "thumbs up" campaign to speed things up ;)

[cschneid]

Note: the newly released scout-apm-php version 2.1.1 (and underlying CoreAgent 1.2.7) solves the mentioned issue with the extension + spans happening too early.

[asgrim]

Submitted patch to add scoutapm to Heroku: heroku/heroku-buildpack-php#390