README

This is a Laravel package for talking to a LibreEHR database via FHIR API

Installation

Via Composer

Get composer

getcomposer.com

Create a Laravel 5.3 project

$ composer create-project --prefer-dist laravel/laravel=5.3.* libre-ehr-laravel-5-3

Require the fhir package which includes LibreEHR/core for as an interface to the LibreEHR database, for now it is in development and should be grabbed by developers via github.

Add the following to the root libre-ehr-laravel/composer.json after the "type"

...

"repositories": [
      {
        "type": "vcs",
        "url": "https://github.com/LibreEHR/fhir.git"
      },
      {
        "type": "vcs",
        "url": "https://github.com/LibreEHR/core.git"
      }
    ],
    
...

Then add the following to the "require" section of the libre-ehr-laravel/composer.json file which will specify the requirement of the development version of libre-ehr/fhir.

...

"libre-ehr/fhir": "dev-master"

...

Then add the following to the bottom of the libre-ehr-laravel/composer.json file, which will allow you to pull the development version.

    ...,
    "minimum-stability": "dev",
    "prefer-stable": true
...

Then from the root of libre-ehr-laravel, run the following to pull in the LibreEHR packages

$ composer update

Install Stripe for payment

composer require stripe/stripe-php

Install the Passport Auth package.

$ composer require laravel/passport

Place your database credentials in the file libre-ehr-laravel/config/database.php in the mysql section

Create a new section for 'auth' and make auth the default in config/database.php like this:

...

    'default' => 'auth',

...

    'auth' => [
        'driver' => 'mysql',
        'host' => '127.0.0.1',
        'port' => '3336',
        'database' => 'libreehr_api',
        'username' => 'libreehr_api',
        'password' => 'libreehr_api',
        'charset' => 'utf8',
        'collation' => 'utf8_unicode_ci',
        'prefix' => '',
        'strict' => false,
    ],
        
...

Point a vhost to libre-ehr-laravel/public.

Make sure to enable mod_rewrite on Apache.

Usage

To integrate with Laravel, there is a service provider you can make use of to automatically prepare the bindings and such.

Add the following to the end of the "providers" array in libre-ehr-laravel/config/app.php

// config/app.php

'providers' => [
    '...',
    LibreEHR\FHIR\Utilities\Providers\FHIRServiceProvider::class,
    LibreEHR\FHIR\Utilities\Providers\CustomPassportServiceProvider::class,
];

run 'php artisan migrate' to install the users table and oauth tables

run 'php artisan passport:install' to generate auth keys keys

run "php artisan passport:client --password" to create a new client if needed (a password grant client is automatically created from passport:install command)

Change driver in guards => api section of auth.php to 'passport'

'guards' => [
        'web' => [
            'driver' => 'session',
            'provider' => 'users',
        ],

        'api' => [
            'driver' => 'passport',
            'provider' => 'users',
        ],
    ],

change user model in providers => users in auth.php to our custom user model, default user model missing hasPITokens

'model' => LibreEHR\FHIR\Http\Controllers\Auth\AuthModel\User::class,

You will then be able to browse to the FHIR endpoint like so:

http://[my vhost]/fhir/Patients

Change log

Please see CHANGELOG for more information what has changed recently.

Testing

$ composer test

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email ken@mi-squared.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.

libre-ehr / fhir

Maintainers

Details