{{ user.name|e }}
{{ user.email|e }}
如何從「寫出能跑的代碼」進化為「寫出優雅、高效、可維護的代碼」?資深 PHP 開發者公認的三大核心準則:懶惰是金、編寫漂亮的代碼、追求程序運行速度而非編碼速度。本文深度解析每條準則的實戰內涵,並提供可直接落地的工具函數庫。
「懶惰」非偷懶,而是拒絕重複造輪子、善於複用、構建個人/團隊組件庫。
將高頻、通用、無業務耦合的邏輯封裝為 Composer 包 (私有 Packagist 或 Git 倉庫),專案間 `composer require` 即用。
class DB {
private static ?PDO $pdo = null;
public static function pdo(): PDO {
return self::$pdo ??= new PDO(
"mysql:host={$_ENV['DB_HOST']};dbname={$_ENV['DB_NAME']};charset=utf8mb4",
$_ENV['DB_USER'], $_ENV['DB_PASS'],
[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC]
);
}
public static function query(string $sql, array $params = []): array {
$stmt = self::pdo()->prepare($sql);
$stmt->execute($params);
return $stmt->fetchAll();
}
public static function execute(string $sql, array $params = []): int {
return self::pdo()->prepare($sql)->execute($params);
}
public static function lastInsertId(): string { return self::pdo()->lastInsertId(); }
}
function dump(mixed ...$vars): void {
if (php_sapi_name() === 'cli') {
foreach ($vars as $v) var_dump($v);
} else {
echo '';
foreach ($vars as $v) var_dump($v);
echo '';
}
}
function dd(mixed ...$vars): never { dump(...$vars); die; } // Dump & Die
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Formatter\JsonFormatter;
function getLogger(string $channel = 'app'): Logger {
static $loggers = [];
return $loggers[$channel] ??= (function() use ($channel) {
$log = new Logger($channel);
$handler = new StreamHandler(storage_path("logs/{$channel}.log"), Logger::DEBUG);
$handler->setFormatter(new JsonFormatter());
$log->pushHandler($handler);
return $log;
})();
}
// 用法
getLogger('order')->info('訂單創建', ['order_id' => $id, 'user_id' => $uid, 'amount' => $amt]);
class Timer {
private static array $starts = [];
public static function start(string $name = 'default'): void { self::$starts[$name] = hrtime(true); }
public static function stop(string $name = 'default'): float {
$start = self::$starts[$name] ?? 0;
unset(self::$starts[$name]);
return ($start ? (hrtime(true) - $start) / 1e9 : 0); // 秒
}
}
// 用法
Timer::start('db_query');
$users = DB::query('SELECT * FROM users WHERE status=1');
$sec = Timer::stop('db_query');
getLogger('perf')->debug('DB query', ['sql' => 'SELECT...', 'time_sec' => $sec, 'rows' => count($users)]);
class LoggingPDO extends PDO {
public function prepare($statement, $options = []): PDOStatement {
$stmt = parent::prepare($statement, $options);
return new class($stmt, $statement) extends PDOStatement {
private PDOStatement $stmt;
private string $sql;
public function __construct(PDOStatement $stmt, string $sql) { $this->stmt = $stmt; $this->sql = $sql; }
public function execute($params = null): bool {
$start = hrtime(true);
$result = $this->stmt->execute($params);
$time = (hrtime(true) - $start) / 1e6; // ms
if ($time > 100) { // >100ms 記錄慢查詢
getLogger('sql_slow')->warning('Slow query', ['sql' => $this->sql, 'params' => $params, 'time_ms' => round($time,2)]);
}
return $result;
}
// 代理其他方法...
public function __call($method, $args) { return $this->stmt->$method(...$args); }
};
}
}
錯誤示範:
<?php
$users = DB::query('SELECT * FROM users');
foreach ($users as $u) {
echo "{$u['name']}
{$u['email']}
";
}
?>
正確分層:
{% for user in users %}
{{ user.name|e }}
{{ user.email|e }}
{% else %}
暫無用戶
{% endfor %}
函數不超過 20 行,嵌套不超過 3 層。大函數拆分為私有方法,名稱即文檔:
public function placeOrder(OrderDTO $dto): Order {
$this->validateStock($dto->items);
$order = $this->createOrderRecord($dto);
$this->deductStock($dto->items);
$this->dispatchOrderCreatedEvent($order);
return $order;
}
// ❌ 硬編碼依賴,難測試
class OrderService { public function place() { $pay = new Alipay(); ... } }
// ✅ 構造函數注入,易替換、易 Mock
class OrderService {
public function __construct(private PaymentGateway $gateway) {}
public function place(OrderDTO $dto): Order { $this->gateway->pay(...); }
}
「快」是指響應延遲低、吞吐量高、資源佔用少,而非「幾分鐘寫完功能」。
| 層級 | 技術 | 場景 | TTL |
|---|---|---|---|
| 瀏覽器 | HTTP Cache (ETag, Cache-Control) | 靜態資源、API GET | 長 (天/月) |
| CDN/反向代理 | Nginx proxy_cache / Varnish / Cloudflare | 全頁面、聚合頁 | 中 (分鐘/小時) |
| 應用層 | Redis (String/Hash/Set/ZSet) / Memcached | 熱點數據、會話、計數器、分佈式鎖 | 短/中 (秒/小時) |
| 本地進程 | PHP Array / APCu / OpCache (JIT) | 配置表、字典表、路由表 | 極短 (請求級/進程級) |