Download the PHP package seiger/stask without Composer
On this page you can find all versions of the php package seiger/stask. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package stask
Short Description Asynchronous task management system for Evolution CMS. Handle background operations and task queues with reliability and performance.
License GPL-3.0
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package stask
sTask for Evolution CMS
Welcome to sTask!
sTask is a high-performance asynchronous task management system designed specifically for Evolution CMS. It provides an enterprise-grade framework for creating, executing, and monitoring background tasks with automatic worker discovery, comprehensive performance monitoring, and advanced caching capabilities.
Whether you need to process large data imports, generate reports, send emails in bulk, or perform any other time-consuming operations, sTask gives you the tools to handle these tasks efficiently without blocking your main application. Built with performance and scalability in mind, it's designed to become the fundamental task management solution for the entire Evolution CMS ecosystem.
Features
🚀 Core Task Management
- Asynchronous Processing: Execute long-running tasks in the background
- Priority System: Task prioritization (low, normal, high) with intelligent queuing
- Progress Tracking: Real-time progress monitoring (0-100%) via filesystem-based tracking
- Status Management: Complete task lifecycle (queued, preparing, running, finished, failed)
- Retry Mechanism: Configurable automatic retry with exponential backoff
- File Downloads: Download task results and exported files
⚡ High-Performance Architecture
- Multi-Level Caching: In-memory + Laravel cache for optimal worker resolution
- Database Optimization: Batch operations and optimized queries
- Memory Management: Automatic memory cleanup and resource management
- Performance Metrics: Real-time monitoring and analytics
- System Health: Automated health checks and performance alerts
- Cache Statistics: Detailed cache performance monitoring
🔧 Worker System
- Automatic Discovery: Auto-discovery of worker implementations from packages
- Worker Registration: Dynamic worker registration and activation/deactivation
- Interface Validation: Comprehensive worker validation and error handling
- Custom Implementation: Clean interface for custom worker development
- Worker Settings: Individual worker configuration and settings management
🎛️ Admin Interface
- Modern Dashboard: Clean, responsive interface with task statistics
- Worker Management: Visual worker management with card-based layout
- Real-time Monitoring: Live task progress and status updates
- Performance Analytics: Built-in performance monitoring and alerts
- Cache Management: Visual cache statistics and management tools
🔌 Developer Experience
- RESTful API: Comprehensive API for task management and monitoring
- Clean Architecture: Well-structured, extensible codebase
- Comprehensive Documentation: Detailed docs with examples
- Error Context: Detailed error information for debugging
- Performance Tools: Built-in performance analysis and optimization tools
🔗 Integration
- Evolution CMS: Seamless integration with Evolution CMS manager
- Menu Integration: Custom logo and menu integration
- Artisan Commands: CLI tools for task management
- Composer Package: Auto-assets publishing and dependency management
Requirements
- Evolution CMS ^3.7.5
- PHP ^8.4
- Composer ^2.2
- One of: MySQL 8.0+ / MariaDB 10.5+ / PostgreSQL 10+ / SQLite 3.25+
Installation
Go to Your /core/ folder:
Run php artisan commands:
Setup Cron Job
Add the following cron job to run scheduled tasks every minute:
Important: Replace /path/to/your/project with the actual path to your Evolution CMS installation.
For shared hosting, you may need to use the full path to PHP:
Quick Start
Creating a Task
Processing Tasks
Creating Custom Workers
Admin Interface
Access sTask through Manager → Tools → Task Manager.
Dashboard
- Task statistics (pending, running, completed, failed)
- Recent activity with progress tracking
- Quick actions for processing and cleanup
Workers
- Automatic worker discovery
- Worker activation/deactivation
- Worker configuration management
Artisan Commands
Task Worker (System Command)
The task worker is automatically executed by the system via cron job every minute. You don't need to run it manually.
What it does:
- Processes all pending tasks in the queue
- Executes tasks through their respective workers
- Updates task progress and status
- Cleans up old progress files when idle
- Should be configured via cron for continuous processing
Note: Workers are automatically discovered when you access the Workers tab in the admin interface. No manual discovery needed!
API Endpoints
sTask provides a comprehensive RESTful API for task management and monitoring:
Task Management
Performance Monitoring
Configuration
Check if sTask is installed:
Database Tables
sTask creates the following tables:
s_workers- Worker configurationss_tasks- Task records
Storage Structure
Task Status Codes
10- Queued (waiting to be executed)30- Preparing (task is being prepared)50- Running (currently executing)80- Finished (successfully completed)100- Failed (encountered an error)
Querying Tasks
Priority Levels
low- Lowest priority, executed lastnormal- Default priorityhigh- Highest priority, executed first
Performance & Monitoring
🎯 Performance Targets Achieved
- Task execution overhead < 100ms
- Memory usage < 10MB per worker
- Database queries < 3 per task
- File I/O operations < 5 per task
- Cache hit rate > 85%
📊 Built-in Monitoring
- Real-time metrics collection and analysis
- Performance alerts with configurable thresholds
- System health checks and automated monitoring
- Worker statistics and performance analytics
- Cache performance tracking and optimization
- Memory usage monitoring and cleanup
🔧 Enterprise Features
- Multi-level caching (in-memory + Laravel cache)
- Database optimization with batch operations
- Automatic memory management and cleanup
- Performance analytics with historical data
- System health monitoring with alerts
- Cache management with detailed statistics
🚀 Roadmap
- [ ] Task scheduling with cron integration
- [ ] Task dependencies and workflow management
- [ ] Email notifications for task completion
- [ ] Webhook support for external integrations
- [ ] Task templates and presets
- [ ] Multi-server task distribution
- [ ] Advanced queue prioritization algorithms
Documentation
- Getting Started - Installation and basic usage
- Admin Interface - Managing tasks and workers
- Developer Guide - Creating custom workers
- API Reference - Complete API documentation
- Performance Guide - Optimization and monitoring
Evolution CMS Ecosystem
sTask is designed to become the fundamental task management solution for the entire Evolution CMS ecosystem:
🎯 Core Dependency
- sCommerce - Uses sTask for product synchronization and data processing
- sArticles - Leverages sTask for content management and publishing
- sGallery - Utilizes sTask for image processing and optimization
- Future packages - Will integrate with sTask for async operations
🔄 Migration Strategy
- Phase 1: Parallel operation with existing systems
- Phase 2: Gradual migration of async operations
- Phase 3: Complete replacement of legacy task systems
- Phase 4: Optimization and enhancement
🚀 Benefits for Package Developers
- Standardized async processing across all packages
- Unified task management interface
- Performance optimization out of the box
- Monitoring and analytics built-in
- Easy integration with clean APIs
Support
If you need help, please don't hesitate to open an issue.
Runner heartbeat
Use Seiger\sTask\Facades\sTask::heartbeat(int $ttl = 3610): bool to check
whether stask:worker started within the last $ttl seconds (inclusive).
The runner calls touch(storage_path('logs/sTask.heartbeat')) before scheduling
or queue access, including empty runs. The check only reads the timestamp and
never creates or refreshes the marker. Missing, inaccessible, expired or future
timestamps return false, as does a negative TTL.
This indicates recent runner invocation, not successful task execution or a
guarantee that a process is still alive. The existing storage/logs directory
must be writable by CLI and the marker readable by the web process. Keep storage
shared across release deployments. Vendor publishing must not create this marker.
sTask::heartbeatStatus() exposes the same check with available, state,
last_seen_at and age_seconds. The manager displays a colored runner indicator
beside the tabs. Its tooltip shows the last invocation and elapsed time, without
the TTL. It updates when the panel component refreshes, without separate polling.
See the PHP API and manager interface documentation for details.
License
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
Author
Seiger IT Team
- Website: https://seigerit.com
- GitHub: @Seiger
Made with ❤️ for Evolution CMS
