History: Encode fix verification
Source of version: 4 (current)
Copy to clipboard
!Encoding Fix Verification Because changes to your Tiki database encoding can be confusing and difficult to troubleshoot problems it's best to do a few quick verification, after you have applied the three steps of the upgrade process to "fix the encoding issue" (if needed, see [https://doc.tiki.org/Upgrade#Fix_the_encoding_issue]) . !!# Verify local.php This file stores the Tiki database connection information #Open <Tiki Install Location>/db/local.php with your favorite text editor (vi, emacs, etc...) #Verify client_charset is set to utf8 #update manually if incorrect !!# Verify Database The database and its tables should have been updated to use the utf8 character set. Verifying the database involves querying the "information_schema" which is essentially the data dictionary for MySQL. So log in to MySQL using the Tiki schema (database) owner account to execute these queries. !!!# Schema verification This simple select lists characteristics for the database itself. {CODE(caption="Schema Verification SQL",wrap="0")}select * from information_schema.schemata;{CODE} #Run the SQL #Verify the "DEFAULT_CHARACTER_SET_NAME" for the Tiki schema is set to "utf8" and that "DEFAULT_COLLATION_NAME" is set to "utf8_general_ci" #If these values are not as specified, run the below SQL: {CODE(caption="Schema Correction SQL",wrap="0")} ALTER DATABASE {Tiki db_name} DEFAULT CHARACTER SET 'utf8' DEFAULT COLLATE 'utf8_general_ci'; {CODE} !!!# Table verification This simple select lists key characteristics for each table of the Tiki DB. {CODE(caption="Table Verification SQL",wrap="0")}select table_name, table_collation from information_schema.tables where table_schema = '{Tiki db_name}';{CODE} #Run the SQL #Verify "table_collation" is set to "utf_general_ci" #Run the below SQL for each table not set correctly {CODE(caption="Table Correction SQL",wrap="0")} ALTER TABLE {Tiki db_name}.{Table Name} CONVERT TO CHARACTER SET 'utf8' COLLATE 'utf8_general_ci' DEFAULT CHARACTER SET 'utf8' COLLATE 'utf8_general_ci'; {CODE} !!!# Content verification You need to be sure that the content in your database has been converted to utf-8. If you had non as-cii characters in your wiki pages, it's very easy to verify if you had your db tables content converted to utf-8 or not. If you see weird characters instead of non-ascii characters like accents, tilde, apostrophes, etc, then your content is not in utf-8. In this case, you can apply the fix from the installer in the last step. Check [https://doc.tiki.org/Upgrade#Fix_the_encoding_issue] . If you were using plain English in your wiki pages, then ask for help in the ((tw:Irc)) channel, for instance.