Instalação - LimeSurvey CE

Nota: Estas instruções de instalação destinam-se à versão 2.0 ou posterior. As instruções antigas para a versão 1.92 podem ser encontradas aqui e as instruções de atualização podem ser encontradas aqui.

Certifique-se de que pode utilizar o LimeSurvey no seu website

Certifique-se de que o seu servidor cumpre os seguintes requisitos adicionais.

O conjunto mínimo de requisitos também será verificado durante o processo de instalação!

O conjunto mínimo de requisitos para o LimeSurvey:

• Mínimo de 250 MB de espaço em disco.
• MariaDB 10.3.38 ou posterior OU MySQL 8 ou posterior OU Microsoft SQL Server 2019 ou posterior OU Postgres 14 ou posterior.
• Requisitos de versão do PHP:
  • LS 7.x a partir do PHP 8.1.29 (testado até ao PHP 8.4.x)
  • LS 6.x do PHP 8.1.x ao 8.3.x
  • LS 5.x do PHP 7.2.5 ao 8.0.x
  • LS 3.x do PHP 5.5.9 ao 7.4.x
• A definição `short_open_tag` do php.ini deve estar definida como `ON`
• Os seguintes módulos/bibliotecas do PHP devem estar ativados:
  • Biblioteca de extensão mbstring (Multibyte String Functions).
  • Controlador de base de dados PDO para MySQL (pdo_mysql ou pdo_mysqli) ou Postgres (pdo_pgsql) ou MSSQL (pdo_sqlsrv para Windows e pdo_dblib para Linux).
  • Biblioteca cURL
  • Além disso, assumimos em geral que todas as bibliotecas padrão do PHP estão ativadas
    • hash
    • session
    • openssl ou mcrypt
    • fileinfo
    • SimpleXML
    • etc …

Nota: Se estiver a ligar-se a partir de Linux a uma base de dados MSSQL num servidor Windows através do controlador PDO dblib, o FreeTDS subjacente tem de estar configurado corretamente. Consulte a página Resolução de problemas para obter mais informações.

Extensões PHP opcionais:

• GD-Library com suporte FreeType instalada é necessária para captchas, gráficos apelativos nas estatísticas ou para carregar imagens através do Editor HTML - consulte a documentação da extensão PHP GD-Library
• IMAP (bastante comum) é necessária para o sistema de rastreio de emails devolvidos - consulte a documentação da extensão PHP IMAP
• LDAP instalada é necessária para importar participantes no inquérito através de LDAP - consulte a documentação PHP LDAP
• Zip (bastante comum) é necessária para o carregamento de temas, a importação de recursos arquivados em .zip e a exportação para Excel - consulte a documentação da extensão PHP Zip
• Zlib (bastante comum) é necessária para o ComfortUpdate - consulte a documentação da extensão PHP Zlib

Na maioria dos casos, o fornecedor do seu servidor web ou o administrador do sistema poderá ajudá-lo com estes componentes opcionais.

Compatibilidade com navegadores

Para quem responde aos inquéritos, suportamos atualmente o Edge e todos os navegadores mais recentes comparáveis, como FF, Chrome, Opera, etc., com o JavaScript ativado.

Para a parte de administração, suportamos atualmente o Edge e todos os navegadores mais recentes comparáveis, como FF, Chrome, Opera, etc., com o JavaScript ativado.

Tamanhos de ecrã

Suportamos qualquer tamanho de ecrã razoável para responder a inquéritos (360px x 640px ou superior). A resolução de ecrã mínima suportada para a página de administração do LimeSurvey é 1280px x 1024px.

Alojamento para o LimeSurvey

O LimeSurvey deverá funcionar com a maioria das empresas de alojamento que disponibilizam PHP e MySQL. Se pretender uma versão do LimeSurvey já instalada, pode experimentar o LimeSurvey Cloud ou consultar outros fornecedores de alojamento.

Transferir o pacote do LimeSurvey

Transfira o pacote zip estável mais recente do LimeSurvey (existem também pacotes gzip, bz2 e 7zip disponíveis para sua conveniência) e guarde-o no seu disco local.

Descompactar o pacote do LimeSurvey

Descompacte o ficheiro zip para uma pasta dedicada, utilizando o seu programa de compressão preferido. Ao descompactar o ficheiro, certifique-se de que descompacta a estrutura de pastas com os ficheiros (este é o comportamento padrão da maioria dos programas de compressão). O nome do caminho da pasta de instalação não deve incluir os caracteres especiais '(' ou ')', mas pode incluir o caractere de espaço.

Recolher informações sobre o seu servidor

Para instalar corretamente o LimeSurvey no seu servidor web, terá de saber o seguinte:

