Instalação - LimeSurvey CE
From LimeSurvey Manual
Certifique-se de que você pode usar o LimeSurvey no seu site
Certifique-se de que seu servidor atenda aos seguintes requisitos.
O conjunto mínimo de requisitos para o LimeSurvey:
- Mínimo de 500 MB de espaço em disco (o pacote descompactado do LimeSurvey 7.x ocupa sozinho cerca de 380 MB), mais espaço para os arquivos carregados e os dados dos seus inquéritos.
- 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é o PHP 8.5.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
memory_limitdo PHP de pelo menos 128 MB.- Os seguintes módulos/bibliotecas do PHP devem estar ativados:
- Biblioteca de extensão mbstring (Multibyte String Functions).
- Controlador de banco de dados PDO para MySQL/MariaDB (pdo_mysql) ou Postgres (pdo_pgsql) ou MSSQL (pdo_sqlsrv para Windows e pdo_dblib para Linux).
- GD - veja a documentação da extensão PHP GD-Library
- Zip - veja a documentação da extensão PHP Zip
- Zlib - veja a documentação da extensão PHP Zlib
- Biblioteca Curl
- fileinfo
- JSON
- Além disso, assumimos, em geral, que todas as bibliotecas padrão do PHP estão ativadas, por exemplo:
- ctype
- filter
- hash
- openssl
- session
- SimpleXML
- etc …
- Para o LimeSurvey 7.x: o formato de URL deve estar definido como path (URLs como index.php/admin). O antigo formato de URL get (URLs como index.php?r=admin) não é mais suportado. O instalador define o formato path automaticamente, portanto você só precisa verificar isso se reutilizar um arquivo config.php mais antigo com
'urlFormat' => 'get'.
Extensões PHP opcionais:
- GD-Library com suporte a FreeType e JPEG é necessária para captchas, gráficos de estatísticas mais bonitos ou para carregar imagens por meio do editor HTML - veja a documentação da extensão PHP GD-Library
- IMAP é necessária para o sistema de rastreamento de e-mails devolvidos - veja a documentação da extensão PHP IMAP. A partir do PHP 8.4, a extensão IMAP não é mais incluída no PHP e precisa ser instalada separadamente a partir do PECL.
- LDAP é necessária para importar participantes do questionário usando LDAP - veja a documentação PHP LDAP
- Intl é usada para ordenar textos corretamente de acordo com as regras do respectivo idioma - veja a documentação PHP Intl
- Sodium é recomendada para a criptografia de dados - veja a documentação PHP Sodium. Se ela estiver ausente, o LimeSurvey recorre a uma implementação em PHP muito mais lenta.
Configurações recomendadas do PHP (o instalador exibe um aviso se seus valores forem menores):
max_input_vars: 5000 ou maispost_max_size: 32M ou maisupload_max_filesize: 32M ou mais
Na maioria dos casos, o provedor do seu servidor web ou o administrador do sistema poderá ajudar você com esses componentes opcionais.
Para a parte de resposta aos inquéritos, atualmente oferecemos suporte ao Edge e a todos os navegadores mais recentes comparáveis, como FF, Chrome, Opera etc., com JavaScript ativado.
Para a parte de administração, atualmente oferecemos suporte ao Edge e a todos os navegadores mais recentes comparáveis, como FF, Chrome, Opera etc., com JavaScript ativado.
Tamanhos de tela
Oferecemos suporte a qualquer tamanho de tela razoável para responder a inquéritos (360px x 640px ou maior). A resolução de tela mínima suportada para a página de administração do LimeSurvey é 1280px x 1024px.
Hospedagem para o LimeSurvey
O LimeSurvey deve funcionar com a maioria das empresas de hospedagem que oferecem PHP e MySQL/MariaDB. Se você quiser uma versão do LimeSurvey já instalada e mantida por nós, experimente o LimeSurvey Cloud. Consulte LimeSurvey Cloud vs LimeSurvey CE para conhecer as diferenças.
Baixar o pacote do LimeSurvey
Baixe o pacote zip estável mais recente do LimeSurvey (também há pacotes gzip, bz2 e 7zip disponíveis para sua conveniência) e salve-o no seu disco local.
Descompactar o pacote do LimeSurvey
Descompacte o arquivo zip em um diretório/pasta dedicado, usando o software de compactação de sua preferência. Ao descompactar o arquivo, certifique-se de preservar a estrutura de diretórios com os arquivos (este é o comportamento padrão da maioria dos programas de compactação). O caminho do diretório de instalação não deve incluir os caracteres especiais '(' ou ')', mas pode incluir o caractere de espaço.
Reunir informações sobre o seu servidor
Você precisará saber o seguinte para instalar o LimeSurvey corretamente no seu servidor web:
- A URL do site onde seus scripts ficarão (por exemplo, https://my.domain.com/limesurvey).
- Qual software de servidor web você está usando?
- para Apache: Configuração de exemplo do Apache para o LimeSurvey
- para nginx: consulte a nossa configuração de exemplo do nginx para o LimeSurvey (desatualizada, sem suporte a editor)
- O local físico no disco do seu servidor onde seus scripts ficarão (por exemplo, /home/usr/htdocs/limesurvey).
- O local de IP/rede do seu servidor de banco de dados (ou seja, localhost).
- Se o seu servidor de banco de dados usa uma porta fora do padrão, descubra qual é.
- Seu usuário e senha do servidor de banco de dados.
- Com a maioria dos provedores, você não pode deixar o script criar o banco de dados, tendo de criá-lo você mesmo. Se você usa um provedor assim, crie um banco de dados (por exemplo, limesurvey) por conta própria. Para MySQL/MariaDB, use o conjunto de caracteres utf8mb4 com a collation utf8mb4_unicode_ci.
Carregar os arquivos para o seu servidor web
Usando seu programa de FTP/SFTP (por exemplo, FileZilla), conecte-se ao seu servidor web e crie um diretório para armazenar seus scripts. Em seguida, carregue os arquivos mantendo a estrutura de diretórios em que estão. Certifique-se de carregar os arquivos em modo binário (verifique as configurações do seu programa de FTP). Observe que o carregamento em modo ASCII pode causar erros incomuns (por exemplo, o erro 'class not found' durante a instalação), e as imagens também podem não ser carregadas corretamente. Certifique-se também de que os arquivos ocultos .htaccess sejam carregados - eles protegem alguns diretórios e permitem URLs sem index.php no Apache.
Definir as permissões dos diretórios
Para que o script funcione corretamente, ele precisa de certo acesso a alguns diretórios - isso se aplica especialmente a sistemas Linux/*nix.
- O diretório "/limesurvey/tmp" (e todos os seus subdiretórios e arquivos) é usado para importações e carregamentos e deve ser definido como Leitura e escrita para o seu servidor web.
- O diretório "/limesurvey/upload/" (e todos os seus subdiretórios e arquivos) também deve ter Leitura e escrita para o seu servidor web, a fim de permitir o carregamento de imagens e arquivos de mídia.
- O diretório "/limesurvey/application/config/" também precisa de permissões de Leitura e escrita para o seu servidor web.
- Os demais diretórios podem ser definidos como Somente leitura.
Criar um usuário do banco de dados
O LimeSurvey criará um banco de dados e as tabelas dentro dele. Para isso, ele precisará do usuário e da senha de um usuário do banco de dados. Em geral, recomendamos criar um usuário do banco de dados com as seguintes permissões:
- MySQL/MariaDB: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX
- PostgreSQL: a maneira mais fácil é tornar o usuário do banco de dados o proprietário do banco de dados do LimeSurvey. Caso contrário, o usuário precisa do privilégio CREATE no esquema, além de SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER nas tabelas e USAGE nas sequências.
- Microsoft SQL Server: o usuário do banco de dados deve ser membro da função db_owner do banco de dados do LimeSurvey. Se você quiser que o instalador crie o banco de dados, o usuário também precisa da função de servidor dbcreator.
Executar o script de instalação
Abra a URL da sua instalação do LimeSurvey no navegador (por exemplo, https://example.org/limesurvey). Se você configurou tudo corretamente, o Instalador do LimeSurvey será iniciado automaticamente - basta seguir as instruções:
- Selecione o idioma do instalador e aceite a licença.
- Confira a Verificação de pré-instalação. Todos os itens obrigatórios devem estar marcados como OK antes de você continuar.
- Informe a Configuração de banco de dados. O LimeSurvey perguntará se você deseja criar o banco de dados e/ou criar as tabelas dentro do banco de dados e, em seguida, criará as tabelas necessárias.
- Configure a conta de administrador: informe o usuário, a senha e o e-mail do administrador, bem como o nome do seu site de questionários e o idioma padrão.
Conectar-se ao script de administração pela primeira vez
Quando a instalação terminar, tudo estará pronto! Abra o seu navegador e digite a URL da administração do LimeSurvey. Supondo que você tenha usado 'limesurvey' como nome do diretório para armazenar os arquivos, será algo como https://www.example.com/limesurvey/admin.
Você deverá ver uma tela de login. Entre com o usuário e a senha de administrador que você informou durante a instalação. Se você não os alterou no instalador, as credenciais padrão são:
User: admin
Password: password
Se você ainda estiver usando a senha padrão, altere-a imediatamente nas configurações da sua conta. Divirta-se!
Configuração adicional
Para outras configurações, como a configuração de e-mail (SMTP) ou configurações de segurança, consulte Configurações opcionais e Definições globais.
Cache
Por padrão, o LimeSurvey usa o cache de arquivos do Yii, mas ele pode ser configurado para usar outros mecanismos de cache. Outros caches possíveis são:
- Memcached (CMemCache)
- Redis (CRedisCache)
- APCu (CApcCache)
- Banco de dados (CDbCache)
Consulte a documentação do Yii para uma descrição completa.
Desde o LimeSurvey 4.0.0, você também pode armazenar em cache os cálculos no ExpressionScript. Isso pode proporcionar um ganho significativo de velocidade, dependendo da complexidade do inquérito. Para ativar o emcache, adicione o seguinte no seu arquivo config.php (array components):
'emcache' => array('class' => 'CFileCache'),
Assim como no cache principal do Yii, outros sistemas de cache podem ser usados.
Se eu tiver problemas...
Como todos os programas de computador, na maior parte do tempo as coisas funcionarão como dizem as instruções, mas às vezes simplesmente não funcionarão. Existem muitos motivos possíveis para que as coisas não saiam conforme o planejado para descrevê-los aqui. Se você tiver problemas, primeiro consulte o FAQ de instalação. Se você não encontrar a resposta lá, publique seu problema e eventuais mensagens de erro nos Fóruns do LimeSurvey, abra um ticket de suporte (somente para clientes que usam o LimeSurvey Cloud) ou participe do nosso canal do Discord.