maxlcoder / laravel-dm8

1.2.3 2026-10-28 17:55 UTC

Requires

• php: ^7.3 || ^8.0
• ext-pdo: *
• illuminate/database: ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0
• illuminate/pagination: ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0
• illuminate/support: ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0
• illuminate/validation: ^6.0 || ^7.0 || ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0

Requires (Dev)

• mockery/mockery: ^1.6
• phpunit/phpunit: ^9.6 || ^10.5

MIT

• Woody

Published on Packagist.org on 2026-10-28 17:56 UTC

README

查询写法

1. 使用 selectRaw 或者 DB::raw 函数查询时，如果当前数据库是忽略大小写的，一律返回小写字段名，

推荐更新版本到最新版

修改部分适配 Laravel

1. 适配 insertGetId：省略返回列时通过 PDO 获取自增值，也可显式指定返回列名
2. 修复 DmBuilder 中 DmAutoIncrementHelper 引用
3. 适配 withCount, 主要是 x_table as y 情况 前缀补充，原包，没有在 y 前面追加前缀，和 Laravel 不兼容
4. 适配 cast json ，数组参数转 json 入库
5. 兼容 mysql group_concat 函数，内部转化为 wm_concat 函数
6. 修复表单验证中 exists 和 unique，去除对 getCount 和 getMultiCount 的重写。原包是对 oracle 进行大小写不敏感设置，但是达梦数据库不支持
7. 修复自动递增，匹配 laravel migration。原包中将 migration 中的 int 和 bigint 均转化为 number 无法使 auto_increment 生效

Laravel-DM8

Laravel-DM8 is an Dm Database Driver package for Laravel. Laravel-DM8 is an extension of Illuminate/Database that uses DM8 extension to communicate with Dm. Thanks to @yajra.

Documentations

• You will find user-friendly and updated documentation here: Laravel-DM8 Docs
• All about dm and php:The Underground PHP and Dm Manual

Laravel Version Compatibility

The 1.2.x line accepts PHP ^7.3 || ^8.0 and Illuminate 6–12 (Illuminate 11/12 require 1.2.3 or later). Composer also enforces each Illuminate version's own PHP requirements.

Laravel / Illuminate	Minimum PHP for this package
6, 7, 8	7.3
9	8.0.2
10	8.1
11–12	8.2

Laravel 12 uses the 1.2.x line starting with 1.2.3. PDO_DM must match the installed PHP runtime.

Quick Installation

composer require maxlcoder/laravel-dm8:^1.2.3

Service Provider (Optional on Laravel 5.5+)

Once Composer has installed or updated your packages you need to register Laravel-DM8. Open up config/app.php and find the providers key and add:

LaravelDm8\\Dm8\\Dm8ServiceProvider::class,

Configuration (OPTIONAL)

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=dm

This will copy the configuration file to config/dm.php.

Then, you can set connection data in your .env files:

DB_CONNECTION=dm
DB_HOST=dm.host
DB_PORT=5236
DB_DATABASE=xe
DB_USERNAME=hr
DB_PASSWORD=hr
DB_CHARSET=UTF8

Then run your laravel installation...

License

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

Upgrading to 1.2.3

Version 1.2.3 supports Laravel 6–12 and includes the insertGetId fixes in the package itself. Remove application-level DM8 patch definitions, patch lock entries and custom patch-check hooks, then run composer require maxlcoder/laravel-dm8:^1.2.3 -W. Restart PHP-FPM and queue workers afterward. Keep unrelated application patches if any.

• Since 1.2.1, Query Builder can omit the return column: DB::table('log')->insertGetId($values). This uses a plain INSERT and the write PDO connection's lastInsertId(), including for auto-increment columns named something other than id. PDO_DM must support identity retrieval.
• Passing a return column retains RETURNING behavior: DB::table('log')->insertGetId($values, 'log_id'). Tables without a generated identity should use insert().
• Eloquent save() uses the model's $primaryKey.
• Custom sequences on DmEloquent are allocated explicitly before insertion; an explicitly supplied key is retained.
• OUT keys use PDO::PARAM_INT | PDO::PARAM_INPUT_OUTPUT with PHP_INT_SIZE, rather than a negative buffer length.
• Use PDO_DM native extensions matching your PHP version, CPU architecture and thread-safety mode. Composer packages do not replace native extensions.

Tests

Run composer install and composer test. Regression coverage uses mocked PDO connections and statements for queries, schema compilation, custom primary keys, custom sequences and LOB bindings. No writes to a real DM database are performed. Real insert, LOB and migration integration still needs verification in your test environment.

Laravel 10 is outside official security maintenance. This driver release does not fix framework security advisories.