mrspockde/laravel-firebird v4.0.0-beta.1

mrspockde/laravel-firebird v4.0.0-beta.1

Status: GitHub prerelease. Packagist publication and released-beta consumer validation are pending.
Release commit: e8ea7bd001459443bf1f0812bc5aeb688fc70815.
This is the first beta of the independent package, not the existing
harrygulliford/laravel-firebird beta with the same version number.
Repository: https://github.com/MrSpockDe/laravel-firebird

Platforms

• Laravel 12 / Illuminate >= 12.17: PHP 8.2–8.5 in CI.
• Laravel 13: PHP 8.3–8.5 in CI; PHP 8.2 is excluded.
• Firebird 4 and 5, through PDO Firebird and the Firebird client library.
• Ubuntu CI, lowest and stable dependency resolutions, 28 matrix combinations.
• Composer constraints remain PHP ^8.2 and Illuminate ^12.17|^13.0. These do not
  establish test coverage for every future version admitted by the constraints.

Package identity and installation

The published tag can be selected through the explicit fork VCS repository:

composer config repositories.firebird vcs https://github.com/MrSpockDe/laravel-firebird.git
composer require "mrspockde/laravel-firebird:4.0.0-beta.1"

Packagist registration and indexing have not been performed as part of this
release. Normal Packagist installation without the VCS override is not yet
claimed. Installation of the exact published beta still requires verification.

The exact beta constraint allows the prerelease without globally lowering
minimum-stability. Existing consumers must remove the old package requirement
and resolve the new package through Composer; do not edit composer.lock manually.
The packages conflict to prevent duplicate classes. No replace rule is declared.
Validate the exact version, source URL and final commit in the resulting lockfile,
and perform a clean Packagist installation without a VCS override.

PHP namespaces and PSR-4 mappings remain HarryGulliford\Firebird, including
HarryGulliford\Firebird\FirebirdServiceProvider for Laravel package discovery.
The installed directory changes to vendor/mrspockde/laravel-firebird.

Functionality included in the candidate

• Dedicated Laravel Firebird connections and automatic provider discovery.
• Schema create/drop, representative column alterations, primary/unique keys,
  indexes, foreign keys and schema introspection.
• Identity columns and generated IDs through INSERT ... RETURNING and the
  custom query processor; no PDO::lastInsertId() dependency.
• Standard Eloquent create/read/update/delete, timestamps, hasMany/belongsTo,
  lazy/eager loading and relationship inserts.
• Regression tests for transactions, bindings, native types and constraint errors.

The existing migration support matrix is explicitly a
historical snapshot at commit 065f24d, not a current exhaustive beta checklist.
Later tests include view introspection, schema wiping, comments and identity
options; consult the corresponding tests and final release evidence when making
specific support claims. This beta does not promise complete Laravel API parity.

Known limitations

• Schema migrations are not automatically wrapped in transactions by Laravel:
  the schema grammar reports supportsSchemaTransactions() = false.
• Temporary tables, table/index rename and spatial indexes are unsupported.
• Supplying storedAs() or enabling useCurrentOnUpdate() is rejected with
  LogicException by the schema grammar.
• change() rejects enum column definitions and computed-column alterations
  through virtualAs() with LogicException.
• change() also rejects explicitly supplied charset or collation alterations
  with LogicException; this does not imply that charset/collation modifiers
  are unsupported when creating columns.
• TRUNCATE, shared locks and UPDATE/DELETE with joins are unsupported.
• Unsigned integer range semantics are not enforced by Firebird types.
• Some raw SQL parameter expressions require explicit CASTs for type inference.
• Batch inserts reject raw expressions; insertOrIgnoreUsing() and
  insertOrIgnoreReturning() are unsupported.
• RESTRICT foreign-key actions are rejected; use explicit NO ACTION where needed.
• Identity counters may advance after failed or ignored inserts.
• No production-readiness guarantee; exercise beta features on controlled data.

See the README for binding and insertOrIgnore caveats.

Evidence and remaining release gate

Previous code baseline: 6ddcad8.
Its CI run
passed all 28 matrix jobs and the aggregate check. OweFlow validated a connection,
the basic Artisan migration lifecycle, and an opt-in Eloquent integration test
with 64 assertions against that dev-branch baseline; these are not tests of an
installed independent beta tag.

Tested development commit

1b2586fd5c375052a4a2eb2133c8d88f6a1a2c3f includes the independent package
identity. Its completed CI run
succeeded: 29 successful jobs, including all 28 PHP/Laravel/Firebird matrix jobs
and ci-success; no failed or skipped jobs. Job counts do not imply that every
individual test had no skips. This is driver-suite evidence for that exact commit.

An independent, disposable Laravel 13.32.0 consumer on PHP 8.5.2 with Composer
2.9.5 successfully installed the driver as a dependency via the explicit fork VCS
repository, using:

composer require "mrspockde/laravel-firebird:4.x-dev#1b2586fd5c375052a4a2eb2133c8d88f6a1a2c3f" --prefer-dist --no-interaction

The consumer's lockfile and installed metadata confirmed:

• Package mrspockde/laravel-firebird, version 4.x-dev.
• Source https://github.com/MrSpockDe/laravel-firebird.git and the exact commit above.
• Installation at vendor/mrspockde/laravel-firebird; the upstream package absent.
• Working Composer autoloading and automatic discovery and loading of
  HarryGulliford\Firebird\FirebirdServiceProvider, without manual registration.

In a separate disposable Composer resolution scenario, simultaneously requiring
this pinned development package and harrygulliford/laravel-firebird:4.0.0-beta.1
failed as expected because of the declared package conflict. The successful
consumer was not modified for this negative test.

This establishes independent VCS dependency installation in addition to driver CI.
It does not establish installation from a beta tag or Packagist, nor does the
installation test repeat the OweFlow database checks against the renamed package.

Final release commit and pending checks

Approved release commit: e8ea7bd001459443bf1f0812bc5aeb688fc70815.
Final candidate CI
completed successfully for this exact commit: 29 successful jobs, including all
28 matrix jobs and ci-success; zero failed, cancelled or skipped jobs.
The changes since the independently installed development commit are documentation only.
The independent VCS installation test described above remains evidence for that
earlier development commit, not a test of installation from this beta tag.

Packagist registration/indexing, installation of the exact published beta, and
final OweFlow connection, migration and Eloquent verification remain pending and
require separate approval. OweFlow has not been tested against this published beta.
Preserve its existing database state; destructive migration lifecycle checks
require a separately approved clean database.

The LICENSE preserves the reviewed upstream provenance and complete MIT terms
without inventing an absent copyright-holder/date notice.

Attribution and license

MIT; see LICENSE. Original credits to Harry Gulliford,
Jacques van Zuydam, Simonov Denis and upstream contributors are preserved in the
README. This independent package does not modify or publish the upstream package.