Base de conhecimento

Este guia aborda a instalação de extensões PHP em Hospedagem Web Infomaniak.

Utilização de extensões PHP Zend

Atenção:

• Zend Guard Loader é uma extensão PHP que permite executar scripts PHP criptografados via Zend Guard.
  • O Zend Guard Loader está instalado por padrão para PHP <= 5.6 em todos os serviços de hospedagem web e não está disponível para versões de PHP >= 5.6.
• A partir do PHP 5.3.x, o módulo Zend Optimizer foi substituído pelo ZendGuardLoader.
• A extensão ZendOPCache requer um Servidor Cloud configurado com o PHP 5.5 ou superior.

Este guia explica como ativar as seguintes funções em Hospedagem Web (em itálico, apenas em Servidor Cloud):

• proc_open
• popen
• exec()
• shell_exec()
• set_time_limit
• passthru
• system

Ativar funções PHP

Para aceder à gestão do site Web:

1. Clique aqui para aceder à gestão do seu site no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao site em questão:
   
3. Clique em Gerenciar as configurações avançadas:
   
4. Clique na aba PHP / Apache:
   
5. Clique nos botões de alternância (toggle switch) Ativar/Desativar conforme desejado:
   
6. Clique no botão Guardar na parte inferior da página para confirmar as alterações.

Este guia explica como restaurar cópias de segurança de versões anteriores dos seus ficheiros e outros dados Web dos seus serviços de alojamento Infomaniak, e como implementar uma política de cópias de segurança eficaz, caso as cópias de segurança disponibilizadas automaticamente e gratuitamente não correspondam ou já não correspondam às suas necessidades em termos de disponibilidade ou segurança.

Serviços de Alojamento Web (Starter, Partilhado, Servidor Cloud)

Consulte estes guias para restaurar as cópias de segurança automáticas:

• de um serviço de alojamento completo (FTP + MySQL),
• de arquivos específicos no serviço de hospedagem,
• de bases de dados específicas,
• de uma Aplicação Web (Wordpress e Apps),
• dos cron SSH do Servidor Cloud.

Consulte estes guias para fazer cópias de segurança e restaurar:

• um serviço de alojamento com Swiss Backup e Restic (avançado),
• WordPress com backup suíço,
• WordPress com uma extensão.

Consulte também https://faq.infomaniak.com/snapshot.

Correio eletrónico / kSuite

• Restaure mensagens a partir das cópias de segurança automáticas da Infomaniak.
• Restaure contactos ou eventos do calendário.
• Faça uma cópia de segurança do conteúdo atual de uma conta de e-mail:
  • baixando o conteúdo atual localmente,
  • duplicando todo o conteúdo atual para uma caixa de correio de reserva,
  • copiando os e-mails futurosà medida que chegam para uma caixa de correio de reserva.

Domínios / Zonas DNS

• Restaure registros DNS excluídos a partir dos backups automáticos da Infomaniak.
• Restaure um domínio expirado durante o período de resgate.

Este guia permite resolver eventuais problemas na ativação da sua licença Windows Server.

Introdução

• Informe-se sobre eventuais problemas em curso em https://infomaniakstatus.com/.
• Especificamente para Public Cloud, a lista de manutenções programadas e problemas em curso pode ser encontrada em https://status.infomaniak.cloud/.

Modificar a chave registada

Abra o utilitário Executar (tecla logotipo do Windows + R).

Remover a chave registada

Execute o seguinte comando:

cscript.exe c:\windows\system32\slmgr.vbs -upk

Adicionar uma nova chave

Reinicie o utilitário Executar e execute o seguinte comando:

cscript.exe c:\windows\system32\slmgr.vbs -ipk {CHAVE/KEY}

substituindo {CLE/KEY} pela chave da sua configuração abaixo:

Ativar o Windows

Reinicie o utilitário Executar e, em seguida, execute o seguinte comando para associar a chave ao robô de ativação Infomaniak:

cscript.exe c:\windows\system32\slmgr.vbs -skms kms.infomaniak.cloud

Reinicie o utilitário Executar e, em seguida, execute o seguinte comando para ativar o seu sistema Windows:

cscript.exe c:\windows\system32\slmgr.vbs -ato

Este guia trata do IonCube Loader, um módulo PHP que permite decodificar os scripts PHP que foram codificados com o IonCube Encoder.

