vtiger CRM 5.0.

4
Configuração Banco de Dados UTF-8
(Para MySQL)

© Copyright 2003-2008 vtiger.com.Todos os direitos reservados.

vtiger é uma marca registrada de vtiger.com. Todas as outras marcas são de propriedade de seus
respectivos donos.
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

© Copyright 2003-2008 vtiger.com.Todos os direitos reservados.

vtiger é uma marca registrada de vtiger.com. Todas as outras marcas são de propriedade de seus
respectivos donos.
1. Introdução
O vtiger 5.0.4 permite-lhe agora trabalhar com o UTF-8. Temos dispensado o maior esforço para fornecer-
lhes 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.

© Copyright 2003-2008 vtiger.com.Todos os direitos reservados.

vtiger é uma marca registrada de vtiger.com. Todas as outras marcas são de propriedade de seus
respectivos donos.
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.

© Copyright 2003-2008 vtiger.com.Todos os direitos reservados.

vtiger é uma marca registrada de vtiger.com. Todas as outras marcas são de propriedade de seus
respectivos donos.
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.

© Copyright 2003-2008 vtiger.com.Todos os direitos reservados.

vtiger é uma marca registrada de vtiger.com. Todas as outras marcas são de propriedade de seus
respectivos donos.
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.

© Copyright 2003-2008 vtiger.com.Todos os direitos reservados.

vtiger é uma marca registrada de vtiger.com. Todas as outras marcas são de propriedade de seus
respectivos donos.
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

© Copyright 2003-2008 vtiger.com.Todos os direitos reservados.

vtiger é uma marca registrada de vtiger.com. Todas as outras marcas são de propriedade de seus
respectivos donos.