FAQ

Yes, absolutely! While Zenith is optimized for multi-tenant applications, it works perfectly for single-tenant applications too.

• Simply create one tenant for your application
• All the core features (routing, ORM, authentication, etc.) work independently
• You can ignore the multi-tenant features if not needed
• The framework is lightweight and doesn't impose multi-tenancy overhead

Minimum: PHP 8.1
Recommended: PHP 8.4 (latest features and best performance)

Zenith uses modern PHP features including readonly properties, enums, match expressions, and constructor property promotion. These features require PHP 8.1 or higher.

Yes! Version 1.2.0 is production-ready and includes:

• 238+ unit and integration tests
• Enterprise-grade security (CSRF, login throttling, encryption)
• Comprehensive error handling
• Performance optimizations
• Stable API with semantic versioning

• SuperAdmin:
  • Platform-level administrator
  • Manages tenants (create, edit, delete)
  • Access to platform settings
  • Stored in central database
  • Can create new tenants and users
• Admin (Tenant Admin):
  • Organization-level administrator
  • Manages users within their tenant
  • Access to tenant-specific data only
  • Stored in tenant database
  • Cannot access other tenants

Via SuperAdmin Dashboard:

1. Log in to SuperAdmin portal at /superadmin/login
2. Navigate to Tenants → Create New
3. Fill in tenant details (name, subdomain, database info)
4. System automatically provisions the tenant database and initial schema

Via CLI:

php zenith create:tenant --name="Acme Corp" --subdomain="acme"

The system handles all database creation, migration, and initialization automatically.

Yes! Zenith supports custom domains for tenants.

Each tenant can have:

• Default subdomain (e.g., acme.zenith.app)
• Custom domain (e.g., acme.com)
• Multiple domains pointing to the same tenant

Simply configure the custom domain in the tenant settings, and point the DNS to your server. Zenith's domain routing middleware handles the rest.

Zenith uses schema-based migrations defined directly in models:

protected static array $schema = [
    'columns' => [
        'ID' => ['type' => 'integer', 'primary' => true, 'autoIncrement' => true],
        'name' => ['type' => 'string', 'length' => 255, 'nullable' => false],
        // ...
    ],
    'indexes' => [...],
    'foreignKeys' => [...]
];

Run migrations with:

php zenith init:database    # Initialize/sync all schemas

The system automatically creates tables, adds columns, and updates indexes based on schema definitions.

Yes! While the Active Record ORM covers most use cases, you can write raw SQL when needed:

// Single row
$result = Database::queryOne('SELECT * FROM users WHERE id = ?', [$id]);

// Multiple rows
$results = Database::query('SELECT * FROM users WHERE active = ?', [1]);

// Execute (INSERT, UPDATE, DELETE)
Database::execute('UPDATE users SET status = ? WHERE id = ?', ['active', $id]);

All queries use prepared statements for SQL injection protection.

Minimum Requirements:

• PHP 8.1 or higher (8.4 recommended)
• PDO extension with desired database driver
• OpenSSL extension (for encryption)
• mbstring extension
• JSON extension
• MySQL 5.7+ / PostgreSQL 10+ / SQLite 3.8+

Recommended:

• Apache with mod_rewrite or Nginx
• 2GB RAM minimum
• SSD storage
• PHP OPcache enabled

With database-per-tenant architecture, you have flexible backup options:

• Per-Tenant Backups: Backup each tenant database separately (allows restore of individual tenants)
• Scheduled Backups: Use cron jobs to automate tenant database backups
• Central Database: Don't forget to backup the central SuperAdmin database
• Storage: Backup uploaded files in storage directories

This approach allows you to restore individual tenants without affecting others.

If you discover a security issue in a Zenith-powered application:

1. Email security details to: [email protected]
2. Include detailed information and steps to reproduce
3. I will respond within 48 hours
4. Security fixes are prioritized and addressed immediately

Responsible disclosure is appreciated and will be acknowledged.

Zenith supports multiple caching strategies:

• OPcache: PHP opcode caching (recommended for production)
• Route Caching: Compiled routes for faster lookup
• Container Caching: Singleton pattern for services
• Database Caching: PDO persistent connections

Additional caching layers (Redis, Memcached) can be integrated through custom service providers.