v1

2026-07-19 21:22:39 +03:00
parent 3221e7b5f5
commit e029cc58e2
7 changed files with 524 additions and 3 deletions
@@ -1,3 +1,45 @@
-# Laravel-Firebird
-
-Firebird connector for Laravel
+# Firebird connector for Laravel
+
+## Usage
+
+### 1. Install
+
+Use `composer require codefort/firebird` to install the project
+
+### 2. Register
+
+Register `CodeFort\Firebird\FirebirdConnector` with `AppServiceProvider`
+
+File `app\Providers\AppServiceProvider.php`:
+
+```php
+use CodeFort\Firebird\FirebirdConnector;
+
+class AppServiceProvider extends ServiceProvider
+{
+    public function register(): void
+    {
+        FirebirdConnector::register($this->app);
+        ...
+	}
+}
+```
+
+### 3. Configure connection
+
+File `config\database.php`
+
+```php
+    'database' => [
+    	'driver' 	=> 'firebird',
+    	'host'		=> env('DB_HOST', 'localhost'),
+    	'port'		=> env('DB_PORT', ''),
+    	'database'	=> env('DB_NAME', ''),
+        'username' 	=> env('DB_USER', 'SYSDBA'),
+        'password' 	=> env('DB_PASS', 'masterkey'),
+        'charset' 	=> 'utf8',
+        // 'options' 	=> [ PDO::ATTR_AUTOCOMMIT => false ],
+    ],
+```
+
+Settings autocommit option to false will require to start transaction explicitly even for read access