diff --git a/migrations.md b/migrations.md
index 12e97462730..a58ee60f938 100644
--- a/migrations.md
+++ b/migrations.md
@@ -410,7 +410,7 @@ The schema builder blueprint offers a variety of methods that correspond to the
[foreignIdFor](#column-method-foreignIdFor)
[foreignUlid](#column-method-foreignUlid)
[foreignUuid](#column-method-foreignUuid)
-[geometryCollection](#column-method-geometryCollection)
+[geography](#column-method-geography)
[geometry](#column-method-geometry)
[id](#column-method-id)
[increments](#column-method-increments)
@@ -418,22 +418,16 @@ The schema builder blueprint offers a variety of methods that correspond to the
[ipAddress](#column-method-ipAddress)
[json](#column-method-json)
[jsonb](#column-method-jsonb)
-[lineString](#column-method-lineString)
[longText](#column-method-longText)
[macAddress](#column-method-macAddress)
[mediumIncrements](#column-method-mediumIncrements)
[mediumInteger](#column-method-mediumInteger)
[mediumText](#column-method-mediumText)
[morphs](#column-method-morphs)
-[multiLineString](#column-method-multiLineString)
-[multiPoint](#column-method-multiPoint)
-[multiPolygon](#column-method-multiPolygon)
[nullableMorphs](#column-method-nullableMorphs)
[nullableTimestamps](#column-method-nullableTimestamps)
[nullableUlidMorphs](#column-method-nullableUlidMorphs)
[nullableUuidMorphs](#column-method-nullableUuidMorphs)
-[point](#column-method-point)
-[polygon](#column-method-polygon)
[rememberToken](#column-method-rememberToken)
[set](#column-method-set)
[smallIncrements](#column-method-smallIncrements)
@@ -546,7 +540,7 @@ The `enum` method creates a `ENUM` equivalent column with the given valid values
The `float` method creates a `FLOAT` equivalent column with the given precision:
- $table->float('amount', 53);
+ $table->float('amount', $precision = 53);
#### `foreignId()` {.collection-method}
@@ -576,19 +570,25 @@ The `foreignUuid` method creates a `UUID` equivalent column:
$table->foreignUuid('user_id');
-
-#### `geometryCollection()` {.collection-method}
+
+#### `geography()` {.collection-method}
-The `geometryCollection` method creates a `GEOMETRYCOLLECTION` equivalent column:
+The `geography` method creates a `GEOGRAPHY` equivalent column with the given spatial type and SRID (Spatial Reference System Identifier):
- $table->geometryCollection('positions');
+ $table->geography('coordinates', subtype: 'point', srid: 4326);
+
+> [!NOTE]
+> Support for spatial types depends on your database driver. Please refer to your database's documentation. If your application is utilizing a PostgreSQL database, you must install the [PostGIS](https://postgis.net) extension before the `geography` method may be used.
#### `geometry()` {.collection-method}
-The `geometry` method creates a `GEOMETRY` equivalent column:
+The `geometry` method creates a `GEOMETRY` equivalent column with the given spatial type and SRID (Spatial Reference System Identifier):
+
+ $table->geometry('positions', subtype: 'point', srid: 0);
- $table->geometry('positions');
+> [!NOTE]
+> Support for spatial types depends on your database driver. Please refer to your database's documentation. If your application is utilizing a PostgreSQL database, you must install the [PostGIS](https://postgis.net) extension before the `geometry` method may be used.
#### `id()` {.collection-method}
@@ -634,13 +634,6 @@ The `jsonb` method creates a `JSONB` equivalent column:
$table->jsonb('options');
-
-#### `lineString()` {.collection-method}
-
-The `lineString` method creates a `LINESTRING` equivalent column:
-
- $table->lineString('positions');
-
#### `longText()` {.collection-method}
@@ -685,27 +678,6 @@ This method is intended to be used when defining the columns necessary for a pol
$table->morphs('taggable');
-
-#### `multiLineString()` {.collection-method}
-
-The `multiLineString` method creates a `MULTILINESTRING` equivalent column:
-
- $table->multiLineString('positions');
-
-
-#### `multiPoint()` {.collection-method}
-
-The `multiPoint` method creates a `MULTIPOINT` equivalent column:
-
- $table->multiPoint('positions');
-
-
-#### `multiPolygon()` {.collection-method}
-
-The `multiPolygon` method creates a `MULTIPOLYGON` equivalent column:
-
- $table->multiPolygon('positions');
-
#### `nullableTimestamps()` {.collection-method}
@@ -734,20 +706,6 @@ The method is similar to the [uuidMorphs](#column-method-uuidMorphs) method; how
$table->nullableUuidMorphs('taggable');
-
-#### `point()` {.collection-method}
-
-The `point` method creates a `POINT` equivalent column:
-
- $table->point('position');
-
-
-#### `polygon()` {.collection-method}
-
-The `polygon` method creates a `POLYGON` equivalent column:
-
- $table->polygon('position');
-
#### `rememberToken()` {.collection-method}
@@ -974,7 +932,6 @@ Modifier | Description
`->virtualAs($expression)` | Create a virtual generated column (MySQL / PostgreSQL / SQLite).
`->generatedAs($expression)` | Create an identity column with specified sequence options (PostgreSQL).
`->always()` | Defines the precedence of sequence values over input for an identity column (PostgreSQL).
-`->isGeometry()` | Set spatial column type to `geometry` - the default type is `geography` (PostgreSQL).
#### Default Expressions
diff --git a/upgrade.md b/upgrade.md
index c9af938aebf..a9ce1d81a6f 100644
--- a/upgrade.md
+++ b/upgrade.md
@@ -18,6 +18,7 @@
- [The `Enumerable` Contract](#the-enumerable-contract)
+- [Spatial Types](#spatial-types)
@@ -62,3 +63,27 @@ The `dump` method of the `Illuminate\Support\Enumerable` contract has been updat
```php
public function dump(...$args);
```
+
+
+### Database
+
+
+#### Spatial Types
+
+**Likelihood Of Impact: Low**
+
+The spatial column types of database migrations have been rewritten to be consistent across all databases. Therefore, you may remove `point`, `lineString`, `polygon`, `geometryCollection`, `multiPoint`, `multiLineString`, `multiPolygon`, and `multiPolygonZ` methods from your migrations and use `geometry` or `geography` methods instead:
+
+```php
+$table->geometry('shapes');
+$table->geography('coordinates');
+```
+
+To explicitly restrict the type or the spatial reference system identifier for values stored in the column on MySQL and PostgreSQL, you may pass the `subtype` and `srid` to the method:
+
+```php
+$table->geometry('dimension', subtype: 'polygon', srid: 0);
+$table->geography('latitude', subtype: 'point', srid: 4326);
+```
+
+The `isGeometry` and `projection` column modifiers of the PostgreSQL grammar have been removed accordingly.