symfony Live 2010 - Using Doctrine Migrations

Using Doctrine Migrations by Dennis Benkert

Dennis Who?! 2

Agenda 3

Agenda Migrating by Hand 3

Agenda Migrating by Hand Doctrine Migrations 3

Agenda Migrating by Hand Doctrine Migrations Migrations and sf CLI 3

Agenda Migrating by Hand Doctrine Migrations Migrations and sf CLI Things to keep in mind 3

So, you want to change your live servers DB schema, right?! 4

But migrating your database by hand is hard work 5

Migrating by Hand 6

Migrating by Hand schema.yml Live DB Dev DB 7

What‘s so bad about it? 8

What‘s so bad about it? Error Prone 8

What‘s so bad about it? Error Prone No Rollback 8

What‘s so bad about it? Error Prone No Rollback Not Comfortable 8

Wouldn‘t it be cool if database changes were a bit like SCM revisions? 9

Doctrine Migrations 10

Migration Process schema.yml Migration File 11

Migration Process Compare schema.yml Migration File 11

Migration Process Compare Generate schema.yml Migration File 11

Migration Process Migrate Compare Generate schema.yml Migration File 11

Migration Files class VersionXX extends Doctrine_Migration_Base { public function up() { $this->addColumn('blog_post', 'tags', 'string', '255', array( )); } public function down() { $this->removeColumn('blog_post', 'tags'); } } 12

Migration Files Used for upgrading class VersionXX extends Doctrine_Migration_Base { public function up() { $this->addColumn('blog_post', 'tags', 'string', '255', array( )); } public function down() { $this->removeColumn('blog_post', 'tags'); } } 12

Migration Files Used for upgrading class VersionXX extends Doctrine_Migration_Base { public function up() { $this->addColumn('blog_post', 'tags', 'string', '255', array( )); } public function down() { $this->removeColumn('blog_post', 'tags'); } } Used for downgrading 12

Migration Files Used for upgrading Table / Data Manipulation class VersionXX extends Doctrine_Migration_Base { public function up() { $this->addColumn('blog_post', 'tags', 'string', '255', array( )); } public function down() { $this->removeColumn('blog_post', 'tags'); } } Used for downgrading 12

How Migrations work migration_version version (int) 13

How Migrations work migration_version version (int) Current version stored in your database 13

How Migrations work 4 3 2 1 14

How Migrations work 4 getVersion 3 2 1 14

How Migrations work 4 getVersion Version =1 3 2 1 14

How Migrations work 4 getVersion Version =1 3 up() 2 1 14

How Migrations work 4 getVersion up() Version =1 3 up() 2 1 14

How Migrations work up() getVersion 4 up() Version =1 3 up() 2 1 14

How Migrations work up() getVersion 4 up() Version =1 3 setVersion(4) up() 2 1 14

Migrations and sf CLI 15

Migrations and sf CLI symfony doctrine:generate-migrations-models symfony doctrine:generate-migrations-db symfony doctrine:generate-migrations-diff symfony doctrine:migrate 16

Migrations and sf CLI symfony doctrine:generate-migrations-models symfony doctrine:generate-migrations-db symfony doctrine:generate-migrations-diff symfony doctrine:migrate Available in other tasks, too 16

Migrations and sf CLI symfony doctrine:generate-migrations-models symfony doctrine:generate-migrations-db symfony doctrine:generate-migrations-diff symfony doctrine:migrate Available in other tasks, too Even works with plugins 16

Migrations and sf CLI symfony doctrine:generate-migrations-models symfony doctrine:generate-migrations-db symfony doctrine:generate-migrations-diff symfony doctrine:migrate Available in other tasks, too Even works with plugins (only in sf, sorry Matthew :P) 16

Migrations and sf CLI symfony doctrine:generate-migrations-models 17

Migrations and sf CLI symfony doctrine:generate-migrations-models Compares Model ﬁles and schema.yml 17

Migrations and sf CLI symfony doctrine:generate-migrations-models Compares Model ﬁles and schema.yml Good when starting without schema 17

Migrations and sf CLI symfony doctrine:generate-migrations-db 18

Migrations and sf CLI symfony doctrine:generate-migrations-db Compares DB tables and schema.yml 18