Introdução

• A codificação IonCube é utilizada para proteger o código-fonte de uma aplicação e impedir a modificação ou distribuição ilegal do mesmo.
• Ao utilizar o IonCube Loader, os proprietários de sites podem garantir a segurança do seu código e conteúdo, permitindo, ao mesmo tempo, uma distribuição segura e fácil das suas aplicações.

Utilizar o ionCube Loader

Com um alojamento partilhado, esta funcionalidade já não está disponível. Pode verificar isso no painel de controlo:

1. Clique aqui para acessar o gerenciamento do seu site no painel de controle Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao site em questão:
   
3. Clique em Gerenciar as configurações avançadas:
   
4. Clique na aba Extensões PHP.
5. Clique em ionCube Loader (se estiver presente na lista) para ver os detalhes:
   
   • Neste caso, será necessário considerar um Servidor Cloud.

Em termos de software livre para manipular arquivos multimídia, FFmpeg é uma ferramenta poderosa e flexível. Pode ser usado para converter, editar e transmitir vídeos e áudios.

No entanto, o uso de FFmpeg em hospedagens compartilhadas apresenta alguns problemas e limitações, tanto para os usuários quanto para os provedores de hospedagem.

Recomendamos que opte pela oferta de Servidor Cloud para utilizar o FFmpeg.

Também pode optar pelo serviço de VOD/AOD da Infomaniak.

Este guia explica como realizar transferências de arquivos entre Hospedagem Web e/ou Servidor Cloud de forma segura e simplificada.

Introdução

• O FXP (File eXchange Protocol) é um método de transferência de arquivos diretamente entre dois servidores FTP, sem que os dados passem pelo cliente local.
• Utilizando os comandos FTP PORT e PASV, ele permite estabelecer uma conexão entre os dois servidores para uma transferência de arquivos mais rápida e eficiente, economizando assim a largura de banda.
• Este método pode, no entanto, apresentar riscos de segurança se as conexões não forem protegidas por FTPS, e requer uma configuração mais complexa em comparação com as transferências FTP tradicionais.

Transferir dados entre servidores

Por exemplo, pode usar o CrossFTP, um software multiplataforma que permite realizar transferências FXP (mas também FTP, SFTP, S3, OpenStack Swift…).

Este guia trata das funções ODBC do PHP.

Funções de Conectividade Aberta de Banco de Dados

Estas são as funções usadas para interagir com bancos de dados através da interface ODBC (Conectividade Aberta de Banco de Dados), um padrão para acessar fontes de dados de forma uniforme. Aqui estão alguns exemplos de uso das funções ODBC do PHP:

• Ler dados de um banco de dados externo e exibi-los no seu site
• Inserir ou modificar dados em um banco de dados externo
• Efetuar consultas complexas numa base de dados externa

Este guia diz respeito ao ImageMagick, um conjunto de software poderoso para a manipulação de imagens, disponível nos Serviços de Hospedagem Web e Servidores Cloud da Infomaniak.

ImageMagick e soluções de manipulação de imagens

