萬盛學電腦網

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

PHP 開發環境搭建全攻略:Windows (Apache/MySQL/PHP) 與 Linux (LAMP) 詳細步驟

Windows 環境搭建 (WAMP 手動配置版)

1. 軟件下載建議

  • Apache: 官網 或國內鏡像 (華軍、天空、中關村) 下載 Win64 二進制壓縮包 (如 httpd-2.4.x-win64-VS16.zip)。
  • MySQL: 官網 下載 Community Server MSI 安裝包或 ZIP 免安裝包。
  • PHP: 官網 下載 Non Thread Safe (NTS) x64 ZIP 包 (如 php-8.3.x-nts-Win32-vs16-x64.zip)。NTS 版配合 FastCGI (php-fpm) 性能更好,也可用於 Apache mod_fcgid。

2. 安裝目錄規劃

D:\dev\
├── Apache24\      # Apache
├── mysql-8.0\     # MySQL
├── php-8.3\       # PHP
└── www\           # Web 根目錄 (DocumentRoot)

3. Apache 配置 (httpd.conf)

  1. 修改 Define SRVROOT "D:/dev/Apache24" (解壓路徑)。
  2. Listen 80 (或其他端口)。
  3. ServerName localhost:80。
  4. DocumentRoot "D:/dev/www"。
  5. <Directory "D:/dev/www"> ... AllowOverride All ... Require all granted </Directory>。
  6. 加載 PHP 模塊 (若用 mod_php,需 TS 版):
    LoadModule php_module "D:/dev/php-8.3/php8apache2_4.dll"
    AddHandler application/x-httpd-php .php
    PHPIniDir "D:/dev/php-8.3"

    推薦:使用 mod_fcgid + php-cgi.exe (NTS 版) 或獨立 php-fpm (端口 9000) + mod_proxy_fcgi,性能更穩定。

  7. 默認文檔:DirectoryIndex index.php index.html。
  8. 字符集:AddDefaultCharset UTF-8。

4. PHP 配置 (php.ini)

  1. 複製 php.ini-development 為 php.ini。
  2. 關鍵設置:
    extension_dir = "D:/dev/php-8.3/ext"
    extension=curl
    extension=gd
    extension=mbstring
    extension=mysqli
    extension=pdo_mysql
    extension=openssl
    extension=xml
    date.timezone = Asia/Shanghai
    memory_limit = 256M
    max_execution_time = 300
    post_max_size = 50M
    upload_max_filesize = 50M
    cgi.fix_pathinfo = 0 ; 安全設置
  3. 將 php.ini 複製到 Apache bin 目錄或系統目錄 (按 PHPIniDir 指定)。

5. MySQL 安裝與配置

  • 運行 MSI 安裝,選擇 Standalone,設置 root 密碼,啟用作為 Windows 服務。
  • 或解壓 ZIP,初始化數據目錄:mysqld --initialize-insecure --datadir=D:\dev\mysql-8.0\data,安裝服務 mysqld install MySQL80,啟動 net start MySQL80。
  • 客戶端連接測試:mysql -u root -p。

6. 驗證安裝

在 D:\dev\www 創建 info.php:

<?php phpinfo(); ?>

瀏覽器訪問 https://localhost/info.php,查看 PHP 信息頁,確認模塊加載、MySQL 連接正常。

Linux 環境搭建 (LAMP 編譯安裝版 - CentOS 7/8 / Ubuntu 20.04+ 示例)

1. 包管理器快速安裝 (生產環境推薦)

# Ubuntu/Debian
apt update && apt install -y apache2 mysql-server php php-mysql php-mbstring php-xml php-gd php-curl php-zip php-bcmath php-redis php-opcache

# CentOS/RHEL 8+
dnf install -y httpd mariadb-server php php-mysqlnd php-mbstring php-xml php-gd php-curl php-zip php-bcmath php-json php-opcache
systemctl enable --now httpd mariadb php-fpm

2. 源碼編譯安裝 (自定義版本/優化)

依賴庫安裝

