ims-laravel-admin-starter
是一個簡化的管理面板和 API 入門應用程序,使用強大的 Laravel 10 框架和 Filment 3 構建。
我們的主要重點是為您提供一個無憂且隨時可用的本地開發入門專案。
與傳統的 API 產生器或程式碼產生器不同,此專案簡化了設定本機開發環境的過程。它使您能夠快速啟動基於 Laravel 的 API 開發和管理面板開發,而不會產生不必要的複雜性。這使您可以專注於建立應用程式邏輯,而不是花費時間進行初始設定。
完整的身份驗證系統:使用 Laravel Jetstream 套件實現強大的身份驗證系統,以實現安全的使用者管理和登入功能。
基於角色和權限的授權系統:使用 Laravel-Permission 套件建立靈活的授權系統,讓您可以定義角色和權限以進行細粒度的存取控制。
用戶管理:有效管理用戶,包括用戶註冊、個人資料更新和用戶角色。
個人資料設定:使用戶能夠自訂他們的個人資料,包括個人資訊和偏好設定。
多語言支援:借助 Filament Translations 和 Laravel Lang 套件的多語言支持,讓全球受眾可以存取您的應用程式。
主題客製化:使用 Tailwind CSS 的強大功能自訂應用程式的外觀和使用者介面,以創建具有視覺吸引力的設計。
Docker 支援:利用 Laravel Sail 的便利性,在 Docker 容器中輕鬆部署和管理您的應用程序,以簡化開發和部署工作流程。
選擇您的本機開發工具:
選擇您首選的本機開發工具,例如 Laragon、XAMPP、WAMP 或任何其他適合您需求的工具。
配置您的環境:
使用正確的資料庫憑證更新您的.env
檔案。
安裝依賴項:
執行以下命令以使用 Composer 安裝所需的依賴項:
composer install
執行以下命令以使用 npm 安裝所需的依賴項並建置它們:
npm install
npm run build
遷移資料庫並為其設定種子:使用以下命令使用預設資料初始化資料庫並為其設定種子:
php artisan migrate --seed
現在,您的項目已可供使用。您可以透過提供的路線存取管理面板。如果您已執行種子命令,請使用提供的憑證登入。根據需要自訂和擴展您的應用程式。
使用提供的說明設定專案後,您可以透過存取 Web 瀏覽器中的/admin
路徑來存取管理面板。
如果您在設定過程中執行了種子命令,則可以使用下列憑證登入:
email: [email protected]
password: 123456
email: [email protected]
password: 123456
ims-laravel-admin-starter
支援基於角色和權限的操作,以控制對管理面板中各種功能的存取。您可以定義具有特定權限的角色,並根據需要將其指派給使用者。
探索這個專案並體驗為基於 Laravel 的 API 和管理面板提供現成的本地開發環境的便利性。
透過採用多種語言來提高此入門專案的可訪問性和使用者友善性。在 Filament Translations 和 Laravel Lang 套件的幫助下,這個入門計畫提供了全面的多語言支援。
有關使用多種語言和翻譯的詳細指南,請造訪我們的專用 wiki 頁面。
透過無縫語言在地化開啟充滿可能性的世界,確保您的應用程式與全球受眾產生共鳴。
如需更全面的指南,請造訪 GitHub 上的 WIKI 頁面:
使用 Docker 和 Laravel Sail 運行應用程式 - Wiki
此詳細資源提供了逐步說明和附加信息,以確保使用 Docker 和 Laravel Sail 設置和運行應用程式時獲得流暢的體驗。
為了確保應用程式的可靠性和正確性,執行測試至關重要。請依照以下簡單步驟操作:
建立一個單獨的測試資料庫:
首先為您的應用程式建立專用的測試資料庫。您可以將其命名為ims-admin-testing
以使其與生產資料庫區分開來。
如果您使用 Docker 和 Laravel Sail,則可以跳過此步驟,而是更新 phpunit.xml 檔案以新增測試資料庫:
< env name = " DB_DATABASE " value = " testing " />
運行測試:
您有兩個方便的選項來執行測試:
使用害蟲:
使用 Pest(一個令人愉快的 PHP 測試框架)執行測試。只需執行以下命令:
./vendor/bin/pest
如果您正在使用 Sail 運行,則可以使用以下命令:
./vendor/bin/sail test
# or if you have an alias configured:
sail test
使用工匠:
Laravel 的 Artisan 命令列工具提供無縫測試功能。使用以下 Artisan 命令執行測試:
php artisan test
如果您正在執行 Sail,則可以使用以下命令:
./vendor/bin/sail artisan test
# or if you have an alias configured:
sail artisan test
運行測試對於確保應用程式功能的可靠性和正確性至關重要。上述命令將啟動測試過程,並為您提供有關程式碼庫品質的寶貴見解。
長絲的一些性能技巧
要優化 Filament 應用程式的效能,您可以使用php artisan icons:cache
命令來快取圖示。此命令會預先載入並快取應用程式中使用的圖標,從而加快載入時間。
php artisan icons:cache
如果您遇到效能問題並希望加快應用程式的速度,請考慮停用偵錯欄中的視圖集合功能。您可以這樣做:
導覽至位於應用程式的config
目錄中的debugbar.php
設定檔。
在debugbar.php
檔案中,您將找到一個名為collectors
陣列。在此數組中找到'views'
收集器。
若要停用視圖集合,只需將'views'
收集器設為false
,如下所示:
' collectors ' => [
...
' views ' => false, // Views with their data
],
此變更將阻止偵錯欄收集和顯示視圖數據,這有助於提高應用程式的效能,特別是在開發環境中。
該專案提供了額外的 Artisan 命令來簡化您的工作流程並提高生產力。
透過執行以下命令產生通用 IDE 幫助程式檔案以改進程式碼自動完成和導航:
php artisan ide-helper:generate
使用以下命令產生 IDE 模型幫助程式檔案而不寫入模型檔案:
# use any one of this two commands
php artisan ide-helper:models -N
php artisan ide-helper:models --nowrite
php artisan csfixer:run
此命令可確保您的程式碼遵循預先定義的編碼標準,使您的程式碼庫乾淨且可讀。
為您的應用程式創建服務變得毫不費力。使用以下命令產生服務:
php artisan make:service subfolder/ServiceName
將子資料夾和 ServiceName 替換為您需要的實際值。您也可以建立沒有子資料夾的服務:
php artisan make:service TestService
新建立的服務將位於app/Http/Services/TestService.php
,準備好處理應用程式的業務邏輯。
特徵是可重複使用的程式碼元件,可以增強程式碼組織。要建立新特徵,只需運行:
php artisan make:trait TestTrait
此命令為您的專案產生一個新的特徵文件,從而提高程式碼的可重複使用性和可維護性。
利用這些 Artisan 命令來簡化您的開發流程並維護結構良好的程式碼庫。
該專案由 Innovix Matrix System 提供,並根據 MIT 許可證作為開源軟體發布。
請根據 MIT 授權條款隨意使用、修改和分發此入門項目。我們鼓勵合作並歡迎社區做出貢獻,以使該計畫變得更好。