萬盛學電腦網

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

PHP 初學者常見 14 大坑與解決方案:變數傳遞、Session、編碼、上傳、Header 錯誤等

前言

PHP 入門看似容易,但環境配置、版本差異、安全機制常讓新手卡關。本文彙整 14 個高頻問題與標準解法,助你快速跨越新手期。

1. 頁面間變數無法傳遞 ($_GET/$_POST/$_SESSION)

原因:PHP 4.2+ 預設 register_globals = Off,不再自動將請求參數註冊為全域變數。

解法:一律使用超全域陣列:$_GET['foo']、$_POST['foo']、$_SESSION['foo']、$_REQUEST['foo'] (不推薦)、$_COOKIE['foo']。

遷移舊碼:若必須相容極舊代碼,可在 php.ini 開啟 register_globals = On (強烈不建議,安全風險極高)。

2. Windows Apache + GET 中文參數亂碼/錯誤

現象:test.php?a=你好 導致內部錯誤。

解法:URL 編碼傳遞:urlencode('你好');接收端 urldecode() 或直接用 $_GET (PHP 內建已解碼)。

$url = 'test.php?a=' . urlencode('你好') . '&b=' . urlencode('你也好');

3. Windows 下 Session 無法工作

原因:php.ini 預設 session.save_path = /tmp (Linux 路徑),Windows 無法寫入。

解法:設定有效 Windows 路徑:

session.save_path = "C:/Windows/Temp"
; 或專用目錄
session.save_path = "D:/phpSession"

確保目錄存在且 IIS_IUSRS / 執行身分有讀寫權限。

4. 開發環境顯示所有錯誤與提示

配置:

display_errors = On
error_reporting = E_ALL

良好習慣:變數使用前先判斷 isset() 或 empty(),或用 @$var 抑制 Notice (不推薦常用)。

5. Windows 下 mail() 無法發送郵件

原因:Windows 無 sendmail,需指定 SMTP 伺服器。

解法:

  • php.ini:SMTP = smtp.yourisp.com、smtp_port = 25、sendmail_from = you@domain.com。
  • 更佳方案:使用 PHPMailer / Symfony Mailer 透過 SMTP (Gmail/Outlook/企業郵箱) 發送,支援 SSL/TLS、附件、HTML、隊列。

6. MySQL 初始化 Root 密碼

mysql -u root
UPDATE mysql.user SET Password=PASSWORD('yourpassword') WHERE User='root';
FLUSH PRIVILEGES;

MySQL 5.7+:ALTER USER 'root'@'localhost' IDENTIFIED BY 'newpass';

7. "Headers already sent" 錯誤

三大成因:

  1. header() / session_start() / setcookie() 前有輸出 (echo/print/空白/HTML)。
  2. 檔案開頭有 BOM (UTF-8 with BOM) → 另存為 UTF-8 無 BOM。
  3. Include 檔案結尾有空白行或輸出 → 結尾 ?> 可省略,或確保無輸出。

8. 修改 php.ini 不生效

必須重啟 Web 伺服器:Apache httpd -k restart、Nginx+FPM systemctl reload php-fpm、IIS 重啟網站/應用程式池。

9. Windows Server 2003 + IIS 6 安裝 PHP (CGI 模式)

PHP 4 ISAPI 與 IIS 6 有衝突,改用 CGI:

  1. 執行 php-4.x.x-installer.exe。
  2. IIS → 預設網站 → 屬性 → 主目錄 → 配置 → 應用程式對應 → 新增:.php → C:\PHP\php.exe。
  3. Web 服務擴展 → 新增 PHP → 允許。

現代建議:放棄 PHP 4/IIS 6,升級至 PHP 8.1+ + Nginx/Apache + Windows Server 2019/2022 或 Linux。

10. SQL 語句不生效/資料庫操作失敗

最快除錯:echo $sql; exit; 輸出實際 SQL,複製到 phpMyAdmin/MySQL Workbench 直接執行,觀察錯誤訊息。

11. include vs require 差異

特性includerequire
檔案不存在E_WARNING,繼續執行E_COMPILE_ERROR,腳本終止
回傳值成功 1,失敗 false成功 1,失敗不回傳 (終止)
用途非核心、可選模組核心配置、必要類別檔

建議:一律使用 require_once / include_once,避免重複載入導致「無法重新宣告類別/函數」錯誤。

12. isset() vs empty() 差異

變數狀態isset()empty()
未定義falsetrue (會觸發 Notice)
nullfalsetrue
0 / "0" / false / "" / []truetrue
非空值truefalse

註銷變數:unset($var) 或 $var = null。

13. MySQL 保留字作為表/欄位名

解法:使用反引號 \` (鍵盤 1 左側) 包裹:

SELECT * FROM `order` WHERE `group` = 1;

14. HTTP 協議單次請求上傳多檔案

方法 A:陣列命名

<input type="file" name="upfile[]" multiple>
<input type="file" name="upfile[]">
<input type="file" name="upfile[]">

後端 $_FILES['upfile']['name'] 為陣列,遍歷處理。

方法 B:不同 name

<input type="file" name="file_a">
<input type="file" name="file_b">

後端分別存取 $_FILES['file_a']、$_FILES['file_b']。

附錄:安全讀寫檔案函數

function read_file($file) {
    $fp = @fopen($file, 'rb');
    if (!$fp) return false;
    flock($fp, LOCK_SH);
    $data = fread($fp, filesize($file));
    fclose($fp);
    return $data;
}

function write_file($file, $data, $mode = 'wb') {
    $fp = @fopen($file, $mode);
    if (!$fp) return false;
    flock($fp, LOCK_EX);
    $bytes = fwrite($fp, $data);
    fclose($fp);
    return $bytes;
}

掌握這 14 大坑,你已跨越 PHP 入門最陡峭的坡道。持續實作、閱讀原始碼、參與社群,技術自會精進。

copyright © 萬盛學電腦網 all rights reserved