illuma-law / healthcheck-pgvector

v0.1.4 2026-10-23 13:52 UTC

Requires

• php: ^8.3
• illuminate/contracts: ^12.0||^13.0
• illuminate/database: ^12.0||^13.0
• illuminate/support: ^12.0||^13.0
• laravel/framework: ^12.0||^13.0
• spatie/laravel-health: ^1.39
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• mrpunyapal/peststan: ^0.2.12
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^10.1||^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• spatie/laravel-ray: ^1.35

MIT

• illuma-law

• postgres
• health
• laravel
• pgvector
• illuma-law

Published on Packagist.org on 2026-10-23 13:52 UTC

README

A Spatie Laravel Health check that reports whether the vector extension is installed on your PostgreSQL connection.

Requirements

• PHP 8.3 or later
• Laravel 12 or 13
• Spatie Laravel Health 1.39 or later
• A PostgreSQL database connection

Install

composer require illuma-law/healthcheck-pgvector

Laravel discovers the service provider automatically. Register the check with your other health checks:

use IllumaLaw\HealthCheckPgvector\PgvectorExtensionCheck;
use Spatie\Health\Facades\Health;

Health::checks([
    PgvectorExtensionCheck::new(),
]);

Configure

The check looks up the installed vector extension and reports its version. When the extension is missing, the result is a warning by default. Require it with the environment variable or published configuration:

HEALTH_PGVECTOR_REQUIRED=true

php artisan vendor:publish --tag=healthcheck-pgvector-config

You can override the default for one check:

PgvectorExtensionCheck::new()->required();

Database query errors always return a failed result.

Test

composer test
composer analyse
vendor/bin/pint --test

MIT licensed. See LICENSE.md.