HulaCWMS有專門為開發過程而設置的調試模式,開啟調試模式后,會犧牲一定的執行效率,但帶來的方便和除錯功能非常值得。
> 強烈建議在開發階段始終開啟調試模式(直到正式部署后關閉調試模式),方便及時發現隱患問題和分析、解決問題。
應用默認是部署模式,在開發階段,可以修改應用配置文件`app.php`中的`app_debug`參數(或者環境變量`APP_DEBUG`)開啟調試模式,上線部署后切換到部署模式。
~~~
// 開啟調試模式
'app_debug' => true,
~~~
> 在模塊配置文件中設置調試模式無效
除此之外,還可以在應用根目錄下面定義`.env`文件,并且定義`APP_DEBUG`環境變量參數,這樣便于在部署環境中設置環境變量來開啟和關閉調試模式。
`.env`文件的定義格式如下:
~~~
// 設置開啟調試模式
APP_DEBUG = true
// 其它的環境變量設置
// ...
~~~
> 定義了`.env`文件后,配置文件中定義`app_debug`參數無效。
調試模式的優勢在于:
* 開啟日志記錄,任何錯誤信息和調試信息都會詳細記錄,便于調試;
* 會詳細記錄整個執行過程;
* 模板修改可以即時生效;
* 記錄SQL日志,方便分析SQL;
* 通過Trace功能更好的調試和發現錯誤;
* 發生異常的時候會顯示詳細的異常信息;
> 由于調試模式沒有任何緩存,因此涉及到較多的文件IO操作和模板實時編譯,所以在開啟調試模式的情況下,性能會有一定的下降,但不會影響部署模式的性能。
一旦關閉調試模式,發生錯誤后不會提示具體的錯誤信息,如果你仍然希望看到具體的錯誤信息,那么可以在`app.php`文件中如下設置:
~~~
// 顯示錯誤信息
'show_error_msg' => true,
~~~
>[danger]在網站正式發布時,不要忘記關閉調試模式!