Merge pull request #1563 from Inori/database-note

added a note about database default charsets/collations

Author: weaverryan

book/doctrine.rst

@@ -79,6 +79,32 @@ information. By convention, this information is usually configured in an
     of your project, like inside your Apache configuration, for example. For
     more information, see :doc:`/cookbook/configuration/external_parameters`.
 
+.. sidebar:: Setting Up The Database
+    
+    One mistake even seasoned developers make when starting a Symfony2 project
+    is forgetting to setup default charset and collation on their database,
+    ending up with latin type collations, which are default for most databases.
+    They might even remember to do it the very first time, but forget that
+    it's all gone after running a relatively common command during development:
+    
+    .. code-block:: bash
+        
+        $ app/console doctrine:database:drop --force
+        $ app/console doctrine:database:create
+    
+    There's no way to configure these defaults inside doctrine, as it tries to be
+    as agnostic as possible in terms of enviroment configuration. One way to solve
+    this problem is to configure server level defaults.
+    
+    Setting UTF8 defaults for MySQL is as simple as adding a few lines to configuration file 
+    (typically ``my.cnf``):
+    
+    .. code-block:: ini
+    
+        [mysqld]
+        collation-server = utf8_general_ci
+        character-set-server = utf8    
+    
 Now that Doctrine knows about your database, you can have it create the database
 for you: