整理 PHP 開發中最常遇到的問題、陷阱與現代最佳實踐,涵蓋變數處理、Session、SQL 規範、安全性、效能、除錯等面向,作為開發隨身查閱手冊。
問題: PHP 4.2+ register_globals = Off 預設關閉,$var 無法直接取得 $_GET/$_POST/$_COOKIE 值。
<?php
// ❌ 錯誤:依賴 register_globals
echo $name;
// ✅ 正確:明確指定來源
$name = $_GET['name'] ?? '';
$name = $_POST['name'] ?? '';
$name = $_REQUEST['name'] ?? ''; // 不建議,來源不明確
// 批次匯入(謹慎使用,會覆蓋同名變數)
extract($_POST); // 產生 $var
extract($_GET, EXTR_PREFIX_ALL, 'g'); // 產生 $g_var,較安全
// 最佳實踐:明確宣告、型別轉換、驗證
$id = (int)($_GET['id'] ?? 0);
$name = trim($_POST['name'] ?? '');
$email = filter_var($_POST['email'] ?? '', FILTER_VALIDATE_EMAIL);
<?php
// debug.php - 開發環境專用
if (($_SERVER['HTTP_X_DEBUG'] ?? '') === '1') {
header('Content-Type: text/plain; charset=utf-8');
echo "=== \$_GET ===\n"; print_r($_GET);
echo "=== \$_POST ===\n"; print_r($_POST);
echo "=== \$_COOKIE ===\n"; print_r($_COOKIE);
echo "=== \$_SESSION ===\n"; print_r($_SESSION);
echo "=== \$_SERVER ===\n"; print_r($_SERVER);
echo "=== \$_FILES ===\n"; print_r($_FILES);
exit;
}
// 使用方式:瀏覽器安裝 Header Editor 擴充套件,加入 X-Debug: 1
// 或 URL 加 ?debug=1 搭配 $_GET['debug'] 判斷
dump($var) 美化輸出、支援 Lazy Loadingerror_log(print_r($var, true))<?php
// 必須在任何輸出前呼叫
session_start();
// 設定 Session 參數(在 session_start() 前)
ini_set('session.use_strict_mode', '1');
ini_set('session.cookie_httponly', '1');
ini_set('session.cookie_secure', isset($_SERVER['HTTPS']) ? '1' : '0');
ini_set('session.cookie_samesite', 'Lax');
ini_set('session.gc_maxlifetime', '1800'); // 30 分鐘
ini_set('session.sid_length', '48');
ini_set('session.sid_bits_per_character', '6');
// 寫入
$_SESSION['user_id'] = 123;
$_SESSION['csrf_token'] = bin2hex(random_bytes(32));
// 讀取
$userId = $_SESSION['user_id'] ?? null;
// 刪除單一鍵
unset($_SESSION['temp_data']);
// 完整銷毀(登出)
session_unset();
session_destroy();
// 並刪除 Cookie(見前文登出範例)
| 錯誤訊息 | 原因 | 解決 |
|---|---|---|
| headers already sent | session_start() 前有輸出(空白、BOM、echo) | 確保 session_start() 在檔案最開頭,檔案存為 UTF-8 無 BOM |
| open(/tmp/sess_...) failed | Session 儲存路徑不可寫 | session_save_path('/path/to/writable/dir') 或 php.ini session.save_path |
| Session 資料遺失 | 多台 Server 無共享儲存 | 使用 Redis/Memcached/資料庫儲存 Session |
<?php
$url = 'https://example.com/search?q=' . urlencode('中文關鍵字 & 特殊符號');
// 輸出: https://example.com/search?q=%E4%B8%AD%E6%96%87%E9%97%9C%E9%8D%B5%E5%AD%97+%26+%E7%89%B9%E6%AE%8A%E7%AC%A6%E8%99%9F
// 解碼(通常不需手動,PHP 自動解碼 $_GET)
$keyword = urldecode('%E4%B8%AD%E6%96%87'); // '中文'
// 建構查詢字串
$query = http_build_query([
'q' => '中文',
'page' => 2,
'tags' => ['php', 'mysql']
]);
// q=%E4%B8%AD%E6%96%87&page=2&tags%5B0%5D=php&tags%5B1%5D=mysql
<?php
// ❌ 錯誤:substr 按位元組切割,中文會斷碼
echo substr('中文測試', 0, 3); // '中'
// ✅ 正確:mb_substr 按字元切割
echo mb_substr('中文測試', 0, 3, 'UTF-8'); // '中文測'
// 封裝函數
function mb_truncate(string $str, int $length, string $suffix = '...'): string {
if (mb_strlen($str, 'UTF-8') <= $length) return $str;
return mb_substr($str, 0, $length, 'UTF-8') . $suffix;
}
<?php
// ✅ 反引號包裹識別字,防關鍵字衝突
$sql = "INSERT INTO `users` (`username`, `email`, `order`) VALUES (?, ?, ?)";
// ✅ Prepared Statement 參數綁定
$stmt = $pdo->prepare($sql);
$stmt->execute([$username, $email, $order]);
// ❌ 絕對禁止:字串拼接
$sql = "SELECT * FROM users WHERE name = '$name'"; // SQL 注入高風險
// 批次插入
$placeholders = implode(',', array_fill(0, count($data), '(?, ?, ?)'));
$sql = "INSERT INTO `logs` (`level`, `message`, `created_at`) VALUES $placeholders";
$stmt = $pdo->prepare($sql);
$flat = [];
foreach ($data as $row) { $flat = array_merge($flat, $row); }
$stmt->execute($flat);
<?php
// 通用跳脫函數
function h(string $str): string {
return htmlspecialchars($str, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
// 使用
echo '<div>' . h($user_input) . '</div>';
echo '<input value="' . h($value) . '">';
// JSON 輸出到 JS
echo '<script>var data = ' . json_encode($data, JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT) . ';</script>';
<?php
// 開發環境
error_reporting(E_ALL);
ini_set('display_errors', '1');
ini_set('log_errors', '1');
ini_set('error_log', __DIR__ . '/logs/php-error.log');
// 生產環境
error_reporting(E_ALL & ~E_DEPRECATED & ~E_USER_DEPRECATED);
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', '/var/log/php/error.log');
// 關閉所有錯誤顯示(不建議)
// ini_set('display_errors', '0');
<?php
$date1 = new DateTime('2024-01-15');
$date2 = new DateTime('2023-01-01');
$diff = $date1->diff($date2);
echo $diff->days . ' 天'; // 總天數
echo $diff->format('%y年 %m月 %d天'); // 1年 0月 14天
// 簡易天數差
$days = (strtotime('2024-01-15') - strtotime('2023-01-01')) / 86400;
<?php
$funcs = get_defined_functions();
echo '內建函數數量: ' . count($funcs['internal']);
echo '使用者函數數量: ' . count($funcs['user']);
// print_r($funcs['internal']); // 列出所有內建函數
<?php
$globalVar = 'global';
function test() {
global $globalVar; // 宣告使用全域變數
echo $globalVar; // 'global'
// 或用 $GLOBALS 陣列
echo $GLOBALS['globalVar'];
// 靜態變數:保持狀態
static $count = 0;
echo ++$count;
}
test(); // 1
test(); // 2
password_hash()/password_verify()htmlspecialchars()、輸入驗證 filter_var()持續精進、遵循現代標準,才能寫出安全、可維護、高效能的 PHP 應用。