[Feature] - Upgrade to Symfony 7.4, PHP 8.3+, API Platform 4.2 (#40)

* [Feature] - Ajoute le déploiement pour les branches 'main-*'

* Initial plan

* Update composer.json and configuration for Symfony 7.4, PHP 8.5, API Platform 4.2

Co-authored-by: Xusifob <8103268+Xusifob@users.noreply.github.com>

* Update composer.lock with Symfony 7.4, API Platform 4.2, PHP 8.3

Co-authored-by: Xusifob <8103268+Xusifob@users.noreply.github.com>

* Update Doctrine DBAL code for DBAL 3 compatibility (remove SQLLogger, fix getDatabasePlatform)

Co-authored-by: Xusifob <8103268+Xusifob@users.noreply.github.com>

* Add upgrade notes documentation for Symfony 7.4, PHP 8.3+, API Platform 4.2

Co-authored-by: Xusifob <8103268+Xusifob@users.noreply.github.com>

* Remove insecure composer config (secure-http: false) and redundant packagist repository

Co-authored-by: Xusifob <8103268+Xusifob@users.noreply.github.com>

* Add migration summary document

Co-authored-by: Xusifob <8103268+Xusifob@users.noreply.github.com>

* fixes

* fixes

* fixes

* fixes

* fixes

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Xusifob <8103268+Xusifob@users.noreply.github.com>

Author: Xusifob

.github/actions/build-docker-image/action.yaml

@@ -37,7 +37,7 @@ inputs:
   php_version:
     description: "The version of PHP to use"
     required: false
-    default: '8.3'
+    default: '8.5'
 
 runs:
   using: 'composite'

.github/actions/create-test-db/action.yaml

@@ -7,7 +7,7 @@ runs:
     - name: Set up PHP
       uses: shivammathur/setup-php@v2
       with:
-        php-version: 8.3
+        php-version: 8.5
         extensions: mbstring, intl, pdo_sqlite
 
     - name: Adjust ownership

.github/workflows/lint.yml

@@ -13,7 +13,7 @@ jobs:
         uses: shivammathur/setup-php@v2
         with:
           extensions: calendar, dom, exif, fileinfo, gd, http, imagick, intl, json, openssl, tidy, xml, zip
-          php-version: 8.3
+          php-version: 8.5
           tools: composer:v2
 
       - name: Validate composer.json and composer.lock

.github/workflows/production-release.yaml

@@ -9,6 +9,7 @@ on:
   push:
     branches:
       - main
+      - main-*
     tags:
       - 'v*' # Push events to matching v*, i.e. v1.0, v20.15.10
 

.github/workflows/tests.yaml

@@ -1,7 +1,7 @@
 name: PHPUnit
 
 env:
-  PHP_VERSION: 8.3
+  PHP_VERSION: 8.5
   DATABASE_URL: "/var/test_db.sqlite"
   DATABASE_ENGINE: "pdo_sqlite"
 

.php-version

@@ -1 +1 @@
-7.3
+8.5

README.md

@@ -4,7 +4,7 @@
 
 This project contains all scripts to fetch and store data as well as a fully functioning API to fetch this data.
 
-The project is based on **PHP 8.3**,  **[API-Platform 3.4](https://api-platform.com/docs/v2.5/distribution/)** and **[Symfony 6.4](https://symfony.com/)**
+The project is based on **PHP 8.3+**,  **[API-Platform 4.2](https://api-platform.com/)** and **[Symfony 7.4](https://symfony.com/)**
 
 Live API is available at [https://data.instamed.fr](https://data.instamed.fr).
 

UPGRADE_NOTES.md

@@ -0,0 +1,90 @@
+# Upgrade Notes: Symfony 7.4, PHP 8.3+, API Platform 4.2
+
+## Summary
+
+This project has been upgraded from:
+- Symfony 6.4 → Symfony 7.4
+- PHP 8.3 (min) → PHP 8.3+ (ready for 8.5)
+- API Platform 3 → API Platform 4.2
+- Doctrine DBAL 2.x → DBAL 3.x
+- Doctrine ORM 2.x → ORM 3.x
+- Doctrine Annotations 1.x → Annotations 2.x
+
+## Changes Made
+
+### 1. Dependency Updates (composer.json)
+- Updated all Symfony packages to 7.4.*
+- Updated API Platform to ^4.2
+- Updated Doctrine DBAL to ^3.0
+- Updated Doctrine ORM to ^2.9 || ^3.0
+- Updated Doctrine Annotations to ^2.0
+- Updated PHP requirement to >=8.3
+- Updated .php-version to 8.5
+
+### 2. Configuration Updates
+- Updated API Platform exception namespaces in `config/services.yaml`:
+  - `ApiPlatform\Core\Bridge\Symfony\Validator\Exception\ValidationException` → `ApiPlatform\Validator\Exception\ValidationException`
+  - `ApiPlatform\Core\Exception\ItemNotFoundException` → `ApiPlatform\Exception\ItemNotFoundException`
+
+### 3. Code Updates for DBAL 3 Compatibility
+- Updated `src/Doctrine/PointWrapper.php`:
+  - Removed SQLLogger usage (deprecated in DBAL 3)
+  - Fixed `getDriver()->getDatabasePlatform()` → `getDatabasePlatform()`
+  - Removed `setFetchMode()` call (deprecated in DBAL 3)
+
+### 4. Documentation
+- Updated README.md to reflect new versions
+
+## Compatibility Notes
+
+### Code Already Compatible
+The codebase was already well-prepared for these upgrades:
+- ✅ Using PHP 8 attributes instead of annotations
+- ✅ Using new API Platform Metadata (ApiResource, Get, GetCollection, ApiFilter, ApiProperty)
+- ✅ Using DBAL 3 methods like `fetchAllAssociative()` instead of deprecated `fetchAll()`
+- ✅ State Providers using new API Platform 4 `ProviderInterface`
+- ✅ Filters extending new API Platform 4 classes
+
+### Installation Notes
+Due to GitHub rate limiting during the upgrade process, the full `vendor/` directory installation should be completed in your Docker environment or CI/CD pipeline with proper GitHub authentication. The `composer.lock` file has been successfully updated with all correct versions.
+
+To complete the installation:
+```bash
+# In Docker container
+make shell
+composer install --ignore-platform-req=ext-redis
+```
+
+### Testing
+After completing the vendor installation, run the test suite:
+```bash
+make phpunit
+```
+
+## Potential Breaking Changes
+
+### Doctrine DBAL 3
+- If any custom code uses DBAL 2-specific methods, they may need updates
+- The `wrapper_class` configuration in doctrine.yaml is still present but may need verification
+
+### Symfony 7
+- Review any deprecated Symfony 6 features that may have been removed in Symfony 7
+- Check for any custom event listeners or subscribers that might need updates
+
+### API Platform 4
+- If using any custom decorators or extensions, verify compatibility with API Platform 4
+- Check OpenAPI/Swagger documentation generation
+
+## Post-Upgrade Checklist
+- [ ] Complete vendor installation
+- [ ] Run database migrations if needed
+- [ ] Run all tests: `make phpunit`
+- [ ] Check application functionality
+- [ ] Review logs for deprecation warnings
+- [ ] Update CI/CD pipelines if needed
+- [ ] Update deployment documentation
+
+## Resources
+- [Symfony 7.4 Upgrade Guide](https://symfony.com/doc/current/setup/upgrade_major.html)
+- [API Platform 4 Upgrade Guide](https://api-platform.com/docs/core/upgrade-guide/)
+- [Doctrine DBAL 3 Upgrade Guide](https://github.com/doctrine/dbal/blob/3.0.x/UPGRADE.md)

composer.json

@@ -4,46 +4,45 @@
   "type": "project",
   "license": "proprietary",
   "require": {
-    "php": ">=8.3",
+    "php": ">=8.5",
     "ext-ctype": "*",
     "ext-curl": "*",
     "ext-iconv": "*",
     "ext-intl": "*",
     "ext-json": "*",
     "ext-zip": "*",
     "ext-zlib": "*",
-    "api-platform/core": "^3",
+    "api-platform/core": "^4.2",
     "cocur/slugify": "^4.6",
-    "doctrine/annotations": "^1.0",
     "doctrine/cache": "^2.2",
-    "doctrine/dbal": "2.*",
+    "doctrine/dbal": "^3.0",
     "doctrine/doctrine-bundle": "^2",
     "doctrine/doctrine-migrations-bundle": "^3.0",
-    "doctrine/orm": "^2.9",
+    "doctrine/orm": "^2.9 || ^3.0",
     "doctrine/persistence": "^3",
     "fakerphp/faker": "^1.20",
     "nelmio/cors-bundle": "^2.1",
     "odolbeau/phone-number-bundle": "^3.1",
     "phpdocumentor/reflection-docblock": "^5.2",
-    "sentry/sentry-symfony": "^4.3",
-    "symfony/asset": "6.4.*",
-    "symfony/cache": "6.4.*",
-    "symfony/console": "6.4.*",
-    "symfony/dotenv": "6.4.*",
-    "symfony/expression-language": "6.4.*",
+    "sentry/sentry-symfony": "^5.8",
+    "symfony/asset": "7.4.*",
+    "symfony/cache": "7.4.*",
+    "symfony/console": "7.4.*",
+    "symfony/dotenv": "7.4.*",
+    "symfony/expression-language": "7.4.*",
     "symfony/flex": "^2.4",
-    "symfony/framework-bundle": "6.4.*",
-    "symfony/http-client": "6.4.*",
-    "symfony/property-access": "6.4.*",
-    "symfony/property-info": "6.4.*",
-    "symfony/security-bundle": "6.4.*",
-    "symfony/serializer": "6.4.*",
-    "symfony/string": "6.4.*",
-    "symfony/translation": "6.4.*",
-    "symfony/twig-bundle": "6.4.*",
-    "symfony/uid": "6.4.*",
-    "symfony/validator": "6.4.*",
-    "symfony/yaml": "6.4.*",
+    "symfony/framework-bundle": "7.4.*",
+    "symfony/http-client": "7.4.*",
+    "symfony/property-access": "7.4.*",
+    "symfony/property-info": "7.4.*",
+    "symfony/security-bundle": "7.4.*",
+    "symfony/serializer": "7.4.*",
+    "symfony/string": "7.4.*",
+    "symfony/translation": "7.4.*",
+    "symfony/twig-bundle": "7.4.*",
+    "symfony/uid": "7.4.*",
+    "symfony/validator": "7.4.*",
+    "symfony/yaml": "7.4.*",
     "twig/twig": "^3"
   },
   "require-dev": {
@@ -52,17 +51,17 @@
     "liip/functional-test-bundle": "^4.5",
     "liip/test-fixtures-bundle": "^2",
     "phpspec/prophecy-phpunit": "^2.0",
-    "phpstan/phpstan": "^1.10",
+    "phpstan/phpstan": "^1.12",
     "phpunit/phpunit": "^10.0",
     "rector/rector": "^0.15",
     "squizlabs/php_codesniffer": "^3.7",
-    "symfony/browser-kit": "6.4.*",
-    "symfony/css-selector": "6.4.*",
-    "symfony/debug-bundle": "6.4.*",
+    "symfony/browser-kit": "7.4.*",
+    "symfony/css-selector": "7.4.*",
+    "symfony/debug-bundle": "7.4.*",
     "symfony/maker-bundle": "^1.23",
-    "symfony/phpunit-bridge": "^6.4",
-    "symfony/var-dumper": "6.4.*",
-    "symfony/web-profiler-bundle": "6.4.*"
+    "symfony/phpunit-bridge": "^7.4",
+    "symfony/var-dumper": "7.4.*",
+    "symfony/web-profiler-bundle": "7.4.*"
   },
   "config": {
     "optimize-autoloader": true,
@@ -110,7 +109,7 @@
   "extra": {
     "symfony": {
       "allow-contrib": false,
-      "require": "6.4.*"
+      "require": "7.4.*"
     }
   }
 }