本教學採用 **Apache + PHP + MySQL** 經典組合,逐步說明下載、安裝、設定、驗證全流程,適合零基礎入門者。
| 元件 | 下載網址 | 建議版本 |
|---|---|---|
| Apache HTTP Server | apachelounge.com | 2.4.x Win64 (VS16) |
| PHP | windows.php.net | 8.2.x Non Thread Safe (CLI) / Thread Safe (Apache 模組) |
| MySQL Community Server | dev.mysql.com | 8.0.x MSI Installer |
注意:Apache 模組模式需下載 **Thread Safe** 版 PHP;若改用 PHP-FPM + Nginx 則用 Non Thread Safe。
C:\Apache24(路徑勿含中文、空格)。cd C:\Apache24\binhttpd.exe -k install(安裝為 Windows 服務)httpd.exe -k start(啟動服務)https://localhost,出現 "It works!" 代表成功。C:\php。php.ini-development 為 php.ini。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"
C:\php\logs、C:\php\sessions 目錄。C:\php 加入系統環境變數 PATH(方便 CLI 直接呼叫 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
在 C:\Apache24\htdocs 建立 info.php:
<?php phpinfo(); ?>
瀏覽 https://localhost/info.php,應顯示 PHP 版本、載入模組、設定資訊。
開啟命令列客戶端(開始功能表 → 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;
建立 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"> |
若不想手動配置,推薦:
docker-compose up -d 一鍵啟動標準化環境,生產環境一致性最佳。手動搭建環境能深入理解各元件交互關係,為後續除錯、調優打下基礎。完成上述步驟後,你已擁有一個功能完整的 PHP + MySQL 開發環境,可以開始撰寫第一個 CRUD 應用了!