PHPackages microestc/oscardb - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. microestc/oscardb ActiveLibrary[Database & ORM](/categories/database) microestc/oscardb ================= OscarDB driver for Laravel v1.2.0(7mo ago)2403MITPHPPHP ^7.0 || ^8.0 Since Sep 25Pushed 7mo ago1 watchersCompare [ Source](https://github.com/microestc/Laravel-OscarDB)[ Packagist](https://packagist.org/packages/microestc/oscardb)[ RSS](/packages/microestc-oscardb/feed)WikiDiscussions master Synced 1w ago READMEChangelog (1)Dependencies (5)Versions (2)Used By (0) Laravel Oscar Database Package ------------------------------ [](#laravel-oscar-database-package) ### OscarDB (updated for Laravel 8.x) [](#oscardb-updated-for-laravel-8x) [![Latest Stable Version]()](https://packagist.org/packages/microestc/oscardb) [![Total Downloads](https://camo.githubusercontent.com/c442ec59c519a0a099baa6a5452bf5155f38a03216ba36c8f56887e6cea48c9b/68747470733a2f2f706f7365722e707567782e6f72672f6d6963726f657374632f6f7363617264622f646f776e6c6f6164732e706e67)](https://packagist.org/packages/microestc/oscardb) OscarDB is an Oscar Database Driver package for [Laravel Framework](https://laravel.com) *NOTE: This package has not been tested in PHP 8.* **Please report any bugs you may find.** ### 在线安装 [](#在线安装) With [Composer](https://getcomposer.org): ``` composer require microestc/oscardb ``` During this command, Laravel's "Auto-Discovery" feature should automatically register OscarDB's service provider. ### 离线安装 [](#离线安装) With [Composer](https://getcomposer.org): #### 1. 首先获取到该项目源码 （Laravel-OscarDB） [](#1-首先获取到该项目源码-laravel-oscardb) ``` root@deb10:~/works/Laravel-OscarDB# tree . ├── composer.json ├── phpunit.xml ├── readme.md ├── src │ ├── config │ │ └── oscardb.php │ └── Microestc │ └── OscarDB │ ├── Connectors │ │ └── OscarConnector.php │ ├── OscarConnection.php │ ├── OscarDBServiceProvider.php │ ├── Query │ │ ├── Grammars │ │ │ └── OscarGrammar.php │ │ ├── OscarBuilder.php │ │ └── Processors │ │ └── OscarProcessor.php │ └── Schema │ ├── Grammars │ │ └── OscarGrammar.php │ └── OscarSchemaBuilder.php └── tests ├── mocks │ └── PDOMocks.php ├── OscarDBConnectorTest.php ├── OscarDBPDOProcessorTest.php ├── OscarDBQueryBuilderTest.php └── OscarDBSchemaGrammarTest.php 12 directories, 17 files root@deb10:~/works/Laravel-OscarDB# ``` #### 2. 配置项目依赖组件 [](#2-配置项目依赖组件) 在项目配置文件 composer.json 中添加下列配置 ``` "require": { "microestc/oscardb": "*" }, "repositories": [ { "packagist.org": false, "type": "path", "url": "../Laravel-OscarDB", "options": { "symlink": false } } ], ``` > `"url": "../Laravel-OscarDB",` 该路径为Laravel-OscarDB源码文件的路径 #### 3. 执行离线安装 [](#3-执行离线安装) ``` composer update ``` 安装结果 ``` root@deb10:~/works/webapp# composer update PHP Warning: Module 'PDO_ACI' already loaded in Unknown on line 0 Warning: Module 'PDO_ACI' already loaded in Unknown on line 0 PHP Warning: Xdebug MUST be loaded as a Zend extension in Unknown on line 0 Warning: Xdebug MUST be loaded as a Zend extension in Unknown on line 0 PHP Warning: Module 'xdebug' already loaded in Unknown on line 0 Warning: Module 'xdebug' already loaded in Unknown on line 0 Xdebug: [Step Debug] Could not connect to debugging client. Tried: localhost:9003 (through xdebug.client_host/xdebug.client_port) :-( PHP Warning: Module 'PDO_ACI' already loaded in Unknown on line 0 Warning: Module 'PDO_ACI' already loaded in Unknown on line 0 PHP Warning: Xdebug MUST be loaded as a Zend extension in Unknown on line 0 Warning: Xdebug MUST be loaded as a Zend extension in Unknown on line 0 Xdebug: [Step Debug] Could not connect to debugging client. Tried: localhost:9003 (through xdebug.client_host/xdebug.client_port) :-( Composer is operating slower than normal because you have Xdebug enabled. See https://getcomposer.org/xdebug Do not run Composer as root/super user! See https://getcomposer.org/root for details Continue as root/super user [yes]? y Loading composer repositories with package information Updating dependencies Lock file operations: 1 install, 0 updates, 0 removals - Locking microestc/oscardb (dev-master) Writing lock file Installing dependencies from lock file (including require-dev) Package operations: 1 install, 0 updates, 0 removals - Installing microestc/oscardb (dev-master): Mirroring from ../Laravel-OscarDB Package swiftmailer/swiftmailer is abandoned, you should avoid using it. Use symfony/mailer instead. Generating optimized autoload files > Illuminate\Foundation\ComposerScripts::postAutoloadDump > @php artisan package:discover --ansi PHP Warning: Module 'PDO_ACI' already loaded in Unknown on line 0 Warning: Module 'PDO_ACI' already loaded in Unknown on line 0 PHP Warning: Xdebug MUST be loaded as a Zend extension in Unknown on line 0 Warning: Xdebug MUST be loaded as a Zend extension in Unknown on line 0 PHP Warning: Module 'xdebug' already loaded in Unknown on line 0 Warning: Module 'xdebug' already loaded in Unknown on line 0 Xdebug: [Step Debug] Could not connect to debugging client. Tried: localhost:9003 (through xdebug.client_host/xdebug.client_port) :-( Discovered Package: facade/ignition Discovered Package: fruitcake/laravel-cors Discovered Package: laravel/sail Discovered Package: laravel/sanctum Discovered Package: laravel/tinker Discovered Package: microestc/oscardb Discovered Package: nesbot/carbon Discovered Package: nunomaduro/collision Package manifest generated successfully. 77 packages you are using are looking for funding. Use the `composer fund` command to find out more! > @php artisan vendor:publish --tag=laravel-assets --ansi --force PHP Warning: Module 'PDO_ACI' already loaded in Unknown on line 0 Warning: Module 'PDO_ACI' already loaded in Unknown on line 0 PHP Warning: Xdebug MUST be loaded as a Zend extension in Unknown on line 0 Warning: Xdebug MUST be loaded as a Zend extension in Unknown on line 0 PHP Warning: Module 'xdebug' already loaded in Unknown on line 0 Warning: Module 'xdebug' already loaded in Unknown on line 0 Xdebug: [Step Debug] Could not connect to debugging client. Tried: localhost:9003 (through xdebug.client_host/xdebug.client_port) :-( No publishable resources for tag [laravel-assets]. Publishing complete. ``` ### 配置 [](#配置) Next, publish OscarDB's configuration file using the vendor:publish Artisan command. This will copy OscarDB's configuration file to `config/oscardb.php` in your project. ``` php artisan vendor:publish --tag=oscardb-config ``` To finish the installation, set your environment variables (typically in your .env file) to the corresponding env variables used in `config/oscardb.php`: such as `DB_HOST`, `DB_USERNAME`, etc. Additionally, it may be necessary for your app to configure the NLS\_DATE\_FORMAT of the database connection session, before any queries are executed. One way to accomplish this is to run a statement in your `AppServiceProvider`'s `boot`method, for example: ``` if (config('database.default') === 'oscardb') { DB::statement("ALTER SESSION SET NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'"); } ``` ### Basic Usage [](#basic-usage) The configuration file for this package is located at `config/oscardb.php`. In this file, you define all of your Oscar database connections. If you need to make more than one connection, just copy the example one. If you want to make one of these connections the default connection, enter the name you gave the connection into the "Default Database Connection Name" section in `config/database.php`. such as in config/database.php ``` 'default' => 'oscardb', ``` Once you have configured the OscarDB database connection(s), you may run queries using the `DB` facade as normal. *NOTE: ACI is the default driver. If you want to use the PDO\_ACI driver, change the `driver` value to `'pdo'` in the `config/oscardb.php` file for whichever connections you wish to have utilize PDO\_ACI. Setting the driver to `'pdo'` will make OscarDB use the [PDO\_ACI](https://www.php.net/manual/en/ref.pdo-aci.php) extension. Given any other `driver` value, OscarDB will use the [ACI Functions](https://www.php.net/manual/en/ref.aci.php).* ``` $results = DB::select('select * from users where id = ?', [1]); ``` The above statement assumes you have set the default connection to be the Oscar connection you setup in config/database.php file and will always return an `array` of results. ``` $results = DB::connection('oscardb')->select('select * from users where id = ?', [1]); ``` Just like the built-in database drivers, you can use the connection method to access the Oscar database(s) you setup in config/oscardb.php file. #### Inserting Records Into A Table With An Auto-Incrementing ID [](#inserting-records-into-a-table-with-an-auto-incrementing-id) ``` $id = DB::connection('oscardb')->table('users')->insertGetId( ['email' => 'john@example.com', 'votes' => 0], 'userid' ); ``` > **Note:** When using the insertGetId method, you can specify the auto-incrementing column name as the second parameter in insertGetId function. It will default to "id" if not specified. See [Laravel Database Basic Docs](https://laravel.com/docs/8.x/database) for more information. ### Unimplemented Features [](#unimplemented-features) Some of the features available in the first-party Laravel database drivers are not implemented in this package. Pull requests are welcome for implementing any of these features, or for expanding this list if you find any unimplemented features not already listed. #### Query Builder [](#query-builder) - insertOrIgnore `DB::from('users')->insertOrIgnore(['email' => 'foo']);` - insertGetId with empty values `DB::from('users')->insertGetId([]);` (but calling with non-empty values is supported) - upserts `DB::from('users')->upsert([['email' => 'foo', 'name' => 'bar'], ['name' => 'bar2', 'email' => 'foo2']], 'email');` - deleting with a join `DB::from('users')->join('contacts', 'users.id', '=', 'contacts.id')->where('users.email', '=', 'foo')->delete();` - deleting with a limit `DB::from('users')->where('email', '=', 'foo')->orderBy('id')->take(1)->delete();` - json operations `DB::from('users')->where('items->sku', '=', 'foo-bar')->get();` #### Schema Builder [](#schema-builder) - drop a table if it exists `Schema::dropIfExists('some_table');` - drop all tables, views, or types `Schema::dropAllTables()`, `Schema::dropAllViews()`, and `Schema::dropAllTypes()` - set collation on a table `$blueprint->collation('BINARY_CI')` - set collation on a column `$blueprint->string('some_column')->collation('BINARY_CI')` - set comments on a table `$blueprint->comment("This table is great.")` - set comments on a column `$blueprint->string('foo')->comment("Some helpful info about the foo column")` - set the starting value of an auto-incrementing column `$blueprint->increments('id')->startingValue(1000)` - create a private temporary table `$blueprint->temporary()` - rename an index `$blueprint->renameIndex('foo', 'bar')` - specify an algorithm when creating an index via the third argument `$blueprint->index(['foo', 'bar'], 'baz', 'hash')` - create a spatial index `$blueprint->spatialIndex('coordinates')` - create a spatial index fluently `$blueprint->point('coordinates')->spatialIndex()` - create a generated column, like the mysql driver has `virtualAs` and `storedAs` and postgres has `generatedAs`; ie, assuming an integer type column named price exists on the table, `$blueprint->integer('discounted_virtual')->virtualAs('price - 5')` - create a json column `$blueprint->json('foo')` or jsonb column `$blueprint->jsonb('foo')` (Oscar recommends storing json in VARCHAR2, CLOB, or BLOB columns) - create a datetime with timezone column without precision `$blueprint->dateTimeTz('created_at')`, or with precision `$blueprint->timestampTz('created_at', 1)` - create Laravel-style timestamp columns having a timezone component `$blueprint->timestampsTz()` - create a uuid column `$blueprint->uuid('foo')` (Oscar recommends a column of data type 16 byte raw for storing uuids) - create a foreign uuid column `$blueprint->foreignUuid('foo')` - create a column to hold IP addresses `$blueprint->ipAddress('foo')` (would be implemented as varchar2 45) - create a column to hold MAC addresses `$blueprint->macAddress('foo')` (would be implemented as varchar2 17) - create a geometry column `$blueprint->geometry('coordinates')` - create a geometric point column `$blueprint->point('coordinates')` - create a geometric point column specifying srid `$blueprint->point('coordinates', 4326)` - create a linestring column `$blueprint->linestring('coordinates')` - create a polygon column `$blueprint->polygon('coordinates')` - create a geometry collection column `$blueprint->geometrycollection('coordinates')` - create a multipoint column `$blueprint->multipoint('coordinates')` - create a multilinestring column `$blueprint->multilinestring('coordinates')` - create a multipolygon column `$blueprint->multipolygon('coordinates')` - create a double column without specifying second or third parameters `$blueprint->double('foo')` (but `$blueprint->double('foo', 5, 2)` is supported) - create a timestamp column with `useCurrent` modifier `$blueprint->timestamp('created_at')->useCurrent()` ### License [](#license) Licensed under the \[MIT License\]. DEMO ---- [](#demo) 创建web 新应用 webapp ``` laravel new webapp cd webapp ``` 安装 microestc/oscardb ``` composer require microestc/oscardb ``` 创建配置文件 config/oscardb.php ```