How to Convert a Database to UTF-8

The following mini script is used to convert existing database tables to UTF-8. Upload the script to your account as “convert.php” and modify the database connection parameters and the character set, then execute the script.

To execute the script, you simply would visit the script in any web browser. If you upload the file to your public_html folder you’d visit “https://example.com/convert.php“.

Don’t forget to replace example.com with your actual domain name. Also, to get your languages to work on your site the collation will need to be utf8.

Code to convert your database to UTF-8

<?php   

// Fill in your Server, User, Database, Password, and Collation configuration below

    $db_server = 'localhost';    
    $db_user = 'database user';  
  
    $db_password = 'password';   
 
    $db_name = 'database name';  
  
    $char_set = 'new character set';   
 
 // Adds the header information header('Content-type: text/plain');   
 // Connects to the MySQL database                               

    $connection = mysql_connect($db_server, $db_user, $db_password) or die(mysql_error() );       
    $db = mysql_select_db($db_name) or die( mysql_error() );  
 
 // Runs the SQL query on teh database      

    $sql = 'SHOW TABLES'; $result = mysql_query($sql) or die( mysql_error() );

 // Runs a loop that finds all collations within the database and changes it to the new collation   

       while ( $row = mysql_fetch_row($result) )   
        {  
            $table = mysql_real_escape_string($row[0]);    
            $sql = "ALTER TABLE 
            $table CONVERT TO CHARACTER SET 
            $char_set COLLATE utf8_general_ci";
                mysql_query($sql) or die( mysql_error() );  
                print "$table changed successfully.n";      
         }    

 // Update the Collation of the database itself  

    $sql = "ALTER DATABASE CHARACTER SET $char_set;";  
            mysql_query($sql) or die( mysql_error());     
            print "Database collation has been updated successfully.n";       
 // close the connection to the database   mysql_close($connection);          
 
 ?>  

Note! You can use this script to change the database to any character set you wish. You need to define the character set in the script to change character sets:

$char_set = ‘character set’;

You will need the change the utf8_general_ci to match the character set you defined in the step above. So, if you want to change the character set to “Hebrew” you’d change the line to:

$sql = “ALTER TABLE $table CONVERT TO CHARACTER SET $char_set COLLATE hebrew_general_ci”;

For more information on MySQL character sets and collation please see the following link:

Character Sets and Collations in MySQL

If you need further assistance please feel free to contact our support department.

6 thoughts on “How to Convert a Database to UTF-8

  1. Hi All,

    Good day.

    I just want to ask if there is a way or syntax to convert this kind of unicode

    测试

    to chinese characters in SQL.

    Thank you in advance.

    Regards, 

    Aman

    1. Hello Aman,

      Thanks for the question on converting the Unicode to Chinese. You can check out this link for an example. If you use a search engine you will also find several websites that just convert it for you. I hope that helps to answer your question! If you require further assistance please let us know!

      Regards,
      Arnel C.

  2. If $char_set != “utf8”, should it read like this? 

    $sql = “ALTER TABLE $table CONVERT TO CHARACTER SET $char_set COLLATE {$char_set}_general_ci”; 

    1. Hello MgFrobozz,

      Check out this post on the issue, as it may provide what you’re searching for.

      If you have any further questions or comments, please let us know.

      Regards,
      Arnel C.

  3. ThankyouThankyouThankyou!!!

    I tried to update my Moodle yesterday but failed because the database was not UTF-8. A Google search found this little routine and it has worked flawlessly. Both database and Moodle have been successfully upgraded. Kudos to Brad Markle!

    One small point – Moodle recommends utf8_unicode_ci collation rather than utf8_general_ci, so that’s what I used.

Was this article helpful? Join the conversation!