perguntas frequentes Page History

Perguntas Frequentes

Onde estão os fóruns de Suporte e Desenvolvimento?

Agora a interação entre os membros da comunidade i-Educar se dará por meio de listas de discussão, que se encontram em "Lista de E-mails" no portal SPB e também podem ser acessadas através do link Lista de E-mails. Fique a vontade para tirar suas dúvidas e ajudar a comunidade. Para mais informações, acesse a página sobre Como se inscrever e participar das listas de discussão do i-Educar?

Importante lembrar que o novo portal SPB ainda está em fase de migrações, e logo será possível acessar os tópicos do antigo portal SPB através das Listas de E-mails.

Qual versão do i-Educar eu devo baixar?

Você deve sempre fazer o download da versão oficial indicada na página inicial da comunidade i-Educar (no bloco Download). Esse bloco sempre indicará a última versão considerada estável pela comunidade. Não faça download de outras versões espalhadas na página de arquivos da comunidade pois não podemos dar suporte a diversas bases de código distintas.

Qual versão do banco de dados PostgreSQL é suportado pelo i-Educar?

O i-Educar está homologado para a versão 8.2 do PostgreSQL.

Quero criar o banco de dados mas sempre dá um erro ERROR: encoding LATIN1 does not match server's locale. Por que?

Provavelmente você está utilizando o PostgreSQL 8.3 onde foi introduzido uma restrição que impossibilita a criação de um banco de dados com uma codificação diferente do definido pelo LC_CTYPE do servidor. Conforme as notas do release do PostgreSQL 8.3:

Disallow database encodings that are inconsistent with the server's locale setting (Tom)

On most platforms, C locale is the only locale that will work with any database encoding. Other locale settings imply a specific encoding and will misbehave if the database encoding is something different. (Typical symptoms include bogus textual sort order and wrong results from upper() or lower().) The server now rejects attempts to create databases that have an incompatible encoding.

Caso tenha o PostgreSQL 8.3 instalado é fazer o downgrade para a versão 8.2. Recomenda-se compilar o banco de dados caso esteja utilizando uma distribuição Linux que suporta apenas a versão mais recente. Usuários Windows podem fazer o download do binário e instalar sem maiores dificuldades.

Instalei tudo mas sempre recebo a mensagem Warning: pg_query() [function.pg-query]: Query failed ao tentar fazer o login. Por que?

Você deve ter esquecido de configurar o search_path do banco de dados. Procure por search_path no manual de instalação da sua versão:

Estou recebendo um erro de query date/time field value out of range

Durante a criação do cluster de seu banco de dados PostgreSQL, seu servidor poderia estar configurado para um locale diferente de pt_BR, com isso, o estilo de data (datestyle) do PostgreSQL pode estar diferente do padrão brasileiro (DMY onde D = dia, M = mês e Y = ano). Verifique o estilo de data para o seu banco de dados:

psql -U ieducaruser -d ieducardb

ieducardb=# SHOW datestyle;

DateStyle

ISO, DMY

(1 row)

Caso o datestyle esteja diferente de ISO, DMY, configure-o:

psql -U postgresql

postgres=# ALTER DATABASE ieducardb SET datestyle TO "ISO, DMY";

postgres=# \c ieducardb

ieducardb=# SHOW datestyle;

DateStyle

ISO, DMY

(1 row)

Instalei tudo mas sempre recebo um erro Allowed memory size of 16777216 bytes exhausted. O que é isso?

O limite de uso de seu PHP está abaixo do necessário para o i-Educar. Ajuste a diretiva memory_limit do arquivo php.ini para 32 MB:

memory_limit = 32M

Quando eu faço login, aparece uma tela branca e nada mais. Como resolver?

Essa é a white screen of death. Provavelmente alguma dependência da aplicação não está presente em seu ambiente de servidor. Essa tela branca ocorre pois o i-Educar (a partir da versão 1.1.0) vem com um arquivo .htaccess que padroniza algumas diretivas de configuração do PHP de acordo com as recomendações mínimas necessárias para a aplicação. Algumas dessas diretivas são ajustadas para elevar a segurança da aplicação, como a supressão de erros do PHP (display_errors).

