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.

This guide explains how to restore backups of previous versions of your files and other web data from your Infomaniak hostings, and how to set up an effective backup policy if the automatically and freely provided backups no longer meet your availability or security needs.

Web Hostings (Starter, Shared, Cloud Server)

Refer to these guides to restore automatic backups:

• of an entire hosting (FTP + MySQL),
• of specific files on the hosting,
• of specific databases,
• of a Web Application (Wordpress & Apps),
• of Cloud Server SSH crons.

Refer to these guides to backup and restore:

• a hosting with Swiss Backup and Restic (advanced),
• WordPress with Swiss Backup,
• WordPress with an extension.

Also refer to https://faq.infomaniak.com/snapshot.

Messaging

• Restore messages from Infomaniak automatic backups.
• Restore contacts or calendar events.
• Backup the current content of an email account:
  • by downloading the current content locally,
  • by duplicating all current content to a backup box,
  • by copying future emails as they arrive to a backup box.

Domains / DNS Zones

• Restore deleted DNS records from Infomaniak automatic backups.
• Restore an expired domain in redemption period.

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

This guide concerns IonCube Loader, a PHP module that allows decoding of PHP scripts that have been encoded with IonCube Encoder.

Preamble

• IonCube encoding is used to protect the source code of an application and prevent its modification or illegal distribution.
• By using IonCube Loader, website owners can ensure the security of their code and content while allowing secure and easy distribution of their applications.

Using ionCube Loader

With shared hosting it is no longer offered. You can check this from the dashboard:

1. Click here to access the management of your site on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the site concerned:
   
3. Click on Manage advanced settings:
   
4. Click on the PHP Extensions tab.
5. Click on ionCube Loader (if present in the list) to see the details:
   
   • Here, you will need to consider a Cloud Server.

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.

This guide explains how to securely and easily transfer files between Web Hosting and/or Cloud Server.

Preamble

• The FXP (File eXchange Protocol) is a method for transferring files directly between two FTP servers without the data passing through the local client.
• Using the FTP PORT and PASV commands, it allows establishing a connection between the two servers for faster and more efficient file transfer, thus saving bandwidth.
• However, this method can present security risks if the connections are not secured by FTPS, and it requires a more complex configuration compared to traditional FTP transfers.

Transferring data between servers

For example, you can use CrossFTP, a multi-platform software that allows FXP (as well as FTP, SFTP, S3, OpenStack Swift…).

This guide concerns the ODBC functions of PHP.

Open Database Connectivity functions

These are the functions used to interact with databases via the ODBC (Open Database Connectivity) interface, a standard for accessing data sources uniformly. Here are some examples of using the ODBC functions of PHP:

• Being able to read data from an external database and display it on your website
• Insert or modify data in an external database
• Perform complex queries on an external database

This guide covers ImageMagick, a powerful software suite for image manipulation, available on Infomaniak's Web Hosting and Cloud Servers.

ImageMagick and image manipulation solutions

Several tools are available to process your visuals (resizing, conversion, watermarks):

1. ImageMagick (CLI): the main suite usable via command line (through SSH); the modern command is magick, but the old syntax convert is still available.
2. PHP Extension imagick: this is the most common solution for websites (WordPress, etc.); it allows you to use ImageMagick directly in your PHP scripts.
3. GD Library: a lighter alternative, often pre-installed, ideal for simple manipulations (thumbnails, text on image).
4. PerlMagick: dedicated interface for Perl scripts to access ImageMagick features.

Paths and Commands

On Infomaniak infrastructures, ImageMagick is installed by default. The executables are located in the following directory:

/usr/bin/

Here are the main available commands:

To test the presence of the Perl module Image::Magick, you can use the following command:

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.

This guide details the management of incoming and outgoing connections (incoming and outgoing connections) between your different hosting environments, specifically for remote access to databases.

Database connections between hostings

1. From a Web Hosting (Shared)

If you have a Web Hosting (except for the old offer "v1 - 60 Go"), you can establish a connection to databases located on:

• another Web Hosting (shared),
• a Cloud Server type hosting.

This flexibility allows you to share a database between multiple sites, establish remote connections, or configure cross-access between your services.

2. From a Cloud Server

With a Cloud Server, it is possible to connect to databases hosted on another Cloud Server in your fleet:

• Make sure that port 3306 (protocol TCP) is open for incoming traffic in your firewall.
• If you restrict access to certain addresses, check the rules for the IPv4 and IPv6 protocols.

Important note: outgoing connections from a Cloud Server to the databases of a shared hosting are not allowed.

3. From an external provider

If you want to access your MySQL databases from a server or a tool located outside the Infomaniak infrastructure (third-party provider, local application, etc.), refer to this other guide.

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.

This guide covers the database management features available with Infomaniak hosting.

MySQL, SQLite, MariaDB, PostgreSQL…

At the Database Management System, hosting supports…

1. … MySQL databases via PHP MySQL access or via Perl DBI+DBD::mysql
   • You can use MySQL as a database management system (DBMS) on Infomaniak servers.
   • You can access it either via PHP using the built-in MySQL database functions, or via Perl using the DBI and DBD::mysql modules
2. … MySQLI, the native MySQL access interface (PHP5)
   • MySQLI is a PHP extension that allows access to a MySQL database.
   • It is an improved and more recent version of the old MySQL extension of PHP, offering enhanced features and performance.
3. … SQLite 3.x
   • SQLite is a lightweight, standalone, and serverless SQL database engine.
   • Infomaniak servers support SQLite version 3.x, which means you can use SQLite to store data on these servers.
4. … MariaDB
   • MariaDB is a fork of MySQL and is often used as an alternative to MySQL
   • You can therefore use MariaDB as a database management system on Infomaniak servers
5. … the PGSQL module
   • PGSQL is a PHP module that allows you to connect to a PostgreSQL database
   • This specific feature allows you to connect to a REMOTE PostgreSQL database via PHP; this requires opening the appropriate port to the specific IP of the PostgreSQL database from the Infomaniak manager.

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.

This guide details the use of the FormMail script on the various Infomaniak hosting offers.

Preamble

• FormMail is a free CGI script that captures and processes the content of a form to send it to the specified users.
• Supported on Shared Hosting & Cloud Server.

Using FormMail

You can freely install FormMail on hosting to send forms from your site to the recipients of your choice:

1. Download the revised version (compat) of the original Matt Wright's FormMail script.
2. Place the Perl file FormMail.pl in a subfolder named cgi-bin.
3. Give it execution permission for the user:

   • chmod u+x FormMail.pl

4. Edit the file FormMail.pl to specify the recipients.

The file EXAMPLE contains an example form that you can adapt to your needs.

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.

This guide will help you find the public IP address of your device, which can be useful when requesting support.

Display the public IP address on the connected device

Click here to obtain the public IP address of your device in IPv4 and IPv6 format.

Alternative methods

Visit ipinfo.io or ifconfig.me.

… on macOS

1. From a Terminal application (command-line interface, CLI) on your device, run the command curl ifconfig.me and press Enter.
2. The address displayed is the public IP address of the computer.

To automate the search for the public IP address, use commands or scripts that query services such as api.ipify.org...