Laravel-OCI8 is an Oracle Database Driver package for Laravel. Laravel-OCI8 is an extension of Illuminate/Database that uses OCI8 extension to communicate with Oracle. Thanks to @taylorotwell.
- You will find user-friendly and updated documentation here: Laravel-OCI8 Docs
- All about oracle and php:The Underground PHP and Oracle Manual
| Laravel | Package |
|---|---|
| 5.1.x | 5.1.x |
| 5.2.x | 5.2.x |
| 5.3.x | 5.3.x |
| 5.4.x | 5.4.x |
| 5.5.x | 5.5.x |
| 5.6.x | 5.6.x |
| 5.7.x | 5.7.x |
| 5.8.x | 5.8.x |
| 6.x.x | 6.x.x |
| 7.x.x | 7.x.x |
| 8.x.x | 8.x.x |
| 9.x.x | 9.x.x |
composer require yajra/laravel-oci8:^9Once Composer has installed or updated your packages you need to register Laravel-OCI8. Open up config/app.php and find the providers key and add:
Yajra\Oci8\Oci8ServiceProvider::class,Finally you can optionally publish a configuration file by running the following Artisan command.
If config file is not publish, the package will automatically use what is declared on your .env file database configuration.
php artisan vendor:publish --tag=oracleThis will copy the configuration file to config/oracle.php.
Note: For Laravel Lumen configuration, make sure you have a
config/database.phpfile on your project and append the configuration below:
'oracle' => [
'driver' => 'oracle',
'tns' => env('DB_TNS', ''),
'host' => env('DB_HOST', ''),
'port' => env('DB_PORT', '1521'),
'database' => env('DB_DATABASE', ''),
'service_name' => env('DB_SERVICE_NAME', ''),
'username' => env('DB_USERNAME', ''),
'password' => env('DB_PASSWORD', ''),
'charset' => env('DB_CHARSET', 'AL32UTF8'),
'prefix' => env('DB_PREFIX', ''),
'prefix_schema' => env('DB_SCHEMA_PREFIX', ''),
'edition' => env('DB_EDITION', 'ora$base'),
'server_version' => env('DB_SERVER_VERSION', '11g'),
'load_balance' => env('DB_LOAD_BALANCE', 'yes'),
'dynamic' => [],
],Then, you can set connection data in your
.envfiles:
DB_CONNECTION=oracle
DB_HOST=oracle.host
DB_PORT=1521
DB_SERVICE_NAME=orcl
DB_DATABASE=xe
DB_USERNAME=hr
DB_PASSWORD=hrIf you want to connect to a cluster containing multiple hosts, you can either set
tnsmanually or set host as a comma-separated array and configure other fields as you wish:
DB_CONNECTION=oracle
DB_HOST=oracle1.host, oracle2.host
DB_PORT=1521
DB_SERVICE_NAME=orcl
DB_LOAD_BALANCE=no
DB_DATABASE=xe
DB_USERNAME=hr
DB_PASSWORD=hrIf you need to connect with the service name instead of tns, you can use the configuration below:
'oracle' => [
'driver' => 'oracle',
'host' => 'oracle.host',
'port' => '1521',
'database' => 'xe',
'service_name' => 'sid_alias',
'username' => 'hr',
'password' => 'hr',
'charset' => '',
'prefix' => '',
]In some cases you may wish to set the connection parameters dynamically in your app. For instance, you may access more than one database, or your users may already have their own accounts on the Oracle database:
'oracle' => [
'driver' => 'oracle',
'host' => 'oracle.host',
'port' => '1521',
'service_name' => 'sid_alias',
'prefix' => 'schemaowner',
'dynamic' => [App\Models\Oracle\Config::class, 'dynamicConfig'],
]The callback function in your app must be static and accept a reference to the $config[] array (which will already be populated with values set in the config file):
namespace App\Models\Oracle;
class Config {
public static function dynamicConfig(&$config) {
if (Illuminate\Support\Facades\Auth::check()) {
$config['username'] = App\Oracle\Config::getOraUser();
$config['password'] = App\Oracle\Config::getOraPass();
}
}
}Then run your laravel installation...
When using oracle, we may encounter a problem on authentication because oracle queries are case sensitive by default. By using this oracle user provider, we will now be able to avoid user issues when logging in and doing a forgot password failure because of case sensitive search.
To use, just update auth.php config and set the driver to oracle
'providers' => [
'users' => [
'driver' => 'oracle',
'model' => App\User::class,
],
]The MIT License (MIT). Please see License File for more information.