Laravel - 錯誤與日誌記錄

Hello, aspiring developers! Today, we're going to dive into the world of errors and logging in Laravel. Don't worry if you're new to programming – I'll guide you through this step-by-step, just like I've done for countless students over the years. Let's embark on this exciting journey together!

Laravel - Errors & Logging

錯誤

理解 Laravel 中的錯誤

錯誤是編程中不可避免的。它們就像是創造出色應用程序道路上的一個個小丘陵。但別擔心！Laravel 為我們提供了強大的工具來順利處理這些丘陵。

錯誤類型

在 Laravel 中，我們通常會遇到三種主要的錯誤類型：

异常 (Exceptions)
HTTP 錯誤
PHP 錯誤

讓我們詳細看看每一種。

异常

異常是代表你代碼中錯誤的特殊對象。把它們想像成當出現問題時會彈出的紅色旗幟。

以下是如何抛出異常的簡單示例：

if ($user->age < 18) {
throw new Exception('You must be 18 or older to access this page.');
}

在這段代碼中，如果用戶年齡小於18歲，我們將抛出一個帶有自定義信息的異常。這就像是對未成年用戶設置一個"禁止進入"的標誌！

HTTP 錯誤

HTTP 錯誤是特定於網絡應用程序的。它們是當網頁無法正確加載時出現的錯誤。Laravel 讓我們能夠輕鬆處理這些錯誤。

例如，創建一個自定義的 404（找不到）錯誤頁面：

在 resources/views/errors 目錄下創建一個名為 404.blade.php 的文件。
將你的自定義 HTML 添加到這個文件：

<h1>Oops! Page Not Found</h1>
<p>Sorry, the page you're looking for doesn't exist.</p>

現在，每當發生 404 錯誤時，Laravel 將自動顯示這個自定義頁面。這就像是為你的網站訪客創建一個友好的"失物招領"區域！

PHP 錯誤

PHP 錯誤是最基本的錯誤類型。它們發生在 PHP 代碼本身有問題時。Laravel 幫助我們優雅地處理這些錯誤。

要自定義 Laravel 如何處理 PHP 錯誤，你可以修改 app/Exceptions/Handler.php 文件：

public function register()
{
$this->reportable(function (Throwable $e) {
// 自定義錯誤報告邏輯在這裡
});
}

這讓你可以為處理 PHP 錯誤添加自定義邏輯。這就像是有一個私人助理來處理任何意外的問題！

日誌記錄

現在我們已經介紹了錯誤，讓我們來聊聊日誌記錄。日誌記錄就像是為你的應用程序保存日記 - 它幫助你跟蹤幕後發生的事情。

配置日誌記錄

Laravel 使用强大的 Monolog 库進行日誌記錄。你可以在 config/logging.php 文件中配置日誌記錄選項。

以下是如何設置自定義日誌通道的示例：

'channels' => [
'custom' => [
'driver' => 'single',
'path' => storage_path('logs/custom.log'),
'level' => 'debug',
],
],

這創建了一個名為 'custom' 的新日誌通道，將信息寫入名為 custom.log 的文件。這就像是為你想要跟踪的特定信息創建一個特殊的筆記本！

寫入日誌信息

在 Laravel 中寫入日誌非常簡單。以下是一些示例：

Log::info('User logged in successfully');
Log::warning('Invalid login attempt');
Log::error('Payment failed', ['user_id' => $user->id]);

這些行寫入不同類型的日誌信息。這就像是為自己（或未來的開發者）留下關於應用程序中發生的事情的筆記。

日誌等級

Laravel 支持多種日誌等級，每個等級表示記錄事件的嚴重程度不同。以下是从最不嚴重到最嚴重的日誌等級：

等級	描述
DEBUG	詳細的調試信息
INFO	有趣的事件，如用戶登錄
NOTICE	正常但重要的事件
WARNING	不尋常的發生，但不是錯誤
ERROR	不需要立即行動的運行時錯誤
CRITICAL	關鍵條件，如組件不可用
ALERT	必須立即採取行動
EMERGENCY	系統不可用

根據事件的重要性選擇合適的等級。這就像是為你的學習筆記的不同部分選擇正確顏色的荧光筆！

查看日誌

默認情況下，Laravel 將日誌存儲在 storage/logs 目錄中。你可以使用任何文本編輯器查看這些日誌。為了更加用戶友好，你可以使用 Laravel 內置的 tail 命令：

php artisan log:tail

這個命令將實時顯示新的日誌條目，就像是觀看應用程序日記的直播！

結論

And there you have it, folks! We've journeyed through the land of errors and logging in Laravel. Remember, errors are not your enemies – they're opportunities to improve your code. And logging is your trusty sidekick, always there to help you understand what's happening in your application.

As you continue your Laravel adventure, don't be afraid to make mistakes. Every error is a chance to learn something new. Keep coding, keep logging, and most importantly, keep having fun!

Happy coding, future Laravel masters! ??‍??‍?



注意：由於原文是英文，並且包含一些不適合直譯的元素（如結尾的呼籲語句），在翻譯時我尽量保留了原文的語氣和風格，同時確保了翻譯的準確性。

Credits: Image by storyset