Download the PHP package synergitech/laravel-typesense-tools without Composer
On this page you can find all versions of the php package synergitech/laravel-typesense-tools. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download synergitech/laravel-typesense-tools
More information about synergitech/laravel-typesense-tools
Files in synergitech/laravel-typesense-tools
Package laravel-typesense-tools
Short Description This library adds tools for Typesense within Laravel
License MIT
Homepage https://github.com/synergitech/laravel-typesense-tools
Informations about the package laravel-typesense-tools
Laravel Typesense Tools
This package adds Artisan commands that help manage Typesense Collections and Collection Aliases in Laravel applications using Laravel Scout.
Using Typesense with Scout requires you to define the schema in the Scout config file so we change the expected functions to static to reduce duplication. This means that the functions cannot reference app() or config() because they're executed too early in the booting process.
We make use of Typesense Collection Aliases so that schema changes can be gracefully deployed to our frontends without causing issues.
See the full examples in examples/config/scout.php.
Requirements
- PHP
^8.2 - Laravel Framework
>=10.0 - Laravel Scout
>=10.0 - Typesense PHP client
>=5.1
Installation
Usage
Our environments typically have separated application/frontend and worker contexts and we also usually run a separate CLI context. The deployment runbook is usually as follows.
- deploy new code to the CLI and run any migrations
- deploy new code to the workers with an updated TYPESENSE_VERSION_SUFFIX. We typically use a date for the suffix for easy versioning, i.e. 20260325.
- run
php artisan search:setupto populate the new collections - when the queue is empty, the new collection schema fields are now available as
search:switch-aliasis run as the final queue job - deploy the new code to the frontend so the new fields are in use
- (optional) run
php artisan search:cleanupto remove the now unused collections and get some memory back
Development
As the frontend is powered by Aliases, you can save yourself a little bit of effort by adding the following to the bottom of your DatabaseSeeder class.
This means that every time you or a colleague are starting from scratch, the Aliases will be created. Scout will automatically create the Collections as part of the new data being added.
If you aren't implicitly creating every Collection during your seeding process, you can swap in search:setup instead and that will make sure all the Collections exist and the Aliases are created.
Command reference
search:setupto ensure collections exist and (optionally) import data.search:switch-aliasto point aliases at the current index collections.search:delete-suffix {suffix}to remove old suffixed collections.search:cleanupto remove collections that are not referenced by an alias.
search:setup
Populates all known collections and dispatches a search:switch-alias at the end. If --only-index is provided, it checks each Collection/Alias exists. The check is useful for confirming your schema works and there aren't any errors.
Options:
--only-index: only verify/create collections.--flush: flush each model before importing.
Examples:
search:switch-alias
Upserts each model's alias (searchableAs) to target the active collection (indexableAs). This is used automatically after a call to search:setup
search:delete-suffix {suffix}
Deletes old collections named as:
<searchableAs>_<suffix>
Example:
search:cleanup
Finds and optionally deletes collections not currently referenced by any alias.
All versions of laravel-typesense-tools with dependencies
laravel/framework Version >=10.0
laravel/scout Version >=10.0
typesense/typesense-php Version >=5.1