Using External Libraries

NixPHP is designed to be minimal and flexible.
You are free to integrate any external library you need without fighting against hidden internals.

Thanks to the PSR-4 structure and Composer, adding new tools is simple and clean.

---

Installing Packages

You can install any Composer package as usual:

composer require some/vendor-package

The package will be autoloaded automatically according to PSR-4 standards.

---

Example: Using Blade Templating

Install Blade via Composer:

composer require jenssegers/blade

Create a simple service registration:

use Jenssegers\Blade\Blade;

app()->container()->set('blade', function () {
    return new Blade(BASE_PATH . '/app/views', BASE_PATH . '/storage/cache/views');
});

Now you can use Blade inside your controllers:

$blade = app()->container()->get('blade');

return response($blade->render('home', ['name' => 'World']));

---

Example: Using Eloquent ORM

Install Eloquent via Composer:

composer require illuminate/database

Configure and initialize Eloquent:

use Illuminate\Database\Capsule\Manager as Capsule;

app()->container()->set('db', function () {
    $capsule = new Capsule;
    $config = config('database');

    $capsule->addConnection([
        'driver'    => $config['driver'],
        'host'      => $config['host'],
        'database'  => $config['database'],
        'username'  => $config['username'],
        'password'  => $config['password'],
        'charset'   => $config['charset'],
        'collation' => 'utf8mb4_unicode_ci',
        'prefix'    => '',
    ]);

    $capsule->setAsGlobal();
    $capsule->bootEloquent();

    return $capsule;
});

Use models as usual:

use App\Models\User;

$user = User::find(1);

---

Tips for Integration

• Register services inside your container via app()->container()->set().
• Load config values using config('key').
• Keep external libraries isolated and modular.
• You are free to build your own architecture around NixPHP without restrictions.

---

Summary

• NixPHP allows easy integration of any Composer package.
• External tools like Blade, Eloquent, or Guzzle work seamlessly.
• Service registration and configuration stay fully under your control.