萬盛學電腦網

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

PHP 常見問題彙總與最佳實踐指南(進階版)

整理 PHP 開發中最常遇到的問題、陷阱與現代最佳實踐,涵蓋變數處理、Session、SQL 規範、安全性、效能、除錯等面向,作為開發隨身查閱手冊。

1. 變數接收與 register_globals

問題: 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);

2. 除錯技巧

<?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'] 判斷

進階除錯工具

  • Xdebug + IDE:斷點、堆疊追蹤、變數檢視、程式碼覆蓋率
  • VarDumper (Symfony):dump($var) 美化輸出、支援 Lazy Loading
  • Clockwork / Laravel Telescope:請求時間軸、SQL 查詢、記憶體用量
  • error_log() + tail -f:error_log(print_r($var, true))

3. Session 最佳實踐

<?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(見前文登出範例)

常見 Session 問題

錯誤訊息原因解決
headers already sentsession_start() 前有輸出(空白、BOM、echo)確保 session_start() 在檔案最開頭,檔案存為 UTF-8 無 BOM
open(/tmp/sess_...) failedSession 儲存路徑不可寫session_save_path('/path/to/writable/dir') 或 php.ini session.save_path
Session 資料遺失多台 Server 無共享儲存使用 Redis/Memcached/資料庫儲存 Session

4. URL 參數編碼

<?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

5. 中文截取不斷碼

<?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;
}

6. SQL 規範與安全

<?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);

7. HTML 輸出防 XSS

<?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>';

8. 錯誤報告設定

<?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');

9. 日期差值計算

<?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;

10. 取得系統定義函數列表

<?php
$funcs = get_defined_functions();
echo '內建函數數量: ' . count($funcs['internal']);
echo '使用者函數數量: ' . count($funcs['user']);
// print_r($funcs['internal']); // 列出所有內建函數

11. 全域變數在函數中使用

<?php
$globalVar = 'global';

function test() {
    global $globalVar; // 宣告使用全域變數
    echo $globalVar;   // 'global'
    
    // 或用 $GLOBALS 陣列
    echo $GLOBALS['globalVar'];
    
    // 靜態變數:保持狀態
    static $count = 0;
    echo ++$count;
}
test(); // 1
test(); // 2

現代 PHP 開發檢查清單

  • ☐ PHP 8.1+ / 8.2+(效能、型別系統、新功能)
  • ☐ Composer 管理依賴,PSR-4 自動載入
  • ☐ PDO + Prepared Statements 存取資料庫
  • ☐ 密碼用 password_hash()/password_verify()
  • ☐ 全站 HTTPS、HSTS、CSP、Secure Cookies
  • ☐ 輸出跳脫 htmlspecialchars()、輸入驗證 filter_var()
  • ☐ 錯誤記錄到檔案、生產環境不顯示錯誤
  • ☐ 靜態分析:PHPStan Level 5+、Psalm
  • ☐ 程式碼風格:PHP-CS-Fixer / Pint (Laravel)
  • ☐ 測試:Pest / PHPUnit、測試覆蓋率 ≥ 80%

持續精進、遵循現代標準,才能寫出安全、可維護、高效能的 PHP 應用。

copyright © 萬盛學電腦網 all rights reserved