萬盛學電腦網

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

PHP 新手最頭痛的 14 大坑與解決方案(2024 更新版)

1. 超全域變數不再自動註冊

現象:$foo 取不到表單送來的值。

原因:PHP 4.2+ register_globals = Off(PHP 5.4 移除)。

正解:永遠使用超全域陣列:

$foo = $_GET['foo'] ?? $_POST['foo'] ?? $_REQUEST['foo'] ?? null;
// 或
$foo = filter_input(INPUT_GET, 'foo', FILTER_SANITIZE_SPECIAL_CHARS);

絕不開啟 register_globals,極大安全風險。

2. Windows Apache + GET 中文參數 400/500 錯誤

原因:URL 編碼不一致、Apache 解碼問題。

正解:

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

// 接收端(PHP 通常自動 urldecode $_GET)
$a = $_GET['a']; // 已解碼

確保檔案儲存為 UTF-8 無 BOM,Apache AddDefaultCharset utf-8。

3. Windows Session 無法寫入

現象:session_start() 警告、$_SESSION 不持久化。

原因:預設 session.save_path = /tmp(Linux 路徑)。

正解:

// php.ini
session.save_path = "C:/Windows/Temp"
// 或專案專用
session.save_path = "D:/php_sessions"
// 確保目錄存在且 IIS_IUSRS / PHP 執行帳號可寫

4. 開發環境錯誤顯示設定

; php.ini 開發環境建議
display_errors = On
display_startup_errors = On
error_reporting = E_ALL
log_errors = On
error_log = "C:/php_logs/php_errors.log"

生產環境:display_errors = Off、log_errors = On、自定義錯誤頁面。

5. 未定義變數/索引 Notice 滿天飛

正解**三選一:

// 1. 先判斷
if (isset($arr['key'])) echo $arr['key'];

// 2. Null 合併運算子 (PHP 7+)
echo $arr['key'] ?? '預設值';

// 3. 抑制運算子(不推薦,隱藏真問題)
echo @$arr['key'];

6. Windows mail() 無法寄信

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

正解:

  • php.ini:SMTP = smtp.example.com、smtp_port = 587、sendmail_from = no-reply@example.com
  • 更佳:使用 **PHPMailer / Symfony Mailer** 直連 SMTP(支援 TLS、認證、附件、HTML)
  • 最佳:隊列化寄信(Redis/RabbitMQ + 背景 Worker),避免阻塞請求

7. MySQL root 密碼初始化

# MySQL 5.7+
mysql -u root -p  # 預設隨機密碼在 /var/log/mysqld.log 或 journalctl
ALTER USER 'root'@'localhost' IDENTIFIED BY 'NewStrongPass!';
FLUSH PRIVILEGES;

8. "Headers already sent" 錯誤

三大元兇:

  1. 標頭前有 echo/print/HTML/空白行
  2. 檔案開頭有 **BOM** (UTF-8 with BOM)
  3. include/require 的檔案尾部有關閉標籤 ?> 後的換行

鐵律:純 PHP 檔案**省略結束標籤 ?>**,編碼存為 **UTF-8 無 BOM**。

9. 修改 php.ini 不生效

必須重啟 Web 伺服器 / PHP-FPM:

# Apache
systemctl restart httpd / apache2

# Nginx + PHP-FPM
systemctl restart php8.3-fpm  # 版本號對應

# IIS
iisreset

驗證:phpinfo() 看 Loaded Configuration File 與生效值。

10. Windows Server 2003 / IIS 6 / PHP 4 ISAPI 衝突

考古級問題。現代環境:Windows Server 2019/2022 + IIS 10 + PHP 8.x (FastCGI),php-cgi.exe 配合 FastCgiModule。

11. 陣列合併陷阱

$a = [1, 2]; $b = [3, 4];
$a + $b;        // [1, 2]  鍵名不覆蓋
array_merge($a, $b); // [1, 2, 3, 4]  數值鍵重新索引
// 關聯鍵:+ 保留左邊,merge 後者覆蓋前者

12. 字串位元組 vs 字元長度

strlen('中文');     // 6 (位元組)
mb_strlen('中文');  // 2 (字元)  需 mbstring 擴展
// 資料庫欄位長度、截取、正則全需 mb_* 版本

13. 浮點數精度陷阱

0.1 + 0.7 == 0.8; // false
// 正解:BCMath / GMP / 整數分單位(存分而非元)
echo bcadd('0.1', '0.7', 1) == '0.8'; // true

14. foreach 參考殘留副作用

$arr = [1, 2, 3];
foreach ($arr as &$v) { $v *= 2; }
unset($v); // 必須 unset!否則 $v 仍參考最後一個元素
foreach ($arr as $v) { ... } // 此時會污染 $arr[2]

總結:新手生存三原則

  1. 開啟錯誤回報,讀懂錯誤訊息
  2. 使用現代工具鏈:Composer、PSR-4、PHPStan、PHP CS Fixer、PHPUnit
  3. 查閱官方文檔:php.net 每個函數都有完整簽名、範例、更新日誌、使用者註釋
copyright © 萬盛學電腦網 all rights reserved