從小專案邁向大型系統,靠的不是語法熟練度,而是**工程化習慣**。本文歸納五大實戰面向,助你建立可維護、可擴展、可協作的程式碼庫。
<?php
// ❌ 散落全域變數
$title = '...';
$userId = 123;
$config = [...];
// ✅ 統一放入單一陣列/物件
$ctx = [
'title' => '...',
'user' => ['id' => 123, 'name' => '...'],
'config' => [...],
];
// 模板/函數統一接收 $ctx 或特定子陣列
function renderHeader(array $ctx): void { /* ... */ }
snake_case 變數、PascalCase 類別、UPPER_SNAKE 常量。$class → $className,$function → $callback。/** @var UserRepository $repo */ 或原生型別宣告。<?php
// 集中登記所有自訂函數名稱 (開發期偵測重複)
$functionRegistry = [];
function registerFunc(string $name, callable $fn): void {
global $functionRegistry;
if (isset($functionRegistry[$name])) {
trigger_error("Function $name 重複定義", E_USER_WARNING);
}
$functionRegistry[$name] = $fn;
}
// 使用
registerFunc('format_price', fn($n) => number_format($n, 2));
registerFunc('format_price', fn($n) => '$' . number_format($n, 2)); // 觸發警告
全域變數在函數內:必須 global $var 或 $GLOBALS['var'],建議**改用依賴注入**傳遞所需服務,杜絕全域狀態。
<?php
/**
* 計算訂單總金額 (含優惠、運費、稅)
*
* @param OrderEntity $order 訂單實體 (需含 items, coupon, shipping_method)
* @param UserEntity $user 會員資料 (判斷 VIP 折扣)
* @return float 最終應收金額 (元,兩位小數)
* @throws InsufficientStockException 庫存不足
* @throws InvalidCouponException 優惠券無效/過期
*/
function calculateOrderTotal(OrderEntity $order, UserEntity $user): float {
// ...
}
declare(strict_types=1) 強制嚴格模式。| 編輯器 | 優點 | 缺點 | 適合階段 |
|---|---|---|---|
| VS Code + PHP Intelephense | 免費、輕量、生態豐富、內建終端機/Git | 大型專案索引偶爾卡頓 | 全階段首選 |
| PhpStorm | 最強靜態分析、重構、資料庫工具、框架深度整合 | 收費、啟動較慢、資源佔用大 | 專業團隊/大型專案 |
| Sublime Text + LSP | 極速、極簡 | 需手動配置、PHP 支援弱於上二者 | 輕量編輯/遠端修改 |