feat!: support utopia-php/database 8 and PHP 8.5

CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## 0.17.0 (unreleased) — utopia-php/database 8
+
+### Added
+
+- Events carry an `ordinal` dimension: the replica ordinal of a multi-node
+  resource, `0` for the first member. Counters such as dedicated-database
+  inbound, outbound and compute can now tell members apart the way gauges
+  already could. `setup()` adds the column to an existing event table, and the
+  daily materialized view still groups by resource identity, so billing sums
+  every member.
+
+### Breaking
+
+- Requires PHP 8.5 and utopia-php/database 8. The Docker test image builds
+  on `php:8.5.8-cli-alpine`.
+
+### Changed
+
+- The Database adapter creates its collection through the utopia-php/database
+  8 schema API (`Collection`, `Attribute` and `Index` models). The collection
+  is unchanged: the same columns, in the same order, with the same types,
+  sizes, flags and indexes as 0.16 (on MariaDB the table is identical).
+  `setup()` still leaves an existing collection alone, so a collection
+  created by 0.16 is reused as it is.
+- `SQL::getAttributeDocuments()` and `SQL::getIndexDocuments()` return
+  `Utopia\Database\Attribute` and `Utopia\Database\Index` models, which are
+  still `Document`s. The index models no longer carry the ClickHouse-only
+  `indexType` hint; the ClickHouse adapter reads it from
+  `Metric::getEventIndexes()` / `Metric::getGaugeIndexes()` as before.
+- The Database adapter compiles `contains()` through `containsString()`
+  instead of the deprecated `contains()` factory. Matching is unchanged: a
+  substring match on the column.
+- `utopia-php/database` is required as `^8.0`, replacing the temporary
+  `dev-feat-query-lib as 7.0.0` root alias. The branch resolves through its
+  own `8.0.x-dev` branch alias, so `minimum-stability` is `dev` with
+  `prefer-stable: true` until database 8.0.0 is tagged; `stable` is restored
+  with that tag.
+- Requires `utopia-php/client` 0.5 (`^0.5`). The ClickHouse adapter
+  imports `Utopia\Client\Client`, where client 0.5 moved the class.
+- `extra.branch-alias` maps `dev-feat-query-lib` and `dev-main` to
+  `0.17.x-dev`, so a consumer can require the branch before 0.17.0 is tagged.
+
 ## Unreleased — query 0.6.x builder
 
 ### Added

Dockerfile

@@ -1,4 +1,4 @@
-FROM composer:2.0 as step0
+FROM composer:2.8 AS step0
 
 WORKDIR /src/
 
@@ -8,7 +8,7 @@ COPY composer.json /src/
 RUN composer install --ignore-platform-reqs --optimize-autoloader \
     --no-plugins --no-scripts --prefer-dist
 
-FROM php:8.4.22-cli-alpine3.24 as final
+FROM php:8.5.8-cli-alpine AS final
 
 LABEL maintainer="team@appwrite.io"
 

README.md

@@ -101,7 +101,7 @@ $tenant->addBatch([
 Events are request-level metrics like bandwidth, executions, API calls. They are summed when aggregated.
 
 Event-specific columns (see `Metric::EVENT_COLUMNS`): `path`, `method`, `status`,
-`service`, `resource`, `resourceId`, `resourceInternalId`, `teamId`,
+`service`, `resource`, `resourceId`, `resourceInternalId`, `ordinal`, `teamId`,
 `teamInternalId`, `country`, `region`, `hostname`, `osCode`, `osName`,
 `osVersion`, `clientType`, `clientCode`, `clientName`, `clientVersion`,
 `clientEngine`, `clientEngineVersion`, `deviceName`, `deviceBrand`,
@@ -455,7 +455,7 @@ coroutines.
 
 ## System Requirements
 
-Utopia Framework requires PHP 8.4 or later. We recommend using the latest PHP version whenever possible.
+Utopia Framework requires PHP 8.5 or later. We recommend using the latest PHP version whenever possible.
 
 ## Copyright and license
 

composer.json

@@ -16,12 +16,13 @@
         "test": "./vendor/bin/phpunit --configuration phpunit.xml --testsuite \"Test Suite\"",
         "bench": "./vendor/bin/phpunit --configuration phpunit.xml --testsuite Benchmark"
     },
-    "minimum-stability": "stable",
+    "minimum-stability": "dev",
+    "prefer-stable": true,
     "require": {
-        "php": ">=8.4",
+        "php": ">=8.5",
         "psr/http-client": "^1.0",
         "utopia-php/client": "^0.5",
-        "utopia-php/database": "^7.0.0",
+        "utopia-php/database": "^8.0",
         "utopia-php/query": "0.6.*"
     },
     "require-dev": {
@@ -48,5 +49,11 @@
             "php-http/discovery": false,
             "tbachert/spi": false
         }
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-feat-query-lib": "0.17.x-dev",
+            "dev-main": "0.17.x-dev"
+        }
     }
 }