PHP

O Rouxinol roda sobre PHP 8.2 ou superior, exigido pelo Laravel 12.

Instalando no Ubuntu/Debian

O repositório oficial do Ubuntu costuma trazer uma versão de PHP defasada. Use o PPA da Ondřej Surý para instalar uma versão atual:

sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update

Instale o PHP e as extensões usadas pelo Rouxinol:

sudo apt install -y \
  php8.3 php8.3-cli php8.3-fpm \
  php8.3-common php8.3-mbstring php8.3-xml php8.3-curl \
  php8.3-mysql php8.3-sqlite3 php8.3-redis \
  php8.3-bcmath php8.3-gd php8.3-zip php8.3-intl

Extensão	Por quê
mbstring, xml, curl, bcmath	Exigidas pelo próprio Laravel.
mysql	Conexão com o MySQL, usado em produção.
sqlite3	Usado em desenvolvimento (DB_CONNECTION=sqlite).
redis	Conexão com o Redis (filas, cache, sessão).
gd ou imagick	Processamento de imagens (avatar do agente).
zip, intl	Dependências comuns de pacotes do Composer.

Verifique a versão instalada:

php -v

Instalando o Composer

curl -sS https://getcomposer.org/installer -o composer-setup.php
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
rm composer-setup.php
composer -V

Configuração recomendada (produção)

No php.ini do PHP-FPM (/etc/php/8.3/fpm/php.ini), ajuste:

memory_limit = 256M
max_execution_time = 120
upload_max_filesize = 20M
post_max_size = 20M

Reinicie o serviço depois de qualquer alteração:

sudo systemctl restart php8.3-fpm

Próximo passo

Com o PHP e o Composer prontos, siga para MySQL e Redis antes de rodar a instalação do Rouxinol.