WPZylos Requirements

Environment and dependency validation for WPZylos framework plugins.

What You Get

• PHP Version Check — Validate minimum PHP version
• WordPress Version Check — Validate minimum WordPress version
• PHP Extensions — Ensure required extensions are loaded
• Plugin Dependencies — Check required plugins are active
• Multisite Compatibility — Validate multisite environment
• Automatic Deactivation — Deactivates plugin when requirements fail

Quick Start

// config/requirements.php
return [
    'min_php_version'         => '8.1',
    'min_wp_version'          => '6.0',
    'is_multisite_compatible' => true,
    'php_extensions'          => ['json', 'mbstring'],
    'required_plugins'        => [
        'WooCommerce' => [
            'plugin_slug'        => 'woocommerce/woocommerce.php',
            'min_plugin_version' => '8.0.0',
        ],
    ],
];

// bootstrap/app.php
$app->register(RequirementsServiceProvider::class);

Documentation

• Overview — Requirements system architecture
• Installation — Setup guide
• Usage — Core patterns
• Configuration — Config file options
• API Reference — Class and method reference
• Examples — Real-world usage patterns
• Testing — Testing requirements
• Security — Security considerations
• Troubleshooting — Common issues

Why Requirements Validation?

Prevent Runtime Errors

Without requirements validation:

• PHP fatal errors when using unsupported functions
• Missing WordPress features cause crashes
• Plugin conflicts go undetected

With wpzylos-requirements:

• Clear error messages before activation
• Automatic deactivation prevents broken sites
• Users know exactly what's needed

Better User Experience

┌────────────────────────────────────────────────────────────┐
| **Bad:** My Plugin Activation Failed                             |
|                                                            |
| • PHP 8.1+ is required. You are running: 7.4.33           |
| • Required plugin WooCommerce is not active.              |
+--──────────────────────────────────────────────────────────┘

Related Packages

• wpzylos-core — Application foundation
• wpzylos-config — Configuration management