# Ubuntu
apt install -y build-essential libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libwebp-dev libfreetype6-dev libzip-dev libonig-dev libsqlite3-dev libreadline-dev libxslt1-dev

# CentOS
dnf install -y gcc gcc-c++ make libxml2-devel openssl-devel curl-devel libjpeg-devel libpng-devel freetype-devel libwebp-devel libzip-devel oniguruma-devel sqlite-devel readline-devel libxslt-devel

下載並編譯 PHP 8.3

cd /usr/local/src
wget https://www.php.net/distributions/php-8.3.10.tar.gz
tar -zxf php-8.3.10.tar.gz
cd php-8.3.10

./configure \
--prefix=/usr/local/php8 \
--with-config-file-path=/usr/local/php8/etc \
--enable-fpm \
--with-fpm-user=www \
--with-fpm-group=www \
--enable-mbstring \
--enable-xml \
--enable-bcmath \
--enable-sockets \
--enable-zip \
--enable-soap \
--enable-pcntl \
--enable-opcache \
--with-curl \
--with-zlib \
--with-openssl \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
--with-gd \
--with-freetype \
--with-jpeg \
--with-webp \
--with-zip \
--with-sodium \
--with-pear

make -j$(nproc)
make test # 可選
make install

配置 PHP-FPM

cp php.ini-development /usr/local/php8/etc/php.ini
cp /usr/local/php8/etc/php-fpm.conf.default /usr/local/php8/etc/php-fpm.conf
cp /usr/local/php8/etc/php-fpm.d/www.conf.default /usr/local/php8/etc/php-fpm.d/www.conf
# 編輯 www.conf: listen = 127.0.0.1:9000 (或 unix socket)
# 編輯 php.ini: 同 Windows 關鍵設置
# 創建 systemd 服務文件 /etc/systemd/system/php-fpm.service
systemctl enable --now php-fpm

Apache 配合 PHP-FPM (mod_proxy_fcgi)

# httpd.conf 載入模塊
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so

# 虛擬主機配置
<VirtualHost *:80>
    DocumentRoot "/data/www"
    ServerName example.com
    # PHP 處理
    ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/data/www/$1
    # 或者 Unix Socket (性能更好)
    # ProxyPassMatch ^/(.*\.php(/.*)?)$ unix:/run/php-fpm.sock|fcgi://localhost/data/www/$1
    <Directory "/data/www">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Nginx + PHP-FPM (主流生產架構)

server {
    listen 80;
    server_name example.com;
    root /data/www;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000; # 或 unix:/run/php-fpm.sock
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
        fastcgi_intercept_errors on;
    }
}

常見問題排查

  • Apache 啟動失敗:端口 80 被佔用 (Systemd `systemctl stop httpd` 或殺掉進程)、模塊路徑錯誤、語法錯誤 (運行 `httpd -t` 檢查)。
  • PHP 模塊不生效:`php -m` 檢查模塊、檢查 `php.ini` 加載路徑 (`php --ini`)、確認 `extension_dir` 正確、DLL/so 文件存在。
  • MySQL 連接失敗:檢查服務狀態、端口 3306、防火牆、用戶權限 (`GRANT ALL ON *.* TO 'user'@'%' IDENTIFIED BY 'pass'; FLUSH PRIVILEGES;`)、`bind-address = 0.0.0.0`。
  • 權限問題:Web 目錄擁有者為 www-data/apache/www 用戶組,權限 755 (目錄) / 644 (文件),上傳目錄 775。
  • 中文亂碼:數據庫、表、連接、PHP、HTML 全鏈路 UTF-8 (utf8mb4)。

結語

手動搭建開發環境能深入理解各組件交互原理,但生產環境強烈建議使用 Docker 容器化部署 (官方 `php:8.3-fpm`、`mysql:8.0`、`nginx:alpine` 鏡像) 或 自動化部署工具 (Ansible、Terraform),保證環境一致性、可復現、易維護。開發階段可使用 Laravel Sail、DDEV、XAMPP、phpstudy 等集成包快速啟動。

copyright © 萬盛學電腦網 all rights reserved