workos/workos-php-laravel

WorkOS PHP Library for Laravel

Maintainers

Details

github.com/workos/workos-php-laravel

Source

Issues

Installs: 1 101 745

Dependents: 0

Suggesters: 0

Security: 0

Stars: 17

Watchers: 18

Forks: 7

Open Issues: 0

v4.1.0 2024-10-22 16:22 UTC

Requires

Requires (Dev)

Suggests

MIT 2191f7284562726f53a88683a9622c13548d7fc2

  • WorkOS <support.woop@workos.com>

SSOsdklaravellaravel 5laravel 6laravel 7workoslaravel 8laravel 9laravel 10

This package is auto-updated.

Last update: 2024-12-22 16:47:23 UTC

README

The WorkOS library for Laravel provides convenient access to the WorkOS API from applications written in Laravel.

Documentation

See the API Reference for Laravel usage examples.

Installation

To install via composer, run the following:

composer require workos/workos-php-laravel

For Laravel 5.0-5.4, add the WorkOS ServiceProvider in your config/app.php:

"providers" => array(
    // ...
    WorkOS\Laravel\WorkOSServiceProvider::class
)

For Laravel 5.5 and up, 6.x and 7.x... you're all set!

Configuration

Create a WorkOS configuration file by running the following:

php artisan vendor:publish --provider="WorkOS\Laravel\WorkOSServiceProvider"

The package will need to be configured with your api key and project id. By default, the package will look for a WORKOS_API_KEY and WORKOS_CLIENT_ID environment variable.

SDK Versioning

For our SDKs WorkOS follows a Semantic Versioning (SemVer) process where all releases will have a version X.Y.Z (like 1.0.0) pattern wherein Z would be a bug fix (e.g., 1.0.1), Y would be a minor release (1.1.0) and X would be a major release (2.0.0). We permit any breaking changes to only be released in major versions and strongly recommend reading changelogs before making any major version upgrades.

Beta Releases

WorkOS has features in Beta that can be accessed via Beta releases. We would love for you to try these and share feedback with us before these features reach general availability (GA). To install a Beta version, please follow the installation steps above using the Beta release version.

Note: there can be breaking changes between Beta versions. Therefore, we recommend pinning the package version to a specific version. This way you can install the same version each time without breaking changes unless you are intentionally looking for the latest Beta version.

We highly recommend keeping an eye on when the Beta feature you are interested in goes from Beta to stable so that you can move to using the stable version.

More Information