PHPackages workos/workos-php-laravel - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Authentication & Authorization](/categories/authentication) 4. / 5. workos/workos-php-laravel ActiveLibrary[Authentication & Authorization](/categories/authentication) workos/workos-php-laravel ========================= WorkOS PHP Library for Laravel v5.0.1(5mo ago)341.8M↑11.9%11[3 issues](https://github.com/workos/workos-php-laravel/issues)[2 PRs](https://github.com/workos/workos-php-laravel/pulls)MITPHPPHP >=8.1.0CI passing Since Apr 11Pushed 1mo ago18 watchersCompare [ Source](https://github.com/workos/workos-php-laravel)[ Packagist](https://packagist.org/packages/workos/workos-php-laravel)[ RSS](/packages/workos-workos-php-laravel/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (3)Versions (46)Used By (0) WorkOS PHP Laravel Library ========================== [](#workos-php-laravel-library) The WorkOS library for Laravel provides convenient access to the WorkOS API from applications written in Laravel. Documentation ------------- [](#documentation) See the [API Reference](https://workos.com/docs/reference/client-libraries) for Laravel usage examples. Installation ------------ [](#installation) To install via composer, run the following: ``` composer require workos/workos-php-laravel ``` Configuration ------------- [](#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](https://dashboard.workos.com/api-keys) and [project id](https://dashboard.workos.com/sso/configuration). By default, the package will look for a `WORKOS_API_KEY` and `WORKOS_CLIENT_ID` environment variable. SDK Versioning -------------- [](#sdk-versioning) For our SDKs WorkOS follows a Semantic Versioning ([SemVer](https://semver.org/)) 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 ------------- [](#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](#installation) 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 ---------------- [](#more-information) - [Single Sign-On Guide](https://workos.com/docs/sso/guide) - [Directory Sync Guide](https://workos.com/docs/directory-sync/guide) - [Admin Portal Guide](https://workos.com/docs/admin-portal/guide) - [Magic Link Guide](https://workos.com/docs/magic-link/guide) ### Health Score 63 — FairBetter than 99% of packages Maintenance80 Actively maintained with recent releases Popularity53 Moderate usage in the ecosystem Community27 Small or concentrated contributor base Maturity77 Established project with proven stability Bus Factor6 6 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~68 days Recently: every ~46 days Total 31 Last Release 164d ago Major Versions v0.9.1 → v1.0.02021-06-24 v1.8.0 → v2.0.02022-12-09 v2.0.0 → v3.0.0.x-dev2023-04-21 v3.1.0 → v4.0.02023-11-22 v4.4.0 → v5.0.02025-12-05 PHP version history (2 changes)v0.0.1PHP >=5.6.0 v5.0.0PHP >=8.1.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/bb9f121082ccf48409fa78d0ae2ccdaafa0a41b360e1866c95ae63e019f897cf?d=identicon)[workos](/maintainers/workos) --- Top Contributors [![sheldon-workos](https://avatars.githubusercontent.com/u/243190984?v=4)](https://github.com/sheldon-workos "sheldon-workos (7 commits)")[![jonatascastro12](https://avatars.githubusercontent.com/u/5503244?v=4)](https://github.com/jonatascastro12 "jonatascastro12 (5 commits)")[![kendallstrautman](https://avatars.githubusercontent.com/u/36613477?v=4)](https://github.com/kendallstrautman "kendallstrautman (5 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (4 commits)")[![blairworkos](https://avatars.githubusercontent.com/u/74257063?v=4)](https://github.com/blairworkos "blairworkos (4 commits)")[![robframpton](https://avatars.githubusercontent.com/u/2466445?v=4)](https://github.com/robframpton "robframpton (3 commits)")[![workos-sdk-automation[bot]](https://avatars.githubusercontent.com/u/47638084?v=4)](https://github.com/workos-sdk-automation[bot] "workos-sdk-automation[bot] (3 commits)")[![willmanduffy](https://avatars.githubusercontent.com/u/782252?v=4)](https://github.com/willmanduffy "willmanduffy (3 commits)")[![jthodge](https://avatars.githubusercontent.com/u/17075617?v=4)](https://github.com/jthodge "jthodge (2 commits)")[![cmatheson](https://avatars.githubusercontent.com/u/35404?v=4)](https://github.com/cmatheson "cmatheson (2 commits)")[![csrbarber](https://avatars.githubusercontent.com/u/29511995?v=4)](https://github.com/csrbarber "csrbarber (2 commits)")[![gjtorikian](https://avatars.githubusercontent.com/u/64050?v=4)](https://github.com/gjtorikian "gjtorikian (2 commits)")[![adamzinder](https://avatars.githubusercontent.com/u/96083517?v=4)](https://github.com/adamzinder "adamzinder (2 commits)")[![mthadley](https://avatars.githubusercontent.com/u/2635560?v=4)](https://github.com/mthadley "mthadley (2 commits)")[![stacurry](https://avatars.githubusercontent.com/u/22999361?v=4)](https://github.com/stacurry "stacurry (2 commits)")[![nicknisi](https://avatars.githubusercontent.com/u/293805?v=4)](https://github.com/nicknisi "nicknisi (1 commits)")[![henrylamchan](https://avatars.githubusercontent.com/u/19150308?v=4)](https://github.com/henrylamchan "henrylamchan (1 commits)")[![birdcar](https://avatars.githubusercontent.com/u/434063?v=4)](https://github.com/birdcar "birdcar (1 commits)")[![awolfden](https://avatars.githubusercontent.com/u/47123183?v=4)](https://github.com/awolfden "awolfden (1 commits)")[![amadeo-workos](https://avatars.githubusercontent.com/u/165715960?v=4)](https://github.com/amadeo-workos "amadeo-workos (1 commits)") --- Tags adfsdirectory-syncgsuite-saml-appslaravel-sdkoktasamlscimssosso-authenticationlaravelsdklaravel 10laravel 11laravel 12SSOworkos ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/workos-workos-php-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/workos-workos-php-laravel/health.svg)](https://phpackages.com/packages/workos-workos-php-laravel) ``` ### Alternatives [aws/aws-sdk-php-laravel A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP. 1.7k35.6M75](/packages/aws-aws-sdk-php-laravel)[tuncaybahadir/quar A simple QR Code generation tool for your projects with Laravel 10, 11, 12 versions, php 8.2, 8.3, 8.4 and 8.5 6966.5k4](/packages/tuncaybahadir-quar)[novu/novu-laravel Novu for Laravel 12204.3k](/packages/novu-novu-laravel)[ip2location/ip2proxy-laravel Allows user to query an IP address if it was being used as open proxy, web proxy, VPN anonymizer and TOR exits. 1063.2k](/packages/ip2location-ip2proxy-laravel)[itsmurumba/laravel-mpesa Laravel Package for Mpesa Daraja API 191.6k](/packages/itsmurumba-laravel-mpesa) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)