Laravel Magellan Laravel Package

Added

• Added custom SRID support for Geojson parser and validation (GeojsonParser, TransformsGeojsonGeometry, GeometryGeojsonRule)

Added

• Added Laravel 13.x support
• Added facades for parsers (WKBParser, WKTParser, GeojsonParser) and generators (WKBGenerator, WKTGenerator, GeojsonGenerator)

Fixed

• Fixed dirty comparison of Model attributes using the Geometry casts

Fixed

• Fixed using the casts after serialization, e.g. in queueable anonymous event listeners. (thanks @henridv #149)

Please check out the upgrade guide for more recommended steps.

Breaking

• Removed support for deprecated Laravel versions 9.x & 10.x
• Require at least PHP 8.2
• Removed the HasPostgisColumns trait & $postgisColumns property.
• Removed GeometryWKBCast
• Refactored BBoxCast to be generic & internal, please use Box subclasses directly
• Removed automatic SRID transformation
• Removed st prefixed builder functions (e.g. stSelect, stWhere, ...)
• Removed GeometryType Enum
• Renamed toString to toRawSql on Box classes
• Removed Doctrine DBAL types & registration (was used for older Laravel versions)
• GeometryGeojsonRule is not directly invokable anymore

Added

• Added Laravel 12 & PHP 8.4 support
• Added Castable to all geometries to use them as casters, instead of the GeometryWKBCast
• Added Castable to all boxes to use them as casters, instead of the BBoxCast
• Added Aliased Expression class as wrapper for AS in query selects
  • Added ->as() helper method on MagellanBaseExpression
• Added withMagellanCasts() as EloquentBuilder macro
• Added AsGeometry and AsGeography database expressions
• Added fromString() to Box classes to create a box from a string
• Added Stringable interface to all box classes
• Added JsonSerializable to Box2D and Box3D

Improved

• Validate the structure of Geometry coordinates to be an array in the GeojsonParser and fail if not
• Use of ST functions directly in the Laravel default builder methods
• Use of ST functions directly in Model::create array
• Renamed parameters of ST functions that can receive geometry or geography from $geometry to $geometryOrGeography
• Geometry & Box implements Expression and therefore can be used in ->select(...) directly now

Fixed

• Fixed only using default PHP string precision in Box toRawSql methods, now uses the maximum precision

Removed

• Removed magellan:update-postgis-columns command
• Removed magellan.eloquent & magellan.model_directories configs

Added

• Support for Laravel 12.x

Fixed

• Fixed only using a precision of 6 decimal digits in WKT, now uses the maximum precision

Added

• PostGIS ST_LineSubstring support
• PostGIS ST_LineFromEncodedPolyline support
• PostGIS ST_LineLocatePoint support
• Added ST::asGeoJson function to convert geometries to GeoJSON via the database

Fixed

• Fixed Expression types in SRID-related functions
• Fixed missing schema prefix for generated SQL of first-level ST functions
• Fixed numeric SRID queries in ST::transform and ST::setSRID (thanks @BezBIS #91)
• Fixed ST::buffer & ST:offsetCurve: Correctly renamed styleMitreLevel to styleMitreLimit

Improved

• Only override attribute preparation functions on models instead of performInsert or performUpdate entirely (thanks @RomainMazB #89)

Fixed

• Fixed geometries not being passed to model events (fixes #87) (thanks @RomainMazB #89)

Added

• Laravel 11.x support

Improved

• Updated spatie/invade to v2, works without reflection now 🥳

Fixed

• Fixed not updating Point dimension when using setAltitude

Added

• Added as parameter for stFrom function
• Aligned stHaving with stWhere to also accept string column and ST expressions, boxes and geometries as value

Fixed

• Fixed builder macro docblocks to use FQDN for an issue within laravel-ide-helper
• Fixed ST_PROJECT function not being migrated to the GeometryType enum.
• Fixed model attribute equality checks for geometries, reduces unnecessary database updates (thanks @adamczykpiotr)

Improved

• Added Typing for Box2D and Box3D in GeoParam allowing Box objects as params in Magellan Expressions
• Added evaluation of parameters in stWhere in order to also allow magellan expressions in value and regular string, boxes or geometries in first parameter

Added

• Added Missing Distance Relationships Functions (Fixes #46)

Fixed

• Fixed nullable handling in TransformsGeojsonGeometry trait (Fixes #37)

Fixed

• Fixed missing handling of expressions in GeoParam

Fixed

• Fixed generation of invalid FeatureCollection in case of zero database rows (thanks @djfhe)

Improved

• Added config for geodetic SRIDs (most of the time WGS84 is sufficient, but there are much more geodetic SRIDs than 4326)

Fixed

• Fixed sql syntax error when trying to create magellanGeography (fixes #27, thanks @tanabi)
• Fix getValue calls on Expressions in Laravel 10

Added

• Laravel 10 support
• PHP 8.2 support

Improved

• Optional geometry type param for ST_Buffer enabling easier control about metric buffering

Fixed

• Typing bug when trying to use a Closure as Geoparam

Fixed

• Fix some ST functions not being migrated to the GeometryType enum.

Fixed

• Fix bindings being wrongly converted to SQL function statements, eg. in query()->update() calls.

• Initial Release 🎉