• O URL do website onde os seus scripts irão residir (p. ex. http://my.domain.com/limesurvey).
• Que software de servidor web está a utilizar?
  • para Apache: Exemplo de configuração do LimeSurvey para Apache
  • para nginx: consulte o nosso exemplo de configuração do LimeSurvey para nginx (desatualizado, sem suporte para o editor)
• A localização física no disco do servidor onde os seus scripts irão residir (p. ex. /home/usr/htdocs/limesurvey).
• O IP/localização na rede do seu servidor de base de dados (ou seja, localhost).
• Se o seu servidor de base de dados utilizar uma porta não padrão, descubra qual é.
• O seu nome de utilizador e a sua senha para o servidor de base de dados.
• Com a maioria dos fornecedores não é possível deixar o script criar a base de dados, tendo de a criar você mesmo. Se estiver a utilizar um fornecedor desse tipo, crie você mesmo uma base de dados (por exemplo, limesurvey).

Carregar os ficheiros para o seu servidor web

Utilizando o seu programa de FTP (p. ex. FileZilla), ligue-se ao seu servidor web e crie uma pasta para guardar os seus scripts. Em seguida, carregue os ficheiros mantendo a estrutura de pastas em que se encontram. Certifique-se de que carrega os ficheiros em modo binário (verifique as definições do seu programa de FTP). Tenha em atenção que o carregamento em modo ASCII pode provocar erros invulgares (p. ex. o erro 'class not found' durante a instalação) e as imagens podem não ser carregadas corretamente.

Definir as permissões das pastas

Para que o script funcione corretamente, necessita de determinado acesso a algumas pastas - isto aplica-se especialmente a sistemas Linux/*nix.

• A pasta "/limesurvey/tmp" (e todas as suas subpastas e ficheiros) é utilizada para importações e carregamentos e deve ter permissões de Leitura e escrita para o seu servidor web.
• A pasta "/limesurvey/upload/" (e todas as suas subpastas e ficheiros) também deve ter permissões de Leitura e escrita para o seu servidor web, de modo a permitir o carregamento de imagens e ficheiros multimédia.
• A pasta "/limesurvey/application/config/" também necessita de permissões de Leitura e escrita para o seu servidor web.
• As restantes pastas podem ser definidas como Só de leitura. Em Linux/Unix, pode querer definir as permissões de cada ficheiro dentro da pasta /limesurvey/admin como Só de leitura.

  Se estiver a utilizar Linux, a definição das permissões depende da configuração do seu servidor web. Por exemplo, se utilizar o Apache HTTPD no CentOS, escreva chmod -R 755 <directory> ; chown -R apache <directory>. Isto dará a todos acesso de leitura e o seu servidor web terá permissão para escrever. Consulte a hiperligação seguinte para obter mais informações sobre permissões em Linux.

Criar um utilizador da base de dados

O LimeSurvey irá criar uma base de dados e as tabelas no seu interior. Para o conseguir fazer, necessitará do nome de utilizador e da senha de um utilizador da base de dados. Recomendamos, em geral, a criação de um utilizador da base de dados com as seguintes permissões:

- MySQL: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX

- PostgreSQL: SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER

- Microsoft SQL Server: Desconhecido - se conseguir obter esta informação, por favor complete-a.

Executar o script de instalação

Aceda a "example.org/limesurvey/admin". Se configurou tudo corretamente, o Instalador do LimeSurvey deverá iniciar - basta seguir as instruções. Será questionado se pretende criar a base de dados e/ou criar as tabelas dentro da base de dados. De seguida, o LimeSurvey criará as tabelas necessárias na base de dados.

Ligar-se ao script de administração pela primeira vez

A instalação está concluída quando terminar! Abra o navegador e introduza o URL da administração do LimeSurvey. Partindo do princípio de que utilizou 'limesurvey' como nome da pasta onde guardou os ficheiros, será algo como "http://www.example.com/limesurvey/admin".

Deverá aparecer um ecrã para iniciar sessão. As credenciais predefinidas (se não tiverem sido alteradas durante a instalação) são:

User: admin
Password: password

Ser-lhe-á pedido que altere a senha predefinida depois de iniciar sessão. Divirta-se!

Configuração adicional

Cache

Por predefinição, o LimeSurvey utiliza a cache de ficheiros do Yii, mas pode ser configurado para utilizar outros motores de cache. Outras caches possíveis são:

• Memcached
• Redis
• WinCache
• XCache

Consulte a documentação do Yii para obter uma descrição completa.

Desde o LimeSurvey 4.0.0 existe também a possibilidade de colocar em cache os cálculos no ExpressionScript. Isto pode proporcionar um aumento significativo da velocidade, consoante a complexidade do inquérito. Para ativar a emcache, adicione isto ao seu ficheiro config.php (tabela components):

'emcache' => array('class' => 'CFileCache'),

Tal como acontece com a cache principal do Yii, podem ser utilizados outros sistemas de cache.

A emcache não é compatível com inquéritos aleatorizados e será desativada automaticamente nesses casos.

E se tiver problemas...

Como todos os programas informáticos, na maioria das vezes tudo funcionará como indicado nas instruções, mas por vezes não. Existem demasiados motivos possíveis para as coisas não correrem como previsto para os descrever aqui. Se tiver problemas, consulte primeiro as Perguntas frequentes sobre a instalação. Se não encontrar a resposta aí, publique o seu problema e quaisquer mensagens de erro nos Fóruns do LimeSurvey, abra um pedido de suporte (apenas para clientes que utilizam o LimeSurvey Cloud) ou junte-se ao nosso canal do Discord.