ims-laravel-admin-starter
強力な Laravel 10 フレームワークと Filment 3 を使用して構築された、合理化された管理パネルと API スターター アプリケーションです。
私たちの主な焦点は、手間のかからないすぐに使えるローカル開発スターター プロジェクトを提供することです。
従来の 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 " />
テストを実行します。
テストを実行するには 2 つの便利なオプションがあります。
ペストの使用:
素晴らしい PHP テスト フレームワークである Pest を使用してテストを実行します。次のコマンドを実行するだけです。
./vendor/bin/pest
Sail で実行している場合は、次のコマンドを使用できます。
./vendor/bin/sail test
# or if you have an alias configured:
sail test
アーティザンの使用:
Laravel の 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
],
この変更により、デバッグバーがビュー データを収集して表示できなくなります。これにより、特に開発環境でのアプリケーションのパフォーマンスの向上に役立ちます。
このプロジェクトでは、ワークフローを簡素化し、生産性を向上させるための追加のアーティザン コマンドが提供されます。
以下を実行して、コードのオートコンプリートとナビゲーションを改善するための一般的な 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
subfolder と ServiceName を実際に必要な値に置き換えます。サブフォルダーなしでサービスを作成することもできます。
php artisan make:service TestService
新しく作成されたサービスはapp/Http/Services/TestService.php
に配置され、アプリケーションのビジネス ロジックを処理できるようになります。
トレイトは、コードの構成を強化する再利用可能なコード コンポーネントです。新しい特性を作成するには、次を実行するだけです。
php artisan make:trait TestTrait
このコマンドは、プロジェクトの新しい特性ファイルを生成し、コードの再利用性と保守性を促進します。
これらの Artisan コマンドを活用して、開発プロセスを合理化し、適切に構造化されたコードベースを維持します。
このプロジェクトは Innovix Matrix System によって提供され、MIT ライセンスの下でオープンソース ソフトウェアとしてリリースされています。
MIT ライセンス条項に従って、このスターター プロジェクトを自由に使用、変更、配布してください。このプロジェクトをさらに改善するために、私たちはコラボレーションを奨励し、コミュニティからの貢献を歓迎します。