PhpRiot
News Archive
PhpRiot Newsletter
Your Email Address:

More information

Deploying a Symfony2 and Composer app on PagodaBox

Note: This article was originally published at Planet PHP on 19 April 8140.
Planet PHP

I have been working on a little pet project and wanted to put it up somewhere to show to a few people how it was going. I wanted something really simple so I decided to give the PHP PaaS solutions a try. Its a very simple Symfony 2.1 based app using Composer for vendor management, so I went on a quest to see what could be done and how.

I have always liked Orchestra, especially because I know the whole crew, but I was left stranded on how I could run the composer commands I needed after deploy. The feature was not done yet, so I moved onto Pagoda Box, thinking I was going to hit the same wall. I was pleasantly surprised that there was a solution and decided to give it a try.

It was mostly painless, but a few quirks kept me up late chatting with their excellent and very friendly support staff. So I decided to write up a few line about it.

Boxfile

The Boxfile defines all the config for your app and that's where the magic happens. This is basically the extent of changes you need to make to your application.

Basic configuration

Some of the configuration is straight forward, so let's get them out of the way. Be sure to adjust between app and app_dev accordingly.

web1: name: mysf2site document_root: web default_gateway: app.php index_list: [app.php] php_version: 5.3.8

Writable directories

As soon as you deploy a Symfony app you remember that you need to make the cache and logs folders writable or you will get a very nice blowup in your face. Pagoda let's you do this but there is a couple thing you should know.

The writable directories configuration is meant for directories your aoWeba role will write into. This means uploads, caching and related events, its does not relate to build steps. During the aobuilda step of your application (this is when you run Composer), everything is writable, so you don't need to make your vendor folder writable for example.

Writable folders are always empty after deploy. This means if you decide to make your app folder writable because you have the crazy idea that it will be needed for bootstrap.php.cache, your deploy will give you a nice big empty app directory. So remember to only use this config for the folders that need it.

This is what it should look like:

shared\_writable\_dirs: - app/cache - app/logs

Extensions

So it might be a good idea to make sure all the extensions are there, this is very easy, and this is the list i came up with:

php_extensions: - intl - mbstring - xsl - apc - mysql - pdo_mysql - zip

Notice zip, this is very important as Composer depends on this extension or falls back onto unzip, which is not a valid executable in a Pagoda server. The rest is standard Symfony stuff and personal choices.

The Configuration and Database

Personally I like to keep my parameters.yml file out of my repositories, to this was a challenge here, how do I create or copy in this configuration or how do i keep my config out of there.

Getting values into the system was a very nice suggestion on the Pagoda Help site. Using ENV variables you can inject this straight into the Symfony2 parameters.yml file, so i setup my database stuff for now with: SYMFONY__DATABASE__NAME which becomes %database.name% in the yml file. Rinse and repeat for all DB variables and create these in the Dashboard with the proper values.

But I still needed to write the parameters.yml file to the system, and that's where afer_build comes in. I needed to write multiple lines, so i cheated and went for a few echo calls.

Update: It appears you do not even need to have a parameters.yml file, you can go straight from ENV to Symfony as @igorwesome pointed out to me andAthis article

after_build: - "echo 'parameters:' app/config/parameters.yml" - "echo ' database_driver: pdo_mysql' app/config/parameters.yml" - "echo ' database_host: %database.host%' app/config/parameters.yml" - "echo ' database_port: 3306' app/config/parameters.yml" - "echo ' database_name: %database.name%'

Truncated by Planet PHP, read more at the original (another 3221 bytes)