Download the PHP package madeiteasytools/multiverse without Composer

MadeItEasyTools/Multiverse 🌌

Run Python, Node.js, and other languages natively inside your Laravel application.

Bridge the gap between PHP's web dominance and Python's data supremacy. Run "Workers" written in other languages as if they were native Laravel classes.

✨ Features

• 🚀 Performance Optimized: Sub-500ms execution times via pre-installed environments
• 🛡️ Robust Error Handling: Custom exceptions with detailed context
• ⏱️ Configurable Timeouts: Prevent hanging workers with flexible timeout options
• 📊 Automatic Logging: Failed workers logged with full context
• 🧹 Process Management: Manual cleanup command for zombie processes
• 🐍 Python Native: First-class support for Python 3.x
• 📦 Shared Dependencies: One requirements.txt for all workers
• 🛠️ Artisan Integration: multiverse:worker, multiverse:install, multiverse:update, multiverse:clear
• 🔒 Security: Built-in static analysis to block dangerous commands

🖥️ Server Requirements

Before installing, ensure your server meets these requirements:

PHP

• PHP 8.1+
• proc_open must not be in disable_functions in php.ini

Shared hosting / HestiaCP / cPanel: These panels often disable proc_open in PHP-FPM pools. You must remove it from disable_functions in your pool config or global php.ini for the package to work. See Troubleshooting.

Python Workers

If you plan to use Python workers, the server also needs:

Replace X with your Python version (e.g. python3.12-venv for Python 3.12). python3-dev and build-essential are only needed if your requirements.txt includes packages that compile from source (e.g. pyswisseph, numpy, Pillow).

Quick check:

📦 Installation

1. Check Server Requirements

Before setting up, verify your server has everything needed:

Example output:

Each failing check prints the exact apt install command to fix it. Returns exit code 1 if any requirement is missing — useful in CI/CD pipelines.

2. Setup Python Environment

This creates a multiverse/ directory, sets up a virtual environment, and automatically updates your .gitignore.

3. Publish Configuration (Optional)

🚀 Quick Start

Create a Worker

Write Your Python Logic

Edit multiverse/python/image_processor/main.py:

Run from Laravel

⚙️ Advanced Features

Timeout Configuration

Default (Unlimited):

Global Timeout:

Per-Worker Timeout:

Error Handling

Automatic Error Logging

Failed workers are automatically logged to storage/logs/laravel.log:

Log Entry Example:

Process Cleanup

Kill hanging or zombie worker processes:

Example:

📚 Managing Dependencies

Add Python Packages

1. Edit multiverse/python/requirements.txt:

2. Update environment:

Shared Virtual Environment

All Python workers share one virtual environment, saving disk space and installation time.

🔒 Security

Static Code Analysis

Block dangerous patterns in worker code:

Best Practices

✅ Validate Input: Always validate data before passing to workers
✅ Use Timeouts: Set reasonable timeouts for all workers
✅ Monitor Logs: Check storage/logs for worker failures
✅ Limit Permissions: Run workers with minimal system permissions
✅ Sanitize Output: Validate worker output before using in your app

🛠️ Artisan Commands

📖 Configuration Reference

🎯 Use Cases

AI & Machine Learning

Image Processing

Data Science

Web Scraping

🐛 Troubleshooting

proc_open Disabled

proc_open is disabled in your PHP configuration. This is common on shared hosting and control panels (HestiaCP, cPanel, Plesk).

Fix — check what's disabled:

Fix — global php.ini (affects all sites):

Fix — per-site PHP-FPM pool (safer, affects only your site):

Edit your pool config (e.g. /etc/php/8.4/fpm/pool.d/yoursite.conf) and add:

Omit proc_open from the list. Note: pool config can only add to the global list, not remove from it — so proc_open must also be absent from the global php.ini.

python3-venv Not Installed

C Extension Build Fails (Python.h / g++ not found)

Worker Not Found

Solution: Check that multiverse/python/my_worker/main.py exists.

Timeout Issues

Solution: Increase timeout or optimize worker code.

Import Errors

Solution: Add package to requirements.txt and run multiverse:update.

Zombie Processes

Solution: Run php artisan multiverse:clear worker_name.

📄 License

MIT License - see LICENSE.md for details.

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

📞 Support

• Issues: GitHub Issues
• Email: [email protected]

Made with ❤️ by MadeItEasyTools