Blog dot Melimato dot Com

Recently, I’ve been doing a few projects using Symfony PHP framework and Bazaar for version control. One of the great features of Symfony is that it generates base classes automatically to interact with the database from a pre-defined schema file. While this is a great feature, every time the schema gets changed, Symfony regenerates all the files thus flagging them as modified in Bazaar. To avoid committing those files all the time, I created a .bzrignore file to ignore them and leave my repository nice and clean.

Firstly, init bazaar for your new project:

bzr init

Next edit your .bzrignore file located in the root dir of your project

vi .bzrignore

And add the following lines:

trunk/cache/*
trunk/log/*
trunk/config/*schema-transformed.xml
trunk/plugins/.*

The above lines are pretty much self-explanatory, the only important thing here to keep in mind is that if you want to ignore all the files inside a directory you firstly have to add the directory to bazaar (bzr add dir) and then ignore everything inside them.
The magic really happens in the following line.
For Doctrine users:

trunk/lib/**/base/*

And Propel

 **/om/*. 
 **/map/*.

This tells bzr to ignore anything inside any directory named base inside the lib directory, and om and map if you’re using propel, which is where all base classes are stored.

This way, your repository will only store the files that you edit. All files generated automatically by Symfony or plugins are ignored, so when checking out a Symfony project you will have to execute:

./symfony doctrine-build-all

or

./symfony propel-build-all

To see which files are currently being ignored use the following command:

bzr ignored

And the output should be something like this:

The first column tells which file is ignored and the second one informs the rule (pattern) used for the match.

trunk/cache/admin                                  trunk/cache/*
trunk/cache/frontend                               trunk/cache/*
trunk/cache/project_autoload.cache                 trunk/cache/*
trunk/lib/filter/doctrine/base/BaseMyClassFormFilter.class.php trunk/lib/**/base/*
trunk/lib/form/doctrine/base/BaseMyClassForm.class.php trunk/lib/**/base/*
trunk/lib/model/doctrine/base/BaseMyClass.class.php trunk/lib/**/base/*
trunk/log/admin_dev.log                            trunk/log/*
trunk/log/frontend_dev.log                         trunk/log/*
trunk/plugins/.channels                            trunk/plugins/.*
trunk/plugins/.depdb                               trunk/plugins/.*
trunk/plugins/.depdblock                           trunk/plugins/.*
trunk/plugins/.filemap                             trunk/plugins/.*
trunk/plugins/.lock                                trunk/plugins/.*
trunk/plugins/.registry                            trunk/plugins/.*
trunk/web/uploads/                     trunk/web/uploads/*

Comments are very much appreciated!