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 许可条款随意使用、修改和分发此入门项目。我们鼓励合作并欢迎社区做出贡献,以使该项目变得更好。