萬盛學電腦網

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

PHP 快速入門教學(一):環境建置與資料庫設計

本系列教學面向 PHP 初學者,以建立「通訊錄管理系統」為例,從環境建置、資料庫設計、CRUD 基本操作完整實作。第一篇涵蓋開發環境準備、資料庫規劃與建立。

開發環境準備

  • Web 伺服器: Apache / Nginx
  • PHP: 8.1+(建議最新穩定版)
  • 資料庫: MySQL 8.0+ / MariaDB 10.5+
  • 工具: VS Code + PHP Intelephense、Composer、Git
  • 資料庫管理: phpMyAdmin / DBeaver / MySQL Workbench

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 重寫規則

資料庫設計

需求分析

  • 聯絡人基本資料:姓名、性別、手機、Email、地址
  • 每筆資料需唯一識別碼
  • 支援中文儲存與搜尋

建表 SQL

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;

設計說明

欄位型別說明
idBIGINT UNSIGNED主鍵、自動遞增、無符號(正數更大範圍)
nameVARCHAR(50)姓名,建立索引加速搜尋
genderTINYINT UNSIGNED0/1/2 代表性別,比字串節省空間
mobileVARCHAR(20)手機號碼含國碼,建立索引
emailVARCHAR(100)Email,RFC 5321 最大 254 字元
addressVARCHAR(200)地址
created_atTIMESTAMP建立時間,預設現在
updated_atTIMESTAMP更新時間,自動更新

資料庫連線封裝 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);
}

下一步預告

下一篇將實作:

  1. create.php — 新增聯絡人表單與驗證
  2. index.php — 列表顯示、分頁、搜尋
  3. edit.php / update.php — 編輯與更新
  4. delete.php — 刪除確認與執行

建立好資料庫與基礎架構,後續 CRUD 開發將事半功倍。

copyright © 萬盛學電腦網 all rights reserved