在 Laravel 中,自訂 Helper 是一種方便的方式來封裝常用的功能或邏輯,使其可以在整個應用程式中被輕鬆調用。以下是如何在 Laravel 中創建自訂 Helper 的步驟:
1. 創建自訂 Helper 檔案
你可以在 app
目錄或 app/Helpers
目錄(如果尚不存在,可以自行創建)中建立一個新的 PHP 檔案。例如,建立一個 app/Helpers/helpers.php
檔案。
<?php
if (!function_exists('your_helper_function')) {
function your_helper_function($param) {
// 你的邏輯
return "Hello, " . $param;
}
}
在這裡,your_helper_function
是自訂的 Helper 函數名。function_exists
用於避免多次定義該函數。
2. 自動加載自訂 Helper
要確保 Laravel 能夠自動加載這個 Helper,你需要在 composer.json
文件中進行配置。
打開 composer.json
,在 autoload
部分添加 files
選項:
"autoload": {
"psr-4": {
"App\\": "app/"
},
"files": [
"app/Helpers/helpers.php"
]
},
這樣,Laravel 就會自動加載你定義的 Helper 檔案。
3. 更新 Composer 自動加載配置
添加 Helper 檔案後,你需要執行以下命令來更新 Composer 的自動加載配置:
composer dump-autoload
這個命令會重新生成 Composer 的自動加載檔案,確保你的自訂 Helper 檔案能夠被正確載入。
4. 使用自訂 Helper
現在,你可以在 Laravel 的任何地方使用你自訂的 Helper 函數。例如:
echo your_helper_function('World'); // 輸出 "Hello, World"
這樣就完成了在 Laravel 中創建和使用自訂 Helper 的步驟。你可以根據需要在 helpers.php
檔案中添加更多的 Helper 函數。