PHP (php-fpm) no Void


Acesse:
https://www.php.net/ Download.
Ao lado clique em Source Tarballs

Escolha a Current Stable, por exemplo:
php-8.5.4.tar.gz (sig) [23,558Kb]

Instalando dependências:

Escolha a versão do momento:

Configurando
Terminará:
...
config.status: executing default commands

+--------------------------------------------------------------------+
| License: |
| This software is subject to the PHP License, available in this |
| distribution in the file LICENSE. By continuing this installation |
| process, you are bound by the terms of this license agreement. |
| If you do not agree with the terms of this license, you must abort |
| the installation process at this point. |
+--------------------------------------------------------------------+

Thank you for using PHP.

Aguarde terminar.
Terminará:
...
Build complete.
Don't forget to run 'make test'

Rodaremos direto (sempre se deve rodar "make install" com "sudo"):
Terminará:
...
Installing man pages: /opt/php85/php/man/man1/
page: phpize.1
page: php-config.1

Linkando as bibliotecas com o sistema:

Exportando a variável de ambiente:

Verificando a instalação:
PHP 8.5.4 (cli) (built: Mar 30 2026 12:26:30) (ZTS)
Copyright (c) The PHP Group
Zend Engine v4.5.4, Copyright (c) Zend Technologies
with Zend OPcache v8.5.4, Copyright (c), by Zend Technologies

Caso aparecer algum warning veja a qual biblioteca ele se refere e instale ela e recompile o PHP com --enable-nome_biblio ou --with-nome_biblio. Veja ./configure --help para maiores informações.

Como compilamos o PHP com as libs embutidas no binário não se faz necessário habilitar extensões, a não ser que tu compilar com, por exemplo, --enable-sockets=shared daí se faz necessário habilitar a extensão respectiva.

Para ver as todas as extensões compiladas e habilitadas:

Para ver uma extensão em específico:

Exemplo:
zip

Configurando o PHP-FPM


Editar pool do PHP-FPM

Abra o arquivo do pool principal:

Verifique e ajuste (a partir da linha ~28):

user = seu_usuaurio <<< aqui vai usuario e grupo do usuario do sistema, não do php.
group = seu_grupo
...
; listen = 127.0.0.1:9000
listen = /opt/php85/var/run/php-fpm.sock
...
;listen.owner = nobody
;listen.group = nobody
;listen.mode = 0660
listen.owner = apache24
listen.group = apache24
listen.mode = 0660

Salve e saia.

Isso garante que o Apache pode se comunicar com o PHP-FPM via socket.

Se preferir TCP deixe:
listen = 127.0.0.1:9000
mas coloque também no httpd.conf.

Criando arquivo e permissionando:

Configurar Apache para usar PHP-FPM

No httpd.conf, carregue os módulos:


A partir da linha ~66:

Depois, no VirtualHost ou no Directory:

Linha ~273:

Acrescente na posição abaixo de "Files .ht*":

Acrescente duas linhas na posição ~415:
Salve e saia.

Linkar php-fpm aos Serviços( sv) do Void

1. Criar a estrutura do serviço
O runit procura por um executável chamado run dentro de uma pasta com o nome do serviço.

2. Criar o script de inicialização (run)
Crie o arquivo e cole o conteúdo abaixo:

Conteúdo do arquivo:
3. Dar permissão de execução
O script precisa ser executável para o runit conseguir iniciá-lo:

Criando e permitindo arquivo de log:

4. Ativar o serviço (Linkar ao SV)
Para "linkar ao sv" e fazer o serviço iniciar automaticamente, crie um link simbólico para /var/service:
ok: run: php85-fpm: (pid 25095) 27s

Conferindo as permissões:
srw-rw---- 1 apache24 apache24 0 mar 17 13:04 /opt/php85/var/run/php-fpm.sock

Como gerenciar o serviço a partir de agora:
O Void Linux usa o comando sv para controlar os serviços.
Void Linux Handbook:
Verificar status: sudo sv status php-fpm
Reiniciar (após mudar o php.ini): sudo sv restart php-fpm
Parar: sudo sv stop php-fpm
Iniciar: sudo sv start php-fpm

Caso não subir o PHP, execute para ver os erros:

php.ini

Localizando o local correto para o arquivo:
...
Configuration File (php.ini) Path => /opt/php85/lib
Loaded Configuration File => (none)

Mimetizando:

Timezone: procure por date.timezone e coloque "America/Sao_Paulo".
Erros: Garanta que display_errors = On esteja ativo enquanto você configura seu site (em produção, mude para Off).
Uploads: Ajuste upload_max_filesize = 64M e post_max_size = 64M (o padrão costuma ser apenas 2MB).

Confirme a localização agora certa:
Configuration File (php.ini) Path => /opt/php85/lib
Loaded Configuration File => /opt/php85/lib/php.ini

Crie o arquivo:

Coloque dentro:
Salve e saia.

Reinicie o Apache:

Abra o navegador e digite:
localhost/info.php
Aparecerão as informações do PHP.
Procure pela linha:
Server API FPM/FastCGI.
Procure pelas extensões pdo_pgsql e pgsql.

Para Recompilar


Linkando as bibliotecas com o sistema:

Exportando a variável de ambiente:

Verificando a instalação:
PHP 8.5.4 (cli) (built: Mar 30 2026 12:26:30) (ZTS)
Copyright (c) The PHP Group
Zend Engine v4.5.4, Copyright (c) Zend Technologies
with Zend OPcache v8.5.4, Copyright (c), by Zend Technologies

A partir daqui, no caso de uma recompilação para acrescentar funcionalidades, somente é necessário reiniciar os serviços Apache, Postgres e PHP.

Para remover


Removendo o link:

Removendo o diretório /opt/php85:

Faça uma busca por reminiscências (remova somente as referências que instalamos):

Obs.: Para navegar na busca use as setas de direção e "Page Up-Page Down", para sair digite q (tecla q).

Remova:

Vamos para as conclusões!