alt-three / segment
A Segment bridge for Laravel
Installs: 512 135
Dependents: 0
Suggesters: 0
Security: 0
Stars: 59
Watchers: 7
Forks: 37
Open Issues: 5
Requires
- php: ^7.1.3
- illuminate/config: ^5.5 || ^6.0 || ^7.0 || ^8.0
- illuminate/support: ^5.5 || ^6.0 || ^7.0 || ^8.0
- segmentio/analytics-php: ~1.5.2
Requires (Dev)
- graham-campbell/analyzer: ^2.4 || ^3.0
- graham-campbell/testbench: ^5.5
- phpunit/phpunit: ^6.5 || ^7.5 || ^8.4 || ^9.0
README
Installation
Alt Three Segment is a Segment bridge for Laravel. This version requires PHP 7.1-7.4, and supports Laravel 5.5-8. Simply require the package using Composer:
$ composer require alt-three/segment:^3.5
Once installed, if you are not using automatic package discovery, then you need to register the AltThree\Segment\SegmentServiceProvider
service provider in your config/app.php
.
Configuration
Alt Three Segment requires configuration.
To get started, you'll need to publish all vendor assets:
$ php artisan vendor:publish
This will create a config/segment.php
file in your app that you can modify to set your configuration. Also, make sure you check for changes to the original config file in this package between releases.
Usage
Once you've set your write_key
value in the configuration, you're ready to go! For the most part you can follow Segments own instructions however, you'll want to replace the Analytics
classname with Segment
- plus, you don't need to call class_alias
.
Identify the user
Segment::identify([ 'userId' => '12345abcde', 'traits' => [ 'name' => 'James Brooks', 'email' => 'test@test.com', ], ]);
Track actions
Segment::track([ 'userId' => '12345abcde', 'event' => 'Did something', 'properties' => [ 'was_awesome' => true, ], ]);
Security
Our full security policy is available to read here.
License
Alt Three Segment is licensed under The MIT License (MIT).