過去建置 Apache 網站時，多半使用 mod_php，讓 Apache 直接載入 PHP 模組。這次新主機改採 Apache event MPM 搭配 PHP-FPM，將 PHP 請求交由獨立的工作程序處理，作為後續新建站的施工方式。
PHP-FPM 可以管理 PHP 工作程序數量，也能透過不同的 pool，分別設定執行帳號與資源限制。這讓網站伺服器與 PHP 的設定、維護更有彈性；不過，各站的隔離程度仍取決於實際帳號、權限與 pool 配置，不是安裝後就自動完成隔離。
採用 PHP-FPM，是希望讓 Apache 連線處理與 PHP 工作量能分別管理，便於後續調整資源。 本次已完成新站建置與操作確認，以下整理實際使用的步驟；併發效能仍需依各站負載測試。
本文以 Ubuntu 24.04、Apache、PHP 8.4-FPM 為例，Apache 與 PHP 採用 Ondřej Surý 提供的第三方 PPA；資料庫與 phpMyAdmin 接續原有 SOP。安裝時請確認實際套件版本與安全更新狀態，既有主機則應先備份並安排維護時段。
0. 開工前核對
```bash
cat /etc/os-release
apache2 -v 2>/dev/null || true
php -v 2>/dev/null || true
```
- 預期為 Ubuntu 24.04 LTS。若不是 24.04，先調整套件版本及本 SOP。
- 若機器不是全新、已有 Apache／PHP，先記錄 `sudo apache2ctl -M`、`dpkg -l | grep -E 'apache2|php8\.'`，再決定是否要停用既有 handler；不要在未知站台上直接切換。
1. 使用 Ondřej Surý PPA 安裝套件來源與 Apache
```bash
sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:ondrej/apache2
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update
apt-cache policy apache2 php8.4-fpm php8.4-cli
sudo apt install -y apache2 apache2-utils ssl-cert openssl ca-certificates
sudo systemctl enable --now apache2
apache2 -v
```
2. 安裝 PHP 8.4-FPM 與網站擴充套件
本次明確安裝 `php8.4-fpm`，搭配下列網站常用擴充套件。為避免安裝到不同的 PHP 執行方式，本流程不使用 `php8.4` 泛用包，也不安裝 `libapache2-mod-php8.4`；擴充套件可依網站與模組需求調整。
```bash
sudo apt install -y php8.4-fpm php8.4-cli php8.4-common \
php8.4-curl php8.4-gd php8.4-mbstring php8.4-mysql php8.4-sqlite3 \
php8.4-xml php8.4-zip php8.4-intl php8.4-bcmath php8.4-imagick
sudo systemctl enable --now php8.4-fpm
php8.4 -v
php8.4 -m | grep -Ei 'curl|gd|mbstring|mysqli|pdo_mysql|xml|zip|intl|bcmath|imagick|opcache'
```
若某個擴充套件不存在，先用 `apt-cache policy 套件名` 確認；不要直接換成別版 PHP 的套件。`php8.4 -v` 只驗證 CLI，網站實際 handler 留到第 4 步確認。
3. Apache 改用 event，交由 FPM 處理 PHP
全新主機先看已載入模組：
```bash
sudo apache2ctl -M | grep -E 'mpm_|php|proxy_fcgi|setenvif'
```
若顯示 `php_module`，先找出版本並執行對應的 `sudo a2dismod php8.4`（或實際版本）；之後若顯示 `mpm_prefork_module`，再執行 `sudo a2dismod mpm_prefork`。只在確認有載入時才停用，不卸載原站資料。 然後執行：
```bash
sudo a2enmod mpm_event proxy_fcgi setenvif rewrite
sudo a2enconf php8.4-fpm
sudo php-fpm8.4 -t
sudo apache2ctl configtest
# 上面兩項設定檢查均通過後，才執行以下重啟指令
sudo systemctl restart php8.4-fpm
sudo systemctl restart apache2
sudo apache2ctl -M | grep -E 'mpm_|php|proxy_fcgi|setenvif|rewrite'
systemctl is-active php8.4-fpm apache2
ls -l /run/php/php8.4-fpm.sock
```
驗收：`mpm_event_module`、`proxy_fcgi_module` 應出現；`mpm_prefork_module`、`php_module` 不應出現。`a2enconf php8.4-fpm` 啟用的是 Apache 共用設定，正常情況下 HTTP 與 HTTPS vhost 都會套用，不用去 SSL／443 設定檔再貼一份 FPM `SetHandler`。若 `configtest` 不為 `Syntax OK`，不要重啟 Apache，先修正。
3-1. 必做：讓網站根目錄的 .htaccess 生效
除了啟用 `rewrite` 模組，也要在 Apache 的實際網站目錄設定允許使用 `.htaccess`。可接續參考原有文章：[mod_rewrite 套件啟用方法：讓網站根目錄使用 .htaccess]
PHP-FPM 可以管理 PHP 工作程序數量，也能透過不同的 pool，分別設定執行帳號與資源限制。這讓網站伺服器與 PHP 的設定、維護更有彈性；不過，各站的隔離程度仍取決於實際帳號、權限與 pool 配置，不是安裝後就自動完成隔離。
採用 PHP-FPM，是希望讓 Apache 連線處理與 PHP 工作量能分別管理，便於後續調整資源。 本次已完成新站建置與操作確認，以下整理實際使用的步驟；併發效能仍需依各站負載測試。
本文以 Ubuntu 24.04、Apache、PHP 8.4-FPM 為例，Apache 與 PHP 採用 Ondřej Surý 提供的第三方 PPA；資料庫與 phpMyAdmin 接續原有 SOP。安裝時請確認實際套件版本與安全更新狀態，既有主機則應先備份並安排維護時段。
0. 開工前核對
```bash
cat /etc/os-release
apache2 -v 2>/dev/null || true
php -v 2>/dev/null || true
```
- 預期為 Ubuntu 24.04 LTS。若不是 24.04，先調整套件版本及本 SOP。
- 若機器不是全新、已有 Apache／PHP，先記錄 `sudo apache2ctl -M`、`dpkg -l | grep -E 'apache2|php8\.'`，再決定是否要停用既有 handler；不要在未知站台上直接切換。
1. 使用 Ondřej Surý PPA 安裝套件來源與 Apache
```bash
sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:ondrej/apache2
sudo add-apt-repository -y ppa:ondrej/php
sudo apt update
apt-cache policy apache2 php8.4-fpm php8.4-cli
sudo apt install -y apache2 apache2-utils ssl-cert openssl ca-certificates
sudo systemctl enable --now apache2
apache2 -v
```
2. 安裝 PHP 8.4-FPM 與網站擴充套件
本次明確安裝 `php8.4-fpm`，搭配下列網站常用擴充套件。為避免安裝到不同的 PHP 執行方式，本流程不使用 `php8.4` 泛用包，也不安裝 `libapache2-mod-php8.4`；擴充套件可依網站與模組需求調整。
```bash
sudo apt install -y php8.4-fpm php8.4-cli php8.4-common \
php8.4-curl php8.4-gd php8.4-mbstring php8.4-mysql php8.4-sqlite3 \
php8.4-xml php8.4-zip php8.4-intl php8.4-bcmath php8.4-imagick
sudo systemctl enable --now php8.4-fpm
php8.4 -v
php8.4 -m | grep -Ei 'curl|gd|mbstring|mysqli|pdo_mysql|xml|zip|intl|bcmath|imagick|opcache'
```
若某個擴充套件不存在，先用 `apt-cache policy 套件名` 確認；不要直接換成別版 PHP 的套件。`php8.4 -v` 只驗證 CLI，網站實際 handler 留到第 4 步確認。
3. Apache 改用 event，交由 FPM 處理 PHP
全新主機先看已載入模組：
```bash
sudo apache2ctl -M | grep -E 'mpm_|php|proxy_fcgi|setenvif'
```
若顯示 `php_module`，先找出版本並執行對應的 `sudo a2dismod php8.4`（或實際版本）；之後若顯示 `mpm_prefork_module`，再執行 `sudo a2dismod mpm_prefork`。只在確認有載入時才停用，不卸載原站資料。 然後執行：
```bash
sudo a2enmod mpm_event proxy_fcgi setenvif rewrite
sudo a2enconf php8.4-fpm
sudo php-fpm8.4 -t
sudo apache2ctl configtest
# 上面兩項設定檢查均通過後，才執行以下重啟指令
sudo systemctl restart php8.4-fpm
sudo systemctl restart apache2
sudo apache2ctl -M | grep -E 'mpm_|php|proxy_fcgi|setenvif|rewrite'
systemctl is-active php8.4-fpm apache2
ls -l /run/php/php8.4-fpm.sock
```
驗收：`mpm_event_module`、`proxy_fcgi_module` 應出現；`mpm_prefork_module`、`php_module` 不應出現。`a2enconf php8.4-fpm` 啟用的是 Apache 共用設定，正常情況下 HTTP 與 HTTPS vhost 都會套用，不用去 SSL／443 設定檔再貼一份 FPM `SetHandler`。若 `configtest` 不為 `Syntax OK`，不要重啟 Apache，先修正。
3-1. 必做：讓網站根目錄的 .htaccess 生效
除了啟用 `rewrite` 模組，也要在 Apache 的實際網站目錄設定允許使用 `.htaccess`。可接續參考原有文章：[mod_rewrite 套件啟用方法：讓網站根目錄使用 .htaccess]
連結：mod_rewrite套件的啟用方法(網站根目錄能使用.htaccess)
本次實機曾漏做這一步：直接開模組的 `index.php` 正常，但只開模組目錄時，Apache 卻讀取 `index.html`，導致頁面退回。補上對應網站目錄的 `AllowOverride` 設定後恢復正常。啟用 rewrite 與允許 .htaccess 是兩件事，不能只做前者。
設定要套在實際網站路徑，不要放寬系統根目錄。根目錄 `.htaccess` 中可保留：
```apache
DirectoryIndex index.php index.html index.cgi
Options -Indexes
```
舊站 `.htaccess` 若有 `php_value`／`php_flag`，請遷移至 FPM 的 php.ini 或 pool 設定；Apache 註解使用 `#`。改完主設定先 configtest，再 reload，並實際開網站測試，因為 configtest 不會完整掃描所有 .htaccess。
4. 用 phpinfo 確認網站實際走 FPM
在實際網站根目錄暫放 `phpinfo.php`，內容如下，再用瀏覽器開啟正式網站網址：
```php
<?php phpinfo();
```
確認這三項：
- Server API：FPM/FastCGI
- PHP Version：預期的 8.4.x
- Loaded Configuration File：/etc/php/8.4/fpm/php.ini
用正式 HTTPS 網址開啟，就能確認 HTTPS 這個入口確實走 FPM。確認完立即刪除 phpinfo.php，避免公開伺服器設定資訊。
5. PHP 設定改看 FPM 的 php.ini
原 mod_php SOP 寫 `/etc/php/8.4/apache2/php.ini`；本工法只改 FPM 設定檔 `/etc/php/8.4/fpm/php.ini`。以下保留大檔上傳能力；PHP 記憶體上限與 FPM 同時處理量仍須看 VM RAM，不能保證任何規格的 VM 都撐得住。先檢查 FPM pool 的執行身分及系統憑證檔：
```bash
grep -E '^(user|group|pm|pm\.max_children)\s*=' /etc/php/8.4/fpm/pool.d/www.conf
ls -l /etc/ssl/certs/ca-certificates.crt
sudo install -d -o www-data -g www-data -m 700 /var/lib/php/neil-upload-tmp
sudo cp -a /etc/php/8.4/fpm/php.ini "/etc/php/8.4/fpm/php.ini.before-neil-fpm-$(date +%Y%m%d-%H%M%S)"
```
若 pool 的 `user`／`group` 不是 `www-data`，先依實際帳號調整暫存目錄擁有者；不要把它放在公開的 `uploads` 下。用 SFTP 或熟悉的編輯器打開 `/etc/php/8.4/fpm/php.ini`，搜尋並修改原有同名項目，每個參數只留一個有效設定值：
```ini
; PHP-FPM 起始值
date.timezone = Asia/Taipei
expose_php = Off
display_errors = Off
log_errors = On
file_uploads = On
upload_tmp_dir = /var/lib/php/neil-upload-tmp
upload_max_filesize = 2000M
post_max_size = 2047M
max_file_uploads = 500
max_input_vars = 3000
memory_limit = 1024M
max_execution_time = 600
max_input_time = 600
curl.cainfo = "/etc/ssl/certs/ca-certificates.crt"
session.upload_progress.enabled = 0
```
以上是本次網站需求的起始值，不是所有 VM 通用的效能參數。`memory_limit` 是每個 PHP 請求的上限，應配合 RAM 與 `pm.max_children` 規劃；`max_file_uploads` 只限制檔案個數，整個請求仍受 `post_max_size` 限制。網站若依賴 PHP 原生上傳進度功能，停用 `session.upload_progress.enabled` 後需另測。
若要支援上述接近 2 GB 的上傳，還需核對 Apache 的請求大小限制。在實際啟用的站台設定中加入或調整以下項目，確保 HTTP／HTTPS 都適用，再 configtest、reload：
```apache
LimitRequestBody 2147483647
```
上傳是否成功還與磁碟、網路速度、逾時及網站程式有關，請用實際檔案測試，不能只看 php.ini 數值。
修改完畢先測設定、重啟，再用暫時的受限 `phpinfo()` 或站內測試頁確認 Loaded Configuration File、上述值及 `PHP_SAPI=fpm-fcgi`；驗證完立即刪除測試檔。不要拿 `php -i`／`php -v` 代替網站端驗證，因它們讀的是 CLI 環境。
```bash
sudo php-fpm8.4 -t
sudo systemctl restart php8.4-fpm
systemctl is-active php8.4-fpm
```
Apache 的 vhost／模組設定改動則先 `sudo apache2ctl configtest`，再 `sudo systemctl reload apache2`。`update-alternatives --set php` 只改 CLI 的 `php` 指令，不能切換網站 handler。
6. MySQL 與 phpMyAdmin
資料庫與 phpMyAdmin 接續參考原文章：
本次實機曾漏做這一步：直接開模組的 `index.php` 正常，但只開模組目錄時，Apache 卻讀取 `index.html`，導致頁面退回。補上對應網站目錄的 `AllowOverride` 設定後恢復正常。啟用 rewrite 與允許 .htaccess 是兩件事，不能只做前者。
設定要套在實際網站路徑，不要放寬系統根目錄。根目錄 `.htaccess` 中可保留：
```apache
DirectoryIndex index.php index.html index.cgi
Options -Indexes
```
舊站 `.htaccess` 若有 `php_value`／`php_flag`，請遷移至 FPM 的 php.ini 或 pool 設定；Apache 註解使用 `#`。改完主設定先 configtest，再 reload，並實際開網站測試，因為 configtest 不會完整掃描所有 .htaccess。
4. 用 phpinfo 確認網站實際走 FPM
在實際網站根目錄暫放 `phpinfo.php`，內容如下，再用瀏覽器開啟正式網站網址：
```php
<?php phpinfo();
```
確認這三項：
- Server API：FPM/FastCGI
- PHP Version：預期的 8.4.x
- Loaded Configuration File：/etc/php/8.4/fpm/php.ini
用正式 HTTPS 網址開啟，就能確認 HTTPS 這個入口確實走 FPM。確認完立即刪除 phpinfo.php，避免公開伺服器設定資訊。
5. PHP 設定改看 FPM 的 php.ini
原 mod_php SOP 寫 `/etc/php/8.4/apache2/php.ini`；本工法只改 FPM 設定檔 `/etc/php/8.4/fpm/php.ini`。以下保留大檔上傳能力；PHP 記憶體上限與 FPM 同時處理量仍須看 VM RAM，不能保證任何規格的 VM 都撐得住。先檢查 FPM pool 的執行身分及系統憑證檔：
```bash
grep -E '^(user|group|pm|pm\.max_children)\s*=' /etc/php/8.4/fpm/pool.d/www.conf
ls -l /etc/ssl/certs/ca-certificates.crt
sudo install -d -o www-data -g www-data -m 700 /var/lib/php/neil-upload-tmp
sudo cp -a /etc/php/8.4/fpm/php.ini "/etc/php/8.4/fpm/php.ini.before-neil-fpm-$(date +%Y%m%d-%H%M%S)"
```
若 pool 的 `user`／`group` 不是 `www-data`，先依實際帳號調整暫存目錄擁有者；不要把它放在公開的 `uploads` 下。用 SFTP 或熟悉的編輯器打開 `/etc/php/8.4/fpm/php.ini`，搜尋並修改原有同名項目，每個參數只留一個有效設定值：
```ini
; PHP-FPM 起始值
date.timezone = Asia/Taipei
expose_php = Off
display_errors = Off
log_errors = On
file_uploads = On
upload_tmp_dir = /var/lib/php/neil-upload-tmp
upload_max_filesize = 2000M
post_max_size = 2047M
max_file_uploads = 500
max_input_vars = 3000
memory_limit = 1024M
max_execution_time = 600
max_input_time = 600
curl.cainfo = "/etc/ssl/certs/ca-certificates.crt"
session.upload_progress.enabled = 0
```
以上是本次網站需求的起始值，不是所有 VM 通用的效能參數。`memory_limit` 是每個 PHP 請求的上限，應配合 RAM 與 `pm.max_children` 規劃；`max_file_uploads` 只限制檔案個數，整個請求仍受 `post_max_size` 限制。網站若依賴 PHP 原生上傳進度功能，停用 `session.upload_progress.enabled` 後需另測。
若要支援上述接近 2 GB 的上傳，還需核對 Apache 的請求大小限制。在實際啟用的站台設定中加入或調整以下項目，確保 HTTP／HTTPS 都適用，再 configtest、reload：
```apache
LimitRequestBody 2147483647
```
上傳是否成功還與磁碟、網路速度、逾時及網站程式有關，請用實際檔案測試，不能只看 php.ini 數值。
修改完畢先測設定、重啟，再用暫時的受限 `phpinfo()` 或站內測試頁確認 Loaded Configuration File、上述值及 `PHP_SAPI=fpm-fcgi`；驗證完立即刪除測試檔。不要拿 `php -i`／`php -v` 代替網站端驗證，因它們讀的是 CLI 環境。
```bash
sudo php-fpm8.4 -t
sudo systemctl restart php8.4-fpm
systemctl is-active php8.4-fpm
```
Apache 的 vhost／模組設定改動則先 `sudo apache2ctl configtest`，再 `sudo systemctl reload apache2`。`update-alternatives --set php` 只改 CLI 的 `php` 指令，不能切換網站 handler。
6. MySQL 與 phpMyAdmin
資料庫與 phpMyAdmin 接續參考原文章：
[Ubuntu 分拆安裝 Apache／PHP／MySQL／phpMyAdmin]，從下半段「步驟 2：安裝 MySQL」開始。
該篇是較早版本的紀錄，接續時要留意以下差異：
- phpMyAdmin 安裝前先確認相依套件不會額外安裝 mod_php 或其他 PHP 執行版本。
- 原稿若有針對 Apache SAPI 的 `phpenmod`，本工法應確認 FPM 的擴充設定；網站參數仍以 `/etc/php/8.4/fpm/php.ini` 為準。
- 匯入後確認 XOOPS 的資料表前綴與實際表名大小寫一致；不要在 MySQL 8 初始化後直接更改 `lower_case_table_names`。
- MySQL 管理帳號的認證方式依實際版本處理，不因改用 FPM 就必須修改 root 認證。
7. SSL 與最後驗收
Ubuntu 24.04 安裝 Certbot 直接使用 Ubuntu 套件庫，舊 `ppa:certbot/certbot` 不適用：
```bash
sudo apt update
sudo apt install certbot python3-certbot-apache
certbot --version
```
接續原 SSL 流程設定實際網域與憑證。PHP-FPM 的共用設定通常會同時套用 HTTP 與 HTTPS；仍要在正式 HTTPS 網址確認 Server API 是 FPM/FastCGI，不必因此先修改憑證路徑。
上線前，確認首頁、登入、後台、模組目錄網址、圖片與附件上傳，以及 phpMyAdmin 都能正常運作。清除臨時 phpinfo 檔，記下實際套件版本與例外設定，這次 Apache＋PHP-FPM 建置才算完成。
以上是本次實作後整理的安裝方法，提供有相同需求的朋友參考。後續仍會依實際維運經驗補充與調整。
工作心得撰寫：徐嘉裕 Neil Hsu
參考：[PHP-FPM 設定文件](https://www.php.net/manual/en/install.fpm.configuration.php)、[Apache 請求大小限制](https://httpd.apache.org/docs/2.4/mod/core.html#limitrequestbody)。
該篇是較早版本的紀錄，接續時要留意以下差異：
- phpMyAdmin 安裝前先確認相依套件不會額外安裝 mod_php 或其他 PHP 執行版本。
- 原稿若有針對 Apache SAPI 的 `phpenmod`，本工法應確認 FPM 的擴充設定；網站參數仍以 `/etc/php/8.4/fpm/php.ini` 為準。
- 匯入後確認 XOOPS 的資料表前綴與實際表名大小寫一致；不要在 MySQL 8 初始化後直接更改 `lower_case_table_names`。
- MySQL 管理帳號的認證方式依實際版本處理，不因改用 FPM 就必須修改 root 認證。
7. SSL 與最後驗收
Ubuntu 24.04 安裝 Certbot 直接使用 Ubuntu 套件庫，舊 `ppa:certbot/certbot` 不適用：
```bash
sudo apt update
sudo apt install certbot python3-certbot-apache
certbot --version
```
連結：如需要申請 Let's Encrypt的 SSL 與安裝可參考下篇文章說明
接續原 SSL 流程設定實際網域與憑證。PHP-FPM 的共用設定通常會同時套用 HTTP 與 HTTPS；仍要在正式 HTTPS 網址確認 Server API 是 FPM/FastCGI，不必因此先修改憑證路徑。
上線前，確認首頁、登入、後台、模組目錄網址、圖片與附件上傳，以及 phpMyAdmin 都能正常運作。清除臨時 phpinfo 檔，記下實際套件版本與例外設定，這次 Apache＋PHP-FPM 建置才算完成。
以上是本次實作後整理的安裝方法，提供有相同需求的朋友參考。後續仍會依實際維運經驗補充與調整。
工作心得撰寫：徐嘉裕 Neil Hsu
參考：[PHP-FPM 設定文件](https://www.php.net/manual/en/install.fpm.configuration.php)、[Apache 請求大小限制](https://httpd.apache.org/docs/2.4/mod/core.html#limitrequestbody)。
留言
張貼留言