萬盛學電腦網

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

Windows 上手把手安裝 PHP + MySQL + Apache 搭建開發環境完整教學

目標:在 Windows 建立可運行的 PHP + MySQL 開發環境

本教學採用 **Apache + PHP + MySQL** 經典組合,逐步說明下載、安裝、設定、驗證全流程,適合零基礎入門者。

準備工作:下載安裝檔

元件下載網址建議版本
Apache HTTP Serverapachelounge.com2.4.x Win64 (VS16)
PHPwindows.php.net8.2.x Non Thread Safe (CLI) / Thread Safe (Apache 模組)
MySQL Community Serverdev.mysql.com8.0.x MSI Installer

注意:Apache 模組模式需下載 **Thread Safe** 版 PHP;若改用 PHP-FPM + Nginx 則用 Non Thread Safe。

步驟 1:安裝 Apache

  1. 解壓縮 Apache 至 C:\Apache24(路徑勿含中文、空格)。
  2. 以管理員身分開啟 CMD,執行:
    cd C:\Apache24\bin
    httpd.exe -k install(安裝為 Windows 服務)
    httpd.exe -k start(啟動服務)
  3. 瀏覽器開啟 https://localhost,出現 "It works!" 代表成功。

步驟 2:安裝 PHP

  1. 解壓縮 PHP 至 C:\php。
  2. 複製 php.ini-development 為 php.ini。
  3. 編輯 php.ini 關鍵設定:
; 啟用常用擴充
extension_dir = "C:/php/ext"
extension=curl
extension=gd
extension=mbstring
extension=mysqli
extension=pdo_mysql
extension=openssl
extension=zip

; 時區
date.timezone = Asia/Taipei

; 錯誤報告(開發環境)
error_reporting = E_ALL
display_errors = On
log_errors = On
error_log = "C:/php/logs/php_error.log"

; Session 儲存路徑
session.save_path = "C:/php/sessions"
  1. 建立 C:\php\logs、C:\php\sessions 目錄。
  2. 將 C:\php 加入系統環境變數 PATH(方便 CLI 直接呼叫 php)。

步驟 3:設定 Apache 載入 PHP 模組

編輯 C:\Apache24\conf\httpd.conf:

# 載入 PHP 模組(Thread Safe 版)
LoadModule php_module "C:/php/php8apache2_4.dll"
AddHandler application/x-httpd-php .php
PHPIniDir "C:/php"

# 目錄索引優先順序

    DirectoryIndex index.php index.html

重啟 Apache:httpd.exe -k restart

步驟 4:驗證 PHP 運作

在 C:\Apache24\htdocs 建立 info.php:

<?php phpinfo(); ?>

瀏覽 https://localhost/info.php,應顯示 PHP 版本、載入模組、設定資訊。

步驟 5:安裝 MySQL

  1. 執行 MSI 安裝程式,選 **Server Only** 或 **Full**。
  2. 設定 Root 密碼(記住!),認證方式選 **Use Strong Password Encryption**。
  3. 安裝完成後,MySQL 會自動啟動為 Windows 服務。

步驟 6:建立測試資料庫與資料表

開啟命令列客戶端(開始功能表 → MySQL 8.0 Command Line Client),輸入 Root 密碼後執行:

CREATE DATABASE testdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'testuser'@'localhost' IDENTIFIED BY 'testpass';
GRANT ALL PRIVILEGES ON testdb.* TO 'testuser'@'localhost';
FLUSH PRIVILEGES;

USE testdb;
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) NOT NULL,
    email VARCHAR(100) NOT NULL UNIQUE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

步驟 7:PHP 連線測試

建立 C:\Apache24\htdocs\test_db.php:

<?php
$host = '127.0.0.1';
$db   = 'testdb';
$user = 'testuser';
$pass = 'testpass';
$charset = 'utf8mb4';

$dsn = "mysql:host=$host;dbname=$db;charset=$charset";
$options = [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES   => false,
];

try {
    $pdo = new PDO($dsn, $user, $pass, $options);
    echo "資料庫連線成功!
"; // 插入測試 $stmt = $pdo->prepare("INSERT INTO users (name, email) VALUES (?, ?)"); $stmt->execute(['張三', 'zhangsan@example.com']); echo "新增一筆資料,ID: " . $pdo->lastInsertId() . "
"; // 查詢測試 $stmt = $pdo->query("SELECT * FROM users"); while ($row = $stmt->fetch()) { echo "ID: {$row['id']}, Name: {$row['name']}, Email: {$row['email']}
"; } } catch (PDOException $e) { echo "連線失敗: " . $e->getMessage(); }

瀏覽 https://localhost/test_db.php,應顯示連線成功與資料操作結果。

常見問題排查

問題解決方向
Apache 啟動失敗檢查 error.log;常見:Port 80 被佔用(關閉 IIS/其他服務)、模組路徑錯誤
PHP 模組載入失敗確認 php8apache2_4.dll 存在、Thread Safe 版本、VC++ Redistributable 已安裝
PHP 無法連線 MySQL檢查防火牆、MySQL 服務狀態、bind-address 設定、使用者權限、密碼正確性
中文亂碼資料庫/表/連線全都設 utf8mb4;PHP default_charset = UTF-8;HTML <meta charset="UTF-8">

進階:一鍵整合包替代方案

若不想手動配置,推薦:

  • Laragon(laragon.org):輕量、支援多版本 PHP/MySQL/Node、自動虛擬主機、內建 Terminal、Database Manager。
  • XAMPP(apachefriends.org):經典跨平台整合包,元件較舊。
  • Docker:docker-compose up -d 一鍵啟動標準化環境,生產環境一致性最佳。

結語

手動搭建環境能深入理解各元件交互關係,為後續除錯、調優打下基礎。完成上述步驟後,你已擁有一個功能完整的 PHP + MySQL 開發環境,可以開始撰寫第一個 CRUD 應用了!

copyright © 萬盛學電腦網 all rights reserved