|
| 1 | +# Custom App Providers |
| 2 | + |
| 3 | +With the multi-tenancy support of Laravel WebSockets, the default way of storing and retrieving the apps is by using the `websockets.php` config file. |
| 4 | + |
| 5 | +Depending on your setup, you might have your app configuration stored elsewhere and having to keep the configuration in sync with your app storage can be tedious. To simplify this, you can create your own `AppProvider` class that will take care of retrieving the WebSocket credentials for a specific WebSocket application. |
| 6 | + |
| 7 | +> Make sure that you do **not** perform any IO blocking tasks in your `AppProvider`, as they will interfere with the asynchronous WebSocket execution. |
| 8 | +
|
| 9 | +In order to create your custom `AppProvider`, create a class that implements the `BeyondCode\LaravelWebSockets\AppProviders\AppProvider` interface. |
| 10 | + |
| 11 | +This is what it looks like: |
| 12 | + |
| 13 | +```php |
| 14 | +interface AppProvider |
| 15 | +{ |
| 16 | + /** @return array[BeyondCode\LaravelWebSockets\AppProviders\App] */ |
| 17 | + public function all(): array; |
| 18 | + |
| 19 | + /** @return BeyondCode\LaravelWebSockets\AppProviders\App */ |
| 20 | + public function findById($appId): ?App; |
| 21 | + |
| 22 | + /** @return BeyondCode\LaravelWebSockets\AppProviders\App */ |
| 23 | + public function findByKey(string $appKey): ?App; |
| 24 | + |
| 25 | + /** @return BeyondCode\LaravelWebSockets\AppProviders\App */ |
| 26 | + public function findBySecret(string $appSecret): ?App; |
| 27 | +} |
| 28 | +``` |
| 29 | + |
| 30 | +The following is an example AppProvider that utilizes an Eloquent model: |
| 31 | +```php |
| 32 | +namespace App\Providers; |
| 33 | + |
| 34 | +use App\Application; |
| 35 | +use BeyondCode\LaravelWebSockets\Apps\App; |
| 36 | +use BeyondCode\LaravelWebSockets\Apps\AppProvider; |
| 37 | + |
| 38 | +class MyCustomAppProvider implements AppProvider |
| 39 | +{ |
| 40 | + public function all() : array |
| 41 | + { |
| 42 | + return Application::all() |
| 43 | + ->map(function($app) { |
| 44 | + return $this->instanciate($app->toArray()); |
| 45 | + }) |
| 46 | + ->toArray(); |
| 47 | + } |
| 48 | + |
| 49 | + public function findById($appId) : ? App |
| 50 | + { |
| 51 | + return $this->instanciate(Application::findById($appId)->toArray()); |
| 52 | + } |
| 53 | + |
| 54 | + public function findByKey(string $appKey) : ? App |
| 55 | + { |
| 56 | + return $this->instanciate(Application::findByKey($appKey)->toArray()); |
| 57 | + } |
| 58 | + |
| 59 | + public function findBySecret(string $appSecret) : ? App |
| 60 | + { |
| 61 | + return $this->instanciate(Application::findBySecret($appSecret)->toArray()); |
| 62 | + } |
| 63 | + |
| 64 | + protected function instanciate(?array $appAttributes) : ? App |
| 65 | + { |
| 66 | + if (!$appAttributes) { |
| 67 | + return null; |
| 68 | + } |
| 69 | + |
| 70 | + $app = new App( |
| 71 | + $appAttributes['id'], |
| 72 | + $appAttributes['key'], |
| 73 | + $appAttributes['secret'] |
| 74 | + ); |
| 75 | + |
| 76 | + if (isset($appAttributes['name'])) { |
| 77 | + $app->setName($appAttributes['name']); |
| 78 | + } |
| 79 | + |
| 80 | + if (isset($appAttributes['host'])) { |
| 81 | + $app->setHost($appAttributes['host']); |
| 82 | + } |
| 83 | + |
| 84 | + $app |
| 85 | + ->enableClientMessages($appAttributes['enable_client_messages']) |
| 86 | + ->enableStatistics($appAttributes['enable_statistics']); |
| 87 | + |
| 88 | + return $app; |
| 89 | + } |
| 90 | +} |
| 91 | +``` |
| 92 | + |
| 93 | +Once you have implemented your own AppProvider, you need to set it in the `websockets.php` configuration file: |
| 94 | + |
| 95 | +```php |
| 96 | +/** |
| 97 | + * This class is responsible for finding the apps. The default provider |
| 98 | + * will use the apps defined in this config file. |
| 99 | + * |
| 100 | + * You can create a custom provider by implementing the |
| 101 | + * `AppProvider` interface. |
| 102 | + */ |
| 103 | +'app_provider' => MyCustomAppProvider::class, |
| 104 | +``` |
0 commit comments