Progetto

Generale

Profilo

Apache-modphp-to-phpfpm » Cronologia » Versione 4

Simone Piccardi, 10-05-2024 10:23

1 1 Simone Piccardi
h1. Migrare Apache da mod_php a php-fpm
2
3 4 Simone Piccardi
Per molti anni il supporto del server web Apache per l'esecuzione di applicazioni web basate su PHP è stato basato su un modulo di estensione, @mod_php@, che consentiva ad Apache di eseguire direttamente il codice PHP. Il modulo però aveva come limitazione principale quella della necessità di usare la versione tradizionale a processi singoli (il cosiddetto MPM prefork) di Apache, e non la nuova versione multi-tread (con il cosiddetto MPM event). Con le versioni più recenti di PHP però la modalità consigliata per l'esecuzione di applicazioni web è divenuta quella di FPM (FastCGI Process Manager); vederemo in questo articolo come passare ad utilizzarla.
4 1 Simone Piccardi
5 4 Simone Piccardi
Nelle seguenti istruzioni faremo riferimento ad una installazione effettuata su una distribuzione Debian o derivata, i passi sono comunque analoghi anche per altre distribuzioni. Il supporto tradizionale per PHP è fornito dal pacchetto @libapache2-mod_php@, mentre quello di FPM dal pacchetto @php-fpm@. Si tratterà di passare dall'uno all'altro e di riconfigurare Apache per passare dall'MPM prefork all'MPM event, che fornisce una lunga serie di vantaggi, come la possibilità di abilitare il supporto per http2.
6 1 Simone Piccardi
7 4 Simone Piccardi
Il primo passo per eseguire PHP con FPM consiste semplicemente nell'installare il pacchetto @php-fpm@ con @apt install php-fpm@, che installerà il programma per la versione specifica di PHP in uso nella propria distribuzione:  ad esempio su Debian 12, la attuale @stabile@, verrà messo in esecuzione il servizio @php8.2-fpm@; tutte le nuove configurazioni che si applicano a questo servizio verranno collocate nella corrispondente directory @/etc/php/8.2/fpm/@. 
8 1 Simone Piccardi
9 4 Simone Piccardi
Su Debian e derivate infatti vengono mantenute in directory separate le configurazioni relative all'esecuzione dei programmi PHP, suddividendole sotto @/etc/php/@ per numero di versione di PHP installata (vengono infatti supportate anche più versioni di PHP in contemporanea). Inoltre viene usata una ulteriore sottodirectory per poter configurare separatamente le diverse modalità con cui si eseguono dei programmi: @apache@ per quelli eseguiti con @mod_php@, @cli@ per l'esecuzione a riga di comando, ed appunto @fpm@ per l'esecuzione con FPM.
10 1 Simone Piccardi
11 4 Simone Piccardi
Pertanto, se si sta usando la modalità tradizionale di @mod_php@ sarà necessario replicare la configurazione per @php-fpm@; allora, se come è sempre opportuno fare per mantenere pulita la configurazione, si sono aggiunte le modifiche ai parametri di PHP su un file ad hoc in @/etc/php/8.2/apache/conf.d@ (ad esempio @99-local.ini@), evitando modifiche ai default di @php.ini@, tutto quello che sarà necessario fare è: 
12 3 Simone Piccardi
13 1 Simone Piccardi
<pre>
14 4 Simone Piccardi
cp -a /etc/php/8.2/apache2/conf.d/99-local.ini /etc/php/8.2/fpm/conf.d/
15 1 Simone Piccardi
</pre>
16
17 2 Simone Piccardi
altrimenti si dovranno trovare le modifiche effettuate e riapplicarle (e potrebbe essere l'occasione per metterle da sole nel file indicato). Si esegua:
18 1 Simone Piccardi
19 2 Simone Piccardi
<pre>
20 4 Simone Piccardi
systemctl restart php8.2-fpm.service
21 2 Simone Piccardi
</pre>
22
23
per fare prendere le modifiche ai parametri.
24
25
A questo punto per effettuare il passaggio si dovrà disinstallare @libapache2-mod_php@ e procedere con la riconfigurazione di apache per l'uso di @php-fpm@ al suo posto, questo, grazie alla ottima pacchettizzazione di Debian, si fa semplicemente con:
26 1 Simone Piccardi
27
<pre>
28 3 Simone Piccardi
apt-get remove --purge libapache2-mod-php7.4
29 1 Simone Piccardi
a2dismod mpm_prefork
30
a2enmod mpm_event
31
a2enmod proxy_fcgi setenvif  http2
32 3 Simone Piccardi
a2enconf php7.4-fpm
33 1 Simone Piccardi
systemctl restart apache2
34
</pre>
35
36
e non c'è bisogno di toccare nulla nella configurazione dei virtual host.
37
38
Si potrà verificare l'uso di HTTP2 andando su una pagina qualunque, attivando gli strumenti di sviluppo web di firefox (o gli analoghi di altro browser), ricaricando la pagina che le richieste e le risposte utilizzano la versione HTTP/2 del protocollo.