Download the PHP package x-laravel/embedding-oracle-driver without Composer
On this page you can find all versions of the php package x-laravel/embedding-oracle-driver. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package embedding-oracle-driver
x-laravel/embedding — Oracle 26ai Driver
Oracle 26ai native vector similarity driver for x-laravel/embedding.
How It Works
- Implements
SimilarityDriver— registers as theoracledriver, similarity search runs entirely in Oracle usingVECTOR_DISTANCE - Implements
VectorStore— writes embeddings viaMERGE INTO ... USING DUALwithTO_VECTOR(), no PHP-side JSON workaround needed - Translates payload
filter:constraints to type-strictJSON_VALUESQL against theembeddablestable
Requirements
- PHP ^8.3
- Laravel ^12.0 | ^13.0
x-laravel/embedding ^1.0- Oracle Database 26ai (Free or Enterprise)
Installation
The OracleEmbeddingServiceProvider is auto-discovered and registers the oracle driver automatically.
Setup
1. Configure x-laravel/embedding
Publish the config if you haven't already:
Set the similarity driver and database connection in config/embedding.php:
2. Create the tables
This driver ships its own Oracle-native migrations that replace the default ones from x-laravel/embedding: embeddings with a VECTOR(1536, FLOAT32) column and embeddables with a native JSON payload column.
Publish and run the migrations (migrations are not loaded automatically — publish the driver migrations, not the core ones):
The published files are plain migrations in database/migrations/ — customise the DDL there if needed (e.g. tablespace, index parameters) before running migrate.
Note:
VECTOR_DISTANCEworks without an index (sequential scan). If you have the Oracle In-Memory option, add aCREATE VECTOR INDEX ... ORGANIZATION INMEMORY NEIGHBOR GRAPHstatement after publishing the migration.
3. Model
Follow the standard x-laravel/embedding setup. No Oracle-specific changes are needed on your models.
Usage
The driver is transparent — use the standard x-laravel/embedding API:
All methods set a similarity_score float attribute on each returned model.
Payload filtering
Models using #[EmbedPayload] can filter similarity searches at the database level. The driver translates filter: to a whereExists subquery with JSON_VALUE — numbers via RETURNING NUMBER, plus a JSON type guard on every condition, so comparisons are type-strict (34 never matches "34"):
Note: oci8 returns Oracle
NUMBERcolumns to PHP as strings. Add anintegercast to numeric payload fields on your models — otherwise a queued payload sync writes"34"instead of34after the DB round-trip, and type-strict filters stop matching.
Testing
License
This package is open-sourced software licensed under the MIT license.
