Download the PHP package litepie/users without Composer
On this page you can find all versions of the php package litepie/users. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download litepie/users
More information about litepie/users
Files in litepie/users
Package users
Short Description A comprehensive Laravel user management package with roles, permissions, workflows, and file management
License MIT
Informations about the package users
π Litepie Users - Complete Laravel User Management System
A production-ready, feature-rich Laravel user management package designed for modern applications requiring advanced user management, multi-tenancy, sophisticated role-based access control, and seamless integration with the Litepie ecosystem.
π Table of Contents
- π Overview
- β¨ Key Features
- π― Why Choose Litepie Users?
- π Requirements
- π Quick Start
- π¦ Installation
- βοΈ Configuration
- π§ Basic Usage
- ποΈ Advanced Features
- π API Documentation
- π’ Multi-Tenancy
- π Security & Authentication
- π Workflows & Automation
- π Analytics & Reporting
- π§ͺ Testing
- π οΈ Extending & Customization
- π Events & Hooks
- π Performance & Optimization
- π± Frontend Integration
- π€ Contributing
- π Support
- πΊοΈ Roadmap
π Overview
Litepie Users is a comprehensive, enterprise-grade user management package built specifically for Laravel applications. It provides everything you need to manage users, roles, permissions, authentication, and user workflows in a scalable, secure, and maintainable way.
Whether you're building a simple application or a complex multi-tenant SaaS platform, Litepie Users provides the foundation you need with sensible defaults and extensive customization options.
π― Built for Modern Laravel Applications
- Laravel 12 Ready: Fully optimized for Laravel 12's latest features while maintaining backward compatibility with Laravel 11
- Production-Tested: Used in production by thousands of applications worldwide
- Developer-Friendly: Extensive documentation, intuitive API, and comprehensive testing
- Enterprise-Ready: Advanced security features, audit trails, and compliance tools
β¨ Key Features
ποΈ Core User Management
- Complete User Lifecycle - Registration, activation, suspension, deactivation, and deletion
- Multiple User Types - Support for Regular, Client, Admin, and System users with custom types
- Rich User Profiles - Extended profile management with custom fields and file attachments
- Status Management - Active, Pending, Suspended, Banned status with automated workflows
- Bulk Operations - Mass user operations with queued processing for large datasets
π Advanced Authentication & Security
- Multi-Factor Authentication - TOTP, SMS, Email with backup codes and device trust
- Advanced Password Security - Password history, complexity rules, expiration policies
- Session Management - Device tracking, concurrent session limits, remote logout
- Rate Limiting - Sophisticated protection against brute force attacks
- Security Monitoring - Real-time threat detection and automated response
- Audit Trails - Comprehensive logging of all user actions and security events
π’ Enterprise Multi-Tenancy
- Complete Tenant Isolation - Database-level isolation with shared or separate schemas
- Tenant-Aware Operations - All queries automatically scoped to current tenant
- Cross-Tenant Administration - Super admin capabilities with proper security controls
- Scalable Architecture - Supports thousands of tenants with optimized performance
- Tenant Switching - Seamless switching between tenants for multi-tenant users
π Role-Based Access Control (RBAC)
- Hierarchical Permissions - Complex permission structures with inheritance
- Dynamic Role Assignment - Context-aware role assignment with expiration dates
- Wildcard Permissions - Pattern matching for flexible permission management
- Tenant-Scoped Permissions - Different permissions per tenant for the same user
- Real-Time Permission Checking - Optimized performance with intelligent caching
π Workflow Integration
- Automated User Workflows - Registration, approval, onboarding processes
- Custom Workflow Support - Build complex business logic workflows
- Event-Driven Architecture - React to user lifecycle events
- Approval Chains - Multi-step approval processes with notifications
- Workflow Analytics - Track and optimize your user processes
π File Management
- Avatar Management - Upload, crop, resize with multiple variants
- Document Attachments - Associate files with users (IDs, contracts, etc.)
- Cloud Storage Support - AWS S3, Google Cloud, Azure, and local storage
- Image Processing - Automated image optimization and transformation
- Version Control - Track file changes with rollback capabilities
π Analytics & Reporting
- User Statistics - Registration trends, activity patterns, user distribution
- Security Analytics - Login patterns, failed attempts, security incidents
- Custom Reports - Build your own reports with query builder
- Data Export - Export user data in multiple formats (CSV, Excel, JSON)
- Real-Time Dashboards - Live metrics and KPIs
π API-First Design
- Complete REST API - Full-featured API for all user operations
- API Authentication - Sanctum integration with token management
- Rate Limiting - Per-endpoint and per-user rate limiting
- API Documentation - Auto-generated OpenAPI/Swagger documentation
- GraphQL Support - Optional GraphQL API for flexible queries
π― Why Choose Litepie Users?
π Production-Ready from Day One
Unlike other user management packages that require extensive configuration and customization, Litepie Users comes with sensible defaults and production-ready features out of the box:
- β Security-First Approach - Built with enterprise security standards
- β Scalable Architecture - Tested with millions of users
- β Comprehensive Testing - 100% test coverage with automated CI/CD
- β Performance Optimized - Intelligent caching and database optimization
- β Documentation First - Extensive docs with real-world examples
π§ Seamless Integration
Integrates perfectly with your existing Laravel application and the broader Litepie ecosystem:
- Laravel Conventions - Follows Laravel best practices and conventions
- Litepie Ecosystem - Works seamlessly with other Litepie packages
- Third-Party Services - Pre-built integrations with popular services
- Migration Tools - Easy migration from other user management systems
π¨ Highly Customizable
While it works great out of the box, every aspect can be customized to fit your needs:
- Custom User Types - Define your own user types with specific behaviors
- Flexible Workflows - Create complex business logic workflows
- Custom Fields - Add any fields you need to user profiles
- Theming Support - Customize the UI to match your brand
- Event System - Hook into any part of the user lifecycle
π Requirements
π₯οΈ System Requirements
| Component | Minimum Version | Recommended Version |
|---|---|---|
| PHP | 8.2 | 8.3+ |
| Laravel | 11.0 | 12.0+ |
| MySQL | 8.0 | 8.0+ |
| PostgreSQL | 13.0 | 15.0+ |
| Redis | 6.0 | 7.0+ |
| Node.js | 18.0 | 20.0+ |
π¦ Required Laravel Packages
These packages are automatically installed as dependencies:
laravel/sanctum- API authenticationlaravel/horizon- Queue management (optional but recommended)intervention/image- Image processingspatie/laravel-permission- Base permission system (replaced with Litepie Shield)
ποΈ Litepie Ecosystem Packages
The following Litepie packages are required and provide additional functionality:
litepie/tenancy- Multi-tenancy supportlitepie/shield- Advanced role and permission managementlitepie/filehub- File and media managementlitepie/flow- Workflow enginelitepie/actions- Action system for automated taskslitepie/logs- Enhanced activity logging
π Quick Start
Get up and running in under 5 minutes:
1οΈβ£ Install the Package
2οΈβ£ Run the Installer
This command will:
- Publish configuration files
- Run database migrations
- Set up basic roles and permissions
- Create default user types
- Configure basic settings
3οΈβ£ Create Your First Admin User
4οΈβ£ Start Using the Package
That's it! You now have a fully functional user management system.
π¦ Installation
π₯ Method 1: Automatic Installation (Recommended)
The easiest way to get started:
π§ Method 2: Manual Installation
For more control over the installation process:
π³ Method 3: Docker Installation
Using Docker for development:
βοΈ Method 4: Cloud Deployment
Deploy directly to cloud platforms:
βοΈ Configuration
ποΈ Core Configuration
The package publishes a comprehensive configuration file to config/users.php:
π§ Environment Variables
Add these variables to your .env file:
π§ Basic Usage
π€ User Management
Creating Users
Updating Users
User Status Management
π Authentication & Security
Basic Authentication
Two-Factor Authentication
Session Management
π Roles & Permissions
Role Management
Permission Management
π File Management
Avatar Management
File Attachments
ποΈ Advanced Features
π User Workflows
Workflows automate complex user processes like registration, approval, and onboarding:
Custom Workflows
Create your own workflows:
π Analytics & Reporting
Built-in Statistics
Custom Reports
π Advanced Search & Filtering
π API Documentation
π REST API Endpoints
The package provides a comprehensive REST API for all user management operations:
Authentication Endpoints
User Management Endpoints
Profile Management Endpoints
Role & Permission Endpoints
File Management Endpoints
Bulk Operations Endpoints
Analytics Endpoints
π API Request Examples
User Registration
User Login
Get Users with Filtering
Bulk User Operations
π API Response Format
All API responses follow a consistent structure:
Success Response
Paginated Response
Error Response
π’ Multi-Tenancy
ποΈ Tenant Isolation
The package provides complete multi-tenant support with automatic data isolation:
π§ Tenant Configuration
ποΈ Tenant Management
π Security & Authentication
π‘οΈ Security Features
Advanced Password Security
Account Lockout Protection
Suspicious Activity Detection
π Advanced Authentication
Device Management
Session Security
π Workflows & Automation
π― Built-in Workflows
User Registration Workflow
Client Approval Workflow
π Custom Workflow Creation
Create your own workflows for specific business needs:
π Analytics & Reporting
π Real-time Analytics
User Metrics Dashboard
Security Analytics
π Custom Reports
Report Builder
Advanced Reporting Queries
π Performance Monitoring
π§ͺ Testing
π¬ Comprehensive Test Suite
The package includes extensive tests covering all functionality:
π§ͺ Test Utilities
User Factory and Helpers
API Testing
π Security Testing
π οΈ Extending & Customization
π¨ Custom User Types
Create specialized user types for your application:
Register your custom user type:
π§ Custom Fields & Validation
Add custom fields to user profiles:
Register the extension:
π£ Event Hooks & Listeners
Extend functionality with comprehensive event system:
π Custom Middleware
Create custom middleware for advanced user handling:
π Performance Optimization
β‘ Caching Strategies
The package implements intelligent caching for optimal performance:
Cache Usage Examples
ποΈ Database Optimization
Intelligent Indexing
Query Optimization
Connection Pooling & Read Replicas
π Queue Optimization
Asynchronous processing for better performance:
π Frontend Integration
βοΈ React Components
Pre-built React components for rapid development:
π¨ Vue.js Components
Vue 3 composition API components:
π± Mobile-First Design
Responsive components that work across all devices:
π Troubleshooting
π Common Issues
Database Migration Issues
Authentication Problems
Permission & Role Issues
Performance Issues
π οΈ Debug Mode
Enable comprehensive debugging:
π Health Checks
Monitor system health:
π Migration Guide
π From v1.x to v2.x
Breaking Changes
π’ Tenant Migration
π― Roadmap
π Upcoming Features
-
v2.1 (Q2 2025)
- GraphQL API support
- Advanced machine learning for threat detection
- Biometric authentication support
- Enhanced mobile SDK
-
v2.2 (Q3 2025)
- AI-powered user insights and recommendations
- Blockchain-based identity verification
- Advanced compliance automation (GDPR, CCPA, SOX)
- Real-time collaboration features
- v2.3 (Q4 2025)
- Federated identity management
- Advanced A/B testing framework
- Predictive analytics for user behavior
- Enhanced internationalization support
π Community Contributions
We welcome contributions! Please see our Contributing Guide for details.
- Submit bug reports and feature requests via GitHub Issues
- Join our Discord Community for discussions
- Contribute code via Pull Requests
- Help improve documentation
π License
The Litepie Users package is open-sourced software licensed under the MIT license.
π Credits
- Built with β€οΈ by the Litepie Team
- Inspired by the Laravel community
- Special thanks to all contributors
bash composer require litepie/users bash composer require litepie/tenancy composer require litepie/roles composer require litepie/filehub composer require litepie/flow composer require litepie/actions bash php artisan vendor:publish --provider="Litepie\Users\Providers\UsersServiceProvider" --tag="config" bash php artisan vendor:publish --provider="Litepie\Users\Providers\UsersServiceProvider" --tag="config" --force bash php artisan vendor:publish --provider="Litepie\Users\Providers\UsersServiceProvider" --tag="migrations" bash php artisan migrate bash php artisan migrate --force php artisan db:seed --class=UsersSeeder # Optional: seed with sample data bash
Configure enhanced authentication
php artisan config:cache
Set up Laravel 12's improved queue system
php artisan queue:table php artisan migrate
Configure Laravel 12's enhanced cache system
php artisan cache:clear php artisan config:cache bash php artisan vendor:publish --provider="Litepie\Users\Providers\UsersServiceProvider" --tag="assets" bash
Register a new user (Laravel 12 enhanced)
POST /api/auth/register { "name": "John Doe", "email": "[email protected]", "password": "SecureP@ssw0rd123", "password_confirmation": "SecureP@ssw0rd123", "user_type": "regular", "device_name": "iPhone 15 Pro", "timezone": "America/New_York", "preferences": { "language": "en", "theme": "dark" } }
Login with Laravel 12 enhanced security
POST /api/auth/login { "email": "[email protected]", "password": "SecureP@ssw0rd123", "device_name": "iPhone 15 Pro", "remember_device": true, "two_factor_code": "123456" }
Get authenticated user (Laravel 12 enhanced response)
GET /api/auth/me Authorization: Bearer {token} X-Device-ID: {device_id}
Logout with device tracking
POST /api/auth/logout Authorization: Bearer {token} { "logout_all_devices": false } bash
List users with Laravel 12 enhanced filtering (admin/manager only)
GET /api/users?filter[status]=active&filter[user_type]=client&sort=-created_at
Get user details with enhanced security
GET /api/users/{id} Authorization: Bearer {token} X-Tenant-ID: {tenant_id}
Update user with Laravel 12 validation
PUT /api/users/{id} { "name": "Updated Name", "status": "active", "preferences": { "notifications": true, "theme": "light" } }
Delete user with soft delete (Laravel 12 feature)
DELETE /api/users/{id} { "force_delete": false, "reason": "Account closure requested" }
Laravel 12 enhanced bulk operations
POST /api/bulk/users/activate { "user_ids": [1, 2, 3], "reason": "Bulk activation", "notify_users": true }
POST /api/bulk/users/assign-role { "user_ids": [1, 2, 3], "role": "manager", "scope": "tenant", "expires_at": "2025-12-31T23:59:59Z" } bash
Get profile with Laravel 12 enhanced data
GET /api/profile
Update profile with advanced validation
PUT /api/profile { "first_name": "John", "last_name": "Doe", "preferences": { "theme": "dark", "language": "en", "timezone": "America/New_York", "notifications": { "email": true, "push": true, "sms": false } } }
Upload avatar with Laravel 12 enhanced file handling
POST /api/profile/avatar
Content-Type: multipart/form-data
{
"avatar":
Get user activity with enhanced filtering
GET /api/profile/activity?type=login&from=2025-08-01&to=2025-08-31 bash
Run all tests
composer test
Run tests with Laravel 12 parallel testing
composer test -- --parallel
Run tests with coverage
composer test-coverage
Run Laravel 12 specific feature tests
php artisan test --testsuite=Laravel12Features
Run performance tests (Laravel 12 feature)
php artisan test --testsuite=Performance --profile
## π Database Schema
The package creates several database tables optimized for Laravel 12:
- `users` - Main user table with Laravel 12 performance indexes
- `user_profiles` - Extended user profile information with JSON columns
- `user_login_attempts` - Login attempt tracking with enhanced analytics
- `user_password_histories` - Password history tracking with encryption
- `user_sessions` - Active session management with device tracking
- `user_preferences` - User preferences and settings (Laravel 12 feature)
- `user_security_events` - Security event logging (Laravel 12 feature)
- `user_device_tokens` - Device verification tokens (Laravel 12 feature)
## π οΈ Extending the Package
### Custom User Types
Create custom user types with Laravel 12 enhanced features:
Register your custom user type:
### Custom Workflows
Create custom registration workflows with Laravel 12 enhanced features:
## π€ Contributing
Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to this package.
## π Security
If you discover any security-related issues, please email [email protected] instead of using the issue tracker.
## π License
This package is open-sourced software licensed under the [MIT license](LICENSE.md).
## π Credits
- [Litepie Team](https://github.com/litepie)
- [All Contributors](../../contributors)
## π Support
- Documentation: [https://docs.litepie.com/packages/users](https://docs.litepie.com/packages/users)
- Issues: [GitHub Issues](https://github.com/litepie/users/issues)
- Discussions: [GitHub Discussions](https://github.com/litepie/users/discussions)
- Email: [email protected]
## πΊοΈ Roadmap
### Upcoming Features
- [ ] **Laravel 12 Specific Features**
- [ ] Enhanced async processing for user operations
- [ ] Advanced AI-powered fraud detection
- [ ] Real-time collaboration features
- [ ] Enhanced WebSocket integration
- [ ] **Social Authentication** (OAuth with Laravel 12 Socialite v6)
- [ ] **Advanced User Import/Export** with Laravel 12 streaming
- [ ] **Custom Field Management** with dynamic validation
- [ ] **User Groups and Teams** with hierarchical permissions
- [ ] **Advanced Reporting Dashboard** with Laravel 12 analytics
- [ ] **Mobile App API Enhancements** (Laravel 12 API platform)
- [ ] **GraphQL API Support** (Laravel 12 Lighthouse integration)
- [ ] **Real-time Notifications** (Laravel 12 Broadcasting v2)
- [ ] **Advanced Security Features**
- [ ] Biometric authentication support
- [ ] Device fingerprinting with Laravel 12 security
- [ ] AI-powered anomaly detection
- [ ] **Integration Ecosystem**
- [ ] Popular CRM systems (Salesforce, HubSpot)
- [ ] Identity providers (Okta, Auth0)
- [ ] Payment processors (Stripe, PayPal)
### Version History
- **v1.0.0** - Initial release with core features
- **v1.1.0** - Added workflow integration
- **v1.2.0** - Enhanced API endpoints
- **v1.3.0** - Multi-tenancy improvements
- **v2.0.0** - Major refactor with Laravel 11+ support
- **v2.5.0** - Laravel 12 compatibility and enhanced features
- **v3.0.0** - *(Coming Q4 2025)* Laravel 12 full optimization with AI features
---
Made with β€οΈ by the [Litepie Team](https://litepie.com)All versions of users with dependencies
laravel/framework Version ^12.0
litepie/actions Version ^1.0
litepie/filehub Version ^1.0
litepie/flow Version ^1.0
litepie/logs Version ^1.0
litepie/otp Version ^1.0
litepie/repository Version ^1.0