Caso lhe ocorra uma tela branca, você tem duas opções para visualizar o erro:

  • Alterar as diretivas display_errors e error_reporting do arquivo .htaccess ou php.ini
  • Verificar o arquivo de log do PHP

Alterar as diretivas display_errors e error_reporting do arquivo .htaccess

Edite o arquivo .htaccess (está localizado no diretório raiz da aplicação) do i-Educar caso tenha configurado um virtual host no Apache (p.ex.: caso tenha configurado para acessar o i-Educar por um endereço do tipo http://ieducar.local). Altere os valores das diretivas error_reporting e display_errors (nas linhas 80 e 81 respectivamente) para que fique como segue:

php_value error_reporting 6135

php_flag display_errors on

Após salvar o arquivo, tente fazer o login novamente. Agora, uma mensagem de erro deixará claro o que faltou ser instalado ou configurado em seu servidor.

Alterar as diretivas display_errors e error_reporting do arquivo php.ini

Caso não tenha configurado um Virtual Host (p.ex.: o acesso ao i-Educar é através de um endereço http://localhost/ieducar), será necessário alterar as diretivas de configuração do PHP direto no arquivo php.ini. A localização desse arquivo é dependente do sistema operacional e da forma como o PHP foi instalado.

Você pode encontrar o caminho para o arquivo ao acessar através do navegador o arquivo info.php que vem por padrão no i-Educar (através de um endereço semelhante a http://localhost/ieducar/info.php). Procure por "Loaded Configuration File":

PHP-ini-Loaded-Conf-File

Então, abra o arquivo informado por "Loaded Configuration File". Procure as diretivas error_reporting e display_errors e edite seus valores de acordo com o seguinte:

error_reporting = E_ALL & ~E_NOTICE

display_errors = On

Reinicie o Apache e tente fazer o login novamente. Agora, uma mensagem de erro deixará claro o que faltou ser instalado ou configurado em seu servidor.

Verificar o arquivo de log do PHP

Toda vez que um processo PHP encerra com erro, o motivo é salvo em um arquivo de log. Em uma instalação LAMP atual (Apache 2 em Linux), esse arquivo de log está em /var/log/apache2/error.log. Verifique as últimas linhas do arquivo para ver os erros mais recentes.

O banco de dados não pode ser em UTF-8?

Não. Toda a aplicação está em LATIN1 (ISO-8859-1) e isso poderia acarretar em problemas como a quebra de caracteres ou dificuldades de conversão entre os sistemas de codificação, levando a incosistência dos dados textuais.

Posso usar o MySQL como banco de dados?

Você tem liberdade para o fazê-lo mas o i-Educar não implementa suporte ao MySQL e nem tem pretensões de fazer isso na versão 1.X.

Encontrei um bug, o que faço?

Primeiro, é importante que você tenha certeza que seu problema é realmente um bug, ou seja, que você consegue simular o problema com a instalação oficial da Comunidade ou no próprio ambiente de demonstração da Comunidade.

Caso você não tenha certeza, recomendamos que relate sua dificuldade na Lista de discussão, para que outros membros ajudem você a identificar.

Se o bug realmente existir, você deve reportá-lo para os desenvolvedores através da abertura de uma issue, seguindo as recomendações da documentação. Saiba como clicando aqui.

Como faço para ajudar/contribuir com o projeto?

Existem diversas formas e com certeza você o já está fazendo em alguma escala. Se deseja tornar o i-Educar em um rock star, participe conosco nessa grande missão de melhorar os processos de gestão escolar.

Corrigi um bug, devo criar uma nova versão do i-Educar e disponibilizar na pasta de Arquivos?

Não. Isso somente cria mais uma base de código (fork) que provavelmente não terá suporte da comunidade. Isso também diminui os esforços de contribuição no repositório de código oficial do projeto.

Saiba como enviar suas contribuições de correção de bugs, funcionalidades novas dentre outras em Como contruibuir.

Last edited by Tiago Giusti