ims-laravel-admin-starter
est un panneau d'administration simplifié et une application de démarrage d'API construite à l'aide du puissant framework Laravel 10 et de Filment 3.
Notre objectif principal est de vous fournir un projet de démarrage de développement local sans tracas et prêt à l’emploi.
Contrairement aux générateurs d'API ou aux générateurs de code traditionnels, ce projet simplifie le processus de configuration de votre environnement de développement local. Il vous permet de relancer le développement de votre API basée sur Laravel et le développement de votre panneau d'administration sans complexités inutiles. Cela vous permet de vous concentrer sur la création de la logique de votre application plutôt que de consacrer du temps à la configuration initiale.
Système d'authentification complet : implémentez un système d'authentification robuste à l'aide du package Laravel Jetstream pour une gestion sécurisée des utilisateurs et une fonctionnalité de connexion.
Système d'autorisation basé sur les rôles et les autorisations : créez un système d'autorisation flexible à l'aide du package Laravel-Permission, vous permettant de définir des rôles et des autorisations pour un contrôle d'accès précis.
Gestion des utilisateurs : gérez efficacement les utilisateurs, y compris l'enregistrement des utilisateurs, les mises à jour de profil et les rôles d'utilisateur.
Paramètres de profil : permettent aux utilisateurs de personnaliser leurs profils, y compris leurs informations personnelles et leurs préférences.
Prise en charge de plusieurs langues : rendez votre application accessible à un public mondial à l'aide des packages Filament Translations et Laravel Lang pour une prise en charge multilingue.
Personnalisation du thème : personnalisez l'apparence et l'interface utilisateur de l'application en utilisant la puissance de Tailwind CSS pour créer des designs visuellement attrayants.
Prise en charge Docker : déployez et gérez facilement votre application dans un conteneur Docker grâce à la commodité de Laravel Sail pour des flux de développement et de déploiement rationalisés.
Choisissez votre outil de développement local :
Sélectionnez votre outil de développement local préféré, tel que Laragon, XAMPP, WAMP ou tout autre outil adapté à vos besoins.
Configurez votre environnement :
Mettez à jour votre fichier .env
avec les informations d'identification de base de données correctes.
Installer les dépendances :
Exécutez la commande suivante pour installer les dépendances requises à l'aide de Composer :
composer install
Exécutez la commande suivante pour installer les dépendances requises à l'aide de npm et créez-les :
npm install
npm run build
Migrer et amorcer la base de données : initialisez et amorcez la base de données avec les données par défaut en utilisant :
php artisan migrate --seed
Maintenant, votre projet est prêt à être utilisé. Vous pouvez accéder au panneau d'administration via l'itinéraire fourni. Si vous avez exécuté la commande seed, connectez-vous avec les informations d'identification fournies. Personnalisez et développez votre application selon vos besoins.
Une fois que vous avez configuré le projet à l'aide des instructions fournies, vous pouvez accéder au panneau d'administration en visitant la route /admin
dans votre navigateur Web.
Si vous avez exécuté la commande seed pendant le processus d'installation, vous pouvez vous connecter à l'aide des informations d'identification suivantes :
email: [email protected]
password: 123456
email: [email protected]
password: 123456
Le ims-laravel-admin-starter
prend en charge les opérations basées sur les rôles et les autorisations pour contrôler l'accès à diverses fonctionnalités de votre panneau d'administration. Vous pouvez définir des rôles avec des autorisations spécifiques et les attribuer aux utilisateurs selon vos besoins.
Explorez ce projet et découvrez la commodité d'un environnement de développement local prêt à l'emploi pour vos API et panneaux d'administration basés sur Laravel.
Améliorez l'accessibilité et la convivialité de ce projet de démarrage en adoptant plusieurs langues. Avec l'aide de Filament Translations et du package Laravel Lang, ce projet Starter offre un support multilingue complet.
Pour un guide détaillé sur l’utilisation de plusieurs langues et traductions, visitez notre page wiki dédiée.
Débloquez un monde de possibilités grâce à une localisation linguistique transparente, garantissant que votre application trouvera un écho auprès d'un public mondial.
Pour un guide plus complet, veuillez visiter la page WIKI sur GitHub :
Exécuter l'application avec Docker et Laravel Sail - Wiki
Cette ressource détaillée fournit des instructions étape par étape et des informations supplémentaires pour garantir une expérience fluide lors de la configuration et de l'exécution de votre application avec Docker et Laravel Sail.
Pour garantir la fiabilité et l'exactitude de votre application, il est essentiel d'exécuter des tests. Suivez ces étapes simples :
Créez une base de données de test distincte :
Commencez par créer une base de données de tests dédiée à votre application. Vous pouvez le nommer ims-admin-testing
pour le distinguer de votre base de données de production.
Si vous utilisez Docker et Laravel Sail, vous pouvez ignorer cette étape et mettre à jour le fichier phpunit.xml pour ajouter une base de données de test :
< env name = " DB_DATABASE " value = " testing " />
Exécuter des tests :
Vous disposez de deux options pratiques pour exécuter des tests :
Utiliser Pest :
Exécutez des tests avec Pest, un délicieux framework de test PHP. Exécutez simplement la commande suivante :
./vendor/bin/pest
Si vous utilisez Sail, vous pouvez utiliser cette commande :
./vendor/bin/sail test
# or if you have an alias configured:
sail test
Utiliser Artisan :
L'outil de ligne de commande Artisan de Laravel offre des capacités de test transparentes. Exécutez les tests avec la commande Artisan suivante :
php artisan test
Si vous exécutez Sail, vous pouvez utiliser cette commande :
./vendor/bin/sail artisan test
# or if you have an alias configured:
sail artisan test
L'exécution de tests est cruciale pour garantir la fiabilité et l'exactitude des fonctionnalités de votre application. Les commandes ci-dessus lanceront le processus de test et vous fourniront des informations précieuses sur la qualité de votre base de code.
Quelques conseils de performances pour le filament
Pour optimiser les performances de l'application Filament, vous pouvez utiliser la commande php artisan icons:cache
pour mettre en cache les icônes. Cette commande précharge et met en cache les icônes utilisées dans votre application, ce qui accélère les temps de chargement.
php artisan icons:cache
Si vous rencontrez des problèmes de performances et souhaitez accélérer votre application, envisagez de désactiver la fonctionnalité de collecte de vues dans la barre de débogage. Voici comment procéder :
Accédez au fichier de configuration debugbar.php
situé dans le répertoire config
de votre application.
Dans le fichier debugbar.php
, vous trouverez un tableau nommé collectors
. Localisez le collecteur 'views'
dans ce tableau.
Pour désactiver la collection de vues, définissez simplement le collecteur 'views'
sur false
, comme ceci :
' collectors ' => [
...
' views ' => false, // Views with their data
],
Cette modification empêchera la barre de débogage de collecter et d'afficher les données d'affichage, ce qui peut contribuer à améliorer les performances de votre application, en particulier dans un environnement de développement.
Ce projet fournit des commandes Artisan supplémentaires pour simplifier votre flux de travail et améliorer la productivité.
Générez des fichiers d'assistance généraux de l'IDE pour améliorer la saisie semi-automatique et la navigation du code en exécutant :
php artisan ide-helper:generate
Générez des fichiers d'assistance de modèle IDE sans écrire dans les fichiers de modèle en utilisant :
# use any one of this two commands
php artisan ide-helper:models -N
php artisan ide-helper:models --nowrite
php artisan csfixer:run
Cette commande garantit que votre code adhère aux normes de codage prédéfinies, rendant votre base de code propre et lisible.
La création de services pour votre application se fait sans effort. Utilisez la commande suivante pour générer un service :
php artisan make:service subfolder/ServiceName
Remplacez subfolder et ServiceName par les valeurs réelles dont vous avez besoin. Vous pouvez également créer un service sans sous-dossier :
php artisan make:service TestService
Le service nouvellement créé sera situé dans app/Http/Services/TestService.php
, prêt à gérer la logique métier de votre application.
Les traits sont des composants de code réutilisables qui améliorent l'organisation du code. Pour créer un nouveau trait, exécutez simplement :
php artisan make:trait TestTrait
Cette commande génère un nouveau fichier de caractéristiques pour votre projet, favorisant la réutilisabilité et la maintenabilité du code.
Tirez parti de ces commandes Artisan pour rationaliser votre processus de développement et maintenir une base de code bien structurée.
Ce projet vous est présenté par Innovix Matrix System et est publié en tant que logiciel open source sous licence MIT.
N'hésitez pas à utiliser, modifier et distribuer ce projet de démarrage conformément aux termes de la licence MIT. Nous encourageons la collaboration et apprécions les contributions de la communauté pour rendre ce projet encore meilleur.