Laravel 中的整潔程式碼架構：實用指南-php教程-PHP中文網

Clean Code Architecture in Laravel: A Practical Guide

如果你已經使用 Laravel 開發了一段時間，你可能聽說過「乾淨的程式碼」這個詞。但它在 Laravel 開發的背景下實際上意味著什麼？更重要的是，為什麼要關心？

「乾淨的程式碼」是指易於理解、維護和擴充的程式碼。乾淨的程式碼架構透過提供一種結構使這一點更進一步，使您可以隨著應用程式的增長更輕鬆地保持程式碼庫乾淨。在這篇部落格中，我們將探索如何在 Laravel 中實現乾淨的程式碼架構，使您的專案更具可擴展性、可維護性和工作樂趣。

什麼是乾淨程式碼架構？
為什麼你應該關心乾淨的程式碼
整潔程式碼架構的關鍵原則
在 Laravel 實現簡潔的程式碼架構
- 實體和用例
- 儲存庫與介面
- 控制器與依賴注入
- 服務與業務邏輯
現實範例：建立部落格平台
Laravel 中整潔程式碼的最佳實踐
最後的想法

什麼是乾淨程式碼架構？

乾淨的程式碼架構是一種組織應用程式的方式，使其更易於維護和擴展。它不依賴任何特定的框架或語言，並將您的應用程式分為多個層。每一層都有特定的職責，並且與其他層鬆散耦合。

這種分離可以幫助您避免臭名昭著的“意大利麵條代碼”，即所有內容都糾纏在一起。憑藉乾淨的程式碼架構，您的業務邏輯與使用者介面和資料存取保持分離，可讓您對應用程式的一部分進行更改，而不會破壞整個系統。

為什麼你應該關心乾淨的程式碼

寫乾淨的程式碼不只是讓你的程式碼看起來漂亮；而是讓你的程式碼看起來更漂亮。從長遠來看，這是為了讓您的生活更輕鬆。當你的程式碼乾淨時：

調試更容易：清晰、結構良好的程式碼可以幫助您更快地發現並修復錯誤。
更容易擴展：當您的應用程式成長時，乾淨的程式碼可以更輕鬆地添加新功能，而不會破壞現有功能。
與他人合作更容易：無論您是與團隊合作還是與開源社群分享項目，乾淨的程式碼都更容易讓其他人理解。

在像 Laravel 這樣鼓勵快速開發的框架中，人們很容易傾向於專注於快速建造而不是乾淨構建。但透過遵循乾淨的程式碼原則，從長遠來看，您最終會節省時間和精力。

乾淨程式碼架構的關鍵原則

在我們深入探討如何在 Laravel 中實現乾淨的程式碼架構之前，讓我們先回顧一下幾個關鍵原則：

關注點分離：架構中的每一層都應該有特定的職責，並且應該避免混合關注點（例如，不要將資料庫邏輯放在控制器中）。
依賴倒置：高層模組不應該依賴低層模組。相反，兩者都應該依賴抽象（如介面）。
單一職責原則：每個類別或函數都應該做一件事，並且做好它。這使得測試和維護程式碼變得更加容易。

在 Laravel 實現簡潔的程式碼架構

現在，讓我們看看如何在 Laravel 應用程式中實現乾淨的程式碼架構。

實體和用例

乾淨程式碼架構的核心是實體和用例。實體是系統中的核心物件（例如貼文或使用者），使用案例定義了您可以使用這些實體執行的操作（例如建立貼文或刪除使用者）。

在 Laravel 中，實體可以表示為 Eloquent 模型，而用例通常是在這些模型上執行特定操作的服務。

例如，讓我們建立一個簡單的用例來建立部落格文章：

// app/Domain/Post/Post.php
class Post {
    private $title;
    private $content;

    public function __construct($title, $content) {
        $this->title = $title;
        $this->content = $content;
    }

    // Getter methods and other domain logic
}

登入後複製

這是建立新貼文的用例：

// app/Services/Post/CreatePostService.php
class CreatePostService {
    private $postRepository;

    public function __construct(PostRepositoryInterface $postRepository) {
        $this->postRepository = $postRepository;
    }

    public function execute($data) {
        $post = new Post($data['title'], $data['content']);
        $this->postRepository->save($post);
    }
}

登入後複製

儲存庫和介面

在乾淨的程式碼架構中，儲存庫處理資料訪問，介面定義儲存庫應實現的方法。這樣，您的業務邏輯不依賴您正在使用的資料庫或 ORM，而是依賴抽象。

讓我們為 PostRepository 建立一個介面：

// app/Repositories/PostRepositoryInterface.php
interface PostRepositoryInterface {
    public function save(Post $post): void;
    public function findById($id): ?Post;
}

登入後複製

以及此儲存庫的 Eloquent 實作：

// app/Repositories/EloquentPostRepository.php
class EloquentPostRepository implements PostRepositoryInterface {
    public function save(Post $post): void {
        // Save post using Eloquent
    }

    public function findById($id): ?Post {
        // Fetch post using Eloquent
    }
}

登入後複製

控制器和依賴注入

您的控制器應該很薄，這意味著它們應該只處理HTTP請求並將繁重的工作委託給服務。透過使用依賴注入，您可以將必要的服務注入到您的控制器中。

// app/Http/Controllers/PostController.php
class PostController {
    private $createPostService;

    public function __construct(CreatePostService $createPostService) {
        $this->createPostService = $createPostService;
    }

    public function store(Request $request) {
        $this->createPostService->execute($request->all());
        return response()->json(['message' => 'Post created!']);
    }
}

登入後複製

服務和業務邏輯

所有業務邏輯都應該存在於服務中。這可以使您的控制器保持乾淨，並確保您的邏輯可以在應用程式的不同部分中重複使用。

// app/Services/Post/CreatePostService.php
class CreatePostService {
    private $postRepository;

    public function __construct(PostRepositoryInterface $postRepository) {
        $this->postRepository = $postRepository;
    }

    public function execute($data) {
        $post = new Post($data['title'], $data['content']);
        $this->postRepository->save($post);
    }
}

登入後複製

真實範例：建立部落格平台

讓我們來看看建立簡單部落格平台的真實範例。以下是如何使用乾淨的程式碼架構來建構它：

實體：您的貼文和使用者模型。
Repositories：PostRepositoryInterface 和 UserRepositoryInterface 等接口，以及 EloquentPostRepository 等實作。
服務：CreatePostService、DeletePostService等
控制器：將工作委託給服務的瘦控制器。

這種分離可確保您的程式碼保持模組化且易於測試。例如，如果您決定從 Eloquent 切換到另一個 ORM，您只需要更新儲存庫實現，而不是整個應用程式。