Todos os produtos
Search
Central de documentação

:Configurar um ambiente PHP usando o IIS em uma instância Windows

Última atualização: Jul 03, 2026

Ao implantar uma aplicação PHP em uma instância do Elastic Compute Service (ECS) Windows, você pode integrar uma versão non-thread-safe (NTS) do PHP ao módulo FastCGI do Internet Information Services (IIS) para garantir o desempenho e a segurança do site. Este guia explica como configurar as permissões de diretório e um pool de aplicativos dedicado para o seu site.

Como funciona

Esta solução integra o módulo FastCGI do IIS ao interpretador PHP para analisar e servir páginas web PHP. As solicitações externas são primeiro filtradas pelo grupo de segurança da instância. Em seguida, o IIS usa um mapeamento de manipulador para encaminhar as solicitações .php ao processo php-cgi.exe no pool de processos FastCGI. O IIS então retorna o resultado ao cliente.

image

Componentes principais

  1. O navegador de um usuário envia uma solicitação HTTP pela rede pública à porta 80 da instância ECS.

  2. O IIS recebe a solicitação HTTP. Se a solicitação for para um arquivo .php, as regras de mapeamento de manipulador do IIS encaminham a solicitação ao executável CGI do PHP (php-cgi.exe) por meio do protocolo FastCGI.

  3. O módulo FastCGI gerencia um pool de processos php-cgi.exe que recebe as solicitações e executa os scripts PHP correspondentes.

  4. O interpretador PHP executa a lógica de negócios e retorna o conteúdo HTML gerado ou outros dados ao IIS.

  5. O IIS retorna o resultado final ao cliente como uma resposta HTTP.

Procedimento

As etapas a seguir usam o Windows Server 2022 como exemplo.

Etapa 1: Instalar o IIS e o módulo CGI

  1. Faça logon em uma instância ECS.

    1. Acesse ECS console - Instances. No canto superior esquerdo, selecione a região e o grupo de recursos da instância de destino.

    2. Navegue até a página de detalhes da instância de destino. Clique em Connect e selecione Workbench. Defina o método de conexão como Terminal Connection, insira seu nome de usuário e senha e faça logon no terminal gráfico.

  2. Na caixa de pesquisa da barra de tarefas, insira Server Manager e abra-o.

  3. Selecione Add roles and features. No assistente, clique em Next até chegar à página Server Roles e marque a caixa de seleção Web Server (IIS).

  4. Na caixa de diálogo exibida, clique em Add Features e depois clique em Next até chegar à página Role Services.

  5. Na lista de Role services, expanda Web Server > Application Development e marque a caixa de seleção CGI. Clique em Next e depois clique em Install.

  6. Após a conclusão da instalação, clique em Close.

Etapa 2: Instalar o ambiente de execução do PHP

  1. Baixe e instale o Microsoft Visual C++ Redistributable necessário para o PHP.

  2. Acesse a página de download no site oficial do PHP. Selecione e baixe o pacote Zip VS17 x64 Non Thread Safe.

    O módulo FastCGI do IIS usa um modelo multiprocessos em que cada processo é executado de forma independente, eliminando a necessidade de segurança de threads. A versão Non-Thread Safe (NTS) do PHP omite essas verificações de segurança, oferecendo melhor desempenho e maior estabilidade em um ambiente IIS.
  3. Extraia o pacote Zip baixado em um caminho de diretório que não contenha espaços, como C:\php. Esse caminho será o diretório de instalação do PHP.

Etapa 3: Configurar a integração do PHP com o IIS

Configure o IIS para usar o protocolo FastCGI e chamar o interpretador PHP. Isso permite que o IIS processe arquivos .php encaminhando as solicitações ao interpretador PHP.

  1. Na caixa de pesquisa da barra de tarefas, insira Internet Information Services (IIS) Manager e abra-o.

  2. No painel de navegação à esquerda, clique no nome do host do servidor para abrir a visualização de recursos do servidor.

  3. Clique duas vezes em Handler Mappings. No painel Actions à direita, clique em Add Module Mapping....

  4. Na caixa de diálogo exibida, configure os seguintes parâmetros:

    • Request Path: *.php

    • Module: FastCgiModule

    • Executable (optional): C:\php\php-cgi.exe

      Na caixa de diálogo de seleção de arquivo, altere o tipo de arquivo de .dll para .exe para localizar o php-cgi.exe.
    • Name: PHP via FastCGI

  5. Clique em OK. Na caixa de diálogo de confirmação exibida, clique em Yes para criar o aplicativo FastCGI correspondente.

Etapa 4: Criar e configurar o site

Crie um novo site e configure um pool de aplicativos dedicado e as permissões de diretório para ele.

  1. Criar um diretório e configurar permissões

    Seguindo o princípio do menor privilégio, o IIS não concede automaticamente permissões a novos diretórios. Você deve conceder manualmente permissões de leitura ao grupo IIS_IUSRS. Caso contrário, ocorrerá um erro 403 ou 500 ao acessar o site.
    1. Na caixa de pesquisa da barra de tarefas, insira File Explorer e abra-o.

    2. Crie um diretório raiz para o seu site, por exemplo, C:\myphp.

    3. Clique com o botão direito no diretório raiz do site e selecione Properties > Security > Edit... > Add....

    4. Na caixa Enter the object names to select, insira IIS_IUSRS, clique em Check Names e depois em OK.

    5. Selecione o grupo IIS_IUSRS recém-adicionado e conceda as permissões Read & execute, List folder contents e Read.

    6. Clique em OK para salvar as configurações de permissão.

  2. Alterar a porta do site padrão do IIS

    O novo site precisa usar a porta 80, que já está ocupada pelo site padrão do IIS (Default Web Site).
    1. Na caixa de pesquisa da barra de tarefas, insira Internet Information Services (IIS) Manager e abra-o.

    2. No painel de navegação à esquerda, expanda o nome do host do servidor e clique em Sites.

    3. Selecione Default Web Site. No painel Actions à direita, clique em Bindings....

    4. Selecione a vinculação de porta, clique em Edit, altere a porta para outro número (como 8080), clique em OK e depois clique em Close.

  3. Adicionar o site

    1. No painel de navegação à esquerda, clique com o botão direito no nó Sites e selecione Add Website....

    2. Configure as informações do site:

      • Site name: Por exemplo, MyPHP.

      • Physical path: O diretório raiz do site, por exemplo, C:\myphp.

      • Port: 80.

    3. Clique em OK.

Etapa 5: Configurar o grupo de segurança e verificar a configuração

Crie uma página de teste para verificar a configuração do ambiente.

  1. Configurar uma regra de grupo de segurança

    Para permitir o acesso pela rede pública ao seu site, abra a porta do serviço web no grupo de segurança da instância.

    1. Acesse o ECS console - Instances e clique no ID da instância de destino para acessar a página de detalhes.

    2. Na página de detalhes da instância, clique na aba Security Groups e depois clique no ID do grupo de segurança de destino para abrir a página de detalhes.

    3. Na lista de regras de entrada, clique em Add Rule, configure os seguintes parâmetros e salve a regra.

      • Action: Allow

      • Protocol: Custom TCP

      • Source: 0.0.0.0/0

      • Destination (Current Instance): 80/80

  2. Criar uma página de teste

    No diretório raiz do site (por exemplo, C:\myphp), crie um arquivo chamado index.php e adicione o seguinte conteúdo:

    <?php
        phpinfo();
    ?>
  3. Acessar a página de teste

    Abra um navegador web e acesse http://<Endereço IP público da instância>/index.php. Se a página exibir informações detalhadas do PHP, o ambiente está configurado corretamente.