vtiger CRM 5.0.4 Configuração Banco de Dados UTF-8 (Para MySQL)
Sumário 1. Introdução... 3 2. Suporte UTF-8 para MySQL... 3 2.1. Nível Servidor... 3 2.2. Nível Base de Dados... 3 2.3. Nível de Tabela... 4 2.4. Nível Coluna... 4 3. Instalação do vtiger... 5 4. Confirmação de Configurações do vtiger... 6 5. Referências... 7
1. Introdução O vtiger 5.0.4 permite-lhe agora trabalhar com o UTF-8. Temos dispensado o maior esforço para fornecerlhes este suporte em todo o produto. Para funcionar adequadamente o banco de dados utilizado pelo vtiger precisará estar configurado para utilizar caracteres codificados em UTF-8. Este documento tem o objetivo de descrever alguns detalhes que recolhemos durante o desenvolvimento. 2. Suporte UTF-8 para MySQL O banco de dados MySQL disponibiliza muitas formas de habilitar o UTF-8. 2.1. Nível Servidor O suporte a UTF-8 pode ser configurado para todo o servidor de banco de dados MySQL. Contudo, isto pode representar um alto custo, caso a base de dados de outra aplicação não necessite de suporte a UTF- 8. Para executar este procedimento você precisa configurar o arquivo de configuração do servidor MySQL (my.ini or my.cnf) da seguinte forma: [mysql] default-character-set=utf8 [mysqld] collation_server=utf8_unicode_ci character_set_server=utf8 default-character-set=utf8 init_connect='set collation_connection = utf8_general_ci' init_connect='set NAMES utf8' NOTA: Você deve reiniciar o servidor MySQL após a realização das mudanças. Para conferir se as mudanças foram aplicadas, abra o a linha de comando do MySQL e digite SHOW VARIABLES; e verifique os valores exibidos. 2.2. Nível Base de Dados Você pode disponibilizar o suporte a UTF-8 para uma determinada base de dados MySQL. Este procedimento tem a função de atribuir o valor padrão quando a tabela é criada sem especificar a configuração do caractere. CREATE DATABASE <nomebd> DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci Se você já possui um banco de dados com outra configuração de caractere e tipo de collate: ALTER DATABASE <nomebd> DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci NOTA: Todas as tabelas criadas depois deste procedimento terão suporte a utf8.
2.3. Nível de Tabela Você pode habilitar o suporte a UTF-8 para cada tabela individual. 2.4. Nível Coluna Você pode habilitar o suporte a UTF-8 para um tipo de texto específico de uma coluna, este procedimento cancelará todas as outras configurações.
3. Instalação do vtiger Se você está criando uma base de dados durante o processo de instalação, certifique-se que a caixa de seleção Enable UTF-8 está ativada. Se você estiver criando uma base de dados antes da instalação, crie esta base de dados com o nível de suporte à UTF-8 conforme discutido na seção anterior.
4. Confirmação de Configurações do vtiger O suporte do banco de dados à UTF-8 é verificado durante a etapa confirmação de configurações da instalação. Esta verificação é baseada no caractere configurado na base de dados e nos valores de collation. Se for detectado que a base de dados tem suporte a UTF-8 então, é exibido Enabled como mostrado abaixo: Se você estiver utilizando uma base de dados sem suporte a UTF-8 isto será destacado. Você poderá continuar com a instalação, mas o suporte a UTF-8 não estará totalmente disponível.
5. Referências http://dev.mysql.com/doc/refman/5.0/en/charset-connection.html Nota do tradutor: Traduzido para o Português por: Valmir Carlos Trindade 04.02.2008 TTCA Consultoria Empresarial 80060-100 - Curitiba Paraná - Brasil http://www.ttcasolucoes.com.br valmir@ttcasolucoes.com.br