萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 開發環境建置完整指南:Windows/Linux 下 Apache、MySQL、PHP 安裝與配置

前言:環境一致性的重要性

開發、測試、生產環境一致性能大幅減少「在我機器上正常」的問題。本指南涵蓋 Windows 手動安裝與 Linux (RPM/原始碼編譯) 兩大主流路徑,並提供現代化替代方案 (Docker、整合包)。

一、軟體取得來源

國內鏡像站 (華軍、天空、中關村) 下載較快,但**驗證簽名/雜湊值**確保未被植入惡意代碼。

二、Windows 環境手動配置 (傳統方式)

安裝路徑建議

  • Apache: `D:\Apache24`
  • PHP: `D:\PHP83`
  • MySQL: `C:\Program Files\MySQL\MySQL Server 8.0` (預設即可)

PHP 配置 (php.ini)

  1. 複製 `php.ini-development` → `php.ini`
  2. 關鍵設定:
    extension_dir = "D:/PHP83/ext"
    extension=pdo_mysql
    extension=mysqli
    extension=mbstring
    extension=gd
    extension=curl
    extension=openssl
    extension=intl
    date.timezone = Asia/Taipei
    display_errors = On
    error_reporting = E_ALL
    cgi.force_redirect = 0
    cgi.fix_pathinfo = 1
    fastcgi.impersonate = 1

Apache 配置 (httpd.conf)

  1. 載入 PHP 模組 (PHP 8.3 為例):
    LoadModule php_module "D:/PHP83/php8apache2_4.dll"
    AddHandler application/x-httpd-php .php
    PHPIniDir "D:/PHP83"
  2. 目錄索引:`DirectoryIndex index.php index.html`
  3. 編碼:`AddDefaultCharset UTF-8`
  4. DocumentRoot 指向專案 `public/` 目錄。

驗證

# cmd
httpd -t           # 語法檢查
httpd -k start     # 啟動
# 瀏覽 https://localhost/ 測試 phpinfo()

三、Linux (CentOS/RHEL/AlmaLinux) 原始碼編譯安裝

MySQL (現建議改用 MariaDB/Percona Server)

# 官方 RPM
dnf install -y https://dev.mysql.com/get/mysql80-community-release-el9-1.noarch.rpm
dnf install -y mysql-community-server
systemctl enable --now mysqld
# 初始密碼在 /var/log/mysqld.log
mysql_secure_installation

Apache

dnf install -y httpd httpd-devel
systemctl enable --now httpd
firewall-cmd --permanent --add-service=http --add-service=https
firewall-cmd --reload

PHP (Remi 套件庫 - 強烈建議,免編譯)

dnf install -y https://rpms.remirepo.net/enterprise/remi-release-9.rpm
dnf module enable -y php:remi-8.3
dnf install -y php php-cli php-fpm php-mysqlnd php-gd php-mbstring php-xml php-opcache php-intl php-zip php-bcmath
systemctl enable --now php-fpm

# Apache 整合 PHP-FPM (Event MPM + ProxyFCGI)
# /etc/httpd/conf.d/php-fpm.conf

    SetHandler "proxy:fcgi://127.0.0.1:9000"

systemctl restart httpd

四、現代化最佳實踐:Docker / 整合包

方案適用場景指令/下載
Docker Compose團隊統一、CI/CD、微服務、生產一致`docker compose up -d` (含 php:8.3-fpm, mysql:8, nginx, redis)
phpstudy / XAMPP / WampServerWindows 初學者、快速原型圖形介面一鍵啟動、切換 PHP 版本
Laravel Sail / ValetLaravel 專案零配置、自動 SSL、分站點
ServBay / MAMP PromacOS 專業開發多版本並行、GUI 管理

五、常見問題排查

  • phpinfo() 顯示 Configuration File (php.ini) Path 確認載入正確檔案。
  • Apache `error.log` / PHP-FPM `www-error.log` 查詢 500/502 根因。
  • MySQL `SHOW VARIABLES LIKE 'character_set%';` 確認 `utf8mb4`。
  • Windows 防火牆/SELinux 阻擋端口 (80, 443, 3306, 9000)。
  • 路徑分隔符:Windows `\` vs Linux `/`,PHP 統一用 `/` 兼容雙平台。

總結

手動配置能深入理解各組件交互,適合學習。**實務專案請直接採用 Docker Compose 或成熟整合包**,鎖定版本、一鍵啟動、團隊零差異,將精力集中在業務代碼而非環境折騰。

copyright © 萬盛學電腦網 all rights reserved