萬盛學電腦網

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

PHP 程序員必守的三大編程準則:懶惰、漂亮、追求運行速度

前言

如何從「寫出能跑的代碼」進化為「寫出優雅、高效、可維護的代碼」?資深 PHP 開發者公認的三大核心準則:懶惰是金、編寫漂亮的代碼、追求程序運行速度而非編碼速度。本文深度解析每條準則的實戰內涵,並提供可直接落地的工具函數庫。

準則一:懶惰是金 —— 站在巨人的肩膀上

「懶惰」非偷懶,而是拒絕重複造輪子、善於複用、構建個人/團隊組件庫。

1. 善用成熟開源庫

  • 數據庫抽象層: 不要手寫 `mysqli`/`PDO` 封裝,直接用 Doctrine DBAL、Laravel Illuminate Database、Medoo、Atlas.Pdo。一行代碼切換 MySQL/PostgreSQL/SQLite,自動防注入、支援事務、查詢構建器。
  • HTTP 客戶端: 棄用 `curl` 手寫封裝,用 GuzzleHttp、Symfony HttpClient、HTTPlug。支援異步、中介軟體、重試、熔斷、PSR-18 標準。
  • 日誌記錄: Monolog (PSR-3 標準),多處理器 (文件、Slack、Syslog、Elasticsearch)、級別控制、格式化器。
  • 驗證器: Symfony Validator、Respect/Validation,聲明式規則,支援國際化。
  • 模板引擎: Twig、Blade (Illuminate View)、Plates (原生 PHP),隔離邏輯與視圖,自動轉義防 XSS。

2. 構建個人/團隊通用函數庫

將高頻、通用、無業務耦合的邏輯封裝為 Composer 包 (私有 Packagist 或 Git 倉庫),專案間 `composer require` 即用。

推薦收錄的 5 類工具函數

① 通用數據庫操作助手 (基於 PDO)
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)]);
⑤ SQL 慢查詢自動記錄 (裝飾器模式)
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); }
        };
    }
}

準則二:編寫漂亮的代碼 —— 讓代碼會呼吸

1. 關注點分離:後端邏輯與前端模板徹底分離

錯誤示範:

<?php
$users = DB::query('SELECT * FROM users');
foreach ($users as $u) {
    echo "

{$u['name']}

{$u['email']}

"; } ?>

正確分層:

  • Controller/Service: 僅負責數據獲取、業務邏輯、組裝視圖模型 (ViewModel)。
  • View (Twig/Blade/原生 PHP 模板): 僅負責展示,包含極少邏輯 (循環、判斷、變量輸出)。

{% for user in users %}
  

{{ user.name|e }}

{{ user.email|e }}

{% else %}

暫無用戶

{% endfor %}

2. 命名規範 (PSR-12 + 領域語言)

  • 類名:`StudlyCase` (如 `OrderService`, `UserRepository`)
  • 方法/變量:`camelCase` (如 `getUserById`, `$orderTotal`)
  • 常量:`SCREAMING_SNAKE_CASE` (如 `MAX_RETRY_COUNT`)
  • 業務術語統一: 團隊建立術語表,禁用縮寫 (如 `$usr` → `$user`),讓代碼可讀如文檔。

3. 單一職責與小函數

函數不超過 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;
}

4. 依賴注入而非靜態調用


// ❌ 硬編碼依賴,難測試
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(...); }
}

準則三:追求程序運行速度,而非編碼速度

「快」是指響應延遲低、吞吐量高、資源佔用少,而非「幾分鐘寫完功能」。

1. 數據庫優化 (80% 性能瓶頸在這)

  • 索引策略: `EXPLAIN` 分析慢查詢,建立聯合索引覆蓋 `WHERE`/`ORDER BY`/`JOIN` 列。
  • 避免 N+1: 關聯數據批量預加載 (`with('relation')` / `JOIN`)。
  • 只查所需列: `SELECT id, name` 而非 `SELECT *`。
  • 分頁優化: 大偏移量改用游標/ID 鍵集分頁 (`WHERE id > :lastId LIMIT 20`)。
  • 讀寫分離: 主庫寫、從庫讀,延遲監控。

2. 緩存分層策略

3. 異步化與併發

  • 耗時任務 (郵件、推送、報表、圖片處理) 推入消息隊列 (Redis Streams、RabbitMQ、Kafka),Worker 異步消費。
  • 並行 IO:`GuzzleHttp\Promise`、curl_multi、Swoole\Coroutine、ReactPHP 並發請求多個下游 API。

4. OpCache / JIT 開啟並調優

; php.ini / php-fpm.d/www.conf
opcache.enable=1
opcache.memory_consumption=256
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=20000
opcache.validate_timestamps=0  ; 生產環境關閉檢查,部署後需重啟或 cachetool 刷新
opcache.jit_buffer_size=128M
opcache.jit=1255  ; tracing 模式,PHP 8.0+

5. 避免過早優化,但要有性能意識

  • 使用 Blackfire.io、Xdebug Profiler、Tideways 定位真實熱點。
  • 基準測試驗證優化效果:`php -d zend_extension=opcache.so -r "require 'bench.php';"`
  • 關注 P99 延遲,而非平均值。

總結

  1. 懶惰: 站在巨人肩膀 (成熟庫) + 構建自己的輪子庫 (通用組件)。
  2. 漂亮: 分層架構、領域命名、小函數、依賴注入、靜態分析 (PHPStan Level 5+)。
  3. 快: SQL 優化 > 緩存分層 > 異步併發 > OpCache/JIT,用數據驅動優化。

內化這三條準則,代碼質量與開發效率將雙提升。記住:代碼是給人看的,順便給機器跑的。

copyright © 萬盛學電腦網 all rights reserved
層級技術場景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)配置表、字典表、路由表極短 (請求級/進程級)