Várias ferramentas estão à sua disposição para processar as suas imagens (redimensionamento, conversão, marcas d'água):

1. ImageMagick (CLI): o conjunto principal, utilizável na linha de comandos (via SSH); o comando moderno é magick, mas a sintaxe antiga convert continua disponível.
2. Extensão PHP imagick: esta é a solução mais comum para sites (WordPress, etc.); permite utilizar o ImageMagick diretamente nos seus scripts PHP.
3. Biblioteca GD: uma alternativa mais leve, frequentemente pré-instalada, ideal para manipulações simples (miniaturas, texto em imagens).
4. PerlMagick: interface dedicada a scripts Perl para acessar as funcionalidades do ImageMagick.

Caminhos e comandos

Nas infraestruturas Infomaniak, o ImageMagick está instalado por padrão. Os executáveis estão localizados no seguinte diretório:

/usr/bin/

Aqui estão os principais comandos disponíveis:

Para testar a presença do módulo Perl Image::Magick, pode usar o seguinte comando:

perl -e 'use Image::Magick; print "Installed\n"';

Este guia detalha o uso do Crontab (tarefas agendadas via SSH), disponível apenas em Servidor Cloud, por padrão (existe também um agendador de tarefas para qualquer tipo de hospedagem).

Pré-requisitos

• Os arquivos de script chamados pelo cron devem ser executáveis (CHMOD).

Caminho completo

As tarefas Cron não têm conhecimento do caminho absoluto. Chamar o PHP sem especificar os caminhos completos para o executável torna, portanto, impossível a execução da tarefa. É necessário especificar

/opt/phpX.X/bin/php

substituindo X.X pela versão desejada do PHP (/opt/php8.1/bin/php, por exemplo).

Outras operações

Por exemplo:

• Listar os cron jobs do utilizador SSH em questão:

  crontab -l -u Username

• Editar os cron jobs:

  crontab -e -u NomeDeUtilizador

• Receber notificações por e-mail sobre o resultado das suas tarefas cron (adicionar no início do ficheiro):

  MAILTO=e-mail@dominio.xyz

Restaurar um backup

A Infomaniak faz o backup dos cron jobs dos últimos 7 dias (uma vez por dia). Em caso de exclusão acidental, entre em contato com o suporte da Infomaniak para solicitar a restauração, indicando a hora e a data da exclusão.

Este guia explica como usar o cabeçalho HTTP X-Frame-Options para limitar a exibição de suas páginas em frames (<frame> e <iframe>) e contribuir para a proteção contra ataques de clickjacking (desvio de cliques).

Valores do cabeçalho X-Frame-Options

O cabeçalho HTTP X-Frame-Options indica ao navegador se uma página pode ser exibida em uma tag <frame> ou <iframe>.

• DENY: impede totalmente a exibição da página em um frame, inclusive a partir do seu próprio site.
• SAMEORIGIN: permite a exibição apenas quando a página é incorporada a partir do mesmo domínio.

Configurar o cabeçalho

Para aplicar esta proteção a todo o seu site, adicione a seguinte diretiva no ficheiro .htaccess:

Header set X-Frame-Options "SAMEORIGIN"

Você também pode enviar este cabeçalho a partir de um script PHP:

Permitir um domínio específico com Content-Security-Policy

Autoriser un domaine spécifique avec Content-Security-Policy

Para permitir que um domínio externo incorpore seu conteúdo em um iframe, use o cabeçalho Content-Security-Policy com a diretiva frame-ancestors.

Exemplo:

Header set Content-Security-Policy "frame-ancestors 'self' https://domain.xyz"

Esta regra permite que o seu próprio site ('self') e https://domain.xyz incorporem as suas páginas numa iframe.

Este guia detalha a gestão das conexões de entrada e saída entre os seus diferentes ambientes de alojamento, especificamente para o acesso remoto às bases de dados.

Conexão às bases de dados entre alojamentos

1. A partir de uma Hospedagem Web (Compartilhada)

Se você possui uma Hospedagem Web (exceto a antiga oferta "v1 - 60 GB"), pode estabelecer uma conexão com bancos de dados localizados em:

• outra solução de Hospedagem Web (compartilhada),
• uma solução de hospedagem do tipo Servidor Cloud.

Essa flexibilidade permite compartilhar um banco de dados entre vários sites, estabelecer conexões remotas ou configurar acessos cruzados entre seus serviços.

2. A partir de um Servidor Cloud

Com um Servidor Cloud, é possível conectar-se aos bancos de dados hospedados em outro Servidor Clouddo seu ambiente:

• Certifique-se de que a porta 3306 (protocolo TCP) está aberta para entrada no seu firewall.
• Se restringir o acesso a determinados endereços, verifique as regras para os protocolos IPv4 e IPv6.

Nota importante: as conexões de saída de um Servidor Cloud para as bases de dados de uma hospedagem compartilhada não são permitidas.

3. A partir de um provedor externo

Se desejar aceder às suas bases de dados MySQL a partir de um servidor ou ferramenta localizada fora da infraestrutura Infomaniak (provedor terceirizado, aplicação local, etc.), consulte este outro guia.

Este guia explica como ativar ou desativar a função PHP set_time_limit de um Serviço de Hospedagem Web.

Introdução

• set_time_limit é uma função PHP que define o tempo limite de execução de um script, em segundos; se este limite for atingido, o script é interrompido e retorna um erro fatal.
• set_time_limit não pode ser usado para definir valores que excedam o limite do tempo de execução dos scripts (max_execution_time) definido no Manager.

Ativar ou desativar a função PHP set_time_limit

Para acessar a gestão do site:

1. Clique aqui para acessar a gestão do seu site no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao site em questão:
   
3. Clique em Gerenciar as configurações avançadas:
   
4. Clique na aba PHP / Apache:
   
5. Clique no botão de alternância (toggle switch) Ativado/Desativado conforme desejado:
   
6. Clique no botão Guardar na parte inferior da página para confirmar as alterações.

Git e GitHub estão disponíveis na Infomaniak com todas as ofertas de hospedagem em…

• … Hospedagem Web compartilhada
• … Servidor Cloud gerenciado

e, claro, na oferta Jelastic Cloud, que permite uma integração profunda do controle de versão.

Este guia aborda as funcionalidades de gestão de bases de dados disponíveis com os serviços de hospedagem da Infomaniak.

MySQL, SQLite, MariaDB, PostgreSQL…

No que diz respeito ao Sistema de Gestão de Base de Dados, os serviços de alojamento suportam…

1. … bases de dados MySQL através de acesso PHP MySQL ou através de Perl DBI+DBD::mysql
   • Pode usar MySQL como sistema de gestão de bases de dados (SGBD) nos servidores Infomaniak.
   • Pode aceder a ele através de PHP, utilizando as funções de base de dados MySQL integradas no PHP, ou através de Perl, utilizando os módulos DBI e DBD::mysql.
2. … MySQLi, a interface nativa de acesso ao MySQL (PHP5)
   • MySQLi é uma extensão do PHP que permite o acesso a um banco de dados MySQL.
   • É uma versão aprimorada e mais recente da antiga extensão MySQL do PHP, oferecendo funcionalidades e desempenho aprimorados.
3. … SQLite 3.x
   • O SQLite é um motor de base de dados SQL leve, independente e sem servidor.
   • Os servidores Infomaniak suportam a versão 3.x do SQLite, o que significa que pode usar o SQLite para armazenar dados nestes servidores.
4. … MariaDB
   • O MariaDB é um fork do MySQL e é frequentemente usado como alternativa ao MySQL.
   • Portanto, pode usar o MariaDB como sistema de gestão de base de dados nos servidores Infomaniak.
5. … o módulo PGSQL
   • PGSQL é um módulo PHP que permite conectar-se a um banco de dados PostgreSQL.
   • Esta funcionalidade específica permite conectar-se a um banco de dados PostgreSQL REMOTO através do PHP; isso requer a abertura da porta apropriada para o endereço IP específico do banco de dados PostgreSQL no painel de controle da Infomaniak.

Este guia explica como obter informações sobre a presença de um sistema de cache em um site usando o comando curl.

Introdução

• No mundo da programação e da administração de sistemas, é frequentemente necessário determinar se um site utiliza um sistema de cache para melhorar o seu desempenho.
• Sistemas de cache como o Fastly são comumente utilizados para armazenar temporariamente dados, de forma a disponibilizá-los mais rapidamente aos utilizadores.
• Seguindo estas etapas, você poderá determinar se um site utiliza um sistema de cache para melhorar seu desempenho e entender o funcionamento e a otimização dos sites.

Utilização do comando curl

curl é uma ferramenta de linha de comando que permite transferir dados usando URLs.

A opção -svo /dev/null é usada para realizar uma solicitação silenciosa (-s), exibir informações detalhadas sobre a solicitação (-v) e redirecionar os dados de saída para /dev/null para descartá-los (/dev/null é um dispositivo especial em sistemas Unix/Linux que funciona como uma lixeira). -H "Fastly-Debug: true" é um cabeçalho HTTP adicionado à solicitação para solicitar informações de depuração específicas do Fastly.

Executar o comando

Execute o seguinte comando a partir de uma aplicação do tipo Terminal (interface de linha de comando, CLI / Command Line Interface) no seu dispositivo:

curl -svo /dev/null [url] -H “Fastly-Debug: true”

e substitua [url] pelo endereço do site que deseja verificar.

Se o site utilizar o Fastly ou outro sistema de cache semelhante, verá informações de depuração específicas na saída do comando. Os detalhes fornecidos podem incluir informações sobre as requisições e respostas HTTP, bem como informações sobre o cache e o desempenho.

Este guia detalha o uso do script FormMail nas diferentes ofertas de hospedagem da Infomaniak.

‍Preâmbulo

• FormMail‍é um script CGI gratuito que captura e processa o conteúdo de um formulário para enviá-lo aos utilizadores especificados.
• Suportado em Hospedagem compartilhada e Servidor Cloud.

Utilizar o FormMail

Pode instalar o FormMail livremente num serviço de alojamento para enviar formulários do seu site para os destinatários que escolher:

1. Descarregue a versão modificada (compatível) do script original do FormMail de Matt Wright.
2. Coloque o ficheiro Perl FormMail.pl numa subpasta chamada cgi-bin.
3. Conceda a permissão de execução para o utilizador:

   • chmod u+x FormMail.pl

4. Edite o ficheiro FormMail.pl para indicar os destinatários.

O arquivo EXAMPLE contém um exemplo de formulário que você poderá adaptar de acordo com suas necessidades.

Este guia explica como modificar o espaço em disco de uma hospedagem no Servidor Cloud.

Introdução

• Os bancos de dados são instalados no mesmo servidor Cloud, portanto, o espaço em disco para os bancos de dados não é limitado ao tamanho da hospedagem, mas sim ao espaço total em disco do Servidor Cloud.
  • Para modificar este espaço total em disco, é necessário modificar a configuração do Servidor Cloud.

Modificar o espaço em disco de uma hospedagem Web

Para aceder ao alojamento no Servidor Cloud:

1. Clique aqui para aceder à gestão do seu produto no Manager Infomaniak (precisa de ajuda?).
2. Clique diretamente no nome atribuído ao produto em questão.
3. Clique no menu de ações ⋮ localizado à direita do serviço de hospedagem web em questão, na seção Hospedagens Web.
4. Clique em Modificar o espaço em disco da hospedagem:
   
5. Ajuste o tamanho de acordo com o espaço em disco alocado e ainda disponível.
6. Clique no botão Confirmar para validar a alteração.

Este guia permite resolver um erro do tipo "Consulta inválida: o servidor MySQL ficou inativo".

Introdução

• Este tipo de erro geralmente ocorre porque uma conexão MySQL permanece aberta sem enviar solicitações durante um período de tempo que excede o limite após o qual a conexão é fechada: http://dev.mysql.com/doc/refman/5.7/en/gone-away.html
• As variáveis wait_timeout e interactive_timeout que controlam essa desconexão estão definidas em 30 segundos: http://dev.mysql.com/doc/refman/5.0/en/communication-errors.html

Soluções

Para evitar o erro "O servidor MySQL foi desligado", aqui estão várias abordagens possíveis:

Verificação e reconexão automática

Antes de executar uma consulta, recomenda-se testar se a conexão MySQL ainda está ativa. Se a conexão foi fechada, você pode restabelecê-la automaticamente antes de prosseguir com sua consulta. Aqui está um exemplo em PHP:

if (!mysqli_ping($connexion)) {
mysqli_close($connexion);
$connexion = mysqli_connect($host, $user, $password, $database);
}

A função mysqli_ping() verifica se a conexão ainda é válida. Se não for, o script fecha a conexão e abre uma nova.

Envio regular de "ping"

Outra opção é executar um script que envie regularmente um "ping" para o banco de dados, a fim de manter a conexão ativa. Por exemplo, você pode criar uma tarefa agendada (cron job) que envie uma consulta leve, como SELECT 1;, em intervalos regulares.

Ajuste das configurações MySQL (Servidor Cloud)

Com um Servidor Cloud, você pode aumentar os valores das variáveis wait_timeout e interactive_timeout no menu MySQL do seu servidor para prolongar a duração da conexão antes que ela seja encerrada.

Este guia permite encontrar o endereço IP público do seu dispositivo, o que pode ser útil em algumas solicitações de suporte.

Exibir o endereço IP público no dispositivo conectado

Clique aqui para obter o endereço IP público do seu dispositivo nos formatos IPv4 e IPv6.

Métodos alternativos

Visite ipinfo.io ou ifconfig.me.

… no macOS

1. A partir de uma aplicação do tipo Terminal (interface de linha de comando, CLI /Command Line Interface) no seu dispositivo, execute o comando curl ifconfig.me e pressione Enter.
2. O endereço exibido é o endereço IP público do computador.

Para automatizar a pesquisa do endereço IP público, use comandos ou scripts que consultem serviços como api.ipify.org...