最近在開發一個內容管理系統（cms）項目時，我遇到了一個普遍的難題：如何讓系統中的某些行為，例如內容顯示規則、權限判斷或特定組件的渲染邏輯，能夠被靈活配置，而不是硬生生地寫死在 php 代碼里？
想象一下這樣的場景：一個內容區塊需要根據當前用戶的角色、某個特定日期，甚至頁面上的其他數據來決定是否顯示。如果每次這種邏輯調整都需要后端開發人員修改代碼、測試、部署，那么開發效率和系統的靈活性都會大打折扣。我嘗試過在數據庫中存儲簡單的配置，但對于復雜的條件判斷，這很快就變得難以管理。我需要一種更強大、更富有表現力的“語言”，讓非技術人員也能在一定程度上定義這些規則，或者至少讓開發者能夠以更清晰、更集中的方式管理它們。
我的困境：硬編碼的泥潭
在遇到 Neos Eel 之前，我的解決方案通常是：
- 大量的 if/else 語句： 在模板或控制器中堆砌復雜的條件判斷，導致代碼臃腫、難以閱讀和維護。
- 配置項爆炸： 為每個可能的條件設置單獨的配置項，使得配置表變得龐大且缺乏關聯性。
- 缺乏靈活性： 業務邏輯與代碼緊密耦合，任何微小的調整都可能引發連鎖反應，需要重新部署。
這讓我意識到，我需要一個能夠將“表達式”嵌入到我的應用程序中的工具，讓這些表達式能夠被解析并執行，從而實現動態的、可配置的邏輯。
composer 的指引：發現 Neos Eel
在尋找解決方案的過程中，我自然而然地想到了 Composer。作為 PHP 生態系統中的包管理器，Composer 總是能幫助我找到并集成各種強大的庫。我開始搜索與“表達式語言”、“DSL（領域特定語言）”相關的庫，最終，neos/eel 引起了我的注意。
通過簡單的 Composer 命令：
composer require neos/eel
我就能將這個強大的工具引入我的項目。Composer 不僅處理了依賴關系，還自動生成了自動加載文件，讓我可以立即開始使用 Neos Eel。
Neos Eel：構建你的領域特定語言
Neos Eel，全稱 Embedded Expression Language，顧名思義，它是一種嵌入式的表達式語言。它最核心的價值在于，它是一個構建領域特定語言（DSL）的基石。這意味著你可以用一種更接近自然語言或特定業務領域的方式來表達邏輯和規則，而無需深入復雜的 PHP 代碼。
雖然 neos/eel 本身是 Neos Flow 框架的一部分，但它被設計為可獨立使用的組件。它的主要特點包括：
- 簡潔的語法： 允許你用非常簡潔的表達式來表示復雜的邏輯。
- 強大的功能： 支持變量、函數調用、條件判斷、集合操作等。
- 可擴展性： 你可以定義自己的函數和變量，將 PHP 的能力暴露給 Eel 表達式。
Neos Eel 如何解決我的問題
有了 Neos Eel，我能夠將之前硬編碼在 PHP 中的邏輯，以一種更聲明式、更易讀的方式表達出來。
例如，以前我可能需要這樣的 PHP 代碼：
// 偽代碼 if ($currentUser->hasRole('admin') && $article->isPublished() && $article->getPublishDate() <= new DateTime()) { // 顯示文章 } else { // 隱藏文章 }
現在，我可以通過 Neos Eel 表達式來定義這個邏輯，并將其存儲在配置、模板或數據庫中：
// 偽代碼：一個Eel表達式示例 ${currentUser.hasRole('admin') && article.isPublished() && article.publishDate <= Date.now()}
在我的 PHP 代碼中，我只需要解析并執行這個 Eel 表達式即可：
use NeosEelCompilingEvaluator; use NeosEelContext; // 假設你已經有了上下文數據 $contextVariables = [ 'currentUser' => $currentUserObject, 'article' => $articleObject, 'Date' => new DateTimeImmutable(), // 模擬Eel中的Date對象 ]; $evaluator = new CompilingEvaluator(); $context = new Context($contextVariables); $expression = '${currentUser.hasRole("admin") && article.isPublished() && article.publishDate <= Date.now()}'; // 假設你有一個解析表達式的函數或服務 $result = $evaluator->evaluate($expression, $context); if ($result) { // 顯示文章 } else { // 隱藏文章 }
通過這種方式，業務邏輯被“外部化”了。當規則需要改變時，我只需修改 Eel 表達式，而無需觸碰核心 PHP 代碼。
Neos Eel 帶來的優勢和實際應用效果
- 極大的靈活性與可配置性： 業務邏輯不再是硬編碼，可以存儲在配置文件、數據庫甚至用戶界面中，實現真正的運行時配置。
- 提高代碼清晰度與可維護性： 將復雜的業務規則從 PHP 代碼中剝離出來，使得核心代碼更加專注于業務流程，而表達式則專注于規則定義。這大大提高了代碼的可讀性和維護性。
- 賦能非技術人員： 在適當的封裝下，產品經理或內容編輯可以在不修改代碼的情況下，通過簡單的 Eel 表達式來調整內容展示、表單校驗等邏輯，提升了團隊協作效率。
- 減少部署頻率： 很多邏輯調整不再需要代碼發布，只需更新配置或數據庫中的表達式即可，大大加快了迭代速度。
- 構建真正的 DSL： Neos Eel 提供了構建更高級別 DSL 的基礎，例如，你可以基于它為特定的業務領域（如電商促銷規則、金融風險評估）開發一套專用的表達式語法和功能。
總結
解決硬編碼邏輯的痛點，是提升應用靈活性和可維護性的關鍵一步。通過 Composer 引入 neos/eel，我不僅找到了一個強大的嵌入式表達式語言，更重要的是，它為我打開了構建領域特定語言的大門。現在，我的應用程序能夠以更優雅、更靈活的方式響應業務變化，而開發者也能從繁瑣的邏輯修改中解脫出來，專注于更核心的開發任務。如果你也面臨類似的挑戰，不妨嘗試一下 Neos Eel，它可能會成為你項目中的“秘密武器”。
