Back to Documentation
Documentation
📄Known Issues & Limitations
| Issue | Severity | Workaround |
v0.35 Known Issues#
Database#
| Issue | Severity | Workaround |
|---|---|---|
| No transaction rollback in CLI | Low | Use DB::transaction() manually |
| SQLite foreign keys off by default | Medium | Enable with PRAGMA foreign_keys = ON |
| No partial rollback for specific migration | Low | migrate:rollback --step=N or migrate:fresh (v0.35.0) |
Auth#
| Issue | Severity | Workaround |
|---|---|---|
| No OAuth2/Passport support | Low | Use API Key auth for external devs |
| No multi-tenancy | Medium | Implement in application layer |
| No 2FA built-in | Low | Add manually or use third-party |
File Upload / Storage#
| Issue | Severity | Workaround |
|---|---|---|
| No chunked upload | Medium | Handle in frontend |
| S3 driver basic (no multipart) | Low | Use local storage for files >100MB |
Queue/Jobs#
| Issue | Severity | Workaround |
|---|---|---|
| Queue: DB driver (default), Redis driver (QUEUE_DRIVER=redis) | Low | Use database queue with retries |
| No job retry UI | Low | Check failed_jobs table manually |
Architecture Limitations#
By design, not bugs:
| Limitation | Why | Workaround |
|---|---|---|
| No admin panel | API-only | Build with any frontend |
| No native WebSocket (Mercure/SSE available via FrankenPHP) | HTTP-only | Use polling or Pusher |
| No GraphQL | REST-first | OpenAPI covers most needs |
| No web debug bar | CLI-first | log:trace, replay, why |
Reporting Issues#
- https://github.com/SiroSoft/SiroPHP/issues
- Include: PHP version, Siro version, reproduction steps