本系列教學面向 PHP 初學者,以建立「通訊錄管理系統」為例,從環境建置、資料庫設計、CRUD 基本操作完整實作。第一篇涵蓋開發環境準備、資料庫規劃與建立。
Windows 推薦 Docker Desktop 或 XAMPP 快速啟動;Linux/macOS 直接用套件管理器安裝。
address_book/
├── public/ # Web 根目錄
│ ├── index.php # 入口/列表頁
│ ├── create.php # 新增表單
│ ├── edit.php # 編輯表單
│ ├── delete.php # 刪除處理
│ └── assets/ # CSS/JS/圖片
├── src/ # PHP 類別/函數
│ ├── Database.php # PDO 連線封裝
│ ├── Contact.php # 聯絡人模型
│ └── functions.php # 共用函數
├── templates/ # 視圖模板(可選)
├── config.php # 設定檔
├── composer.json
└── .htaccess # Apache 重寫規則
CREATE DATABASE `address_book`
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;
USE `address_book`;
CREATE TABLE `contacts` (
`id` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
`name` VARCHAR(50) NOT NULL COMMENT '姓名',
`gender` TINYINT UNSIGNED NOT NULL DEFAULT 0 COMMENT '0=女、1=男、2=其他',
`mobile` VARCHAR(20) NOT NULL DEFAULT '' COMMENT '手機號碼',
`email` VARCHAR(100) NOT NULL DEFAULT '' COMMENT '電子郵件',
`address` VARCHAR(200) NOT NULL DEFAULT '' COMMENT '通訊地址',
`created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
`updated_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
INDEX `idx_name` (`name`),
INDEX `idx_mobile` (`mobile`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
| 欄位 | 型別 | 說明 |
|---|---|---|
id | BIGINT UNSIGNED | 主鍵、自動遞增、無符號(正數更大範圍) |
name | VARCHAR(50) | 姓名,建立索引加速搜尋 |
gender | TINYINT UNSIGNED | 0/1/2 代表性別,比字串節省空間 |
mobile | VARCHAR(20) | 手機號碼含國碼,建立索引 |
email | VARCHAR(100) | Email,RFC 5321 最大 254 字元 |
address | VARCHAR(200) | 地址 |
created_at | TIMESTAMP | 建立時間,預設現在 |
updated_at | TIMESTAMP | 更新時間,自動更新 |
src/Database.php<?php
// src/Database.php
declare(strict_types=1);
class Database {
private static ?PDO $instance = null;
public static function getInstance(): PDO {
if (self::$instance === null) {
$config = require __DIR__ . '/../config.php';
$dsn = "mysql:host={$config['db_host']};dbname={$config['db_name']};charset=utf8mb4";
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci",
];
self::$instance = new PDO($dsn, $config['db_user'], $config['db_pass'], $options);
}
return self::$instance;
}
// 禁止實例化、複製、反序列化
private function __construct() {}
private function __clone() {}
public function __wakeup() {}
}
config.php<?php
// config.php
return [
'app_name' => '通訊錄管理系統',
'app_env' => 'development', // production
'debug' => true,
'db_host' => '127.0.0.1',
'db_name' => 'address_book',
'db_user' => 'root',
'db_pass' => '', // 請修改為實際密碼
'timezone' => 'Asia/Taipei',
'upload_dir' => __DIR__ . '/public/uploads',
'max_upload_size' => 5 * 1024 * 1024, // 5MB
];
src/functions.php<?php
// src/functions.php
function h(string $str): string {
return htmlspecialchars($str, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
function redirect(string $url, int $status = 302): never {
header('Location: ' . $url, true, $status);
exit;
}
function flash(string $message, string $type = 'info'): void {
session_start();
$_SESSION['flash'][] = ['message' => $message, 'type' => $type];
}
function get_flashes(): array {
session_start();
$flashes = $_SESSION['flash'] ?? [];
unset($_SESSION['flash']);
return $flashes;
}
function csrf_token(): string {
session_start();
if (empty($_SESSION['csrf_token'])) {
$_SESSION['csrf_token'] = bin2hex(random_bytes(32));
}
return $_SESSION['csrf_token'];
}
function csrf_check(string $token): bool {
session_start();
return isset($_SESSION['csrf_token']) && hash_equals($_SESSION['csrf_token'], $token);
}
下一篇將實作:
create.php — 新增聯絡人表單與驗證index.php — 列表顯示、分頁、搜尋edit.php / update.php — 編輯與更新delete.php — 刪除確認與執行建立好資料庫與基礎架構,後續 CRUD 開發將事半功倍。