Migrations and sf CLI symfony doctrine:generate-migrations-db Compares DB tables and schema.yml Good when starting with schema 18

Creating a Migration Diff Before BlogPost: # [...] columns: title: { type: string(255), notnull: true } # [...] 19

Creating a Migration Diff After BlogPost: # [...] columns: title: { type: string(255), notnull: true } # [...] tags: { type: string(255) } 20

Migrations and sf CLI symfony doctrine:generate-migrations-diff 21

Migrations and sf CLI symfony doctrine:generate-migrations-diff Compares changed schema.yml and Model ﬁles 21

Migrations and sf CLI symfony doctrine:generate-migrations-diff Compares changed schema.yml and Model ﬁles Good when already using Migrations 21

Migrating using sf CLI symfony doctrine:migrate symfony doctrine:build-model symfony doctrine:build-filters symfony doctrine:build-forms 22

Migrating using sf CLI symfony doctrine:migrate symfony doctrine:build-model symfony doctrine:build-filters symfony doctrine:build-forms That‘s the obvious way 22

Migrating using sf CLI symfony doctrine:migrate symfony doctrine:build --all-classes 23

Migrating using sf CLI symfony doctrine:migrate symfony doctrine:build --all-classes That‘s the nice way 23

Migrating using sf CLI symfony doctrine:build --all-classes --and-migrate 24

Migrating using sf CLI symfony doctrine:build --all-classes --and-migrate That‘s the cool sf 1.3 way 24

Things to keep in mind 25

Big vs. small Migrations aka. „Complete Migrations“ vs. „Wild West Cowboy Style Migrations“ 26

Big vs. small Migrations 27

Big vs. small Migrations Small Migrations more Agile 27

Big vs. small Migrations Small Migrations more Agile Really need to be Agile?! 27

Big vs. small Migrations Small Migrations more Agile Really need to be Agile?! Small Migrations more dirty 27

Big vs. small Migrations Small Migrations more Agile Really need to be Agile?! Small Migrations more dirty Big Migrations more complicated 27

Keep in mind Run a diff before building the model 28

Keep in mind Run a diff before building the model After migrating you can‘t generate the diff! 28

Keep in mind Keep Data Migrations simple 29

Keep in mind Keep Data Migrations simple Migrate the Data as easy as possible! 29

Keep in mind Version get‘s updated after all Migrations are run 30

Keep in mind Version get‘s updated after all Migrations are run You have to ﬁx problems by hand if they fail. 30

Thank you! 31

Credits Thanks to: - Ryan Weaver for his presentation about Doctrine ...Migrations - Samim for the designs and the artworks. Picture „Von A nach B“ - photocase.com © Anna-Lena Thamm : cydonna Creative Commons stuff used: - „Application, Mime, Vnd.sun.xml.draw“ icon by „New Mooon“ - http://www.iconfinder.net/ icondetails/28957/128/ - „Application, Sqlite2, X“ icon by „New Mooon“ - http://www.iconfinder.net/icondetails/ 28899/128/ - „Application, Php, X “ icon by „New Mooon“ - http://www.iconfinder.net/icondetails/28894/128/ 32

http://www.symfonylab.com	1252
http://www.symfony-project.org	382
http://nithin.me	216
http://gpupo.com	164
http://www.slideshare.net	126
http://swik.net	119
http://symfony.com	113
http://flavors.me	62
http://www.denderello.com	5
http://www.odino.org	4
http://wildan.openthinklabs.com	3
http://www.symfolive.com	3
http://webcache.googleusercontent.com	2
http://translate.googleusercontent.com	2
http://slideclip.b-prep.com	1
http://www.phpframeworks.com	1
http://gpupo.tumblr.com	1
http://pt.minichiello.name	1
http://xss.yandex.net	1
http://www.old.odino.org	1
http://posterous.com	1
http://symfony.lab216.com	1
http://www.sfexception.com	1

symfony Live 2010 - Using Doctrine Migrations

by Dennis Benkert

Accessibility

Categories

Upload Details

Usage Rights

23 Embeds 2,462

Statistics

symfony Live 2010 - Using Doctrine Migrations Presentation Transcript